diff --git a/AGENTS.md b/AGENTS.md index e03f03c..9dcb35a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,38 +1,25 @@ # Arbeiten an Rust Discovery -## Einstieg für jeden Auftrag +Der abgenommene MVP liegt auf dem Branch `main`. Der [Produktvertrag](Rust_RMM_Implementierungsspezifikation.md) beschreibt das Verhalten, die [MVP-Abnahme](docs/mvp-completion-plan.md) die tatsächlich geprüften Geräte und Ergebnisse. Den nächsten Arbeitsumfang bestimmt der aktuelle Nutzerauftrag. -1. Lies das [Produktziel, den geprüften Stand und den nächsten Schritt](docs/mvp-completion-plan.md). **Nur dort** steht die aktive Arbeitsreihenfolge. Die [Übergabe](docs/handover.md) nennt den passenden Betriebszugang. Eine datierte Abnahme oder ein alter Reparaturplan ist ein Beleg für seinen damaligen Stand. -2. Benenne das Nutzerergebnis des gewählten Schritts, den schon vorhandenen Beleg und die fehlende Beobachtung. Lies vor Änderungen den betroffenen Code und Vertrag. Bei Produktentscheidungen gilt [Kapitel 0 der Spezifikation](Rust_RMM_Implementierungsspezifikation.md) mit dem jüngsten einschlägigen Nutzerentscheid. [Entscheidungsbuch](docs/project-decisions.md) und [Entwicklungsweg](docs/development.md) liefern den Hintergrund. -3. Ein Integrator koordiniert Zielgeräte, gemeinsam genutzte Dateien, WebUI und Gitindex. Teilaufträge bekommen einen Dateibereich und ein prüfbares Ergebnis. Vorhandenen WIP mit `git status --short` abgrenzen, funktionierende Teilstrecken wiederverwenden und nur aufgabenbezogene Änderungen aufnehmen. -4. Wenn eine frühere Grenze das Ziel behindert, kläre ihren Zweck und wähle die kleinste begründete Änderung. Technische Vereinfachungen dürfen direkt umgesetzt werden. Eine geänderte Produktentscheidung in Kapitel 0 und im Entscheidungsbuch festhalten. Eine unbekannte Wirkung eines früheren Jobs bleibt dabei unbekannt. -5. Nach einem Schritt den Status **in derselben Planzeile** aktualisieren. Quelle, Artefakt, echter Zielkontakt und fachliche Abnahme getrennt belegen. Bei einem Hindernis die konkrete fehlende Beobachtung festhalten und am nächsten unabhängigen Liefergegenstand weiterarbeiten. Weitere Randfälle sammeln. Nach Abschluss des beauftragten Ablaufs den Betreiber fragen, welche davon bearbeitet werden sollen. +## Einen Auftrag übernehmen -## Was wir liefern +1. Mit `git status --short --branch` den Arbeitsbaum und vorhandene Änderungen prüfen. Für laufende Fremdarbeit einen separaten Branch oder Worktree verwenden. +2. In der [Übergabe](docs/handover.md) den betroffenen Einstiegspunkt finden. Vor Änderungen den tatsächlichen Aufrufer, die Berechtigungsprüfung und die vorhandenen Tests lesen. Ein datierter Beleg in `docs/evidence/` dokumentiert das Ereignis zu seinem Messzeitpunkt. +3. Den normalen Bedienweg und den konkreten Fehlerfall prüfen. Bei einem Linux- oder Windows-spezifischen Verhalten den betreffenden Gast verwenden. Ein Build belegt die Erzeugung des Artefakts. Das Ergebnis des Zielgeräts belegt seine Wirkung. +4. Verändert sich das Produktverhalten, die zuständige Anleitung und den Produktvertrag abgleichen. Eine neue Abnahme im [Prüfstand](docs/mvp-completion-plan.md) mit Quelle, Ziel und beobachtetem Ergebnis nachtragen. -Ein Server mit WebUI und MCP verwaltet Linux- und Windows-Clients. Die Clients melden Heartbeats und Inventar, holen optionale Skriptaufträge ab und geben Ergebnisse zurück. Eine benannte, versionierte Skriptbibliothek bedient beide Oberflächen. Windows-Updates sind ein PowerShell-Katalogeintrag. Ein frischer Client lässt sich über ein HTTPS-Installationsskript aufnehmen und aktualisiert seinen eigenen Agenten periodisch aus dem signierten Releasebestand des Servers. Die Abnahmekriterien stehen im Plan. +## Regeln für Änderungen -Für Geräte und Kunden gilt Kapitel 0.7. Änderungen an Kundengrenzen mit beschränktem und globalem Token prüfen, einschließlich Listen, direkter Geräte-IDs und Widerruf. Die Trennung von Bestand und Historie beruht auf der bestätigten Geräteidentität. Bei einem Kundenwechsel neu enrollen und die bisherige Historie beim ursprünglichen Kunden belassen. +- Jede neu geplante Geräteaktion nutzt ein Skript. Ein Neustart und ein Betriebssystemupdate durchlaufen denselben Weg wie ein eigenes Shell- oder PowerShell-Skript. +- Jeder eingereichte Skriptplan wartet auf Genehmigung. Eine berechtigte Person bestätigt in der WebUI Ziel, genaue Skriptbytes, Rechte, Zeitfenster und feste Versuche. Diese Entscheidung gehört zur Person. Für produktive Aufträge sind Freigaben durch die KI, einen MCP-Token oder direkte Datenbankzugriffe ausgeschlossen. Separat gekennzeichnete Simulationen gehören ausschließlich zum internen Entwicklungsprofil. +- Beim Zustellen und Wiederverbinden die Signatur-, Zeit-, Geräte- und Versuchsbindung erhalten. Einen bereits gestarteten oder ungeklärten Versuch anhand seines Journals und der Serverdaten abgleichen. Ein neuer Versuch braucht einen eigenen genehmigten Plan. Einen Neustart mit Bootwechsel, authentisiertem Kontakt derselben Installation und erfolgreichem Folgeauftrag prüfen. +- Die Kundenbindung gilt auch für direkte IDs und gespeicherte Ergebnisse. Änderungen an Tokenrechten mit berechtigtem und fremdem Kunden sowie nach Widerruf prüfen. Für einen Kundenwechsel das Gerät neu aufnehmen. Die bisherige Historie gehört zum bisherigen Kunden. +- Ein Administrator-Skript braucht neben den Serverrechten den für diese Installation eingerichteten Helper. Bei `SCRIPT_HELPER_SCOPE_DENIED` zuerst Kunden- und Tokenrechte sowie die zentrale Geräteregel prüfen. [MCP-Zugang](docs/public-access.md) +- Beim Binärwechsel Geräteidentität, Zertifikate, Journale und Dateirechte erhalten. Bei Änderungen am Installer oder Selbstupdate den HTTPS-Installer beziehungsweise den regulären Updateabruf prüfen. -Für Skriptaufträge gelten Kapitel 0.8 und 0.10. Alle neuen Geräteaktionen einschließlich Neustarts verwenden ein Skript. Beim Prüfen eines Neustarts den alten und neuen Bootbezug, die Kopplung und das Ergebnis eines Folgeauftrags festhalten. Die Bibliothek veröffentlicht Skriptversionen. Gerätezuweisung und Ergebniskontrolle gehören zu „Aufträge“, die interaktive Entscheidung zu „Genehmigungen“. Änderungen an einem dieser Wege am Übergang zum nächsten prüfen. +## In der Entwicklungsumgebung arbeiten -Für MCP-Administratoranträge gemäß Kapitel 0.12 zuerst die wirksamen Tokenrechte im Kunden und die zentrale Regel der konkreten Installation prüfen. Bei `SCRIPT_HELPER_SCOPE_DENIED` zeigt der [Operator für die Geräteregel](docs/public-access.md#administrator-skripte-anfordern), ob sie für solche Anträge geöffnet ist. +Das Notebook ist der Entwicklungsrechner. Server und beide Testgäste sind getrennte Ziele. Für Builds, Transfer und Aktivierung die [Projektwerkzeuge](docs/development.md) verwenden. Vorhandene Artefakte dürfen für die Entwicklung über gepinntes SSH/SFTP bereitgestellt werden. Zielneustarts, echte Betriebssystemupdates und Löschungen brauchen einen konkreten Auftrag. -## Betrieb und Freigabe - -- Der dedizierte Server ist `discovery.ease-technologies.de`. Testclients sind die Cloud-Linux-VM und der Windows-11-Gast. Das Notebook dient ausschließlich der Entwicklung. Plattformspezifische Arbeit auf beiden Gästen darf parallel laufen. Plattformfunktionen jeweils nativ nachweisen. -- Der produktive Geräteverkehr geht vom Client aus. SSH/SFTP ist im Entwicklungsbetrieb ausdrücklich für die direkte Bereitstellung vorhandener Artefakte zulässig. Der [Entwicklungsweg](docs/development.md) beschreibt Build, Transfer und Aktivierung. Zur Produktabnahme von Installer und Selbstupdate den jeweiligen Produktweg benutzen. -- Jeder **Skript- oder Wartungsjob** aus UI, MCP oder Automatik wird zunächst als `pending_approval` gespeichert. Erst eine berechtigte Person genehmigt den unveränderlichen Plan mit Ziel, Skriptbytes, Rechten, Grenzen und festen Versuchen in der WebUI. Vorher bleiben ausführbare Jobs, Outbox, Angebote und Startgrants leer. Policies begrenzen. Direkte API-/DB-Freigaben durch KI oder Automatik sind ausgeschlossen. -- Ausschließlich im expliziten dev/test-Profil darf ein sichtbar **simulierter Testprincipal** die tatsächliche WebUI per Browser bedienen. Audit bindet `approval_origin`, `testsimulation`, Principal und Plan. In Produktion gilt die menschliche Freigabe. Redelivery darf keine zweite Ausführung auslösen. Neue Versuche und Folgejobs brauchen eine eigene feste Freigabe. -- Passive Standardtelemetrie und gespeicherte Lesezugriffe laufen ohne Job. Version 1.33 spezifiziert zusätzlich die automatische Installation **veröffentlichter signierter Agent-Releases**. Der Releasepfad akzeptiert ausschließlich die festgelegten Agentkomponenten. Eine Live-Diagnose oder ein OS-Update ist ein Wartungsjob. -- WebUI und MCP sind öffentlich über HTTPS mit lokalem Passwort/TOTP beziehungsweise scoped Bearer-Tokens erreichbar. Der [öffentliche Zugang](docs/public-access.md) ist der maßgebliche Aufbau seit Spezifikation 1.35. Der separate dev/test-Zugang bleibt intern über den SSH-Tunnel erreichbar. Dockerports an Loopback binden, PostgreSQL intern betreiben. Für die öffentlichen Geräte- und Bootstrapwege TLS-Kette und SAN/SNI prüfen, für registrierte Geräte mTLS und Mandantenbindung durchsetzen. Der öffentliche Installer braucht einen auf dem frischen Gerät bereits vertrauenswürdigen TLS-Anker. -- `credentials/` bleibt ignoriert und privat (0700, Dateien 0600). Die [Zugangsanleitung](docs/operations-access.md) nennt Parser und bestätigte Hostpins. Profile ausschließlich als Daten verarbeiten, kein `source` oder `eval`. Schlüssel, Token und private Diagnoseausgaben gehören weder ins Repository noch in Agentkontexte. -- Windows x64 wird offiziell mit `windows-gnu-x64` gebaut und mit `--official-windows` veröffentlicht. Die [Releaseanleitung](docs/development.md#offizielle-windows-veröffentlichung) gilt auch für den Starter neuer Kunden. Bei Änderungen an Installer, Vertrauensstellung oder Updateablauf auf dem Gast den Übergang zwischen zwei signierten Releases prüfen. -- Bei einem normalen Binärwechsel Identität, PKI, Konfiguration, Journale und Dateirechte erhalten. Im aktuellen Entwicklungssystem dürfen ausdrücklich freigegebene Altanträge und blockierende Testprojektionen gezielt entfernt werden. Nach einer Bereinigung das Fehlen des Auftrags und den frischen Geräteabgleich prüfen. Zielreboots, OS-Updates und destruktive Tests brauchen einen konkreten Auftrag. Vom Status `unknown` führt nur der belegte Abgleich oder der dokumentierte WebUI-Abschluss weiter. Niemals blind wiederholen. - -## Nachweise und Umfang - -Teste die betroffene Funktion und den konkreten Fehlerpfad. Verwende vorhandene native Belege weiter. Kennzeichne geplante, noch nicht ausgeführte Befehle sowie fehlende Zugänge oder Werkzeuge. Historische APT-/MSI-/Rebootabnahmen, Terminal, RustDesk, PVE/PBS, Cluster und Backups sind keine Voraussetzungen für den aktuellen Lieferplan. - - -Für ein benötigtes Windows-Update-Wartungsfenster den [dokumentierten Operator](docs/windows-update-dev-window.md) wiederverwenden. Der temporäre SYSTEM-Helper bindet das aktuelle signierte Agentpaar und die Geräteidentität. Nach terminalem Ergebnis das Fenster schließen und den normalen Agent-/Updatebetrieb nachlesen. Eine echte OS-Installation gilt erst mit ihrem eigenen Zielergebnis als nachgewiesen. +`credentials/` bleibt privat und von Git ausgeschlossen. Profile als Daten über die vorhandenen Parser lesen, Zugangswerte weder ausgeben noch ins Repository übernehmen. Zugangsdatenverzeichnis, Dateirechte und Hostprüfung sind in den [Betriebszugängen](docs/operations-access.md) beschrieben. diff --git a/README.md b/README.md index dcf62d2..0ca9068 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,24 @@ # Rust Discovery -Rust Discovery verwaltet Linux- und Windows-Geräte über einen dedizierten Server mit WebUI und MCP. Die Clients melden sich ausgehend per HTTPS, liefern Inventar und Heartbeats, holen genehmigte Skripte ab und melden ihre Ergebnisse zurück. Wiederkehrende Aufgaben lassen sich als versionierte Skripte hinterlegen. Neue Geräte werden über einen HTTPS-Installer aufgenommen und beziehen signierte Agentupdates vom Server. +Rust Discovery ist eine Remote-Monitoring- und Management-Plattform für Linux- und Windows-Geräte. Der Server verwaltet Kunden, Geräte, Skripte und Aufträge. Die Agenten melden sich von den Geräten aus, liefern Inventar und Heartbeats, holen genehmigte Skripte ab und melden die Ausgabe zurück. -**[Aktueller Stand und Schritt-für-Schritt-Plan](docs/mvp-completion-plan.md)** · [Entwicklungsbefehle](docs/development.md) · [Übergabe und Zugänge](docs/handover.md) +**Der MVP ist abgenommen.** Auf Ubuntu und Windows 11 wurden ein eigenes Administrator-Skript, eine Skriptversion aus der Bibliothek, ein echter Neustart und ein weiterer Auftrag nach der Wiederanmeldung geprüft. Die Abnahme enthält die Ausgaben und den installierten Stand beider Geräte. [MVP-Abnahme](docs/mvp-completion-plan.md) -## Stand am 17. November 2026 +## Von der Geräteauswahl zum Ergebnis -Die beiden über den öffentlichen Installer aufgenommenen Geräte haben ein Bibliotheksskript mit Exitcode 0 zurückgemeldet. WebUI und MCP zeigen das Ergebnis desselben Versuchs. Der Linux-Timer und der Windows-Updaterdienst haben auf den Testgästen selbstständig veröffentlichte Versionen übernommen. Die integrierte Windows-Update-Vorlage erfordert gesondert eingerichtete Wartungsrechte. [Aktueller Prüfstand](docs/mvp-completion-plan.md) +1. In der WebUI den Kunden und unter **Geräte** die Zielmaschine auswählen. +2. Unter **Aufträge** ein eigenes Skript eingeben oder eine feste Version aus **Skripte** auswählen. Ausführungskonto und Zeitfenster prüfen und den Auftrag einreichen. +3. Unter **Genehmigungen** prüft eine berechtigte Person den Skriptinhalt und die Ziele und entscheidet über die Ausführung. +4. Unter **Aufträge** den Auftrag öffnen und pro Gerät Ergebnis, Ausgabe und Exitcode lesen. Über das Gerätedetail sind seine letzten Aufträge ebenfalls erreichbar. -## Einstieg in den Code +MCP kann Skriptversionen veröffentlichen, eigene Skripte und Bibliotheksversionen für berechtigte Kunden einreichen sowie Ergebnisse lesen. Die persönliche Genehmigung erfolgt in der WebUI. [WebUI öffnen](https://discovery.ease-technologies.de:8443/) · [Zugang und MCP-Rechte](docs/public-access.md) -| Aufgabe | Einstieg | +## Einstieg ins Projekt + +| Ich möchte … | Einstieg | | --- | --- | -| Verwaltungs-API, UI und MCP | [Server-Routen](crates/server/src/main.rs), [MCP-Werkzeuge](crates/server/src/mcp.rs), [WebUI](web/src/main.tsx) | -| Gerätekommunikation und Jobs | [HTTPS-Poll](crates/server/src/agent_http.rs), [Jobzustellung](crates/server/src/job_gateway.rs), [gemeinsamer Agentkern](crates/agent-core/src/lib.rs) | -| Linux- und Windows-Dienst | [Linux-Agent](crates/agent/src/main.rs), [Windows-Laufzeit](crates/agent-windows/src/runtime.rs) | -| Releases und Selbstupdate | [Releasekatalog und Downloads](crates/server/src/agent_updates.rs), [Manifestprüfung](crates/updater/src/manifest.rs) | - -Der Server läuft auf `discovery.ease-technologies.de`. Die [öffentliche WebUI](https://discovery.ease-technologies.de:8443/) verwendet Passwort und TOTP. Der [MCP-Endpunkt](https://discovery.ease-technologies.de:8443/mcp) verwendet eigene Bearer-Tokens. [Einrichtung und Betrieb](docs/public-access.md) Die Cloud-Linux-VM und der Windows-11-Gast dienen als Testgeräte. Das Notebook ist der Entwicklungsrechner. - -[Agenthinweise](AGENTS.md) · [Spezifikation](Rust_RMM_Implementierungsspezifikation.md) · [Entscheidungen](docs/project-decisions.md) · [Historische Linux-Abnahme](docs/mvp-final-audit.md) · [Windows-Nachweise](docs/windows-gates.md) +| einen Entwicklungsauftrag übernehmen | [Agenthinweise](AGENTS.md) und [Übergabe](docs/handover.md) | +| den Funktionsumfang und die Grenzen des MVP verstehen | [Produktvertrag](Rust_RMM_Implementierungsspezifikation.md) | +| ein Gerät aufnehmen oder einen Agenten aktualisieren | [Linux](deploy/linux/README.md) oder [Windows](deploy/windows/README.md) | +| eine Änderung bauen, testen oder bereitstellen | [Entwicklung und Deployment](docs/development.md) | +| einen Betriebsvorgang auf dem Testsystem prüfen | [Betriebszugänge](docs/operations-access.md) und [Abnahmebelege](docs/mvp-completion-plan.md) | diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index ad7ab3b..4deb58f 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,2013 +1,41 @@ -# Rust RMM: Architektur und Implementierungsspezifikation +# Produktvertrag des Rust-Discovery-MVP -Version 1.41 · 2026-11-18 · Sprache: Deutsch +Dieser Vertrag beschreibt den ausgelieferten Funktionsumfang. Die eingesetzten Versionen und die Ergebnisse auf den Zielgeräten stehen in der [MVP-Abnahme](docs/mvp-completion-plan.md). -**Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. +## Server, Geräte und Kunden -**Status:** Spezifikation; keine Behauptung einer bereits vorhandenen Implementierung. Version 1.4 führte Linux-first mit realem VM-Nachweis und lokalem Docker-/SSH-/TLS-Entwicklungsweg ein. Version 1.5 dokumentiert die neuen Userentscheidungen: MVP ohne RustDesk und eng begrenzte dev/test-Browsersimulation tatsächlicher UI-Interaktionen. Die zwingende menschliche WebUI-Genehmigung im Produktionsverhalten bleibt unverändert. Sie benötigt weder das Word-Dokument noch externe Diagrammdateien. +Der Server betreibt die WebUI, den MCP-Endpunkt, den Releasekatalog und das Gerätegateway. PostgreSQL speichert die kundengebundenen Verwaltungsdaten. Der Geräteverkehr geht vom Client aus. Ein aufgenommener Agent authentisiert sich mit seinem Gerätezertifikat, übermittelt Heartbeats und Inventar, holt eventuell vorliegende Aufträge ab und meldet deren Verlauf und Ergebnis. Auch im Leerlauf meldet sich das Gerät regelmäßig. -**Versionsverlauf:** 1.2 → 1.3: keine automatische Jobfreigabe, eigenständige Gastagenten, PVE nachgelagert. 1.3 → 1.4 (2026-11-12): erstes Phasenziel Linux-MVP M0–M5, alle Features zuerst auf tatsächlicher Linux-Test-VM; Windows erst danach, PVE noch später; verbindliche Entwicklungs- und Nachweisregeln in `AGENTS.md` und `docs/development.md`. +Jede Installation ist an Kunde, Gerät und Agentenidentität gebunden. Die Standardansicht zeigt bereits authentisierte aktuelle Geräte als online oder offline, mit Hostname, Betriebssystem, freiem und gesamtem Speicherplatz, RAM, CPU und Kunde. Ausgemusterte, ersetzte und unbestätigte Kopplungen sind getrennt in der Historie abrufbar. Fehlende Inventarwerte bleiben als solche erkennbar. Der Zeitpunkt des letzten Kontakts und der Zeitpunkt der Inventarmessung haben unterschiedliche Bedeutung. [Geräteauswahl](crates/server/src/device_list.sql) -1.4 → 1.5 (2026-11-12): ausdrücklicher Useroverride „rustdesk musst du nicht machen ... das lasse aus“; RustDesk ist keine Pflicht dieser Umsetzung und keine MVP-Abnahme. Ausschließlich browsergesteuerte dev/test-Bedienung darf mit sichtbar simuliertem Testprincipal menschliche UI-Aktionen nachstellen; keine API-/DB-Freigabeabkürzung. Lokale Serverneustarts ausdrücklich erlaubt, keine impliziten VM-Reboots/Updates/destruktiven Zieltests. +Kunden lassen sich in der WebUI anlegen und umbenennen. Beim Kundenwechsel erhält das Gerät eine neue Kopplung. Eine ausgeschiedene Installation kann nach Widerruf und persönlicher Bestätigung endgültig gelöscht werden. Ein noch gültiger offener Genehmigungsantrag oder ein nicht abgeschlossener Job einschließlich `unknown` sperrt die Löschung. Daten weiterhin beteiligter Zielgeräte bleiben erhalten. [Regeln zur Löschung](migrations/0036_delete_device_pairing.sql) -1.15 → 1.16 (2026-11-14): Windows-SYSTEM als eigene explizite Identität und -`system:execute` mit unabhängiger, standardmäßig verweigernder zentraler und -lokaler Helperpolicy präzisiert. Keine Vererbung von Linux-Rootrechten, keine -Windowsfähigkeit aus einer bloßen Quellen-/Build-/Linux-Unitqualifikation. +## Vom Skript zum Ergebnis -1.18 → 1.19 (2026-11-14): Nächster Windows-M4-Schnitt als ausdrücklicher -Opt-in für zwei eigene feste MSI-Rezepte (1.0 und1.0→1.1) präzisiert: -unveränderlicher Tenantkatalog, exakte automatische Job-/Artefaktbindung, -getrennte SYSTEM-Paketerlaubnis und unabhängige Nachbedingungen. Kein freier -Installer, kein automatisches Update/Repair, keine implizite EXE-/Rebootfreigabe. - -1.17 → 1.18 (2026-11-14): Ausdrückliche Userfreigabe für die feste, vor der -WebUI-Genehmigung sichtbare RemoteSigned-Option je Windows-PowerShell5.1- -Jobprozess, gezieltes Starten des bestehenden W32Time ohne Konfigurationsänderung -und einen erst später abgestimmten manuellen VM-Konsolenneustart präzisiert. -Keine Maschinen-/GPO-Policyänderung, kein Remote-/RMM-Reboot und keine daraus -abgeleitete Clock-/Capability-Abnahme. - -1.16 → 1.17 (2026-11-14): Dauerhafter SYSTEM-Delegationsintent und enges deny-only -Abandon mit Originalgrant, unabhängiger Helper-Lineage und vollständiger -Snapshotbindung präzisiert. Mehrdeutige Übergaben bleiben Unknown; keine -Abschwächung der vorhandenen Sync-/Verbrauchsinvarianten. - -1.19 → 1.20 (2026-11-14): Der User priorisiert die vollständige, einzeln -WebUI-genehmigte Shell-/PowerShell-Skriptkonsole für KI/MCP und Menschen. -Ein ausdrücklich gebundenes Profil `full_maintenance_v1` ermöglicht nach -getrennter Qualifikation Root-/SYSTEM-Hostwartung; bisherige begrenzte -Dienst-/Paketprofile erhalten dadurch keine zusätzliche Erlaubnis. Batchstatus -und abschließende begrenzte Rohbyteausgabe verwenden die bestehende Jobstrecke; -interaktive PTY-/ConPTY-Sitzungen bleiben späterer eigener Umfang. - -1.20 → 1.21 (2026-11-14): Auf ausdrücklichen Userwunsch wird ausschließlich -Agent-Selbstupdate ausM7 parallel vorgezogen. Signiertes festes Agent-/Helper- -Codepaar, eigener großer Artefaktpfad, WebUI-gebundener Updatejob und erhaltende -Helper-/Updater-Übergabe mit geschlossenem Inflight-/Healthkontrollpfad werden -präzisiert. Das ist keine native Applyabnahme oder Freigabe weitererM7-Themen. - -1.21 → 1.22 (2026-11-14): Der User erlaubt für Windows einen unabhängigen, -signierten Zeitvergleich mit dem festgelegten Server als alternative Trustsource. -Agent und SYSTEM-Helper prüfen unabhängig; fehlende Qualität sperrt Jobs. -Keine Uhrstellung, keine automatische Genehmigung und kein nativer Erfolgsbeleg. - -1.22 → 1.23 (2026-11-15): Der User erlaubt für die konkrete aktive Windows-KVM- -Testumgebung ausdrücklich das versionierte Profil `trusted_os_active_guest`. -Dokumentierte Windows-/KVM-/Hardwarezeit wird als nominelle OS-Zeitskala -vertraut; eine zusätzliche unabhängige physikalische Timerkalibrierung entfällt -ausschließlich in diesem Opt-in-Profil. Signierter Serververgleich, kurze -Fristen, unabhängige Helperprüfung und WebUI-Genehmigung bleiben erhalten. - -1.29 → 1.30 (2026-11-16): technische Präzisierung des normalen frischen -Onlineabgleichs bei genau einer belegten, wirkungslos abgeschlossenen -Windows-Teilkante. Originale bleiben erhalten, neue unabhängige Zeit-/Signatur- -und Helper-ACK-Prüfungen bleiben Pflicht. Eng typisierter Precommit-Uhrfehler -darf nur innerhalb derselben ursprünglichen Applyanfrage begrenzt erneut -geprüft werden. Keine neue administrative Historienausnahme, Wireänderung, -Jobgenehmigung, alte Lease oder Zeitlockerung. - -1.30 → 1.31 (2026-11-17): ausdrückliche Userentscheidung „Ja, setze das so -um“: allgemeiner menschlicher WebUI-Abschluss eines `unknown`-Jobs als eigener -Endzustand `closed_unknown`. Die Wirkung bleibt unbekannt; kein Erfolg, -Fehlschlag oder Nichtstart wird behauptet, kein Retry, keine neue Genehmigung. -Der Abschluss hebt ausschließlich die Gerätesperre für neue, einzeln -genehmigte Aufträge auf. Details Kapitel 0.2. - -1.31 → 1.32 (2026-11-17): ausdrückliche Userentscheidung „Du kannst das harte -Zeitfenster auflockern … nimm das harte Zeitfenster gerne großzügiger an und -dokumentiere diese Entscheidung“: signierte Zeitbelege bleiben bis zu fünf -Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3. - -1.32 → 1.33 (2026-11-17): Aktuelles Lieferziel sind clientseitiger Skriptabruf, benannte Skriptbibliothek, veröffentlichte Agentbinaries, automatischer Versionswechsel und Erstinstallation per HTTPS. Kapitel 0 legt die Abweichung vom früheren manuellen Updatejob und die aktuelle Arbeitsreihenfolge fest. - -## Inhaltsverzeichnis - -- [0 Auftrag und verbindliche Produktanforderungen](#0-auftrag-und-verbindliche-produktanforderungen) -- [1 Entscheidung und Geltungsbereich](#1-entscheidung-und-geltungsbereich) -- [2 Komponenten und Systemgrenzen](#2-komponenten-und-systemgrenzen) -- [3 Rust und der technische Stack](#3-rust-und-der-technische-stack) -- [4 Aufbau der Agenten](#4-aufbau-der-agenten) -- [5 Verbindung und Nachrichtenprotokoll](#5-verbindung-und-nachrichtenprotokoll) -- [6 Datenmodell und Gerätezuordnung](#6-datenmodell-und-gerätezuordnung) -- [7 Inventarisierung und Datenerhebung](#7-inventarisierung-und-datenerhebung) -- [8 Monitoring und Alarmierung](#8-monitoring-und-alarmierung) -- [9 Proxmox und Backupbeobachtung](#9-proxmox-und-backupbeobachtung) -- [10 Aufträge und Softwareinstallation](#10-aufträge-und-softwareinstallation) -- [11 Shell und Bereitstellung von RustDesk](#11-shell-und-bereitstellung-von-rustdesk) -- [12 MCP und Steuerung durch KI](#12-mcp-und-steuerung-durch-ki) -- [13 Mandanten und Schutz der Verwaltungsfunktionen](#13-mandanten-und-schutz-der-verwaltungsfunktionen) -- [14 Oberfläche und Bedienung](#14-oberfläche-und-bedienung) -- [15 Speicherung und Größenordnung](#15-speicherung-und-größenordnung) -- [16 Betrieb und Aktualisierung](#16-betrieb-und-aktualisierung) -- [17 Umsetzung in überprüfbaren Schritten](#17-umsetzung-in-überprüfbaren-schritten) -- [18 Startentscheidungen und konfigurierbare Betriebsdaten](#18-startentscheidungen-und-konfigurierbare-betriebsdaten) -- [19 Repository, Module und Abhängigkeitsrichtung](#19-repository-module-und-abhängigkeitsrichtung) -- [20 Normative Datenverträge](#20-normative-datenverträge) -- [21 Normativer Agentprotokoll-Vertrag](#21-normativer-agentprotokoll-vertrag) -- [22 Pläne, Ausführungserlaubnis und Jobzustände](#22-pläne-ausführungserlaubnis-und-jobzustände) -- [23 HTTP API, MCP und Berechtigungen](#23-http-api-mcp-und-berechtigungen) -- [24 Aktions-, RustDesk- und Providerverträge](#24-aktions--rustdesk--und-providerverträge) -- [25 Implementierungsreihenfolge und Abnahmekriterien](#25-implementierungsreihenfolge-und-abnahmekriterien) -- [26 Direkt verwendbarer Startauftrag für eine Coding-KI](#26-direkt-verwendbarer-startauftrag-für-eine-coding-ki) -- [Quellen und Referenzen](#quellen-und-referenzen) - -## 0 Auftrag und verbindliche Produktanforderungen - -### 0.12 MCP-Anträge für Administrator-Skripte (Version 1.41) - -Ein MCP-Token kann einmalige Skripte und feste Bibliotheksversionen für seine Kunden planen und einreichen. Die Rechte werden pro Token auf dem Server vergeben. Zusätzlich zu Planung, Einreichung, Lesen und Skriptausführung erfordert der administrative Kontext auf Linux `root:execute`, auf Windows `system:execute`. - -Der Betreiber kann eine bestehende zentrale Geräteregel für diese Tokenrechte öffnen. Dabei gelten die Bindungen an Installation, Helper und Skriptprofil sowie etwaige Beschränkungen auf konkrete Skriptinhalte. Eine Tokenrotation erfordert auf dem Client keine Konfigurationsänderung. Der Server stellt den signierten Startauftrag nach der persönlichen Entscheidung aus Kapitel 0.8 aus. Der Client prüft dessen Bindung an Gerät, Skript und Versuch und führt ihn ohne lokale Rückfrage aus. - -### 0.11 Gültigkeit von Releases bei bereits installierten Skripthelfern (Version 1.40) - -Für Neuinstallationen und Updates muss das Release-Manifest zum Zeitpunkt der Prüfung gültig sein. Für Administrator-Skripte auf bereits installierten Clients prüft der Server die Manifest-Gültigkeit zum gespeicherten Zeitpunkt der Katalogregistrierung. Die Signatur wird mit dem aktuellen Schlüsselring geprüft. Gerätebindung, Helper-Hash, Berechtigungen und Auftragsgenehmigung sind weiterhin erforderlich. - -### 0.10 Ausführbare Geräteaufträge (Version 1.39) - -Jede neue Aktion aus WebUI oder MCP wird als `run_script` geplant. Das gilt auch für Neustarts. Die Bibliothek stellt je eine Revision für Linux (Root) und Windows (SYSTEM) bereit. Plan, Genehmigung und Ergebnis binden die ausgewählte Revision und das Zielgerät. Der Exitcode des Neustartskripts belegt die Annahme durch das Betriebssystem. Die Abnahme eines Neustarts erfordert zusätzlich einen geänderten Bootbezug, einen neuen authentisierten Kontakt und einen erfolgreichen Folgeauftrag der gleichen Kopplung. - -Ein eingeschriebener Client meldet seine tatsächlich verfügbaren Skriptkontexte. Der reguläre Dienst verwendet sein Dienstkonto. Administratorausführung erfordert einen für diese Geräteidentität konfigurierten und verifizierten Helper sowie eine passende zentrale Berechtigung. Eine frühere Freigabe einzelner Wartungsskripte gilt weiterhin nur für deren festgelegten Umfang. Für regulär eingerichtete Administratorausführung ist kein Wartungsfenster pro Auftrag erforderlich. Passive Heartbeats, Inventar, signierte Selbstupdates und die Wiederaufnahme alter Versuchsergebnisse haben eigene Lebenszyklen. Historische typisierte Pläne bleiben einsehbar und können abgelehnt werden. - -### 0.9 Offizieller Windows-Kanal und ausgeschiedene Geräte (Version 1.38) - -Für Windows x64 wird `x86_64-pc-windows-gnu` als offizielles Ziel gebaut, signiert und vom HTTPS-Installer standardmäßig gewählt. Das veröffentlichte Agent-/Helperpaar und der stabile Updater stammen aus einem nachgewiesenen GNU-Build. Der offizielle Schlüssel ist vom Entwicklungsschlüssel getrennt. Alle Verwaltungs- und Geräteprozesse einer Installation verwenden denselben offiziellen Schlüsselring. Die native Abnahme umfasst Erstaufnahme, Ablehnung einer Entwicklungssignatur, automatisches Folgeupdate unter derselben Geräteidentität und einen genehmigten Skriptauftrag. MSVC bleibt ein optionales weiteres Buildziel. - -Für eine ausgeschiedene Installation bietet die Geräteverwaltung die endgültige Löschung an. Eine interaktiv angemeldete Person mit `devices:revoke` widerruft die konkrete Kopplung und bestätigt die Löschung. Kunde, Asset und Agent-ID bestimmen den Gegenstand. Offene Genehmigungen, laufende Jobs und ungeklärte Wirkungen sperren die Löschung. Mit der Installation entfallen ihr Inventar und ihre eigenen Aufträge und Ergebnisse. Geteilte signierte Pläne bleiben für weitere Zielgeräte lesbar. Das Audit protokolliert Widerruf und Löschung. Eine spätere Installation erhält ihre eigene Identität. - -### 0.8 Skripte, Aufträge und Genehmigungen in der WebUI (Version 1.37) - -Die Geräteübersicht ist die Startseite. „Skripte“ veröffentlicht benannte Versionen pro Kunde. „Aufträge“ weist ein einmaliges Skript oder eine feste Bibliotheksversion ausgewählten Geräten eines Kunden zu, reicht den unveränderlichen Plan ein und zeigt den Verlauf und die Ergebnisse je Gerät. Die Auswahl im Gerätebestand kann in einen neuen Auftrag übernommen werden. Einreichungen lassen sich für denselben gespeicherten Plan idempotent fortsetzen. - -„Genehmigungen“ bündelt eingereichte Anträge aus WebUI und MCP über die berechtigten Kunden hinweg. Die prüfende Person sieht Ziele, Skriptinhalt, Version, Ausführungsrechte und Zeitfenster vor ihrer ausdrücklichen Entscheidung. Der Server prüft die Rechte erneut. Technische Planbytes und Prüfsummen bleiben im Detail einsehbar. - -### 0.7 Kunden, Gerätebestand und MCP-Zugriff (Version 1.36) - -Ein Kunde entspricht einem Tenant. Die Kundenwahl bei der Geräteaufnahme bindet die Identität an diesen Tenant. Bei einem Wechsel wird das Gerät für den Zielkunden neu aufgenommen. Die vorherige Identität und ihre Auftragsdaten gehören weiterhin zum bisherigen Kunden. - -Der Bestand umfasst Geräte mit bestätigtem authentisiertem Kontakt, einschließlich inzwischen offline befindlicher Geräte. Widerrufene, ersetzte, explizit archivierte und unbestätigte Installationen sind über die Historie erreichbar. Gleiche Hostnamen sind kein Identitätsnachweis. Gespeicherte Inventardaten liefern OS, Speicherplatz, RAM und CPU mit Erhebungszeit. Fehlende Werte werden als solche angezeigt. - -Die interaktive Kundenverwaltung pflegt Kundennamen. Bei MCP-Tokens wählt ein berechtigter Verwalter sowohl die Aktionen als auch den Kundenkreis. Eine feste Auswahl enthält einen oder mehrere ausdrücklich gewählte Kunden. Der ausdrücklich globale Zugriff umfasst auch später angelegte Kunden und benötigt Kundenadministratorrechte. Beide Grenzen gelten bei Auflistungen und Direktzugriffen. Die Jobgenehmigung erfolgt weiterhin interaktiv in der WebUI. - -### 0.6 Öffentliche Verwaltung mit lokaler Authentisierung (Version 1.35) - -Userentscheidung vom 17. November 2026. WebUI und MCP sind über öffentliches HTTPS erreichbar. OAuth ist für diesen Aufbau ausgeschlossen. Die WebUI verwendet lokale Benutzer mit Passwort und TOTP. MCP verwendet individuell widerrufbare zufällige Bearer-Tokens mit Mandantenbindung, festen Scopes und Ablauf. Tokens werden nur gehasht gespeichert und einmal ausgegeben. Die feste WebUI-Genehmigung von Jobs bleibt an die echte interaktive Person gebunden. Die öffentliche Anmeldung verwendet das Produktionsprofil ohne simulierte Testidentität. Der private Entwicklungszugang bleibt für native Abnahmen verfügbar. - -Diese Entscheidung ersetzt die frühere ausschließliche SSH-Tunnel-Verwaltung und die Pflicht zu OIDC für den öffentlichen Anmeldeweg. Geräte-mTLS, ausgehendes HTTPS-Polling, TLS-Prüfung und Tenantgrenzen gelten weiterhin. [Öffentlicher Aufbau und Abnahme](docs/public-access.md) - -### 0.5 Entwicklungssystem für den MVP (Version 1.34) - -Der Betreiber hat die Löschung des als `closed_unknown` abgeschlossenen Entwicklungsantrags und das Entfernen blockierender Entwicklungsdaten ausdrücklich beauftragt. Für die MVP-Abnahme darf ein Testgerät mit neuer Identität über den Installer aufgenommen werden. Ein bereinigter Testauftrag erzeugt keine Ausführung und keinen neuen Versuch. Bei einem regulären Selbstupdate behält das Gerät seine Identität. Der verbindliche Nachweis steht im [Lieferplan](docs/mvp-completion-plan.md). - -Nach einem abgeschlossenen temporären Windows-Wartungsfenster darf der Entwicklungsoperator eindeutig terminale lokale Arbeitsprojektionen mit ihren Nachweisen archivieren und die an dieses Fenster gebundene Helper-Zuordnung lösen. Vorbedingungen sind der geschlossene zentrale Scope, eine leere aktive Auftragsliste und die geprüfte Geräte-/Releasebindung. Serverseitige Ergebnisse bleiben erhalten. - -Der dedizierte Produktgateway liefert Jobs ausschließlich in Antworten auf HTTPS-Anfragen des Geräts. Der damalige Windows-GNU-Entwicklungsrelease trägt sein tatsächliches Buildziel `x86_64-pc-windows-gnu` und einen eigenen Signaturschlüssel. Der Windows-MSVC-Kanal ist separat adressiert. - -Für die mitgelieferte PowerShell-Vorlage „Windows-Updates installieren“ darf der feste Plan ein längeres Ausführungsfenster bis 3600 Sekunden auswählen. Es gilt nur für die geprüften Originalbytes und die ausgewählte Bibliotheksrevision. Server- und Gerätescope müssen das längere Fenster ausdrücklich erlauben, und der Agent muss es unterstützen. Der engste der gesetzten Grenzwerte gilt. Das Ergebnis meldet den von Windows festgestellten Neustartbedarf. Ein Neustart ist ein eigener Wartungsauftrag. - -### 0.4 Aktuelles Lieferziel für Server und Geräte (Version 1.33) - -Der Auftrag vom 17. November setzt für die nächste Lieferung folgende Prioritäten. Diese Fassung hat für ihren Umfang Vorrang vor den älteren Phasenplänen und dem manuellen Updatevertrag aus 1.21. [Stand, Reihenfolge und Abnahme](docs/mvp-completion-plan.md) - -1. Ein Server stellt WebUI und MCP bereit. Windows- und Linux-Clients melden auch bei leerer Warteschlange ausgehend Heartbeats und Inventar. Die Clients fragen nach Arbeit und senden Annahme, Status und Ergebnis über denselben logischen Gerätekanal zurück. Das Produktprofil nutzt den vorhandenen HTTPS-Poll. Ein Auftrag darf ausschließlich als Antwort auf eine Clientanfrage zugestellt werden. Der bestehende timergetriebene WSS-Angebotspfad gehört zur bisherigen Betriebsart. Für bestehende Geräte den Wechsel erhaltend vornehmen. -2. Der Server verwaltet benannte, versionierte Shell- und PowerShell-Skripte pro Mandant. Die WebUI und MCP verwenden dieselben Vorlagen und Planungsregeln. Eine Bibliotheksrevision kann zahlreichen Aufträgen zugrunde liegen. Jeder Wartungsauftrag bindet Ziel, Skriptrevision und genaue Bytes vor der WebUI-Genehmigung. „Windows-Updates installieren“ ist ein PowerShell-Skript mit ausgewiesenen Rechten, Ergebnissen und Neustartbedarf. -3. Für Linux und Windows bietet der Server stets den aktuellen **vollständigen veröffentlichten** Agent-Release für Plattform und Architektur an. Der Client prüft beim Start und regelmäßig die Version. Eine neuere passende signierte Version aktiviert er selbstständig, auch wenn kein Auftrag vorliegt. Der veröffentlichende Berechtigte legt die unveränderliche Version und ihre Artefakte fest. **Das Veröffentlichen autorisiert die automatische Aktualisierung der vorgesehenen Agentkomponenten ohne eigenen Job oder WebUI-Klick je Gerät.** Wiederverwendbar sind Releaseprüfung, Versionsuntergrenze, Gerätebindung, lokale Übergabe, Healthbeleg und begrenzter Fehlerrückweg. Den Zugriff auf Releaseartefakte für diesen Ablauf eigenständig autorisieren. Skripte, OS-Updates und Reboots gehören zur genehmigten Jobstrecke. Bereits ausgestellte manuelle Updatepläne behalten ihre ursprüngliche Bindung. -4. Für jede Plattform gibt es ein dauerhaft per verifiziertem HTTPS abrufbares Installationsskript. Ein berechtigter Installationsaufruf mit mandantengebundenem Einmalnachweis richtet Agent und Updater ein. Der neue Client erzeugt seinen Geräteschlüssel lokal und meldet sich selbst an. Der anfängliche Bezug von Installer, Vertrauensmaterial und signiertem Startrelease muss schon vor Ausstellung des Gerätezertifikats funktionieren. Öffentliche Skripte und URLs enthalten keine wiederverwendbaren Zugangsdaten. -5. Entwicklung verwendet wiederholbare Zielbuilds und darf vorhandene Dateien per geprüftem SSH direkt bereitstellen. Der Entwicklungsrechner betreibt keinen RMM-Dienst. Ein Entwicklungsdeploy und ein automatischer Versionswechsel besitzen getrennte Nachweise. Für den aktuellen Auftrag zählen die plattformspezifischen Nutzerabläufe und ihre nötigen Voraussetzungen. Alte Einzelreparaturen, zusätzliche Provider und spätere Integrationen ergeben keine Reihenfolge für diese Lieferung. - -Diese Festlegungen beschreiben den Sollzustand. Alle übrigen Wartungsjobs benötigen weiterhin den unveränderlichen Antrag und die interaktive Freigabe. Für Prüfungen im dev/test-Profil gilt die in 0.1 dokumentierte sichtbare Simulation. - -**Userentscheidung Version 1.26, Windows-MVP vollständig fortsetzen.** -Der Betreiber beauftragt nach dem ersten festen PowerShell-Test ausdrücklich -auch die verbleibenden Windows-MVP-Arbeiten, möglichst parallel. Die -Loopback-/SSH-Verwaltung ohne OIDC-Anbieter gilt weiterhin. Der sichtbar -simulierte dev/test-WebUI-Prüfer darf nach 0.1 auch die weiteren festen -Abnahmepläne bedienen; ein echter externer Identitätsanbieter wird dadurch -nicht nachträglich zur MVP-Voraussetzung. - -Die zusätzliche, dauerhaft gespeicherte Beschränkung auf den bereits -abgeschlossenen einzelnen Echoauftrag wird nicht durch Dateilöschung, einen -Konfigurationsschalter oder eine Migration automatisch aufgehoben. Ein eigener -interaktiver administrativer WebUI-Abschluss darf ausschließlich nach Prüfung -des exakten früheren Scopes, seiner signierten Quittung, des einmaligen -Originalverbrauchs und des erfolgreichen Ergebnisses diese Zusatzbeschränkung -historienerhaltend beenden. Ursprüngliche Quittungen, Journale, Signaturen, -Geräteidentität, Verbräuche und Ergebnisse bleiben erhalten; der Abschluss wird -zusätzlich unveränderlich protokolliert. Er genehmigt keine Aufträge und -erzeugt keine Bereitschaft. Beide Dienstrollen benötigen anschließend den -regulären unabhängigen Zeit-/SignedSync-Abgleich. Jeder weitere Auftrag hat -seinen eigenen festen Antrag und tatsächlichen WebUI-Genehmigungsschritt. - -Allgemeine LocalService-Skripte und getrennt erlaubte SYSTEM-Vollwartung, -Dienst-/MSI-Aktionen, Zertifikatslebenszyklus und der bereits vorgezogene -signierte Agentupdater bleiben eigenständig tatsächlich abzunehmen. Quellen, -Crossbuilds oder OS-Portbibliotheken sind keine vollständige native Abnahme. -Diese Fortsetzung erteilt keine implizite Freigabe unangekündigter destruktiver -Tests oder Betriebssystemupdates. Aktueller Nachweisstand: -`docs/windows-mvp-completion.md`. - -**Historische Userentscheidung Version 1.25, durch Version 1.35 in Kapitel 0.6 ersetzt.** -Der Betreiber verwendet aktuell keinen OIDC-Anbieter. Für den MVP werden -WebUI und MCP ausschließlich auf Server-Loopback angeboten und über den -SSH-Tunnel bedient. Der vorhandene gekennzeichnete Entwicklungslogin und -die browsergesteuerte Testgenehmigung reichen für die Entwicklungsabnahme. -Der Betreiber beauftragt ausdrücklich den tatsächlichen PowerShell-Test -und dessen simulierte Genehmigung in der WebUI durch die KI. Ein -OIDC-Anbieter ist hierfür keine MVP-Voraussetzung. Öffentliche Agenten- -TLS-/mTLS-Endpunkte bleiben für die ausgehenden Clientverbindungen erforderlich. -Die Testfreigabe ist als Simulation zu auditieren. Die erforderlichen -Job-, Signatur-, Journal-, Zeit- und Startprüfungen bleiben bestehen. - -**Userentscheidung Version 1.29, genau der fehlgeschlagene SYSTEM-Testfall221.** -Der Betreiber hat den konkreten Vorschlag -`docs/windows-system-script-nonstart-221-proposal.md` am16.November ausdrücklich -freigegeben und ausschließlich dessen Abschluss und anschließende neue -SYSTEM-PowerShell-Abnahme beauftragt. Die frühere205-Ausnahme wird dadurch -nicht allgemein erweitert. - -Geltungsbereich: Job `94047873-5088-433b-bc1b-490d3eafe0da`, Versuch -`f071e6d6-8635-42f7-92fa-533c681edd8b`, Originalgrant -`97e705b8-fb2b-4158-84d9-d90595d1ce6e`, Verbindung221 und ursprünglicher Boot -`a9ad0895-5a96-8f2c-8fb6-cfdc2d5225ea`. Die beiden ursprünglichen -Unknown-Outcomes `1f284b66578d61c4364cc0060a67ce9b467e1d661ed8885804391b51a6f18b1a`, -Starts, Requests, Signaturen, Intent, Identität und historischen Kontrollantworten -bleiben unverändert erhalten. Ein zusätzlich gespeicherter, unabhängig geprüfter -Nichtstartabschluss darf nur diesen nachweislich vor Skriptdatei/CreateProcess -liegenden Sharingfehler als fehlgeschlagenen Nichtstart ausweisen, niemals Erfolg. -Die tatsächliche Win32-Probe, der exakte damalige Quell-/Imagebezug und der seit -vor dem Originalversuch bestehende gebundene Helperprozess mit dauerhaftem -Writerhandle sind Teil der Beweiskette. Unvollständige oder widersprüchliche -Zeugen verweigern den Abschluss. - -Ein eigener administrativer Beleg bindet die vollständigen Originale und den -Kontrollspalt zwischen Agententscheidung0442c732…/Checkpoint10784 und -Helperentscheidung193b951b…/Agentcheckpoint10783/Helpercheckpoint413. Er benötigt -vor Anwendung die tatsächliche sichtbar simulierte WebUI-Bestätigung nach0.1, -eigene Signatur und unveränderlichen Audit. Er erzeugt keine Jobs, Startgrants, -Bereitschaft oder alte Startrechte. Keine alte Lease wird wiederbelebt und keine -historische Uhr als aktuell an eine Applyfunktion übergeben. Der abgeleitete -Nichtstart und seine Herkunft bleiben von den originalen Unknown-Belegen getrennt. -Erst nach historienerhaltender Anwendung, Installation des engen Sharingfixes -und regulärem frischem unabhängigem Zeit-/SignedSync beider Rollen darf ein -neuer fester MCP-Antrag mit eigenem Versuch und eigener tatsächlicher -WebUI-Genehmigung folgen. Kein alter Grant wird erneut verwendet. Keine weiteren -MVP-Arbeiten oder Neustarts sind Bestandteil dieses aktuellen Schritts. - -**Userentscheidung Version 1.28, enger Windows-Abgleichfall 205.** -Der Betreiber hat am 16. November den konkreten Vorschlag -`docs/windows-sync-alignment-205-proposal.md` ausdrücklich mit -„Ja, historienerhaltend wiederherstellen“ freigegeben. Zulässig ist ausschließlich -die dort beschriebene Lücke zwischen Agententscheidung -`2af359c5-5b5c-4992-b445-1c00e271a288` (Checkpoint10137, Helper135) und -Helperentscheidung `1a4758ad-0b39-449e-8551-16846851b09a` -(Agentcheckpoint10135, ursprünglicher Applycheckpoint134), Verbindung205, -Boot `a9ad0895-5a96-8f2c-8fb6-cfdc2d5225ea`. Der aktuelle höhere reine -Helpercapturecheckpoint wird nicht zurückgesetzt. -Vor Eingriff sind beide kanonischen Originalrequests und Signaturen, -Geräte-/Journal-/Lockidentitäten sowie genau die unveränderte erfolgreiche -Echohistorie und der abgelaufene allgemeine Auftrag ohne Grant unabhängig -zu prüfen. Kein weiterer Verbrauch, SYSTEM-Intent, offener oder unbekannter -Effekt darf vorliegen. Die vorherige Freigabe für Verbindung150 wird nicht -verallgemeinert. -Ein frischer administrativer WebUI-Beleg bindet den ganzen Zeugen, wird mit -tatsächlichen gekennzeichneten Test-UI-Interaktionen bestätigt und dauerhaft -auditiert. Er bleibt `ready=false`, `helper_ready=false`, `unlock=false`. -Bei gestoppten Diensten und gehaltenen Originalguards darf allein der belegte -wirkungslose Kontrollspalt geschlossen werden, mit zusätzlichem unveränderlichem -administrativem Herkunfts-/Anwendungsbeleg. Keine normale alte Lease wird als -aktuell wiederbelebt, keine künstliche historische Uhr an `HelperSync.apply` -übergeben. Alle Originale, Signaturen, PKI, Identität, abgeschlossenen Jobs und -bestehenden Zeilen bleiben erhalten. Anschließend sind ein regulärer neuer -signierter Abgleich beider Rollen und für jeden neuen Job dessen eigene -WebUI-Genehmigung erforderlich. Abweichende Originale oder Wirkung verweigern. - -**Userentscheidung Version 1.24, historienerhaltende Windows-Recovery.** -Der Betreiber hat die Wiederherstellung der bestehenden Windows-Testinstallation -für den dokumentierten Fehler `HELPER_CHECKPOINT_REQUIRED` ausdrücklich -beauftragt. Der neue Wiederherstellungsvertrag bindet die zwei bereits -persistierten und unabhängig verifizierten Originalentscheidungen der -Verbindung 150, den weiterhin akzeptierten Servercheckpoint 6755 und den -lokal gespeicherten ablehnenden Checkpoint 6756. Identität, Originalrequests, -Signaturen, Journale und bisherige Verbräuche bleiben erhalten. -Ein neuer administrativer Wiederherstellungsweg muss diese Unterschiede -explizit prüfen und den Eingriff dauerhaft auditieren. Eine historische -Signaturprüfung allein stellt keine aktuelle Bereitschaft her. -Erst ein anschließender regulärer signierter Abgleich beider Rollen darf -Bereitschaft herstellen. Jeder Ausführungsjob braucht weiterhin seinen -festen Antrag und seine eigene WebUI-Genehmigung. -Die in Version 1.10 beschriebene Reparatur eines ungesendeten Requests -bleibt ein eigener Fall. - -**Userentscheidung Version1.23, begrenztes aktives Windows-KVM-Zeitprofil:** -Am2026-11-15 hat der User den konkreten Vorschlag mit „Ja, dieses begrenzte -Zeitprofil umsetzen“ angenommen. Ausschließlich für die identifizierte aktive -Windows-KVM-Testumgebung ist ein gesondert versionierter, geschützt und -ausdrücklich aktivierter Modus `trusted_os_active_guest` zulässig. Er vertraut -den dokumentierten Windows-Zeit-APIs und einer korrekt laufenden Hardware-/ -KVM-/QEMU-Zeitbasis als nomineller Intervalluhr. Die zusätzliche unabhängige -physikalische Timerkalibrierung aus1.22 ist in diesem Profil keine Voraussetzung. -Ein gemessener maximaler Bracket oder100ns-Darstellung darf weiterhin nicht als -physikalische Genauigkeitsgarantie ausgegeben werden. Kein geratener positiver -`Calibration.base_error_ns` als Ersatz für das ausdrückliche Profil. - -Der neue geschützte Loadervertrag muss Profilversion, tatsächliche Rollen-/ -Imagebindung, Plattform-/Qualifikationsreferenz und Betriebsannahmen explizit -binden. Fehlende/unbekannte/alte Konfiguration darf den Modus nicht automatisch -aktivieren. Eigene vollständige Capturebrackets und notwendige ganzzahlige -Darstellungs-/Umrechnungsreste werden konservativ im angenommenen OS-Zählerraum -gerechnet; nicht belegte physikalische Restfehler werden nicht erfunden. -Die1s-/100ms-Frischegrenzen und höchstens50ms-Softwarecapturebudget bleiben -erhalten. Ihre physikalische Konservativität ist ausdrücklich durch die -angenommene korrekte OS-/Hypervisorzeitskala bedingt, keine unabhängige SI-Garantie. - -Das Profil gilt nur im aktiven Betrieb. Vor VM-Pause, Save/Restore, Snapshot- -Rückkehr, Migration oder Notebook-/Host-Suspend müssen beide Agent-/Helperprozesse -beendet werden; danach sind frische Prozesse, eigene neue Challenges und -normaler unabhängiger Sync erforderlich. Solche Betriebsereignisse mit -laufenden Prozessen sind nicht unterstützt. Ohne VMGenID wird keine lückenlose -automatische Erkennung behauptet. Beobachtete Rückwärts-/Schlaf-/Wallstep- -Diskontinuitäten sperren weiterhin. Keine VM- oder Hosteinstellung wird durch -diese Entscheidung automatisch geändert. - -Unverändert bleiben tatsächliche Serverquellqualität, separater Zeitkey, mTLS-/ -Tenant-/Geräte-/Verbindungsbindung, getrennte Agent-/SYSTEM-Verifikation, volle -Intervalle und unveränderte Grantfristen, Verbrauchs-/Ledger-/Helpergrenzen sowie -jede interaktive WebUI-Genehmigung. Kein NTP-Sync wird erfunden und kein -Clocksetter oder manueller Resync genehmigt. Der strengere bisherige numerische -Kalibrierungsvertrag bleibt für nicht ausdrücklich profilierte Konfigurationen -erhalten. Quelle allein aktiviert keine Wirkung: neue Linux-first-/Windows- -Nachweise bleiben erforderlich. Entscheidungsdetails und vorheriger Befund: -`docs/windows-kvm-clock-contract-proposal.md`. - -**Userentscheidung Version1.22, signierter Windows-Zeitvergleich:** Auf die -konkrete Frage nach der Alternative zur nicht qualifizierbaren W32Time- -Dienstidentitätsbindung hat der User ausdrücklich „Ja, signierten Zeitvergleich -umsetzen“ geantwortet. Ein unabhängiger signierter Onlinevergleich mit -`discovery.ease-technologies.de` darf daher die aktuelle Windows-Wallclock -qualifizieren. Der frühere Ausschluss eines Serverzeitankers im lokalen -Windows-Clockvertrag wird ausschließlich für diesen gebundenen Vergleich ersetzt. -W32Time-Rohstatus bleibt unverfälscht separat; daraus wird kein lokaler NTP-Sync -erfunden. Keine OS-Zeitstellung oder implizite Resyncfreigabe. - -Ein gesondert geschützter Ed25519-Zeitschlüssel, exakte versionierte Codecbytes -und provisionierte Pins müssen unabhängig von TLS-/Job-/Updateschlüsseln sein. -Agent und SYSTEM-Helper erzeugen und prüfen jeweils eigene Nonce, Inkarnation, -Boot-/Verbindungs-/Gerätebindung und lokale monotone/Wallclockbeobachtung; der -Agent ist beim Helper ausschließlich Transport. Serverseitige Gerätezuordnung -kommt aus gültigem mTLS und tatsächlichem Verbindungskontext, nicht aus -ungeprüften Requestfeldern. TLS/SAN/SNI wird auch bei falscher OS-Zeit nicht -umgangen. Jede fehlende Bindung oder Qualität bedeutet CLOCK_UNTRUSTED. - -Der Server muss vor jeder Signatur tatsächlichen synchronisierten Kernelstatus, -höchstens1h altes gutes Quellensync und konservativ höchstens500ms Gesamtfehler -nachweisen. Fehlende Providerbelege sperren; Pollzeit ersetzt kein Syncalter. -Je verifiergehaltener Challenge gelten höchstens1s bis Prüfung und höchstens100ms -seit Empfang; das zusätzliche Capture-/Timerbudget von höchstens50ms benötigt -reale Plattformqualifikation; die ausdrückliche aktive Windows-KVM-Ausnahme -aus1.23 steht unmittelbar darüber. Für Capture T, Serverfehler epsilon, vollen selbst -gemessenen RTT R und qualifiziertes Budget delta gilt die konservative Spanne -[T-epsilon,T+epsilon+R+delta]. Lokale Wallclock muss zur gesamten Spanne -höchstens2s abweichen. Startfristen müssen die gesamte Spanne erfüllen: -Untergrenze >= not_before, Obergrenze < start_before. Alte Grantbytes und -60s-Startfenster bleiben unverändert; kein Refresh verlängert einen Grant. - -Boot-/Prozess-/Verbindungswechsel, Replay, Rückwärtszähler, Wallstep oder -Sleepdiskontinuität verwerfen Bereitschaft und offene Challenges. Nach einer -Diskontinuität braucht es eine danach erzeugte Challenge; kein Konstruktorreset -oder gespeicherter Beleg darf den Fence umgehen. Kein längerer Holdover. -Ein Zeitbeleg ist weder SignedSync noch Startgrant oder Jobgenehmigung; -WebUI-, Verbrauchs-, Ledger- und Helpergrenzen bleiben zusätzlich erforderlich. -Der konkrete Entwurf und die offenen tatsächlichen Qualifikationsschritte stehen -in docs/windows-clock-attestation-proposal.md. Dies genehmigt Implementierung, -keinen Clockgatewechsel ohne Linux-first-/Windows-Nachweise. - - -**Präzisierung Version1.14, zeitgebundener Rebootnachweis:** Die ursprüngliche -Wiederverbindungsfrist ab serverseitiger Startreservierung bleibt unverändert. -Ein tatsächlich vor Fristende unabhängig empfangener neuer Boot-Inventarbeleg -bleibt als unveränderlicher rechtzeitiger Nachweis verwendbar. Erfolgt seine -Erstverifikation später als fünf Minuten nach Empfang, braucht sie zusätzlich -einen unabhängig empfangenen, höchstens fünf Minuten alten Inventarbeleg -derselben aktuellen Boot-ID sowie den aktuell authentisierten, nicht -widerrufenen Geräte-/Mandanten-/Generationskontext. Beide konkreten Beleg-IDs -und Serverempfangszeiten sind im signierten Ergebnis und Audit zu binden. -Fehlender ursprünglicher Fristbeleg bleibt unknown; ein erst nach Fristende -empfangener Beleg wird durch spätere Aktualität niemals rechtzeitig. Keine -Verlängerung, Umdatierung, neue Wirkung oder Wiederholungserlaubnis. - -**Präzisierung Version1.13, begrenzte MVP-Nachbedingungen:** Ein bereits vor -einer Paketwirkung vorhandener Host-Neustartbedarf verhindert deren Erfolg -nicht, wenn sämtliche Paketnachbedingungen unabhängig vollständig nachgewiesen -sind. `no_reboot=true` verbietet den eigenmächtigen Neustart; das tatsächliche -Hostflag wird unverfälscht als `reboot_required` berichtet. Für die harmlosen -APT-Fixturerezepte muss derselbe gebundene Hostflagwert vor/nach der Wirkung -nachgewiesen sein; der private Sandboxwert ersetzt diese Hostbeobachtung nicht. -Fehlende historische Vorhermessungen werden nicht rückwirkend erfunden. - -Beim festen Rebootjob beginnt die zentrale `reconnect_timeout_seconds`-Frist -konservativ an der dauerhaft gespeicherten serverseitigen Startreservierung -des gleichen Jobs/Versuchs/Grants. Ein späterer lokaler Start verlängert sie -nicht. Erstmaliger Erfolg braucht authentisierten Wiederkontakt mit neuer -Boot-ID sowie unabhängig gespeichertes Inventar, dessen Serverempfang nach -Reservierung und spätestens zur Frist liegt. Fehlender/verspäteter Nachweis -bleibt `unknown`. Späterer signierter Abgleich darf den ursprünglichen -rechtzeitigen Inventarbeleg erneut prüfen, aber keinen anderen verspäteten -Beleg unterschieben. Dies begrenzt die vorhandene Rebootabnahme und erlaubt -keinen zusätzlichen Reboot oder automatischen Wiederholungsversuch. - -**Topologieoverride des Users vom 2026-11-13 (Version 1.6):** Der Entwickler-PC -wird nicht mehr als RMM-Server genutzt. Der dedizierte Internetserver übernimmt -Backend, Datenbank und TLS-Endpunkt; Agenten verbinden sich direkt ausgehend -mit diesem Server. **Präzisierung Version 1.7, ausdrückliche Userkorrektur vom -2026-11-13:** Dieses Notebook dient ausschließlich der Entwicklung und darf -nicht als RMM-Client installiert, enrolled oder betrieben werden. Der aktuelle -Testaufbau besteht aus der Cloud-Test-VM als Client und dem bereits endgültig -festgelegten Cloudserver `discovery.ease-technologies.de` als Server. Der kurzzeitig -installierte Notebook-Client wurde gestoppt/deinstalliert und seine Identität -über die WebUI widerrufen. Frühere Aussagen zum lokalen Notebook-Client sind -damit überstimmt. Frühere Vorgaben -„Server lokal in Docker auf dem PC“, PC→VM-Reversetunnel und VM-Loopback als -Serverziel sind hiermit historisch und überstimmt. Docker-Veröffentlichungen -bleiben Loopback, PostgreSQL bleibt intern; öffentlicher TLS-Ingress wird separat -abgesichert. Keine öffentliche Dev-Anmeldung. Bis zu einer eingerichteten sicheren -öffentlichen Anmeldung bleibt die WebUI nur über SSH-Tunnel erreichbar. -Root-SSH ist Bootstraptransport, der RMM-Dienst läuft unprivilegiert. TLS/mTLS, -Mandantentrennung und WebUI-Plangenehmigung bleiben verbindlich. -Deploymentdaten, offene Konfiguration und reale Nachweise: -`docs/server-deployment.md`. Diese Entscheidung ist kein Deploymentnachweis. - -### 0.3 Gelockertes Zeitfenster für signierte Zeitbelege (Version 1.32) - -Userentscheidung 2026-11-17. Die bisherige Gültigkeit eines empfangenen -signierten Zeitbelegs von 100 ms machte SYSTEM-Aufträge praktisch unmöglich: -Der Helper kann während einer Ausführung nicht auffrischen, und jeder kurz -veraltete Beleg beendete Sitzungen oder machte Versuche zu `unknown`. - -- Ein Beleg bleibt bis zu **fünf Minuten** nach Empfang nutzbar - (`MAX_RECEIVED_AGE_NS`). Die Grenze von einer Sekunde gilt weiterhin für den - signierten Umlauf selbst (Anfrage bis Antwort). -- Die untere Intervallgrenze läuft mit der seit Empfang am monotonen - Interrupt-Zähler gemessenen Zeit mit. Beide Grenzen enthalten alle - Erfassungsbudgets und einen Driftzuschlag von 0,1 %. Das Intervall bleibt - dadurch eng, die 2-Sekunden-Prüfung gegen die lokale Uhr bleibt wirksam. -- Ein fehlgeschlagener Auffrischversuch verwirft den gültigen Beleg nicht - mehr. Eine neue Anfrage ersetzt eine unbeantwortete; deren Nonce kann nie - nachträglich vervollständigt werden. -- Unverändert bleiben: Start- und Ablauffenster der Aufträge, maximale - Laufzeit, Signatur-, Bindungs- und Pinprüfungen, Abbruch bei - Generationswechsel, Diskontinuität oder Widerruf. - -### 0.2 Menschlicher Abschluss unbekannter Wirkung (Version 1.31) - -Userentscheidung 2026-11-17. Ein Job im Zustand `unknown` darf ausschließlich -durch einen berechtigten Menschen in der interaktiven WebUI (Recht -`plans:approve`, interaktive Sitzung, CSRF/Origin; im dev/test-Profil sichtbar -simuliert mit `approval_origin`/`testsimulation`) mit Begründung abgeschlossen -werden. MCP, KI, Automatik, API-Token und direkte DB-Aufrufe können das nicht. - -- Der Job erhält den Endzustand `closed_unknown`. Die Wirkung bleibt unbekannt. - Es wird weder Erfolg noch Fehlschlag noch Nichtstart behauptet. -- Originalzustand, Revision und Ergebnis bleiben unveränderlich in - `job_unknown_closures` erhalten; auf den Geräten wird das ursprüngliche - Ergebnis vor dem Ersetzen in `unknown_closure_originals` aufbewahrt. -- Der Versuch wird nie wiederholt; der alte Grant bleibt verbraucht. Ein - abgeschlossener Job ist in der Datenbank gegen jede weitere Zustands-, - Revisions- oder Ergebnisänderung gesperrt. -- Der Server liefert den Abschluss im signierten Abgleich als endgültiges - Ergebnis (`OPERATOR_CLOSED_UNKNOWN`) aus. Agent und Helper akzeptieren genau - diese Form für einen lokal unbekannten Versuch und geben damit nur die - Gerätesperre frei. Neue Aufträge brauchen weiterhin einen eigenen Plan und - eine eigene WebUI-Genehmigung. -- Ein Abschluss ist eine Risikoentscheidung des Menschen und wird mit Person, - Sitzung, Herkunft und Begründung auditiert. - -### 0.1 Auftrag an die implementierende KI - -**Bisheriger manueller Vertrag (Version 1.21).** Der folgende Abschnitt beschreibt die jobgebundene Aktivierung. Für den zusätzlich geforderten automatischen Betrieb gelten Kapitel 0.4 und dessen eigene Abruf- und Aktivierungsregeln. - -APT-/MSI-Paketfixtures sind kein Agent-Autoupdater. Der User zieht diesen engen -Teil ausM7 parallel vor; Restore, HA, Relay und weitere Betriebsreife werden -hierdurch nicht zusätzlich beauftragt. Im manuellen Pfad erfolgt die Aktivierung als -typisierte Aktion `update_agent` mit `fixed_code_pair_v1`, persistentem -`pending_approval` und tatsächlicher WebUI-Genehmigung gemäß0.1. Ersteller und -Freigeber brauchen aktuell `updates:apply` sowie getrennt `root:execute` oder -`system:execute`. Eine manuelle Jobgenehmigung bindet ausschließlich die konkrete Version. Der Plan bindet exakten -release-signierten Manifestenvelope, Plattform, Vorgängerrecord/Codepaar, -Updater-/Policy-/Keyringhashes und Generation, getrennten Healthpublickey samt -Originalhash seines geschützten lokalen öffentlichen Pins, beide Artefakte, Pintransition, -festen Versuch, Fristen und einmalige erlaubte Vorgängercode-Rückkehr. - -Erstes Format: genau zwei Rohbinaries Agent und gemeinsamer Helper, getrennte -Update-/Job-/TLS-Schlüssel, kanonische domänengetrennte Ed25519-Releases. -Der stabile separat provisionierte Updater ist nicht selbst Updateartefakt. -Kein Archiv, Postinstall-Skript, freier Ziel-/Downloadpfad oder Hostreboot. -Bestehender256KiB-Paketartefaktstore bleibt unverändert; nur eigener -Updatekatalog/-stream erlaubt bis256MiB je gebundener Datei und512KiB je Chunk. -Geräte-mTLS, Tenant, genau genehmigter Job/Versuch, beide Manifestreferenzen und -aktuelle begrenzende Admission gelten auch beim Download. Beide Dateien müssen -vollständig gestreamt, auf exaktes EOF/Länge/Hash geprüft und geschützt gestaged -sein **vor** Aktivierungsverbrauch/Handoff; danach ist der Admissiondownload -kein Resume-, Health- oder neuer Startpfad. - -Reiner Metadatencheck beim Start und täglich ist passiv. Ein eigener -`InventorySnapshot`-Scope `agent.update`/Capability `agent.update/1` meldet -höchstens alle60s tatsächlichen Updatezustand; er stempelt kein Baseinventar -frisch und löst keinen CIM-/Vollinventarzwang aus. Qualifizierte -`agent.update.check/1` und `agent.update.apply/1` sind zusätzliche tatsächliche -Fähigkeiten, keine Folge des Schemas oder eines Builds. Fehlende Provisionierung -meldet `not_configured`, ohne scheinbaren Vorgänger/Preview. Planung benutzt -nur frische gespeicherte typisierte, Boot-/Generations-/SignedSync-gebundene -Beobachtung und genau eine lokal unabhängig gerenderte Kandidatenpreview. -Kein vom Modell gelieferter Vorgänger oder Pin. Zentrale/lokale Updatepolicy -bleiben getrennt und standardmäßig deny; Full-/SCM-/APT-Rechte werden nicht -übertragen. Linux berücksichtigt General, Full und Agent; vorhandener APT- -Reader gehört ins geschlossene Stopset und bleibt inaktiv/unqualifiziert. -Der Fullrenderer ändert ausschließlich benannte Helperhash-Wertspans und den -abgeleiteten Policyhash; alle übrigen rohen Config-/Pinbytes bleiben erhalten. -Bei filebasiertem Signierkey wird der bereits provisionierte öffentliche Key -extern authentisiert übergeben, ohne den leeren Raw-Inlinekey zu ersetzen. - -Vor dem ersten Apply ist ein gesonderter erhaltender Bootstrap auf ein bereits -Update-/Handoff-/Inflight-decoderkompatibles Agent-/General-/Fullpaar samt -stabilem Updater und qualifizierter Provisionierung erforderlich. **Das alte -1.20-Paar ist nach neuen Updatezeilen kein zulässiges Rollbackziel.** Erst die -kompatible tatsächlich qualifizierte Baseline erhält einen separat -release-signierten InstalledRecord/Floor. Manifest-/Protokoll-/Zustandsvertrag -und historische Journaldecoder müssen erhalten bleiben; keine Rückkehr zu -alten Decoderbytes durch einen Daten-/Ledger-/Generationreset. Aktive Version, -bestätigter Antirollbackfloor und angebotener Kandidat bleiben getrennt. -Ein zulässiger Code-Rollback verändert weder Datenzustand noch Floor; widerrufene -oder verbotene Vorgänger werden auch hierfür verweigert. - -Auf Linux ist ausschließlich der ausdrücklich provisionierte Fullhelper der -ursprüngliche Updateautorizer sowie Owner-/Healthguard. Der Generalhelper bleibt -während dieses Inflightfalls geschlossen; fehlende eigene Zuständigkeit darf den -Originalversuch nicht zu Unknown herabstufen. Gegenseitige Imageprüfung muss unter -den tatsächlichen Dienst-Capabilities funktionieren. Kein CAP_SYS_PTRACE-Zusatz -oder aufgeweichter Generaldienst als Umgehung einer nicht erlaubten /proc-Prüfung. - -Der alte unabhängig prüfende Helper schreibt Verbrauch, exakten bestehenden -Startzeugen, immutable Handoff, konkreten Delegationszeugen (stabiler -Updaterdienst/PID/Prozessgeburt/Image und ursprünglicher Helper) sowie Stopintent -in **einer Transaktion desselben erhaltenen Helperledgers**. Vorher kein Stop -oder Austausch. `ExecutionPermitPayload.agent_update_plan_id` wird ausschließlich -für diese Aktion zusätzlich signiert; bei allen anderen Aktionen fehlt das -Feld vollständig und erhält alte Grantbytes. Plan-ID/Hash, Job/Versuch/Grant, -Ownernonce, Boot, vorhandene Journal-/Kontrollketten und Dateiidentitäten bleiben -fest gebunden. Jeder andere offene/Unknown-Versuch verweigert Admission. - -Der Updater übernimmt den echten bestehenden Executorlock und denselben Ledger -nur während alle installierten Reader bestätigt gestoppt sind. Austausch ist -kein atomarer Bundleswap: jeder Code-/Pin-Schritt bekommt dauerhaften Intent und -belegte Nachlese. Vor neuem Helperstart wird der dauerhafte Rückgabeintent -committet und der Guard tatsächlich abgegeben. Danach schreibt der neue Helper -unter seinem Guard. Geschlossene native Unterintents und Nachbeobachtungen -liegen append-only mit FK am selben Originalhandoff, nicht in einem neuen -Verbrauchs-/Serverjournal. Rückgabeintent und genau einmal reservierte Startfolge -General→Full→Agent committen gemeinsam vor Lockabgabe; diese Zeilen erlauben -keinen späteren Dispatch oder Resume durch einen neu gestarteten Worker. -Bis `ServicesStarted` bleibt der konkrete lebende stabile -Updater logischer Owner, auch im Rückgabe-/Startupgap; danach sind die neuen -konkreten Helperprozesse nachzuweisen. Fehlende/lost Owner-, Boot-, Zeit- oder -Effektzeugen bleiben `unknown`. Read-only-Reconciliation ist weder Execute- -Resume noch allgemeines Unknown-Healing; ursprüngliche Signaturen, Zeilen, -Outcomes, PKI und DB-/Lock-Dateiidentitäten werden nicht ersetzt. - -Ein ausschließlich an diesen Originalversuch gebundener Inflightbeleg wird -additiv in `SyncAttempt.update_handoff_bytes` (Tag14) übertragen. Ein optionaler -signierter `AttemptDecision.update_inflight` bestätigt nur den exakten erhaltenen -Präfix bei `ready=false`, `helper_ready=false`, `unlock=false` und ohne Outcome. -Fachlicher Jobzustand bleibt `running`; sämtliche neuen Starts bleiben gesperrt. -Die gezielte read-only Helperquittung darf keine Startlease eröffnen. Bereits -persistiertes Unknown, fehlende Originale oder zurückgesetzte Präfixe dürfen -hierdurch nicht nachträglich zu Inflight werden. Kein weiterer ungebundener -Server-Journalslot wird eingeführt. - -Health benötigt lokal belegtes vollständiges Code-/Pinpaar, erhaltene Zustände, -konkrete neue Serviceprozesse und neu authentisierten Agentkontakt samt frisch -serverseitig gespeichertem Inventar/ACK und tatsächlich angewandtem SignedSync. -Der gesonderte signierte `rmm.agent-update-health.v1`-Beleg verwendet einen -separat provisionierten Healthsignierschlüssel; Jobsigner-/TLS-/Releasekeys sind -kein Fallback. Der vor Genehmigung gebundene öffentliche Healthpin wird lokal -unabhängig authentisiert und im ursprünglichen Handoffkontext erhalten. Der -Beleg ist evidence-only, -bindet Originalhandoff/Owner/Boot/Codepaar/Prozesse/Kontroll- und Inventarzeugen -und bleibt Ready=false. Er verlängert weder180sHealth- noch600sGesamtfrist und -reaktiviert keine Genehmigung. Der tatsächlich inventarbestätigende originale -SignedSyncResponse wird als Inventar-ACK gehasht; eine gespeicherte nächste -SignedSyncRequest-Runde muss beide lokal angewandten Vorentscheidungen belegen. -Die bestätigende Serverzeit ist nur obere Applyzeitgrenze; der Helper gleicht -seine eigenen erhaltenen Rawbytes und Applyzeit unabhängig ab. Nach Health -werden InstalledRecord und Floor gemeinsam als ein neuer geschützter Record -mit erhaltenem Vorgänger und einmaligen nativen Intents publiziert. Erst danach -darf der neue Helper das noch fehlende -Originaloutcome create-once per bestehendem CAS speichern; vorhandenes Unknown -wird nicht überschrieben. Vorhandene Spiegelung und normaler signierter Sync -übernehmen exakt diese Bytes und lösen die gleiche ursprüngliche Sperre. - -Präzisierung des Windows-Ports in1.26: Die vorhandene geschützte -`time-attestation.json` bindet ebenfalls beide Codeimages. Ein neuer optionaler -streng typisierter Windows-Zeitprofilübergang bindet daher vor Genehmigung -exakte alte/neue Profilbyteshashes und zwei tatsächlich qualifizierte -Rollenbelege; fehlend bleibt er aus historischen Codecbytes ausgelassen. -Serverzeitschlüssel, Schlüsselgeneration, Geräte-/Plattform-/Betriebsannahmen -werden nicht verändert. Das zusätzliche feste fünfte Dateiziel erhält denselben -Intent-/Nachlesevertrag wie Code und Peerpins. Nur dieses neue Windows- -Handoffprofil darf bis18 Ereignisse haben; historische/Linuxprofile bleiben -bei ihrer bisherigen16-Ereignisgrenze. Ein Renderer oder OS-Port allein -qualifiziert weder eine Baseline noch Apply oder Rollback. - -Technische Präzisierung in1.27 innerhalb des beauftragten Selbstupdateumfangs: -Der stabile Windows-Updater besitzt eine eigene geschützte Zeitkonfiguration, -eigene Service-SID-/SCM-/Imagequalifikation, eigenen Prozess-/Noncekontext und -eigene signierte Serververgleiche. Er übernimmt niemals einen Helperzeitbeleg. -Die neue explizite Rolle `updater` verwendet Bindungsschema2 mit eigenem -Updaterimagefeld; alte Rollen lassen das neue Feld vollständig aus. Der -Serverbroker und alle tatsächlich beteiligten Decoder müssen dafür gemeinsam -qualifiziert ausgeliefert werden. Bei VM-Pause, Save/Restore, Snapshotrückkehr, -Migration oder Hostruhezustand gilt der abgestimmte Betriebsvertrag auch für -diesen dritten Prozess: vorher stoppen, danach mit neuem Prozess neu beginnen. - -Ein explizites Handoffschema2 bindet die einmalige Rückkehr bei unabhängig -belegtem Start-/Healthfehler an denselben ursprünglichen lebenden Updaterowner, -Boot, Versuch, Ledger, Dateisatz und ursprüngliche Fristen. Separate -SaveRejected-/Restoreintents und native Nachlesen erhalten beide Versionen; -keine unsichere Umbenennung wird als atomarer Tausch ausgegeben. Ausschließlich -dieses Schema darf für seinen längeren endlichen Rückweg bis40 Events enthalten. -Altes Schema1 erhält seine bisherigen Grenzen (16 beziehungsweise18 beim -Windows-Zeitprofil). Weder ein Ownerneustart noch Antwortverlust, unklare -Wirkung oder persistiertes Unknown eröffnen einen Rückweg. Vor dessen Abschluss -sind reale Vorgängerprozesse und ein frischer signierter Vorgänger-Healthbeleg -erforderlich; ursprüngliche 180-Sekunden-Health-/600-Sekunden-Gesamtgrenzen -werden nicht verlängert. Ein zurückgeführter Kandidatenauftrag endet `failed`, -kein neuer Versuch wird erzeugt. Private lokale Recordrechte bleiben erhalten; -der Agent erhält ausschließlich deren öffentlichen Metadatenteil über einen -authentisierten rein lesenden Fullbeleg mit vollständiger Historienprüfung. -Quellen, Vertragsprüfungen und tatsächliche native Ausführung bleiben getrennt. - -Dieser Abschnitt normiert den beauftragten engen Vertrag. Teilquellen/Units, -OS-Port, tatsächliche Kernel-/VMnachweise und noch fehlender ausgelieferter -Worker/Bootstrap/Apply sind getrennt in `docs/agent-updater-proposal.md`, -`docs/agent-updater-handoff.md` und `docs/agent-updater-linux-port.md` dokumentiert. -Keine Capability oder Native-/Produktionsfreigabe allein aus dieser Norm ableiten. - - -**Userentscheidung Version1.20 — vollständige genehmigte Skriptkonsole zuerst:** -Die KI darf über MCP gespeicherte Geräte-/Telemetriedaten im erlaubten Mandanten -lesen, vollständige Shell-/PowerShell-Skripte schreiben und feste Aufträge als -`pending_approval` beantragen. Ein berechtigter Mensch prüft und genehmigt in -der WebUI die gespeicherten exakten Skriptbytes, Interpreter, Argumente, Ziele, -Versuche, Identität und Grenzen. Erst dann darf der Agent ausführen. Der User -wählt zunächst die Batch-Skriptkonsole mit Zustandsverfolgung und abschließender -Ausgabe, ausdrücklich auch mit Root-/SYSTEM-Rechten zur vollständigen -Hostwartung. Diese Strecke hat Vorrang vor weiteren Paketfixture-Erweiterungen. -Die bisherige Einordnung interaktiver Terminals in M7 verschiebt diese -Batchkonsole nicht; PTY/ConPTY, neue Sitzungen und laufendes Outputstreaming -werden hierfür nicht eingeführt. Standardinventar/Heartbeats bleiben passiv; -angeforderte Live-Skripte bleiben Jobs, auch wenn sie nur Logs lesen. - -`run_script` erhält das additive optionale Stringfeld -`privileged_script_profile="full_maintenance_v1"`. Fehlend wird es vollständig -ausgelassen und erhält sämtliche alten Codec-/Hashbytes. Explizites `null`, -unbekannte Werte und ein Profil bei `agent_service` sind ungültig. Das Profil -gehört vor Genehmigung in die exakten Aktions-, Job- und Planbytes und wird von -Signatur/Grant, zentraler Policy und lokaler Helperprüfung gebunden. Keine -nachträgliche Hülle, implizite Profilauswahl oder Erweiterung alter Pläne. -Windows-SYSTEM-Skripte benötigen dieses Profil; alte SYSTEM-SCM-/MSI-Policies -erlauben sie weiterhin nicht. Historische Linux-Root-Skripte ohne Profil behalten -ihren bisherigen begrenzten Ausführungsvertrag und werden nicht Vollwartung. - -Planersteller und Freigeber benötigen jeweils aktuell `scripts:execute` und -zusätzlich genau `root:execute` beziehungsweise `system:execute`; beide -Identitäten bleiben getrennt. Das Profil braucht zusätzlich ein ausdrückliches, -versioniertes zentrales und lokales Opt-in samt exakten Geräte-/Generations-/ -Principal-/Helperhashbindungen. Zentrale Linux-Policyversion2 und lokale -General-Policyversion2 können `allowed_script_profiles` mit genau dem -bekannten Profil enthalten; Windows-SYSTEM-Policyversion3 kann es getrennt von -SCM und MSI enthalten. Fehlend bleibt deny für Vollwartung; vorhandene `null`- -oder unbekannte Profile verweigern. Qualifizierte Capability -`script.full_maintenance/1` kommt zusätzlich zu Aktion, Interpreter, -`root:run_script` beziehungsweise `system:run_script`, Helperhash und signiertem -Sync hinzu. Quelle, Build oder Policydatei allein veröffentlichen sie nicht. - -Für das neue Linux-Fullprofil ist zusätzlich `helper_binary_sha256` im -Schema2-Policy-/Pin-/zentralen Scope verpflichtend. Der Roothelper beobachtet -sein eigenes tatsächlich laufendes Image über einen gehaltenen Dateideskriptor -und prüft es vor Probe/neuer Zulassung gegen den geschützten Pin. Der Agent -verifiziert diese Rootpeer-Probe, ohne fremde Root-/proc-Dateien lesen zu müssen, -und meldet nur dann `helper.binary.sha256:`; die Zentrale verlangt denselben -Hash. Neue optionale Metadaten bleiben bei General/APT vollständig ausgelassen; -Schema1-Pins und deren alte Byte-/Hashverträge bleiben unverändert. - -Linux erhält hierfür ein getrenntes explizites Helper-Ausführungsprofil -`full_maintenance_v1`; bestehende General-/APT-Sandboxes bleiben erhalten. -Seine systemd-Start-/Dateisystem-/Netzwerk-/Capabilitybedingungen müssen die -zugesagte Hostwartung tatsächlich erlauben und vor Zieländerung überprüfbar -feststehen. Windows führt mit dem eigenen SYSTEM-Token (SID18) aus, niemals -mit einem nur umbenannten LocalService-Prozess (SID19). Beide verwenden weiter -die unabhängige Originalsignaturprüfung, Peer-/Clock-/Boot-/Sync-/Fenceprüfung -und dauerhaften atomaren Einmalverbrauch. Windows bewahrt zusätzlich Intent, -Dispatchmarker, unabhängigen RawMirror und deny-only Abandon ohne Dateierzeugung -oder Wirkung. Skriptdateien entstehen erst nach erfolgreichem Helperverbrauch -in einem vom jeweiligen Helper geschützten Bereich. Journalidentitäten, -File-IDs/Inodes, Schlüssel und vorhandene Verbräuche bleiben erhalten; keine -Ledgerresets zur Einführung des Profils. - -Die erste Vollwartungsstrecke erlaubt 1..32768 exakte UTF-8-Skriptbytes, -höchstens32 Argumente gemäß bestehendem Vertrag und insgesamt höchstens65536 -stdout-/stderr-Rohbytes. Laufzeit bleibt ausdrücklich begrenzt: Linux1..300s, -Windows1..120s, zusätzlich zur engeren genehmigten/lokalen Grenze. Interpreter -und argv bleiben fest (`/bin/sh` oder qualifiziertes `/bin/bash` mit privater -Datei; Windows PowerShell5.1 mit `-NoLogo -NoProfile -NonInteractive -File`). -Die getrennte explizite, vor Genehmigung gebundene Prozessoption `RemoteSigned` -aus1.18 darf hinzukommen; kein Executorfallback oder Maschinen-/GPO-Override. -Encoding/BOM/Zeilenenden werden nach Genehmigung nicht verändert. - -**Vollwartung ist volle Hostautorität:** Ein genehmigtes Root-/SYSTEM-Skript -kann Dateien, Netzwerk, Konten, Dienste, Agent und Schlüsselbestand ändern und -auch einen Neustart auslösen. Kein Sandbox-, No-Reboot-, Rollback- oder -Geheimnisschutzversprechen für beliebigen privilegierten Code. Nachgeladene -Programme/Netzwerkdaten sind ohne eigenen Vertrag nicht automatisch auf ihren -Inhalt festgelegt. Der Plan zeigt diese Autorität ausdrücklich. Dies ersetzt -keine einzelne Genehmigung und autorisiert keine unangekündigten destruktiven -Abnahmen. Ein Skriptneustart ist keine typisierte Rebootabnahme; fehlender -Abschluss bleibt `unknown` und wird nach Wiederkontakt nicht automatisch erneut -versucht. Exit0 belegt Prozessabschluss, keine beliebige fachliche Wirkung. - -Abbruch/Fence/Timeout müssen während der Ausführung beobachtet und ehrlich -berichtet werden. Nur eigene Prozessgruppe beziehungsweise atomar zugewiesenes -Windows-JobObject und erhaltene Handles dürfen beendet werden. Keine Übernahme -fremder PIDs, kein globaler Kill und kein Anspruch, dass ein privilegiertes -Skript keine unabhängigen Dienste/Tasks erzeugen kann. Bereits eingetretene -Teilwirkung bleibt möglich; unklarer Abschluss bleibt `unknown`. Eigene laufende -Kinder/Handles und lokale Sperre bleiben bis belegtem Abschluss kontrolliert; -ein spätes Exit0 heilt keinen Timeout/Abbruch. Bestehende finale Rohbytes samt -Trunkierung werden unverändert gespeichert; WebUI/MCP erhalten die gespeicherten -Plan-/Ergebnisdaten im berechtigten Mandanten. Vollständige Skriptanzeige vor -Genehmigung und sichere Textdarstellung der abschließenden Ausgabe sind Pflicht, -kein behauptetes Livestreaming. - -Dieser Abschnitt normiert den Vertrag und ersetzt keine Quellen-, Build-, -VM- oder Capabilitynachweise; aktuelle getrennte Belege stehen in -`deploy/linux/full-maintenance-README.md`. Zuerst Linux-Cloud-VM, -anschließend getrennte native Windows-VM-Abnahme; Notebook nur Entwicklung. - -**Ausdrückliche Userentscheidungen Version1.18 — begrenzte Windowsfreigaben:** -Für jeden zuvor mit seinem unveränderlichen Plan in der WebUI genehmigten -Windows-PowerShell5.1-Jobprozess darf die feste Option `RemoteSigned` ausschließlich -im Prozesskontext gesetzt werden. Diese konkrete Option und ihr Prozessumfang -müssen bereits vor der Genehmigung sichtbar und im festen Aktions-/Jobpayload -hash-/signaturgebunden sein; kein nachträglicher Executor-Default oder stiller -Fallback. Der Executor verändert dafür weder Maschinen-, CurrentUser- noch -Gruppenrichtlinien und setzt weder `Bypass` noch `Unrestricted`. GPO-Vorgaben -bleiben vorrangig; eine Blockade wird unverfälscht berichtet. Es entsteht keine -SYSTEM-/Root-Shellberechtigung. Alte Pläne, Jobbytes und Grants werden nicht -umgeschrieben. Umsetzungsvorschlag und offene native Nachweise: -`docs/windows-powershell-policy.md`. - -Der vorhandene Windows-Zeitdienst `W32Time` darf gezielt gestartet werden. -Startart, NTPserver/Peers, ACLs und sonstige Zeitkonfiguration bleiben dabei -unverändert; keine impliziten Updates oder zusätzlichen Neustarts. Running ist -kein Nachweis einer vertrauenswürdigen Uhr: tatsächliche lokale Status-/Boot-/ -Unsicherheitsnachweise und alle bisherigen Clock-/Syncgrenzen bleiben nötig. -Ein manueller Neustart des Windowsgasts über dessen VM-Konsole ist erst später -nach ausdrücklicher zeitlicher Abstimmung mit dem User vorgesehen. Diese -Zustimmung erlaubt keinen Remote-Reboot, keinen RMM-Reboottest und erzeugt -keinen Rebootjob-Abnahmenachweis. Dokumentierte Freigaben sind keine bereits -ausgeführten Schritte. Neue Capabilities werden erst nach ihrer getrennten -nativen Qualifikation eröffnet. - -**Technische Präzisierung Version1.19 — enger Windows-M4-MSI-Schnitt:** -Nach dem getrennten SCM-Vertrag wird `ensure_package` ausschließlich für die -eigenen festen Machine-/x64-MSI-Rezepte1.0 und1.0→1.1 erweitert. Keine freie -SYSTEM-Shell, URL, Transformdatei, Propertyliste oder Ableitung von Linux-Root. -Ein optionales, bei Vorhandensein streng typisiertes `windows_msi_manifest` -bindet das vollständige kanonische Rezept samt Hash in der Action; fehlend bleibt -bei alten Linuxjobs ausgelassen. APT- und Windowsmanifest schließen einander aus. -Äußere Paket-/Versions-/Kontextfelder, Plattform und SYSTEM-Identität müssen -exakt zum Rezept passen. Sämtliche historischen Linux-Codecbytes bleiben erhalten. - -Der Windowskatalog ist eigenständig, unveränderlich und mandantengetrennt; seine -Artefaktreferenz benötigt denselben Tenant. Pro konkretem Job/Versuch entsteht -automatisch genau die eine Referenz aus dem genehmigten Rezept: Artefakt-ID, -SHA256 und Länge. Freie zusätzliche Artefakt-IDs sind im MSI-Pfad verweigert. -Fehlende, zusätzliche oder doppelte Referenzen verweigern Revalidation, -Startgrant und Download. Der bestehende geräte-mTLS-/Job-/Versuch-gebundene -Artefaktendpoint bleibt maßgeblich; Bootstrap-SFTP ist keine Paketabnahme. - -Zentrale und lokale SYSTEM-Policy erweitern ihre bisherige SCM-Erlaubnis nur -ausdrücklich versioniert um exakte MSI-Rezepthashes und eigene Paketrechte/ -Capabilities. Alte SCM-only-Profile erteilen keine Paketerlaubnis. Vor WebUI- -Genehmigung stehen SYSTEM/Machine/x64, Rezept-/Artefakthashes, Produkt-/Upgrade- -und beim1.1-Rezept PackageCode, feste Version/Nutzdatei, Vorgänger, feste Argumente und -No-Reboot-Vertrag sichtbar aus den unveränderlichen Planbytes fest. Clock, -signierter unabhängiger Helpersync, Plan/Grant und dauerhafter Einmalverbrauch -bleiben vor Installerwirkung zwingend. Der Helper kopiert ausschließlich gegen -das signierte Rezept geprüfte Bytes in seinen geschützten Cache; keine vom -Netzwerkagenten frei gewählten Pfade/Programme oder allgemeinen Schreiboperationen. - -Der getrennte Nichtdispatch-/Abandon-/RawMirror-Vertrag gilt additiv auch für -diese konkrete typisierte Action, ohne Cache-/Provider-/Installerwirkung durch -Abandon. Nach möglicher Übergabe gibt es keinen Execute-Retry. MSI0/3010 ist -nur mit unabhängiger innerhalb des ursprünglichen Budgets beobachteter -Nachbedingung erfolgreich;3010 meldet Neustartbedarf ohne Neustartstart. -1641 bleibt Unknown,1618 bekannter Konflikt ohne Retry. Unklarer Timeout/Abbruch -bleibt Unknown; kein globales Beenden von Windows Installer. Auch Noop benötigt -gültige Clock/Fence, Abbruchprüfung und rechtzeitigen unabhängigen Beleg. -Upgrade1.1 setzt genau den bekannten1.0-Vorgänger voraus; danach1.1 installiert, -1.0 entfernt und Nutzdatei exakt. Derselbe1.1-Rezept-/PackageCode erlaubt einen -separat genehmigten echten Noop, kein implizites Repair/Downgrade/Fresh1.1. -Quellen, Builds und Units eröffnen keine Capability oder Policy. Native -Installation/Upgrade/Noop erfolgen jeweils ausschließlich nach tatsächlicher -WebUI-Genehmigung auf der Windows-VM; Linux-first-Vertragsnachweise zuerst. - -**Technische Präzisierung Version 1.17 — Nichtstart vor SYSTEM-Delegation:** -Vor jeder Socketübergabe bindet ein dauerhafter Intent die unveränderten -Originalrequest-/Job-/Grant-/Signaturbytes, Plan/Autorisierung, Gerät und -Generationen, Boot und tatsächlich bestätigten Helperjournal-/Checkpointkontext. -Der atomare Übergang `may_have_dispatched` steht vor Execute; ein eindeutig -belegter Nichtübergabepfad darf ausschließlich deny-only `Abandon` verwenden. -Abandon prüft historische Vollsignatur/Originalbindung, aktuellen TrustedClock- -und ursprünglichen Bootkontext sowie unabhängige erhaltene Helper-Lineage. -Ein abgelaufener Grant erhält dadurch kein neues Startfenster. Nur nachgewiesene -Abwesenheit erlaubt einen atomaren Originalrequest-/Grant-Nichtstart-Tombstone -ohne Provider-/SCM-/Prozess-/Rebootwirkung. Bestehender Verbrauch, fehlender -Startzeuge oder Unknown werden niemals zu einem neuen Nichtstart umgeschrieben. -Antwortverlust erlaubt keine erneute Executeübergabe. `may_have_dispatched` -mit fehlendem Helperbeleg bleibt Unknown/manuell gesperrt; bloße Abwesenheit -ersetzt keinen Nichtstart- oder Rollbacknachweis. Vor lokaler Consumption- -Spiegelung und gemeinsamem Sync wird ein frischer authentisierter roher -Helpersnapshot gegen das vollständige Originaltupel samt Requesthash geprüft, -auch nach einer Executeantwort. Der Originalgrant bleibt erhalten; alle -bisherigen Missing-Row-, Clock-, Journal- und WebUI-Grenzen bleiben streng. -Reservierungs- und Spiegelungszeitpunkte werden nicht als unbekannte native -Helperstartzeit ausgegeben. Der konkrete Vertrag und die getrennten -Implementierungs-/Nachweisstände stehen in `docs/windows-system-abandon.md`. - -**Technische Präzisierung Version 1.16 — getrennte Windows-SYSTEM-Grenze:** -`execution_identity=system` und `system:execute` sind von Linux-`root` und -`root:execute` unabhängig. Planung, Submit, interaktive WebUI-Genehmigung, -Revalidation, Zustellung und Start prüfen die jeweilige konkrete Identität und -aktuelle Rechte-/Policybindung. Die erste enge SYSTEM-Strecke darf ausschließlich -fest benannte eigene Fixturedienste auf `running` oder `stopped` setzen; keine -freie SYSTEM-Shell oder implizite Paket-/Log-/Rebootfreigabe. Zentrale Policy -bindet Kunde/Gerät/Generationen, Principals, exakte Helperbinary-/Policyhashes -und Grenzen. Die lokale SYSTEM-Helperpolicy prüft den vollständigen signierten -Originalauftrag unabhängig. Beide verweigern ohne erfolgreiche Qualifikation, -TrustedClock und bestätigten signierten Agent-/Helpersync. Ein Startgrant -benötigt einen tatsächlich vorhandenen unabhängigen Helperjournalbezug, kein -Legacy-Readyflag. Source- oder Unitnachweise eröffnen keine Fähigkeit oder -Genehmigung. Standard bleibt deaktiviert; eigene Windows-VM-/WebUI-Abnahmen -sind erforderlich. Bestehende Linux-Job-/Grantbytes und die allgemeine -`pending_approval`-/WebUI-Grenze bleiben unverändert. Implementierungsstände -werden in `docs/windows-system-policy.md` getrennt von diesem Vertrag berichtet. - -**Technische Präzisierung Version 1.15 — endliche Journalbudgets:** -Agentjournal sowie Agent-/Helper-Verbrauchsledger erhalten pro SQLite-Datei -maximal1GiB bei geprüften4096-Byte-Seiten (262144Seiten). Die früheren festen -64MiB und256MiB blockierten auf der tatsächlichen VM bei vollständig erhaltenen -Sync-Historien, zuletzt während des Abschlussabgleichs nach dem einzigen -Reboot. Eine Erhöhung ist ausschließlich versionierte Bootstrapwartung mit -qualifizierten Artefakten und unveränderten Identitäten, Journal-/Ledgerinodes, -Verbrauchszeilen, Signaturen und Tombstones. Kein Reset oder Löschen zur Abnahme. -Volle/inkonsistente Journale sperren weiterhin neue Wirkungen; Kapazitätsfehler -werden nie ignoriert. Sichere Kompaktierung und weitergehende Kapazitätsplanung -bleiben späterer eigener Umfang, keine automatische Löschung oder unbeschränkte -Datenbank in diesem MVP. Die größere Grenze ist kein Langzeitbetriebsnachweis. - -**Technische Präzisierung Version 1.11 — neuer Configure-only-Plan:** -Nach unabhängig belegtem und durch normalen signierten RootSync abgeschlossenem -Fehler „Fixture1.0 ausschließlich entpackt“ darf ein neuer fester WebUI-Plan -allein dieses Paket konfigurieren. Manifestschema4 bindet ursprünglichen -Grant/Versuch und unveränderlichen Partial-Proof; Transaktionsschema2 verlangt -explizit `operation=configure_only` und alte/neue Version1.0. Frische vollständige -Teilzustandsplanung hat eine eigene authentisierte Operation/Inventarquelle; -normale Planung und Baseline bleiben strikt. Tatsächlicher v3-Hook und dpkg- -Aufruf dürfen ausschließlich die Konfiguration dieses exakten Pakets enthalten, -kein Unpack, Pending, Triggerlauf oder Fremdpaket. Eigene Create-once- -Recoverymarker/-Nachweise; alte Marker und History bleiben erhalten. Dies -bescheinigt keine nachträgliche frische Installationsabnahme. Danach braucht ein -Upgrade1.0→1.1 einen eigenen neuen festen WebUI-Plan und native Nachprüfung; -gewünschte Noops werden getrennt und ehrlich als Noops abgenommen. - -**Technische Präzisierung Version 1.10 — wirkungslose Kontrollkettenreparatur:** -Ein nachweislich nicht serverseitig persistierter Sync-Request darf im expliziten -Entwicklungsprofil über ein eng begrenztes Root-Bootstrapwerkzeug abgeglichen -werden. Server und beide lokalen Verifier prüfen die vollständigen erhaltenen -Journale, ursprünglichen Signaturen, exakten Geräte-/Boot-/Checkpointbindungen -und den unveränderten offenen Verbrauch. Nur die bereits gespeicherte signierte -Ablehnung wird zum monotonen gemeinsamen Kontrollhead; eine kurzlebige, -domänengetrennte Signatur bindet sämtliche Zeugen. Lokale alte Faults und -Quittung werden dauerhaft archiviert. Keine Bereitschaft, Genehmigung, Jobs, -Grants, Verbräuche oder Outcomes entstehen oder ändern sich dadurch. Kein -manuelles Löschen einer Sperre, kein Journal-/Identitätsreset. Erst der normale -signierte Sync und eine unabhängig gebundene Nachprüfung dürfen anschließend -ein unbekanntes Ausführungsergebnis klassifizieren. Dies konkretisiert den -bestehenden Abgleichvertrag und ist keine Ausnahme von der WebUI-Jobgenehmigung. - -**Präzisierung Version 1.9, 2026-11-13 — expliziter neuer APT-Testversuch:** -Ein bekannter Fehler vor der vertrauenswürdigen Hookübergabe darf nach belegtem -unverändertem vollständigem Paketbestand durch genau einen neuen festen, -separat WebUI-genehmigten Versuch des unveränderten Fixture-Rezepts geprüft -werden. Manifestschema 3 bindet hierfür den ursprünglichen Grant/Versuch und -Hash des unveränderten Create-once-Markers. Der Helper prüft unabhängig den -ursprünglichen signierten Auftrag und dessen eindeutiges `HOOK_NOT_HANDED_OFF` -im selben dauerhaften Ledger. Die alte Signaturprüfung ist ausschließlich -historisch und berechtigt keinen neuen Start. Alter Marker und vollständige -Historie bleiben erhalten; der neue Versuch erhält einen eigenen Create-once- -Retrymarker. Vorhandener Hook, unbekannte/partielle Wirkung, geänderte Baseline, -Identität, Generation oder Transaktion verweigern die Wiederaufnahme. Keine -automatische Wiederholung und keine allgemeine Freigabe unbekannter Wirkungen. -Schema 2 bleibt ohne Retryfeld bytekompatibel. Diese Vertragspräzisierung ist -kein Nachweis einer ausgeführten oder bestandenen Paketabnahme. - -**Useroverride Version 1.8, 2026-11-13:** Der User erlaubt ausdrücklich, -den Windows-11-Client bereits parallel zur offenen Linux-MVP-Abnahme zu -entwickeln und auf seiner Windows-Test-VM nativ zu prüfen. Die bisherige -Reihenfolgeregel „Windows erst nach Linux-MVP-Abnahme“ ist ausschließlich -hierfür überstimmt. Linux bleibt Referenz und erstes MVP-Abnahmeziel; -Windows-Nachweise bleiben separat und sind kein zusätzlicher Linux-MVP-Blocker. -Der Notebook-Host erhält keinen Agenten; die Windows-VM ist ein eigenständiger -Gast mit ausgehender Verbindung zum endgültigen Cloudserver. Bootstrapzugang -über abgesicherten Reverse-SSH-Tunnel ist erlaubt; TLS/mTLS, Mandantengrenzen -und die WebUI-Genehmigung jedes RMM-Jobs bleiben unverändert verbindlich. - -Implementiere das in dieser Datei beschriebene System schrittweise. Wähle den nächsten offenen Schritt aus dem aktuellen Lieferplan in Kapitel 0.4 und liefere ein lauffähiges, überprüfbares Ergebnis. Erzeuge nicht lediglich ein breites Gerüst mit leeren Methoden. Nutze die Startentscheidungen aus Kapitel 18, wenn konkrete Betriebsdaten noch fehlen. Halte tatsächlichen Implementierungsstand, offene Punkte und durchgeführte Prüfungen im Repository fest. - -Die Begriffe **MUSS**, **DARF NICHT** und **Abnahme** bezeichnen verbindliche Anforderungen. **Default** bezeichnet einen konfigurierbaren Startwert. **Optional** gehört nicht zum ersten Produktumfang. Der jeweils jüngste einschlägige Nutzerentscheid in Kapitel 0 hat Vorrang vor früheren Architekturannahmen und Beispielen; sonst konkretisieren Kapitel 18 bis 26 die Architektur. Verbleibende Widersprüche werden dokumentiert und fachlich geklärt. - -**Neuer verbindlicher Useroverride 2026-11-12 – Umfang ohne RustDesk:** „rustdesk musst du nicht machen ... das lasse aus“. Keine RustDesk-Installation, Profile/Provisionierung, RustDesk-spezifischen Schnittstellen oder externe Desktopabnahme in dieser Umsetzung. M4 bleibt allgemeine Linux-Paketverwaltung; M5 umfasst nur Referenzabläufe 0.3 Nr. 1–3. REQ-11, Referenzablauf Nr. 4, `ensure_rustdesk`, `rustdesk_profiles`, Kapitel 24.2 und AT-17/AT-18 sind ausschließlich spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Sämtliche verbliebenen RustDesk-Architekturtexte einschließlich Windows-Beispielen und Startauftrag sind in diesem Sinne historisch/optional zu lesen, nicht als Implementierungsauftrag. Keine eigene Desktop-Engine als Ersatz; Linux-first und die übrigen Sicherheits-/Abnahmegates bleiben bestehen. - -**Einzige Bedienungsausnahme für diese Entwicklungsabnahme:** Der User hat ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des unveränderlichen Plans mit einem deutlich sichtbar als **simulierter Testprincipal** gekennzeichneten Principal durchführen. Diese Ausnahme präzisiert alle nachfolgenden Aussagen zu tatsächlicher menschlicher Bedienung bei Entwicklungstests (insbesondere REQ-10, Kapitel 22/23/25/26 und AT-30); sie schafft keine Code-Abkürzung und keine Produktionsausnahme. `pending_approval`, Planbindung, Rechte-, Tenant-/Policyprüfungen und interaktive UI-Grenze bleiben unverändert; vor UI-Genehmigung keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Audit MUSS `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr samt Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar kennzeichnen. Keine tatsächliche menschliche Identität vortäuschen, Simulation getrennt nachweisen, kein Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft; normale UI-Browserrequests bleiben an deren interaktiven Kontext gebunden. Simulation außerhalb dev/test verweigern; Produktionsverhalten bleibt unverändert. Lokale Serverneustarts sind erlaubt, keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. Diese Regeln dokumentieren Erlaubnis und Anforderungen, keine bereits implementierte oder ausgeführte Simulation. Details/Nachweisvorlage: `docs/project-decisions.md`, `docs/development.md`. - -**Historische Phasenentscheidung vom 2026-11-12, in 1.33 abgelöst:** Linux-first galt für alle Features: zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Erstes Phasenziel ist das Linux-MVP x86-64 mit WebUI, MCP und autorisierten dauerhaften Jobs (M0–M5). Windows-x86-64-Implementierung und native Abnahmen beginnen erst nach dokumentierter Linux-MVP-Abnahme; PVE-Modul/-Client, Cluster und Backups folgen noch später nach der Windows-Phase. ARM64 und Betriebsreife bleiben nachgelagerte Ausbaustufen. Windows-/Linux-Agenten sind als Produktziel auf physischen Geräten und beliebigen VMs eigenständig verwaltbar, ohne PVE-Agent, Hypervisorzugang oder bekannten Host. Proxmox verwendet später denselben Linux-Agenten mit Zusatzmodul. Keine vorgezogene PVE-Implementierung oder PVE-Testpflicht im Linux-MVP. Build, Simulator oder lokaler PC-/Containerlauf ersetzen keinen realen VM-Nachweis. - -**Historischer Entwicklungsweg vor dem Serverumzug, abgelöst durch Kapitel 0.4 und die Cloudtopologie:** Server lokal in Docker auf dem PC, sämtliche veröffentlichten Dockerports ausschließlich Loopback. PC initiiert SSH zur VM mit `-N -T`, `ExitOnForwardFailure=yes`, Keepalive und `-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent verbindet sich ausgehend über dortigen Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`, explizitem VM-Hosts-Eintrag oder geprüftem Client-Connect-Override unter Erhalt der Namensprüfung; niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein RMM-Sicherheitsersatz. VM-Daten in `credentials/linux-vm.conf`, `.gitignore`-Ausschluss, Modi 700/600; keine Secrets loggen/committen, kein `source`/`eval`. Toolinstallation ist erlaubt, aber keine impliziten Reboots, Updates oder destruktiven Zieltests. Details und ausschließlich geplante, nicht als getestet behauptete Befehle: `docs/development.md`. Verbindliche AI-Regeln: `AGENTS.md`. Kein Erfolg ohne tatsächlichen Nachweis. - -**Unbedingte Freigabegrenze:** JEDER zur Ausführung eingestellte Job aus UI, MCP oder Automatik benötigt vorher die explizite Genehmigung eines berechtigten Menschen in der WebUI. Dies gilt auch für Diagnosejobs, Hello World, Reboot-Folgejobs und neue Versuche. Eine Genehmigung bindet einen unveränderlichen Plan und feste Einzeljobs/Versuche; ein transparent angezeigtes Sammelpaket ist zulässig, Dauer- und Wildcardfreigaben nicht. Policies dürfen nur begrenzen oder verweigern, niemals Genehmigungen ersetzen. MCP darf planen und einen persistenten Antrag mit `pending_approval` einstellen, aber weder genehmigen noch vor Genehmigung Ausführungsjobs einreihen, `JobOffer` zustellen oder Startgrants erhalten. Passive Telemetrie/Heartbeats und das Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Diese Ausnahme darf keine angeforderten Diagnose- oder Ausführungsjobs als Telemetrie tarnen. - -### 0.2 Verbindlicher Funktionsumfang - -| ID | Anforderung | +| Schritt | Verhalten | | --- | --- | -| REQ-01 | Ein zentrales Backend in Rust verwaltet mehrere voneinander getrennte Kunden. | -| REQ-02 | Ein gemeinsamer Rust-Agentkern unterstützt Windows und Linux eigenständig auf physischen Geräten und beliebigen VMs; Host/Hypervisor darf unbekannt sein. Kein PVE-Agent oder Hypervisorzugang ist nötig. Proxmox verwendet nach dem MVP denselben Linux-Agenten mit zusätzlichem Modul. | -| REQ-03 | Historische erste Phase Linux-MVP x86-64/AMD64; aktuelle Lieferung gemäß 0.4 für Windows und Linux x86-64, ARM64-Clients später. Gemeinsame Funktionen und plattformspezifische Wirkung auf den betreffenden Gästen nachweisen. Support gilt je getesteter Betriebssystem-/Architekturkombination; 32-Bit-Ziele sind zusätzliche, noch nicht zugesagte Erweiterungen. | -| REQ-04 | Alle RMM-Netzwerkverbindungen zu Kundengeräten werden vom Agenten ausgehend aufgebaut. Die Zentrale öffnet keine eingehenden Verbindungen zu den Geräten. | -| REQ-05 | Inventar, Erreichbarkeit, Messwerte, erwartete Dienste, Software, Updates und begrenzte Logs sind je Kunde abrufbar; Proxmox-/Backupinformationen folgen nach dem MVP. | -| REQ-06 | Jeder Status zeigt Datenquelle und Erhebungszeit. Nicht erreichbare Geräte zeigen den letzten bekannten Stand; die Plattform behauptet keinen aktuellen Messwert ohne neue Erhebung. | -| REQ-07 | Eine Weboberfläche stellt Kunden, Geräte, Probleme und Aufträge dar. Diese Verwaltungsoberfläche bleibt Bestandteil; sie ist von grafischer Desktopfernsteuerung zu unterscheiden. | -| REQ-08 | Ein MCP-fähiger LLM-Client kann gespeicherte Gerätedaten abfragen, Skripte und Installationen vorbereiten und Sammelaufträge zur menschlichen WebUI-Genehmigung beantragen, etwa ausgewählte Server eines Kunden neu starten. | -| REQ-09 | Wartungsjobs durch Menschen, KI oder automatische Regeln verwenden dieselben Pläne, Berechtigungsprüfungen, Jobs und Ergebnisnachweise. Für den Lebenszyklus des Agenten gelten die Veröffentlichungs- und Aktivierungsregeln in 0.4. | -| REQ-10 | Jeder Ausführungsjob benötigt explizite menschliche WebUI-Genehmigung für seinen unveränderlichen Plan und festen Versuch, einzeln oder als transparentes Sammelpaket. Policies begrenzen/verweigern nur; KI und Automatik dürfen niemals genehmigen. | -| REQ-11 | Spätere optionale Integration, ausdrücklich nicht Teil dieser Umsetzung/MVP-Abnahme: RustDesk auf ausgewählten Geräten mit versionierter Konfiguration installieren und prüfen; separater RustDesk-Bildschirmzugriff. | -| REQ-12 | Eine eigene Desktop-Engine, Bildschirmübertragung oder Maussteuerung wird nicht entwickelt. RustDesk hat einen separaten, passend konfigurierten Verbindungsweg. | -| REQ-13 | Der Lieferumfang 1.33 führt Shell-/PowerShell-Skripte als abholbare Batchaufträge aus. Interaktive Sitzungen sind eine spätere Option. | -| REQ-14 | Offlinegeräte erhalten gültige Aufträge nach Wiederverbindung. Ein ausgeschaltetes Gerät kann über seinen Agenten keine Aktion ausführen. | -| REQ-15 | Die Zuordnung verkaufter Geschäftsleistungen ist eine optionale spätere Erweiterung. Sie blockiert Inventar, Monitoring und Verwaltung nicht. | +| Skript veröffentlichen | In der Bibliothek eines Kunden erhält ein Skript einen Namen, einen Interpreter, einen Standard-Ausführungskontext und eine unveränderliche Version. Eine Bearbeitung veröffentlicht eine weitere Version. | +| Auftrag planen | Zielgeräte eines Kunden auswählen und entweder die genaue Bibliotheksversion oder ein eigenes Skript angeben. Der Plan bindet Skriptbytes, Geräteinstallation, Ausführungsrechte, Zeitfenster, Laufzeit, Ausgabegrenze und Versuch. Eine spätere Bibliotheksänderung ändert den Plan nicht. | +| Einreichen und genehmigen | Die Einreichung erzeugt einen Antrag mit Status `pending_approval`. Erst die interaktive WebUI-Genehmigung erzeugt ausführbare Jobs. Im Verlauf stehen Entscheidung, Person und Zeitpunkt. Ein abgelehnter Antrag erzeugt keine Ausführung. | +| Ausführen | Der Client holt den Auftrag ab. Er prüft die signierte, versuchsgebundene Starterlaubnis und führt das Skript im vorgesehenen Konto aus. Vor Ort ist keine Benutzerbestätigung nötig. Doppelte Zustellung darf den Versuch nur einmal starten. | +| Ergebnis lesen | Der Server speichert Zustand, Exitcode und verfügbare Standard- und Fehlerausgabe pro Ziel und Versuch. Die WebUI zeigt Skriptinhalt und Ergebnis im Auftrag. MCP liefert über die Auftrags-ID den Gesamtstand und über die Job-ID das einzelne Ergebnis. | -### 0.3 Referenzabläufe +Linux führt Shellskripte unter dem Dienstkonto oder über den eingerichteten Helper als root aus. Windows führt PowerShell unter LocalService oder über den Helper als SYSTEM aus. Neustart und Installation von Windows-Updates sind Skriptaufträge. Bei einem Neustart kann das Skript bereits vor dem Herunterfahren erfolgreich enden. Der Betriebsnachweis verbindet den neuen Bootbezug mit dem nächsten authentisierten Kontakt und einem Folgeauftrag. [Skriptbibliothek](crates/server/src/script_library.rs) · [Auftragsverarbeitung](crates/server/src/jobs.rs) -1. **Inventar:** „Gib mir alle Server von Kunde X, ihren letzten Kontakt und freien Speicher.“ Die Antwort enthält nur berechtigte Geräte, Datenalter und gegebenenfalls unvollständige Ergebnisse. -2. **Sammelreboot:** „Starte alle Server von Kunde X neu.“ Die Plattform löst Kunde und feste Zielmenge eindeutig auf und beantragt die menschliche WebUI-Genehmigung des Plans. Erst danach führt sie Jobs gestaffelt aus. Ein Gastauftrag erweitert sich nicht auf seinen Hypervisor; dieser muss nicht bekannt sein. -3. **KI-Skript:** „Erstelle Hello World und führe es auf allen Clients von Kunde X aus.“ Das LLM liefert passende Skriptvarianten; exakte Bytes, Interpreter und feste Ziele werden vor menschlicher WebUI-Genehmigung gebunden. Erst danach wird ausgeführt; Ergebnis und Ausgabe werden je Gerät zurückgemeldet. -4. **RustDesk (historischer Zielvertrag, nur spätere optionale Integration; keine MVP-Pflicht):** „Installiere RustDesk auf den PCs von Kunde X mit Profil Y.“ Bei späterer Beauftragung prüft die Plattform die Plattform-/Paketkombination und beantragt die menschliche WebUI-Genehmigung des festen Plans. Erst danach installiert und konfiguriert sie und meldet ID, Version und Dienstzustand. Ein externer Verbindungstest bleibt dann ein eigener Nachweis; zusätzliche Testjobs und Reboots benötigen ebenfalls Genehmigung. In dieser Umsetzung vollständig ausgelassen. +Ein Abbruchwunsch wird am Auftrag gespeichert. Bei unterbrochener Rückmeldung gleichen Server, Agent und gegebenenfalls Helper den gespeicherten Versuch ab. Bei `unknown` bleibt die Wirkung ungeklärt. Die WebUI kann einen solchen Fall dokumentiert abschließen. Dieser Abschluss erteilt keine Freigabe für einen weiteren Versuch. -## 1 Entscheidung und Geltungsbereich +## Öffentliche Verwaltung und Berechtigungen -Empfohlen wird eine mandantenfähige Plattform mit einem zentralen Rust-Backend und einem gemeinsamen Rust-Agenten, der je nach Betriebssystem und Rolle unterschiedliche Module aktiviert. Windows und Linux verwenden denselben Protokoll-, Sicherheits- und Auftragskern. Jede verwaltete VM verwendet einen eigenen, vollständig eigenständigen Windows- oder Linux-Agenten; sie muss nicht auf Proxmox laufen. Ein bekannter oder verwalteter Host ist keine Voraussetzung. Physische Maschinen verwenden dieselben Pakete. Erst nach dem MVP kann derselbe Linux-Agent auf Proxmox VE eine zusätzliche Proxmox-Funktion aktivieren. +Die WebUI verwendet HTTPS mit lokalem Passwort und TOTP. MCP verwendet HTTPS mit individuell ausgestellten, befristeten und widerrufbaren Bearer-Tokens. Ein Token gilt für ausgewählte Kunden oder ausdrücklich für alle aktuellen und künftigen Kunden. Der Server prüft die Aktion im Zielkunden und kontrolliert die Rechte der Beteiligten erneut vor Ausführung. -Alle Verbindungen zwischen verwalteten Geräten und der Zentrale werden vom Gerät ausgehend aufgebaut. Für die Lieferung 1.33 laufen Aufträge und Ergebnisse über den ausgehenden Gerätekanal gemäß 0.4. Zusätzliche Kanäle für interaktive Sitzungen gehören zu einer späteren Ausbaustufe. Ein eingehender SSH-, WinRM- oder RMM-Port am Kundengerät ist dafür nicht erforderlich. +MCP unterstützt Kunden- und Geräteabfragen, Skriptbibliothek, Planung, Einreichung, Auftrags- und Ergebnisabfrage, Abbruchanforderung sowie gespeicherte Status-, Log- und Releaseabfragen. Kundenpflege, Tokenverwaltung und persönliche Entscheidungen erfolgen in der WebUI. Die vom Server angebotenen MCP-Werkzeuge und deren Parameter sind im Toolkatalog definiert. [MCP-Werkzeuge](crates/server/src/mcp.rs) · [Bedienung und Rechte](docs/public-access.md) -Rust ist für Backend und Agenten eine sinnvolle Wahl, wenn im Entwicklungsteam Rust-Erfahrung vorhanden ist oder aufgebaut werden soll. Der Entwurf verbindet einen gemeinsamen technischen Kern mit den notwendigen plattformspezifischen Implementierungen. Die Weboberfläche wird in TypeScript umgesetzt. MCP bietet kontrollierte Lese- und Planungsfunktionen, aber keine Genehmigung. Die Plattform erzwingt Rechte, begrenzende Regeln und menschliche WebUI-Genehmigung vor jeder Jobausführung. +Für administrative Skripte gilt zusätzlich das Plattformrecht `root:execute` oder `system:execute`. Bei einem installierten signierten Helper kann der Betreiber die vorhandene zentrale Geräteregel mit `mcp:scoped` für berechtigte Token öffnen. Der Server prüft Kunde, aktuelle Tokenrechte, Installation, Helper und gegebenenfalls die in der Regel festgelegten Skriptbeschränkungen. Eine Tokenrotation erfordert keine Anpassung auf dem Gerät. [Geräteregel](crates/server/src/managed_scripts.rs) -Der Gesamtentwurf umfasst Inventar, Monitoring, Softwareinstallation, Betriebssystemaktionen, Protokollzugriff, menschlich genehmigte Bereitstellung von RustDesk und Mandantentrennung. Proxmox, Cluster, Backupbeobachtung, Shell-Sitzungen und Betriebsreife sind spätere Ausbaustufen nach dem MVP gemäß Kapitel 25. Eine eigene grafische Fernsteuerung ist nicht Bestandteil; Bildschirmzugriffe erfolgen mit RustDesk. Eine Zuordnung verkaufter Dienstleistungen wird vorbereitet; Vertragsverwaltung und Abrechnung gehören nicht zum MVP. +## Geräteaufnahme und Agentupdates -**Planungsannahmen:** Ein IT-Dienstleister betreibt zunächst eine zentrale Installation für mehrere Kunden. Eine Pilotumgebung beginnt mit einigen Dutzend Geräten. Für die Auslegung werden später 1.000 und 10.000 Geräte als Lastszenarien getestet. Diese Zahlen sind Testziele und keine Leistungszusage. Unterstützte Windows-, Linux-, PVE- und PBS-Versionen werden als verbindliche Matrix festgelegt. Dieses Dokument ist die Arbeitsgrundlage für die anschließende Implementierung; es enthält selbst noch keine fertige Software. Die Startentscheidungen und Abnahmen werden in den Abschnitten 18 bis 26 konkretisiert. +Die WebUI erzeugt einen kundengebundenen Einmalcode und zeigt die HTTPS-Installationsanleitung für die verfügbare Plattform. Zum Erstbezug braucht das Gerät eine vertrauenswürdige TLS-Verbindung. Der Installer prüft Vertrauensmaterial und Release, richtet die lokalen Dienste ein und nimmt das Gerät auf. Anschließend verwendet die Installation ihre eigene Identität. Der lokale Administrator richtet den privilegierten Skript-Helper ein, wenn das Gerät auch Administratoraufträge erhalten soll. [Serverseitiger Bootstrap](crates/server/src/bootstrap) -| Anforderung | Architekturentscheidung | -| --- | --- | -| Nur ausgehende Verbindungen | Agent öffnet TLS über TCP 443 und fordert Aufträge an | -| Windows und Linux auf physischer oder virtueller Hardware | Gemeinsamer Agentkern mit Betriebssystemadaptern | -| Proxmox Host und Gäste (nach MVP) | Linux-Agent mit PVE-Modul auf dem Host; Gastagent vollständig unabhängig davon | -| Übersicht je Kunde | Mandant, Standort, Asset und Agentinstallation als getrennte Entitäten | -| KI kann lesen und handeln | MCP-Adapter vor derselben Fachlogik und Auftragsverwaltung wie die UI | -| Kontrollierte Automatisierung | Automatische Planung mit begrenzenden Regeln; feste Ausführungsjobs erst nach menschlicher WebUI-Genehmigung | -| Nachvollziehbare Administration | Dauerhafte Jobs, Ausführungsnachweise und getrennt gesicherte Audits | -| RustDesk bereitstellen | Installation mit versioniertem Kundenprofil und überprüftem Ergebnis | +Der Server stellt je Kunde und Plattform Agent und Helper mit einem gemeinsam signierten Manifest bereit. Das Manifest bindet die Hashes und Größen der Binärdateien. Für die Erstaufnahme liefert der Server auch den passenden Bootstrap-Updater. Linux x64 verwendet den GNU/Linux-Kanal, Windows x64 offiziell `x86_64-pc-windows-gnu`. Der lokale Updater fragt regelmäßig nach einer neueren veröffentlichten Generation, prüft die Bindung an Plattform, Schlüsselring, Releasefolge und Binärhashes und aktiviert das geprüfte Paar unter derselben Geräteidentität. Auf Linux steuert ein systemd-Timer den Abruf, auf Windows ein eigener Updatedienst. -## 2 Komponenten und Systemgrenzen - -```mermaid -flowchart TD - UI["Weboberfläche"] --> API["HTTP API und MCP"] - AI["LLM mit MCP Client"] --> API - Agent["Windows, Linux und Proxmox Agent"] -->|"ausgehend TLS 443"| Gateway["Agent Gateway"] - API --> Core["Rust Fachservices"] - Gateway --> Core - Core -->|"Aufträge über bestehenden Kanal"| Gateway - Core --> DB["PostgreSQL"] - Core --> Metrics["Messwertdienst"] - Core --> Objects["Artefaktspeicher"] -``` - -Die Pfeile zum Gateway beschreiben den Datenfluss. Neue Netzwerkverbindungen zu den verwalteten Geräten baut die Zentrale nicht auf. RustDesk ist eine separat betriebene Anwendung; seine Bereitstellung läuft als normaler Verwaltungsauftrag. - -Die Anwendung beginnt als modularer Monolith. Damit sind Fachmodule innerhalb einer gemeinsamen Codebasis gemeint, mit eindeutigen Zuständigkeiten und internen Schnittstellen. Das vermeidet verteilte Transaktionen zwischen vielen kleinen Diensten. Gateway, Hintergrundverarbeitung und Relay müssen dennoch getrennt startbar sein, damit sie bei höherer Last unabhängig skalieren und mit unterschiedlichen Berechtigungen laufen können. - -| Komponente | Aufgabe | -| --- | --- | -| Web API und MCP Adapter | Eingaben prüfen, Benutzerkontext herstellen und Fachservices aufrufen | -| Identitäts und Richtliniendienst | Kundenrechte, Gerätezuordnung, Aktionen, Freigaben und Sitzungsrechte auswerten | -| Inventardienst | Quellen normalisieren, Assets zuordnen und aktuelle sowie historische Sicht bereitstellen | -| Agent Gateway | Geräte authentifizieren, Verbindungen halten, Telemetrie annehmen und Jobs zustellen | -| Jobdienst und Worker | Pläne, Warteschlange, Laufzustände, Fristen und Nachprüfungen verwalten | -| Monitoringdienst | Sollzustände und Messwerte auswerten, Vorfälle gruppieren und Benachrichtigungen erzeugen | -| Sitzungsrelay | Autorisierte interaktive Terminaldaten vermitteln | -| PostgreSQL | Verbindliche Stammdaten, Rechte, Inventar, Jobs, Richtlinien und Auditverweise speichern | -| Messwertspeicher | Zeitreihen für Metriken und Diagramme speichern | -| Objektspeicher | Installationsartefakte, größere Ausgaben, Logauszüge und Sitzungsaufzeichnungen speichern | - -PostgreSQL ist die verbindliche Quelle für Aufträge und Berechtigungen. Eine offene Netzwerkverbindung oder ein flüchtiger Cache ist nie der einzige Nachweis eines Auftrags. Die Verbindungstabelle des Gateways darf nach einem Neustart aus neuen Agentanmeldungen rekonstruiert werden. Eine zusätzliche Message-Broker-Infrastruktur wird erst eingeführt, wenn ein Lasttest oder eine benötigte Entkopplung dies rechtfertigt. - -Eine reine Prozessgrenze innerhalb desselben privilegierten Betriebssystemkontos schützt nicht gegen eine vollständige Kompromittierung. In der Produktionsbereitstellung laufen API, Relay und besonders sensible Signierfunktionen mit getrennten Dienstidentitäten. Das Relay erhält keine allgemeinen Datenbank- oder Signierrechte. Gemeinsame Rust-Bibliotheken erlauben diese Trennung ohne duplizierte Fachlogik. - -## 3 Rust und der technische Stack - -Rust passt zu langlebigen Systemdiensten, nebenläufigen Netzwerkverbindungen und lokalem Betriebssystemzugriff. Speicher- und Nebenläufigkeitssicherheit in sicherem Rust sowie der Verzicht auf einen obligatorischen Garbage Collector sind dafür relevante Eigenschaften. Sie ersetzen keine korrekte Autorisierung und schützen nicht automatisch unsichere FFI-Aufrufe oder gestartete Fremdprogramme. [^1] - -Der größte Aufwand liegt in den Betriebssystemadaptern, Installationspaketen, Rückwärtskompatibilität und dem sicheren Betrieb. Rust beseitigt diese Unterschiede nicht. Bei einem Team ohne Rust-Kenntnisse würde Go die Entwicklung des Servers möglicherweise vereinfachen; für dieses Vorhaben ist ein durchgängiger Rust-Kern dennoch eine nachvollziehbare Entscheidung. Ein eigener Browser-UI-Stack in Rust würde zunächst wenig fachlichen Nutzen hinzufügen. - -| Bereich | Empfohlene Auswahl | Zweck | -| --- | --- | --- | -| Backend | Rust, Tokio, Axum | Asynchrone Dienste, HTTP API und Gateway | -| Datenzugriff | SQLx und PostgreSQL | Typisierte Abfragen und versionierte Migrationen | -| Agentprotokoll | Protobuf mit prost | Versionierbare Nachrichten über WSS und HTTPS | -| TLS und HTTP Client | rustls und reqwest | Zertifikatsprüfung und ausgehende Verbindungen | -| MCP | Offizielles Rust SDK rmcp | MCP als Adapter vor den Fachservices | -| Agentjournal | SQLite | Bestätigte Aufträge und begrenzter Offlinepuffer | -| Betriebssystemadapter | windows Crate und lokale Linux APIs | Native Plattformfunktionen mit gekapseltem FFI | -| Oberfläche | TypeScript und React | Kundenübersicht, Tabellen, Diagramme und Terminal | -| Produktive Metriken | VictoriaMetrics hinter internem Zugriffsdienst | Zeitreihen getrennt vom Auftragsdatenbestand | -| Diagnose der Plattform | tracing und OpenTelemetry | Korrelation von Anfrage, Auftrag und Agentereignis | - -Die Bibliotheken werden in festgelegten, getesteten Versionen verwendet. Die verbindliche Struktur des Cargo-Workspace und die Trennung zwischen Bibliotheken und ausführbaren Diensten stehen in Abschnitt 19. Fachmodule kennen keine UI- oder MCP-spezifischen Berechtigungsabkürzungen. rmcp ist ein offizielles SDK und basiert auf Tokio. [^2] Tokio und Axum bilden den passenden asynchronen Serverunterbau. [^3] - -## 4 Aufbau der Agenten - -Der gemeinsame Kern übernimmt Enrollment, Geräteidentität, Zertifikatsrotation, Transport, Heartbeats, Konfiguration, das lokale Journal, begrenzte Telemetriepuffer, Auftragsannahme und signierte Updates. Plattformmodule implementieren Collector für Inventar und Messwerte sowie Executor für klar definierte Aktionen. Eine Capability-Liste meldet, welche Funktionen auf einem konkreten Gerät tatsächlich verfügbar sind. - -Eine nicht verfügbare Fähigkeit wird explizit als nicht unterstützt oder nicht berechtigt gemeldet. Sie darf weder durch erfundene Werte ersetzt noch als erfolgreicher Test gewertet werden. Collector laufen mit Zeitlimits und Fehlerisolation. Blockierende Systemaufrufe dürfen die Netzwerkverbindung nicht blockieren; besonders problematische oder privilegierte Provider können in eigenen Prozessen laufen. - -Das erste Linux-MVP unterstützt x86-64 beziehungsweise AMD64 für ausdrücklich auf der tatsächlichen Linux-Test-VM geprüfte Linux-Versionen. Windows x86-64 folgt erst nach Linux-MVP-Abnahme mit eigenen nativen Tests. ARM64 folgt später mit nativen Abnahmen; Rust-Compilerziele allein belegen keine Agentfunktion. 32-Bit-x86 und ARM32 sind zusätzliche, nicht zugesagte Ziele. Physische Hardware und beliebige VMs verwenden dieselbe passende Agentvariante ohne Hypervisorabhängigkeit. Das noch spätere Proxmox-Modul wird separat auf unterstützten PVE-Hostplattformen geprüft. Die Hardware- und Plattformunterstützung von RustDesk ist davon unabhängig. [^23][^24] - -### 4.1 Windows - -Der Agent wird als signierter Windows-Dienst installiert. Telemetrie und Netzwerk laufen unter einer möglichst eingeschränkten Dienstidentität. Ein separater Helper führt notwendige Systemaktionen aus. Der lokale Kommunikationskanal verwendet eine Named Pipe mit restriktiver ACL und überprüft auf beiden Seiten Identität und Auftrag. - -Für Dienste werden die Service-Control-Manager-APIs genutzt, für Ereignisse die Windows-Event-Log-APIs mit gespeicherten Bookmarks und für Systeminformationen geeignete Win32-, CIM- oder WMI-Provider. COM-basierte Zugriffe wie Windows Update laufen auf korrekt initialisierten, dafür vorgesehenen Threads. Allgemeine asynchrone Tasks dürfen COM-Objekte nicht unkontrolliert zwischen Threads verschieben. [^4] - -Softwareinventar verbindet Registry-, MSI- und gegebenenfalls AppX-Informationen. Regelmäßige Win32_Product-Abfragen werden vermieden, da sie MSI-Konsistenzprüfungen und Reparaturaktivitäten auslösen können. Benutzerbezogene Software wird getrennt erfasst; ein Dienstkonto sieht nicht automatisch alle Zustände jeder Benutzeranmeldung. [^5] - -Die Paketausführung besitzt Provider für geprüfte MSI- und EXE-Installationsrezepte sowie weitere ausdrücklich unterstützte Quellen. WinGet wird nicht als universeller Systeminstaller vorausgesetzt: Microsoft dokumentiert Einschränkungen im Systemkontext. Paketkennung, Version, Installationskontext, Herkunft, Hash und Nachprüfung gehören in das Rezept. [^6] - -### 4.2 Linux - -Der Agent läuft bei unterstützten Distributionen als systemd-Dienst. Ein unprivilegierter Prozess sammelt verfügbare Daten; ein eng begrenzter Helper verwendet erforderliche Root-Rechte. Lokale IPC erfolgt über einen Unix-Socket mit geprüften Peer-Credentials und restriktiven Dateirechten. Bestehende MAC-Regeln wie SELinux oder AppArmor werden berücksichtigt. - -Provider lesen unter anderem /proc, /sys, /etc/os-release, systemd-Zustände, Journald und Paketdatenbanken. Debian und Ubuntu erhalten einen APT/dpkg-Adapter; weitere Distributionsfamilien einen eigenen Adapter. Sperren des Paketmanagers und fremde Updateprozesse werden respektiert. Anfangs ist eine kleine, klar getestete Distributionsmatrix wertvoller als eine unbelegte Zusage für jedes Linux. - -### 4.3 Privilegierter Helper - -Der Helper akzeptiert typisierte, autorisierte Operationen mit Ziel, Parametern, Frist und Ausführungsidentität. Für Paketinstallationen bedeutet dies beispielsweise eine geprüfte Paketkennung mit Argumenten, nicht einen frei zusammengesetzten Shellstring. Er prüft die für ihn relevanten Autorisierungsnachweise selbst und vertraut nicht allein einer Anfrage des Netzwerkprozesses. - -Eine allgemein freigegebene Root- oder SYSTEM-Shell besitzt zwangsläufig weitreichende Rechte auf dem Gerät. Die Trennung bleibt für Standardaktionen sinnvoll, kann eine solche bewusste Volladministration aber nicht in eine ungefährliche Aktion verwandeln. Die breite Fähigkeit ist deshalb ein eigener, zeitlich begrenzter Betriebsmodus. - -## 5 Verbindung und Nachrichtenprotokoll - -Der Agent verbindet sich zu einem festgelegten DNS-Namen der Plattform über TLS auf TCP 443. Der bevorzugte Kanal ist ein vom Agenten geöffneter WebSocket. Innerhalb dieser bereits bestehenden Verbindung können beide Seiten Nachrichten senden. Die Richtung des TCP-Verbindungsaufbaus bleibt immer vom Kundengerät zur Zentrale. - -Ein HTTPS-Long-Polling-Modus nutzt denselben logischen Nachrichtenvertrag. Der Agent fragt nach Arbeit, der Server hält die Antwort begrenzt offen und liefert bei Bedarf einen Auftrag. Dieser Modus ermöglicht Inventar und Jobs auch dort, wo WebSockets blockiert sind. Eine interaktive Konsole kann ohne brauchbaren Streamingkanal eingeschränkt oder nicht verfügbar sein; das Produkt muss diese Grenze anzeigen. - -HTTP/2 und gRPC sind für diesen äußeren Kanal keine Voraussetzung. Das reduziert die Abhängigkeit von fremden Proxys. Unternehmensproxy, Proxyanmeldung im Dienstkontext, Idle-Timeouts und Reconnect-Verhalten werden ausdrücklich getestet. Ein erlaubter ausgehender Port 443 beweist noch keine funktionierende Streamingverbindung. - -Für Agentidentitäten wird mTLS vorgesehen. Eine TLS-Inspection kann die direkte Clientzertifikatsprüfung verhindern. Die Betriebsanforderung ist dann eine passende Ausnahme für den Agentendpunkt. Long Polling löst eine solche Zertifikatsinkompatibilität nicht. Falls ein Kunde diese Ausnahme nicht bereitstellen kann, benötigt er einen ausdrücklich entworfenen und geprüften Alternativtransport; die Zertifikatsprüfung wird nicht deaktiviert. - -Pro Gerät regelt eine Verbindungsgeneration die aktive Zustellung. Nach Reconnect oder Transportwechsel erhält ein alter Kanal keine neuen Aufträge. Verspätete Ergebnisse werden weiterhin anhand der Job-ID korrekt verarbeitet. Widerruf beendet bestehende Kanäle oder sperrt sie durch regelmäßig erneuerte Autorisierung. Eine einmal erfolgreiche TLS-Anmeldung erlaubt keine unbegrenzt gültige Sitzung. - -Artefakte können über denselben erlaubten Verwaltungsendpunkt vermittelt werden. Direkte Objektspeicher-Downloads und Betriebssystemupdates aus Herstellerquellen benötigen zusätzliche erlaubte Ziele oder ein passendes lokales Repository. Diese Egress-Anforderungen gehören in die Installationsvoraussetzungen. - -### 5.1 Erstregistrierung und Identität - -1. Ein Administrator erstellt einen kurzlebigen Enrollment-Nachweis für genau einen Kunden und optional Standort und Gerätegruppe. -2. Der Agent erzeugt sein Schlüsselpaar lokal. Enrollment über serverauthentifiziertes TLS bindet den öffentlichen Schlüssel an eine neue Agentinstallation. -3. Der Server vergibt agent_id und ordnet eine asset_id zu. Ein Zertifikat oder vergleichbarer Gerätenachweis bestätigt diese Zuordnung. -4. Enrollment-Nachweise sind einmalig oder ausdrücklich mengenbegrenzt. Sie werden nach Verwendung verworfen und nicht in Golden Images gespeichert. -5. Gerätezertifikate rotieren frühzeitig. Lange offline gewesene Geräte erhalten einen geregelten Wiederaufnahmeprozess; ein abgelaufenes Zertifikat wird nicht dauerhaft toleriert. - -Private Geräteschlüssel werden mit Betriebssystemmechanismen geschützt, soweit möglich hardwaregestützt. Das Design setzt keinen TPM auf jedem Gerät voraus. Hostname, IP-Adresse, MAC-Adresse und Seriennummer sind Inventarmerkmale und keine alleinigen Authentifizierungsmerkmale. Widerrufene Agenten bekommen keine neuen Aufträge und können keine laufende Sitzung erneut öffnen. - -### 5.2 Nachrichten und Flusskontrolle - -Ein Nachrichtenumschlag enthält mindestens protocol_version, message_id, agent_id, enrollment_generation, boot_id, sequence, observed_at, payload_type und payload. Der Server ergänzt received_at und den authentifizierten Mandanten. Eine im Payload angegebene Kundenzuordnung wird nicht als Berechtigung übernommen. Schemaänderungen sind versioniert; neue Fähigkeiten werden vor Verwendung ausgehandelt. - -Der Server bestätigt dauerhafte Ereignisse erst nach beständiger Übernahme. Der Agent wiederholt unbestätigte Nachrichten; der Empfänger dedupliziert sie. Inventardeltas referenzieren eine Snapshotgeneration. Fehlt die Basis, fordert die Zentrale einen vollständigen Snapshot an. Ein Cursor für Logs oder Proxmox-Tasks wird erst nach bestätigter Speicherung weitergesetzt. - -Heartbeats und Auftragssteuerung erhalten Vorrang. Große Dateien, Logströme und interaktive Sitzungen verwenden eigene Kanäle oder begrenzte Teilströme. Größenlimits gelten vor und nach Dekompression. Backpressure, Ratenlimits je Kunde und Gerät, zufällig versetzte Intervalle sowie exponentieller Reconnect mit Jitter verhindern, dass ein Neustart der Zentrale sofort alle Clients gleichzeitig belastet. - -## 6 Datenmodell und Gerätezuordnung - -Der Begriff Asset bezeichnet die verwaltete Maschine oder Ressource. Eine Agentinstallation ist eine konkrete Softwareinstallation mit eigenem Schlüssel und Lebenszyklus. Diese Trennung erlaubt Neuinstallation, Proxmox-Discovery vor Agentinstallation und nachvollziehbare Geräteaustausche. Ein entdecktes Asset ohne Agent kann angezeigt, aber nicht über den Gastkanal verwaltet werden. - -| Entität | Wesentliche Informationen | -| --- | --- | -| Tenant und Site | Kunde, Standort, Zeitzone, Richtlinien und Kontakte | -| Asset | Stabile ID, Typ, Rolle, Kunde, Standort, Tags und Lebenszyklus | -| AgentInstallation | Assetbezug, Schlüsselfingerabdruck, Generation, Version und Capabilities | -| Observation und InventorySnapshot | Quelle, Erhebungszeit, Empfangszeit, Qualität und normalisierte Daten | -| SoftwareInstallation | Produkt, Version, Architektur, Quelle und Installationskontext | -| ServiceExpectation | Gewünschter Dienstzustand, zugehöriges Asset und Prüfregel | -| CheckResult und Incident | Messung, Zustand, Schwelle, Zeitverlauf und zusammengefasster Vorfall | -| VirtualizationRelation (optional; PVE nach MVP) | Gastidentität, gegebenenfalls Cluster/Host, Laufzeit und Herkunft; unbekannter Hypervisor/Host ist zulässig und beschränkt den Gastagenten nicht | -| BackupPolicy und BackupEvidence | Sollplan, Versuche, Snapshots, Abdeckung, Verify und Restoretests | -| OperationPlan und AuthorizationGrant | Festgelegte Ziele, Aktion, Artefakte, Planhash und Erlaubnis | -| ApprovalRequest und OperationExecution | Persistenter Genehmigungsantrag mit festen Jobdefinitionen; erst nach menschlicher Genehmigung ein Ausführungslauf mit Einzeljobs | -| Job und JobAttempt | Zustellung, Ausführung, Fristen, Sperren, Ergebnis und Nachbedingungen | -| RemoteSession und AuditEvent | Bediener, Ziel, Rechte, Laufzeit, Nachweise und Aufnahmeverweis | - -Relevante Tabellen besitzen tenant_id. Kundenbezogene Fremdschlüssel enthalten ebenfalls den Mandanten, damit eine Beziehung nicht versehentlich in einen fremden Kundenbestand zeigt. Aktuelle Inventarsicht und historische Beobachtungen werden getrennt gespeichert. Nicht vorhandene, nicht ermittelte, veraltete und fehlgeschlagene Daten sind verschiedene Zustände. - -Agenten in Vorlagen dürfen noch keine produktive Identität besitzen. Ein Klon führt ein neues Enrollment durch. Treffen zwei aktive Geräte mit demselben Schlüsselnachweis oder widersprüchlichen Maschinenmerkmalen auf, folgt eine Identitätsprüfung statt einer stillen Zusammenführung. Hardwaremerkmale sind Hinweise für diese Prüfung, keine sichere automatische Entscheidung. - -Eine Virtualisierungsbeziehung ist optional: Ein Gast mit Agent ohne bekannten Host ist vollständig verwaltbar, auch außerhalb von Proxmox. Nach dem MVP werden bekannte Proxmox-Gäste über Plattform-ID plus Providerverbindung, Cluster, Gasttyp, VMID und Lebenszyklus korreliert. Migration innerhalb eines Clusters ändert die Hostbeziehung. VMID-Wiederverwendung, Restore, Cross-Cluster-Migration und Klonen dürfen nicht allein anhand gleicher Nummern oder Namen zusammengeführt werden. Die optionale Zuordnung zum Gast-Agenten erhält Herkunft und bei Unsicherheit einen Prüfstatus. [^7] - -## 7 Inventarisierung und Datenerhebung - -Die folgenden Intervalle sind konfigurierbare Startwerte. Sie werden im Pilot anhand von Ressourcenverbrauch, Netzlast und Nutzen angepasst. Ereignisbasierte Änderungen ergänzen regelmäßige Erhebungen; ein vollständiger Abgleich korrigiert verlorene Deltas. - -| Bereich | Inhalt | Startwert | -| --- | --- | --- | -| Erreichbarkeit | Heartbeat, Agentversion, Uhrabweichung und letzter Kontakt | 30 Sekunden | -| Leistung | CPU, RAM, Swap, Netzwerk, Platten und I/O | 60 Sekunden | -| Erwartete Dienste | Vorhanden, Startart, Laufzustand und definierte Funktionsprüfung | 60 bis 120 Sekunden | -| Betriebssystem | Edition, Build, Architektur, Kernel, Bootzeit und Virtualisierung | Bei Start und täglich | -| Hardware und Datenträger | Hersteller, Modell, CPU, RAM, Volumes, Verschlüsselungsstatus, geeignete SMART Daten | Täglich und bei Änderung | -| Netzwerk | Adapter, Adressen, DNS und Routingmerkmale | Bei Änderung und alle 15 Minuten | -| Software | Installierte Pakete und Programme, Versionen und Installationskontext | Alle 6 bis 24 Stunden | -| Updatezustand | Installierte Updates, ausstehende Updates, Scanzeit, Fehler und Neustartbedarf | Alle 6 Stunden und nach Auftrag | -| Proxmox (nach MVP) | Lokaler Host, Gäste, Storage, Tasks und Clusterzustand | 1 bis 5 Minuten | -| Logs | Relevante Ereignisse oder begrenzte Auszüge mit Quelle und Cursor | Ereignisbasiert oder auf Anfrage | - -Für Speicherplatz werden sowohl freie Bytes als auch freie Prozentwerte erfasst. Auf Linux sind Inodes zusätzlich relevant. Eine aggregierte Prozentzahl über alle Laufwerke kann einen vollen Systemdatenträger verbergen. Bei Thin Provisioning werden Host-, Pool- und Gastsicht getrennt gehalten. - -Updateinventar benötigt mehrere Felder. Unter Windows gehören Updatehistorie, Ergebnisse des letzten Scans, vorhandene Updates und Neustartbedarf zusammen. Einzelne WMI-Abfragen liefern keinen vollständigen universellen Patchstatus. Unter Linux hängt belastbare Historie von Paketmanager und vorhandenen Logs ab. Fehlende Historie wird als unbekannt dargestellt; Dateizeitstempel werden nicht zu einem angeblich exakten letzten Updatezeitpunkt umgedeutet. - -Sicherheitsrelevante Zustände wie Firewall, Endpointschutz und Datenträgerverschlüsselung werden nur über unterstützte Provider erfasst. Prozessargumente, Umgebungsvariablen, private Dateien und Schlüssel werden nicht pauschal inventarisiert. Eine weitergehende Diagnose ist eine eigene, berechtigte Aktion mit definierter Datenmenge. - -## 8 Monitoring und Alarmierung - -Die Oberfläche führt drei Zustände getrennt: Verbindung zum Agenten, Frische der jeweiligen Datenquelle und fachliche Gesundheit. Eine laufende VM kann einen nicht erreichbaren Gast-Agenten enthalten. Ein erreichbarer Agent kann einen ausgefallenen Webdienst melden. Ein alter grüner Messwert darf nicht weiterhin als aktueller Erfolg erscheinen. - -Bei einem Heartbeat alle 30 Sekunden sind beispielsweise 90 Sekunden ohne Kontakt ein Warnsignal und 180 Sekunden ein Zustand nicht erreichbar. Das sind Richtlinienwerte, keine Feststellung, dass der Rechner ausgeschaltet ist. Gateway-Ausfall, Netzunterbrechung und ausgeschaltetes Gerät sehen aus der Zentrale zunächst ähnlich aus. Wiederholte alte Telemetrie darf die Präsenzanzeige nicht auffrischen. Der Server verwendet für die Verbindung seinen Empfangszeitpunkt und für Messdaten zusätzlich deren tatsächliche Erhebungszeit. - -Sollregeln werden je Kunde, Gerätegruppe oder Asset gesetzt: Ein Dienst muss laufen, ein lokaler HTTP-Check muss erfolgreich sein, eine Sicherung darf höchstens ein bestimmtes Alter haben oder ein Datenträger muss eine Reserve behalten. Diensterkennung allein legt noch keinen Sollzustand fest. Ein laufender Prozess beweist nicht die Funktion der Anwendung. - -Prüfergebnisse verwenden OK, Warnung, Kritisch, Unbekannt und Unterdrückt. Regeln besitzen Dauerbedingungen, Hysterese, Wartungsfenster und Wiederanlaufverzögerungen. Vorfälle werden dedupliziert; eine Standortstörung kann untergeordnete Meldungen zusammenfassen. Der ursprüngliche Messzustand bleibt erhalten, auch wenn Benachrichtigungen vorübergehend unterdrückt werden. - -Automatische Regeln dürfen Behebungspläne und persistente Genehmigungsanträge erzeugen, niemals selbst genehmigen oder ausführen. Jeder feste Job und jeder neue Versuch benötigt explizite menschliche WebUI-Genehmigung. Begrenzende Policies setzen Aktionsgrenzen, Wiederholungslimits und Abkühlzeiten, ersetzen aber keine Genehmigung. Ein Alarm löst keine unbegrenzte Schleife von KI-generierten Reparaturversuchen aus. Die Plattform selbst wird zusätzlich von einer unabhängigen externen Überwachung beobachtet. - -## 9 Proxmox und Backupbeobachtung - -**Ausbaustufe nach dem MVP:** Dieses gesamte Kapitel einschließlich PVE-/PBS-Client, Cluster- und Backupabnahmen ist keine MVP-Voraussetzung. Es ergänzt eigenständig verwaltbare Windows-/Linux-Agenten; weder eine Proxmox-VM noch ein Hostagent wird für deren Betrieb vorausgesetzt. Die folgenden Hostanforderungen gelten nur für ausdrücklich in diese spätere Integration aufgenommene PVE-Hosts. - -Auf jedem PVE-Host läuft der Linux-Agent mit Proxmox-Modul. Er fragt die bereits vorhandene lokale PVE-API ab und sendet seine Ergebnisse ausgehend zur Zentrale. PVE stellt die API über HTTPS auf Port 8006 bereit und kann clusterinterne Anfragen zwischen Knoten weiterleiten. Die vorhandene Proxmox-Clusterkommunikation ist von der RMM-Netzwerkanforderung zu unterscheiden. Die Zentrale baut keine neue Verbindung auf Port 8006 zum Kunden auf. [^8] - -Jeder Host meldet seine lokalen Daten. Clusterweite Inventar- und Planabfragen übernimmt jeweils ein dafür ausgewählter Collector mit zeitlich begrenzter Zuständigkeit und Generation. Eine überholte Collector-Generation darf die aktuelle Inventarsicht nicht überschreiben. Unveränderliche historische Taskereignisse dürfen weiterhin authentifiziert, geprüft und dedupliziert übernommen werden. Bestätigte Cursor werden pro Quelle zentral geführt; verworfene Daten dürfen keinen Cursor vorziehen. Ereignisse werden zusätzlich anhand von Quellkennung und Taskkennung dedupliziert. Diese Auswahl regelt die Datenerhebung, nicht eine automatische Übernahme administrativer Clusteraktionen. - -Erfasst werden Mitglieder und Quorum, HA-Zustände, PVE-Version, laufender Kernel, Gäste und Templates, Storage, ZFS oder Ceph soweit vorhanden, Ressourcenzuteilung und relevante Tasks. Eine reine API-Loginprobe genügt nicht als Funktionsprüfung: Der Connector muss auch fremd gestartete Tasks und deren Fehler sehen können. Berechtigungen werden gegen jede unterstützte PVE-Version getestet. [^9] - -Für lesende API-Zugriffe wird ein dedizierter Benutzer mit getrennt berechtigtem Token verwendet. PVEAuditor ist ein Ausgangspunkt, kein Ersatz für die Prüfung der konkret verwendeten Endpunkte. Schreibende Funktionen erhalten eigene Fähigkeiten und Rechte. Ein parallel erlaubter Root-Executor kann diese Tokenbegrenzung auf dem Host umgehen; die technische Grenze entsteht erst durch den getrennten und kontrollierten Administrationspfad. [^9] - -### 9.1 Backupnachweise - -Eine Backupübersicht beantwortet getrennt: War eine Sicherung fällig? Wurde sie versucht? War der einzelne Gast erfolgreich? Sind die benötigten Datenträger enthalten? Existiert der Snapshot noch? Ist seine Integrität geprüft? Gibt es einen erfolgreichen praktischen Restoretest? - -Die Plattform speichert geplante und effektive Gastauswahl, Taskkennung beziehungsweise UPID, Versuch und Ergebnis je Gast, Ziel, Dauer, Alter, ausgeschlossene Datenträger und Fehler. Eine fehlende Sicherung wird auch dann erkannt, wenn kein fehlgeschlagener Task existiert. Taskhistorie wird paginiert und inkrementell gesichert; die Plattform setzt keine unbegrenzte Historie auf dem Host voraus. - -Zusätzliche LXC-Mountpoints sind nicht automatisch vollständig im Backup enthalten. Bind- und Device-Mounts werden von PVE nicht als normale Container-Backupinhalte gesichert. Deshalb ist Abdeckung ein eigenes Prüffeld. Ein grüner Gesamtjob reicht als Nachweis nicht aus. [^10] - -### 9.2 Proxmox Backup Server - -PBS besitzt eine eigene API, eigene Rechte und eine eigene Datensicht. Für das strikte ausgehende Modell kann derselbe Linux-Agent mit PBS-Modul auf dem Backupserver laufen. Er meldet Datastores und Namespaces, Snapshotbestand, Verify-, Sync-, Prune- und GC-Zustände sowie Kapazität. Die Zentrale benötigt keinen direkten Zugriff auf PBS-Port 8007. - -Für Status und Auflistung reichen passende Audit-Rechte; ein Restore-fähiger DatastoreReader ist nicht automatisch erforderlich. Kunden- und Clusterzuordnung werden auch bei gemeinsamem PBS ausdrücklich gespeichert. [^11] Eine erfolgreiche PBS-Verifikation ist ein Integritätsnachweis innerhalb der Möglichkeiten des jeweiligen Backups. Ein Restoretest prüft zusätzlich Schlüsselverfügbarkeit, Start und Anwendungsfunktion. Diese Ergebnisse werden getrennt ausgewiesen. [^12] - -## 10 Aufträge und Softwareinstallation - -Jeder auszuführende Job, auch lesende Live-Diagnose, wird zunächst zu einem unveränderlichen Plan. Dieser enthält konkrete Geräte-IDs, feste Einzeljobs und Versuche, Aktion, normalisierte Parameter, Paket- oder Skriptversion, Artefakthash, erforderliche Ausführungsidentität, Vorbedingungen, Nachbedingungen, Wartungsfenster, maximale Laufzeit und Ablaufzeit. Eine dynamische Gruppe wird vor dem Speichern zu einer festen Zielmenge aufgelöst. Die menschliche WebUI-Freigabe bezieht sich ausschließlich auf diesen gespeicherten Plan; nachträglich hinzugekommene Geräte werden nicht ergänzt. Passive Standardtelemetrie und Lesen gespeicherter Daten sind keine Jobs. - -Der Server prüft Benutzerrechte und begrenzende Kundenrichtlinie. Richtlinien dürfen nur begrenzen oder verweigern. Genau dieser Plan benötigt stets eine konkrete menschliche Genehmigung in der WebUI; ein transparent angezeigtes Sammelpaket kann alle festen Einzeljobs gemeinsam genehmigen. Ändern sich Ziele, Parameter, Wirkung oder Versuch, entsteht ein neuer genehmigungspflichtiger Plan. Dauer-/Wildcardfreigaben sind verboten. Weder Modell noch MCP-/Automatisierungsidentität dürfen genehmigen. Rechteentzug und Gerätewechsel werden vor dem Start erneut geprüft. - -Die Prüfung findet bei Planung, Einreihung und unmittelbar vor dem Start statt. Ein kurzlebiger Ausführungsgrant bindet außerdem die Version der Kunden- und Gerätezuordnung. Rechteentzug sperrt neue Starts. Bereits laufende Installationen werden nur abgebrochen, wenn der Provider einen sicheren Abbruch unterstützt; andernfalls laufen sie kontrolliert zu Ende und das Ergebnis wird erfasst. Ein Paketmanager wird nicht pauschal hart beendet. Interaktive Sitzungen werden geschlossen. Ein Entzug macht bereits erfolgte Änderungen nicht rückgängig. - -```mermaid -flowchart TD - Plan["Unveränderlicher Plan"] --> Policy{"Berechtigung und Richtlinie"} - Policy -->|"zulässig, noch nicht genehmigt"| Request["Persistenter Antrag pending_approval"] - Policy -->|"verweigert"| Denied["Keine Ausführung"] - Request --> Approval["Menschliche WebUI-Planfreigabe"] - Approval --> Queue["Dauerhafte Ausführungsjobs und Outbox"] - Queue --> Accepted["Lokal journalisiert"] - Accepted --> Start{"Aktuelle Starterlaubnis"} - Start -->|"gültig"| Run["Ausführen und nachprüfen"] - Start -->|"Frist abgelaufen"| Expired["Abgelaufen"] - Run --> Success["Erfolg bestätigt"] - Run --> Failure["Fehler bekannt"] - Run --> Unknown["Wirkung unbekannt"] - Unknown --> Reconcile["Zustand abgleichen"] - Reconcile --> Success - Reconcile --> Failure -``` - -Das Diagramm zeigt den fachlichen Ablauf. Die vollständigen, normativen Jobzustände und Übergangsregeln stehen in Abschnitt 22. Freigabe, Netzwerkzustellung, Prozessstart und fachlicher Erfolg sind unterschiedliche Ereignisse. - -Planerstellung, Antrag und menschliche Freigabe sind getrennte dauerhafte Schritte. `operations.submit` speichert nur den Genehmigungsantrag (`pending_approval`), keine Ausführungsjobs oder ausführbare Outbox. Erst die WebUI-Genehmigung erzeugt atomar Genehmigungsnachweis, Ausführungslauf, feste Einzeljobs und Outbox-Einträge. Vor Ausführung wird die aktuelle Starterlaubnis erneut geprüft; Abschnitt 22 legt die Transaktionsgrenzen fest. Worker übernehmen ausschließlich genehmigte Arbeit mit transaktionaler Sperre und begrenzter Zuständigkeit. PostgreSQL unterstützt SKIP LOCKED für konkurrierende Verbraucher einer Warteschlangentabelle. Dies organisiert die Vergabe; es garantiert nicht genau eine Wirkung auf einem entfernten Betriebssystem. [^13] - -Der Agent bestätigt die Annahme erst nach Eintrag im lokalen dauerhaften Journal. job_id und Ausführungsidentität bleiben stabil. Ein wieder zugestellter Auftrag wird am Journal erkannt. Kollidierende Aktionen werden pro Ressource serialisiert, insbesondere Paketinstallationen, Reboots und Agentupdates. Eine Idempotenzkennung ist an Aufrufer, Mandant und Inhalt gebunden; gleicher Schlüssel mit geändertem Inhalt führt zu einem Fehler. - -**Zustellung und Wirkung sind verschieden:** Netzbedingt wird eine Nachricht möglicherweise mehrmals zugestellt. Eine beliebige Installation oder Shellaktion kann nicht atomar zusammen mit SQLite und der zentralen Datenbank bestätigt werden. Nach einem Absturz zwischen Wirkung und Ergebnis lautet der Zustand deshalb zunächst unbekannt. Ein Verlust der Zuständigkeit berechtigt keinen zweiten Worker, die Aktion blind erneut auszuführen. Idempotente API-Verträge verlangen genau diese bewusste Behandlung von Wiederholungen. [^14] - -Vor einer Wiederholung wird der tatsächliche Zustand abgeglichen. Ein Auftrag ensure_package mit fester Version lässt sich über das installierte Produkt prüfen. Separate Diagnosejobs für den Abgleich benötigen ebenfalls menschliche Genehmigung; Lesen gespeicherter Nachweise nicht. Ein neuer Ausführungsversuch benötigt stets einen neuen menschlich genehmigten Plan. Erneute Zustellung desselben Versuchs benötigt keine neue Genehmigung und darf keine zweite Wirkung auslösen. Nach Snapshot-Restore synchronisiert der Agent seine Generation und Auftragslage mit der Zentrale, bevor neue Jobs beginnen. - -Ein Installationsjob besteht aus Prüfung, Paketbezug, Herkunfts- und Hashprüfung, Ausführung, Erfassung des Ergebnisses und gebundener Nachprüfung der installierten Version. Ein Installer-Exitcode allein ist nicht immer ein Erfolgsbeleg. Neustartbedarf ist ein eigener Zustand. Ein erforderlicher Reboot ist ein eigener menschlich zu genehmigender Folgejob mit Wiederanmeldung und Nachprüfung; er darf im ursprünglichen transparenten Sammelpaket bereits als fester Einzeljob enthalten sein, nicht als pauschale Folgeerlaubnis. - -Während einer laufenden Installation darf eine Netzwerkunterbrechung den Installer nicht automatisch abbrechen. Ergebnisse werden lokal gepuffert und später übermittelt. Vor dem Start abgelaufene Aufträge werden verworfen. Abbrechen bedeutet zunächst Abbruch angefordert; der Executor meldet, ob ein sicherer Abbruch möglich war. Ein Abbruch ist keine allgemeine Rollbackzusage. Rollouts erfolgen in Gruppen mit Testgeräten, Parallelitätsgrenzen und Abbruchschwellen. - -## 11 Shell und Bereitstellung von RustDesk - -Für viele Verwaltungsaufgaben genügen strukturierte Jobs: Dienststatus live lesen, Logs erheben, Software installieren, Updates anwenden und Neustarts planen. Jeder dieser Jobs benötigt menschliche WebUI-Genehmigung. Für offene Diagnose steht später eine interaktive Sitzung zur Verfügung. Der Nutzer wählt Gerät und Berechtigungsstufe; erst nach expliziter menschlicher WebUI-Genehmigung des konkreten Sitzungsplans stellt der Server ein kurzlebiges, an Nutzer, Gerät, Plan und Sitzung gebundenes Ticket aus. Eine Sitzung ist keine Dauerfreigabe für neue strukturierte Jobs. - -Der Agent erhält das Ticket über seinen ausgehenden Steuerkanal und öffnet anschließend ausgehend einen separaten Stream zum Relay. Lokal startet er die zugelassene Shell, unter Linux über ein PTY und unter unterstützten Windows-Versionen beispielsweise über ConPTY mit PowerShell. Das Relay vermittelt Ein- und Ausgabe zur Weboberfläche. Resize, EOF, Prozessende und Signalbehandlung gehören zum Sitzungsprotokoll. - -Sitzungen besitzen Höchstdauer, Leerlaufzeit, explizite Beendigung, aktive Widerrufskontrolle und nachvollziehbare Zuordnung. Ein verlorener Browserkontakt beendet eine privilegierte Sitzung nach definierter kurzer Frist. Aufzeichnungen können vertrauliche Daten enthalten und erhalten eigene Zugriffsrechte und Aufbewahrungsregeln. Die Verbindung wird im ersten Entwurf am Relay terminiert; das Relay gehört somit zur Vertrauensgrenze. Echte Ende-zu-Ende-Verschlüsselung würde zentrale Aufzeichnung und Inspektion verändern. - -Für grafische Zugriffe stellt die Plattform RustDesk auf den gewünschten PCs bereit. Sie implementiert keine Bildschirmübertragung, Maussteuerung oder eingebettete Desktop-Engine. Der Nutzer verbindet sich anschließend über seinen RustDesk-Client. RustDesk dokumentiert die automatisierte Verteilung und das Anwenden von Serverkonfigurationen über Skripte beziehungsweise --config. [^15] - -Ein versioniertes RustDeskConfigProfile gehört einem Kunden oder einer Gerätegruppe. Es enthält die freigegebene Paketversion, den ID-Server, gegebenenfalls Relay- und API-Server, den öffentlichen Serverschlüssel sowie die gewünschten Zugriffsregeln. Zugangsdaten werden als geschützte Secret-Referenzen geführt und nicht in normale Jobausgaben oder LLM-Kontexte geschrieben. Bestehende kundenspezifische Einstellungen werden nur gemäß dem gewählten Profil geändert. Ein wiederholter Auftrag gleicht den Sollzustand ab und setzt Zugangsdaten nicht unbeabsichtigt zurück. - -Die typisierte Aktion ensure_rustdesk prüft Betriebssystem und Architektur, installiert das passende Paket, richtet bei Bedarf den Systemdienst ein und wendet die Konfiguration im tatsächlich genutzten Dienst- und Benutzerkontext an. Anschließend meldet der Agent Version, RustDesk-ID, Dienstzustand und angewendete Profilversion. Installiert, konfiguriert und für eine Verbindung erreichbar bleiben getrennte Nachweise. Ein Praxistest belegt die Verbindung mit dem vorgesehenen RustDesk-Client; ein laufender Dienst allein genügt dafür nicht. Die Abnahme prüft außerdem den Zustand nach einem Rechnerneustart. - -RustDesk verwendet seine eigene Verbindungsinfrastruktur. Seine Verbindungen werden nicht automatisch durch den RMM-Agentkanal transportiert. Für strikt ausgehenden Betrieb wird ein getesteter Relaymodus vorgesehen. Eine Beschränkung auf Port 443 erfordert eine dafür geeignete Kombination aus RustDesk-Client, Serveredition, Version und WSS-Konfiguration. Diese Voraussetzungen werden ausdrücklich geprüft; die Eigenschaft des RMM-Kanals wird nicht pauschal auf RustDesk übertragen. Die offizielle Dokumentation beschreibt einen WSS-Relaybetrieb über TCP 443. [^22] - -Dateitransfer erhält einen eigenen autorisierten Vorgang mit Pfadgrenzen, Größenlimits und Hashkontrolle. Portweiterleitungen sind ausschließlich für konkret freigegebene Ziele und Laufzeiten zulässig. Ein allgemeiner Tunnel ins gesamte Kundennetz gehört nicht zum Standardprofil. Ein ausgeschaltetes oder vollständig isoliertes Gerät kann über seinen Agenten keine Aufträge ausführen; Out-of-Band-Management wäre eine gesonderte Integration. - -## 12 MCP und Steuerung durch KI - -MCP wird am zentralen Server über HTTPS angeboten. Der Agentkanal bleibt ein eigenständiges Protokoll. Ein MCP-Aufruf kann einen dauerhaften Genehmigungsantrag erzeugen und dessen `operation_id` mit `pending_approval` zurückgeben, aber keinen Job vor menschlicher WebUI-Genehmigung starten. Genehmigte Jobs laufen unabhängig von der KI-Unterhaltung. Bei einem Modell- oder MCP-Ausfall funktionieren Weboberfläche, Monitoring und laufende Jobs weiter. - -Der MCP-Adapter verwendet rmcp und Streamable HTTP. SDK, Protokollversion und unterstützte KI-Clients werden gemeinsam festgelegt und im Repository dokumentiert. Transport- und Sessionverhalten richten sich nach genau diesem geprüften Profil; verschiedene Protokollstände dürfen nicht unbemerkt vermischt werden. Persistente RMM-Jobs bleiben unabhängig vom MCP-Transport Anwendungsdaten. [^2][^16] - -| MCP Werkzeug | Aufgabe | -| --- | --- | -| tenants.list | Für die Identität sichtbare Kunden eindeutig auflösen | -| inventory.list_devices | Berechtigte Geräte eines Kunden mit Filtern und Pagination liefern | -| inventory.get_device | Inventar, Quelle, Erhebungszeit und Datenalter eines Geräts liefern | -| monitoring.get_health | Probleme und begrenzte Metrikverläufe abrufen | -| logs.query | Gespeicherte erlaubte Logs lesen; Live-Erhebung als genehmigungspflichtigen Diagnoseplan beantragen | -| operations.plan | Paket, Dienstaktion, Update oder Skript als Plan vorbereiten; RustDesk mit Profil nur spätere optionale Erweiterung, keine MVP-Schnittstellenpflicht | -| operations.submit | Plan als dauerhaften Antrag `pending_approval` einstellen; keine Ausführungsqueue erzeugen | -| jobs.get | Antrag inklusive `pending_approval`, spätere Ausführung, Fortschritt und Ergebnis abfragen | -| jobs.cancel | Abbruch anfordern und dessen tatsächlichen Ausgang anzeigen | -| sessions.request | Eine zeitlich begrenzte privilegierte Sitzung beantragen | - -Ein Tool mit beliebigem Shelltext ist kein Standardwerkzeug für alle KI-Aufgaben. Freie Skripte sind möglich, besitzen aber eine eigene Berechtigung, feste Skriptbytes, einen Hash und eine dazu passende Richtlinie. Die Werkzeuge liefern strukturierte Ergebnisse mit Datenalter, Vollständigkeit und Fehlern. Fachliche Begrenzungen werden serverseitig geprüft; Toolbeschreibungen allein sind keine Autorisierung. - -Damit sind Sammelaufträge wie ein Neustart ausgewählter Server oder Hello World ausdrücklich vorgesehen, stets erst nach menschlicher WebUI-Genehmigung. Das LLM erzeugt passende PowerShell- und Shellvarianten. Der Plan bindet Inhalt und Interpreter an feste Zielgeräte und Einzeljobs. Die WebUI zeigt Zielanzahl, Inhalte/Hashes und Auswirkungen vor der Sammelgenehmigung. Die Plattform meldet Ausgabe und Ergebnis je Gerät. Neustarts können gestaffelt werden. Offlinegeräte führen nur bereits genehmigte Jobs nach Wiederverbindung aus, sofern Freigabe und Frist weiterhin gelten. - -### 12.1 Autonomie im Alltag - -| Stufe | Beispiel | Ausführung | -| --- | --- | --- | -| Lesen | Bereits gespeicherte Geräte-/Logdaten lesen | Innerhalb der Leserechte ohne Einzelgenehmigung; passive Standardtelemetrie ebenfalls kein Job | -| Diagnose | Live-Logfenster oder Diagnoseplaybook ausführen | Jeder Job erst nach menschlicher WebUI-Genehmigung des festen Plans | -| Standardänderung | Paket auf einer festen Gerätemenge installieren | Jeder Job erst nach menschlicher WebUI-Genehmigung; Sammelpaket möglich | -| Erweiterte Administration | SYSTEM-Sitzung, Reboot oder Massenänderung | Eigene Berechtigung und konkrete menschliche WebUI-Genehmigung; Policies begrenzen nur | - -Richtlinien begrenzen nicht nur einen einzelnen Toolaufruf, sondern auch aufsummierte Aktionen: beispielsweise maximale Gerätezahl pro Stunde, Anzahl Neustarts, Laufzeit und Fehlerquote. Sonst könnte eine Folge kleiner Aufträge eine Grenze für Massenänderungen umgehen. Globale, kundenbezogene und gerätespezifische Stopps können neue Änderungen sperren. - -Beispiel: „Installiere das Monitoringwerkzeug auf Server X bei Kunde A“ wird auf eine eindeutige asset_id aufgelöst. Der Server ermittelt Paket, Version, Rezept und gespeicherten Zustand, erstellt den festen Plan und prüft begrenzende Policies. MCP stellt einen Antrag `pending_approval`. Erst nach menschlicher WebUI-Genehmigung erfolgt die Ausführung. Die KI berichtet nur den tatsächlich bestätigten Zustand einschließlich Neustartbedarf oder unbekanntem Ergebnis. Bei mehreren passenden Servern wird die Auswahl geklärt; eine zusätzliche Live-Diagnose benötigt selbst Genehmigung. - -### 12.2 Identität und nicht vertrauenswürdige Daten - -MCP verwendet den authentifizierten Nutzer oder eine ausdrücklich eingerichtete Automatisierungsidentität. Token werden auf Aussteller, Signatur beziehungsweise Gültigkeit, Ablauf und Zielressource geprüft. Scope und Kundenmitgliedschaft werden kombiniert. MCP-Token werden nicht als allgemeine Zugangsdaten an Kundensysteme weitergereicht. Die MCP-Spezifikation verlangt eine Prüfung der vorgesehenen Token-Audience. [^17] - -Logzeilen, Dateiinhalte und Paketbeschreibungen können manipulierte Anweisungen enthalten. Sie bleiben Daten, auch wenn sie durch einen eigenen Agenten geliefert werden. Nachfolgende Toolaufrufe werden unabhängig davon autorisiert. Filter und eine Anweisung an das Modell, Logs nicht zu befolgen, sind zusätzliche Hilfen, aber keine Sicherheitsgrenze. [^18] - -Das System sendet standardmäßig nur benötigte Ausschnitte an ein Modell. Rohdatenzugriff und die Erlaubnis zur Weitergabe an einen externen KI-Anbieter sind unterschiedliche Rechte. Anbieter, erlaubte Datenkategorien, Aufbewahrung und regionale Anforderungen werden je Kunde konfiguriert. Die Zentrale gibt dem Modell weder allgemeine Root-Zugangsdaten noch einen unbeschränkten Secret-Lesezugang. - -## 13 Mandanten und Schutz der Verwaltungsfunktionen - -Kundenrechte werden bei jedem Zugriff auf Asset, Job, Plan, Logobjekt und Sitzung geprüft. Die Kenntnis einer UUID reicht nicht als Zugriffserlaubnis. Ein angefragter tenant_id ist ein Filterwunsch; der authentifizierte Kontext entscheidet über die zulässige Menge. Rollen können Lesen, Operator, Freigeber, Kundenadministrator und Plattformbetrieb unterscheiden und zusätzlich auf Gerätegruppen eingeschränkt werden. - -PostgreSQL Row Level Security bildet eine zusätzliche Barriere. Die Anwendung nutzt eine Rolle ohne Superuser- oder BYPASSRLS-Rechte und besitzt die Tabellen nicht. Der Kundenzustand wird innerhalb jeder Transaktion gesetzt und bei Connection-Pooling nicht zwischen Anfragen weiterverwendet. Migrationen besitzen eine separate Identität. RLS-Regeln berücksichtigen USING und WITH CHECK; Tests müssen auch Hintergrundjobs, Exporte und Fehlerpfade erfassen. PostgreSQL dokumentiert ausdrücklich Ausnahmen für Eigentümer und privilegierte Rollen. [^19] - -Bei gemeinsam genutzten Hypervisoren gehört die Host- und Clustersicht einem Infrastrukturmandanten des Dienstleisters. Einzelne Gäste können anderen Kunden gehören. Ein eng berechtigter Zuordnungsdienst erzeugt daraus die freigegebenen Kundensichten anhand expliziter Zuweisungen. Kundennutzer sehen weder vollständige Hostinventare noch Namen oder Daten benachbarter Gäste. Neue und unklare Gäste bleiben zunächst unzugeordnet. Historische Zuordnungen erhalten Gültigkeitszeiträume. - -Bei einem Kundenwechsel wird die historische Kundenzugehörigkeit nicht pauschal überschrieben. Bestehende Historie bleibt nach festgelegter Aufbewahrungsregel beim bisherigen Mandanten; neue Beobachtungen und Rechte folgen der neuen Zuweisung. Fehlender Mandantenkontext bedeutet in Datenbank, Worker und Metrikabfrage immer verweigerten Zugriff. - -Ein Gast-Agent darf nur sein eigenes Gerät melden. Ein Proxmox-Collector erhält eine separat registrierte Quellberechtigung für seinen Cluster. Selbst ein gültig authentifizierter Host darf keine beliebigen fremden Assets oder Mandanten in seinem Payload behaupten. Für schreibende Hypervisoraktionen wird das konkrete Gastziel zusätzlich anhand des aktuellen Mappings überprüft. - -Aufträge werden mit manipulationsgeschützten Autorisierungsnachweisen an Planhash, Ziel, Aktion, Frist und Gerätegeneration gebunden. Signierschlüssel für Agentsoftware, Geräteidentitäten und administrative Aufträge sind getrennt. Ein kompromittierter Netzwerkgateway soll allein weder neue Agentsoftware signieren noch eine beliebige privilegierte Aktion freigeben können. Offline befindliche Geräte sehen einen zentralen Widerruf erst wieder bei Kontakt; kurze Grant-Laufzeiten und erneute Startprüfung begrenzen dieses Fenster. - -Audits enthalten tatsächlichen Bediener, Automatisierungsidentität, Kunde, Gerät, Planhash, Richtlinienentscheidung, Ausführungsidentität und überprüftes Ergebnis. Secrets werden redigiert. Für kritische Vorgänge werden Kopien mit getrennten Schreib- und Löschrechten aufbewahrt. Eine veränderbare SQL-Tabelle allein begründet keine manipulationssichere Historie. Ein kompromittierter Agent kann trotz Authentisierung über seinen lokalen Zustand lügen; das System darf daraus keinen unabhängigen Sicherheitsbeweis ableiten. - -## 14 Oberfläche und Bedienung - -Die MVP-Startseite zeigt den authentisierten Gerätebestand nach Kapitel 0.7. Die Bedienwege für Skripte, Aufträge und Genehmigungen stehen in Kapitel 0.8. Für eine spätere Betriebsübersicht sind offene Vorfälle, Erreichbarkeit, veraltete Daten, Updateprobleme und Backupabweichungen vorgesehen. Ein Kunde führt zu Standorten und Geräten. Die Geräteseite enthält Überblick, Inventar, Messwerte, Dienste, Software, Updates, Logs, Aufträge, Sitzungen und Änderungshistorie. Jede Anzeige besitzt einen erkennbaren Erhebungszeitpunkt. - -Nach dem MVP zeigt die optionale Proxmox-Ansicht Cluster, Hosts, VMs und LXC-Container mit getrennten Zuständen für Hypervisor, Gast-Agent und Anwendung. Spätere Backupansichten unterscheiden fehlende Sicherungen, gescheiterte Versuche, Integritätsprüfung und praktischen Restore. Im MVP und danach darf eine fehlende Hostbeziehung keine Gastverwaltung sperren; ein Konnektivitätsproblem der Plattform wird nicht als bestätigter Geräteausfall ausgegeben. - -Die Geräteseite zeigt bei bereitgestelltem RustDesk zusätzlich dessen ID, Version, Dienstzustand und Konfigurationsprofil. Diese Angaben unterstützen den Wechsel in den separaten RustDesk-Client. Der eigene Sitzungsbereich bleibt auf administrative Terminalfunktionen beschränkt. - -Vor jeder Jobgenehmigung zeigt die WebUI den unveränderlichen Plan, sämtliche festen Einzeljobs/Versuche, Zielanzahl und Zielgeräte, Aktion, Interpreter/Provider, Skript-/Paketbyteshash, Paket-/Skriptversion, Rechte, Fristen, mögliche Neustarts und Nachprüfung. Große Sammelpakete bleiben vollständig einsehbar, nicht nur als Anzahl. Ein berechtigter interaktiv angemeldeter Mensch genehmigt explizit diesen Plan; Policyentscheidungen sind nur zusätzliche Begrenzungen. Bei Massenauswahl bleibt die Zielmenge als Snapshot erhalten. Anträge zeigen `pending_approval`; erst danach liefern Ausführungsjobs Fortschritt und Ergebnisse unabhängig vom Browserfenster. - -Für die optionale Zuordnung verkaufter Dienste wird später ein BusinessService mit Kunde, Owner, Vertragsbezug und Abhängigkeiten ergänzt. Eine Betriebsprüfung wie „nginx soll laufen“ bleibt eine technische ServiceExpectation. Beide können verbunden werden, haben aber unterschiedliche Lebenszyklen. Das verhindert, dass Dienstüberwachung von einer noch nicht benötigten Vertragsverwaltung abhängig wird. - -## 15 Speicherung und Größenordnung - -PostgreSQL speichert Inventar, Beziehungen, Regeln, Aufträge und Auditmetadaten. Größere Binärdaten und Ausgaben liegen verschlüsselt in einem S3-kompatiblen Objektspeicher. Downloads werden nach erneuter Objektberechtigungsprüfung vermittelt oder mit kurzlebigen, eng gebundenen Downloadrechten ausgegeben. Objektpfad oder Dateiname allein stellen keine Mandantengrenze dar. - -Zeitreihen erhalten einen getrennten Speicherzugriff. Für eine kleine technische Pilotierung sind partitionierte PostgreSQL-Messwerttabellen möglich. Für den vorgesehenen laufenden Produktivbetrieb wird VictoriaMetrics als eigener Messwertdienst empfohlen. Dadurch verdrängen hohe Messraten nicht die Latenz der Auftragsverwaltung. Die Empfehlung ist eine Architekturabwägung und keine Benchmarkzusage. - -VictoriaMetrics Single Node bietet nicht dieselbe native Mandantenverwaltung wie die Clustervariante; eine Trennung kann dort über erzwungene Labels und einen vorgeschalteten Zugriffsdienst erfolgen. Im Entwurf bleiben alle Datenbankendpunkte intern. Der Rust-Dienst setzt das Kundenlabel beim Schreiben aus der authentifizierten Zuordnung und erzwingt es bei jedem Lesen. Browser und MCP erhalten nur definierte Metrikabfragen, keine beliebigen PromQL-, Metadaten- oder Exportzugänge. Für eine strengere Datenbankgrenze kommen die Cluster-Mandantenfunktion oder getrennte Speicherinstanzen zum Einsatz. [^20] - -Eine Beispielrechnung zeigt die Größenordnung: 1.000 Geräte mit 40 Werten pro Minute erzeugen 57,6 Millionen Messpunkte pro Tag. Bei 10.000 Geräten sind es 576 Millionen. Bei einem Heartbeat je 30 Sekunden ergeben sich ungefähr 33 beziehungsweise 333 Heartbeats pro Sekunde. Das sind arithmetische Lastszenarien; Speicherbedarf und Hardware hängen zusätzlich von Labels, Kompression, Aufbewahrung und Abfragen ab. - -Hohe Kardinalität wird begrenzt: Prozess-IDs, freie Dateipfade, Logtexte und unbeschränkte frei wählbare Tags sind keine geeigneten dauerhaften Metriklabels. Per-Disk- und Per-Interface-Daten erhalten kontrollierte Dimensionen. Abfragen begrenzen Zeitraum, Ergebnisgröße und Auflösung. Kundenquoten verhindern, dass eine einzelne Installation die Plattform mit Messwerten oder Logs überlastet. - -Als Startpolitik sind beispielsweise 30 Tage Rohmetriken und länger gespeicherte stündliche Zusammenfassungen sinnvoll. Langzeitaggregate werden ausdrücklich über einen Aggregationspfad oder eine dafür geeignete Produktfunktion erzeugt; kostenlose automatische Verdichtung wird nicht vorausgesetzt. Inventarhistorie, Logs, Audits und Aufzeichnungen erhalten unterschiedliche, kundenbezogene Aufbewahrungsregeln. Rohlogs werden überwiegend lokal gehalten und anlassbezogen abgefragt. - -Der lokale Offlinepuffer hat feste Größen- und Altersgrenzen. Bei Platzmangel werden ältere unkritische Messwerte verdichtet oder verworfen, bevor Betriebssystem oder Jobjournal gefährdet sind. Ein Geräteausfall darf nicht durch ein unbegrenztes Telemetrieverzeichnis verursacht werden. Verlorene Messwerte und unvollständige Zeitfenster werden sichtbar ausgewiesen. - -## 16 Betrieb und Aktualisierung - -Die Pilotbereitstellung besteht aus einem kontrollierten HTTPS-Eingang, Rust-Diensten, PostgreSQL und gegebenenfalls Messwert- und Objektspeicher auf einer zentralen Umgebung. Ein OIDC-fähiger Identitätsanbieter liefert Anmeldung und Mehrfaktorauthentisierung für Administratoren. Exponiert werden nur die benötigten HTTPS-Endpunkte für Bedienung, MCP, Enrollment, Agenten und Sitzungen. Datenbanken und interne Verwaltungsports bleiben im privaten Betriebsnetz. - -Für verlässlichen Produktivbetrieb werden Gateway und API mehrfach bereitgestellt, Worker redundant ausgeführt und Datenbankausfallsicherheit sowie Wiederherstellung geplant. Langlebige Verbindungen bleiben einem Gateway zugeordnet; nach dessen Ausfall verbinden sich Agenten mit Jitter erneut. Laufende Agentjobs können unabhängig davon weiterlaufen. Ein Sitzungsabbruch wird sichtbar behandelt, statt eine transparente Wiederaufnahme einer privilegierten Shell zu versprechen. - -Ein anfängliches Betriebsziel kann sein, nach Verlust der zentralen Umgebung innerhalb von vier Stunden wieder betriebsfähig zu werden und höchstens 15 Minuten Stammdatenänderungen zu verlieren. Diese RTO- und RPO-Werte sind zu vereinbarende Ziele. Für Aufträge wird unabhängig davon Restore-Abgleich verlangt: Ein älterer Datenbankstand darf keine bereits ausgeführten Änderungen erneut auslösen. Nach Wiederherstellung startet die Plattform zunächst mit gesperrten Änderungen, gleicht Journale und Generationen ab und öffnet die Ausführung kontrolliert. - -Backups umfassen Datenbank, Objektdaten, Konfiguration und den gesondert gesicherten Schlüsselbestand. Wiederherstellungstests überprüfen auch das erneute Authentisieren vorhandener Agenten. Schlüsselverlust, kompromittierte Signierschlüssel und lange offline gebliebene Geräte benötigen dokumentierte Recovery-Verfahren. Die Alarmierung der Plattform selbst nutzt einen unabhängigen Kommunikationsweg. - -Agentupdates sind signiert, nach Betriebssystem und Architektur getrennt und werden zunächst an Testgeräte verteilt. Ein kleiner Updater prüft Manifest, Version, Hash und Signatur, installiert atomar soweit plattformspezifisch möglich und testet den neuen Dienst. Ein fehlerhafter Start erlaubt die Rückkehr auf eine zulässige letzte Version. Ein Schutz gegen das Einspielen beliebiger veralteter Versionen bleibt bestehen. Rotation und Widerruf von Updateschlüsseln werden von Beginn an berücksichtigt; TUF beschreibt die relevanten Angriffe auf Updatekanäle. [^21] - -CI prüft Rust-Abhängigkeiten und erzeugt reproduzierbar nachvollziehbare Pakete, Herkunftsnachweise und eine Komponentenliste. Native Windows-Tests laufen auf Windows, Linux-Pakettests auf passenden Systemen. PVE- und ARM64-Tests werden erst in ihrer Ausbaustufe verpflichtend, nicht für das MVP. Protokoll- und Datenbankmigrationen unterstützen überlappende Server- und Agentversionen. Die konkrete Kompatibilitätsdauer wird veröffentlicht. Ein Kunde wird nicht durch ein zentrales Update gezwungen, alle Geräte gleichzeitig zu aktualisieren. - -## 17 Umsetzung in überprüfbaren Schritten - -| Schritt | Inhalt | Abnahmekriterium | -| --- | --- | --- | -| 1 Technische Grundlagen | Zuerst Linux-Dienst auf tatsächlicher Test-VM, Enrollment, Zertifikate, WSS und Long Polling | Reale VM-Verbindung hinter NAT, Rotation und Widerruf; Proxyabnahmen je bereitgestellter Umgebung | -| 2 Lesendes Produkt | Kunden, Standorte, Inventar, Präsenz, Metriken und Sollprüfungen | Geräteansichten zeigen korrekte Quellen und Datenalter; Mandantentests bestehen | -| 3 Kontrollierte Verwaltung (MVP) | Planbindung, begrenzende Policies, WebUI-Genehmigung gemäß 0.1, Startgrants, dauerhafte Jobs, Paketkatalog, Dienste, Logs und MCP Lesen; ohne RustDesk | Jeder Job erst nach UI-Genehmigung; keine blinden Doppelaktionen; keine RustDesk-Abnahme | -| 4 MCP und Sammelaktionen (Linux-MVP-Abschluss) | MCP plant und beantragt auf derselben Strecke; eigenständiger Linux-Agent x86-64 | Alle Features zuerst auf realer Linux-VM; Sammelpakete erst nach menschlicher WebUI-Genehmigung; unbekannter Hypervisor blockiert keinen Gast | -| 4b Windows nach Linux-MVP | Windows-x86-64-Adapter und M0–M5-Capabilities portieren | Native Windows-Dienst-/Installer-/Mischplattformabnahmen erst nach Linux-MVP-Abnahme | -| 5 Erweiterungen noch später | Monitoringausbau, ARM64 sowie separat PVE-/PBS-Modul, Cluster und Backups nach Windows-Phase | Native ARM64-Tests; eigene spätere PVE-/Backup-/Clusterabnahmen | -| 6 Sitzungen und Betriebsreife nach MVP | Terminal, gestaffelte Agentupdates, Restoreverfahren und Hochverfügbarkeit | Menschlich genehmigte Sitzungen; Abbruch/Rechteentzug wirken; Plattformrestore praktisch getestet | -| 7 Optionale Erweiterung | Business Services und weitere Paketprovider | Zuordnung verkaufter Leistungen und zusätzliche geprüfte Installationsrezepte | - -Linux-Paketrezepte werden in ihrer Linux-Phase auf Dienstkontext und wirksame Konfiguration geprüft. RustDesk-Rezepte sind aus dieser Umsetzung ausgeschlossen und bleiben spätere optionale Integration. Windows-Installer folgen erst nach Linux-MVP-Abnahme. PVE-Implementierung/-Abnahme folgt noch später nach der Windows-Phase und erzeugt keine PVE-Testumgebungspflicht für eigenständige Agenten. - -Abnahmen werden der jeweiligen Ausbaustufe zugeordnet: Im MVP sind insbesondere fehlende menschliche Genehmigung, Agentabsturz nach Installerstart, verlorene Bestätigung, Fristen, Klonidentität, fremder Jobzugriff, manipulierter Loginhalt und Server-/Gatewaywiederanlauf zu prüfen. VM-Migration, VMID-Wiederverwendung, Cluster und Backupabdeckung gehören ausschließlich zur späteren PVE-Stufe; Plattformrestore und signierte Agentupdates zur Betriebsreife. Der Nachweis ist jeweils die erwartete Reaktion, nicht allein der Normalfall. - -Lasttests verwenden die zuvor genannten Gerätemengen mit realistischer Metrikkardinalität, Verbindungsabbrüchen, erneut ankommenden Puffern und Massenausführung. Erst daraus werden Hardware, Grenzen und Hochverfügbarkeit abgeleitet. Testziele für Agent-CPU, RAM, Disk und Einfluss auf Hostdienste werden vor dem Pilot vereinbart und dort gemessen. - -## 18 Startentscheidungen und konfigurierbare Betriebsdaten - -Die Entwicklung kann ohne weitere Produktentscheidung beginnen. Konkrete Kundenzugangsdaten, Domains und vorhandene Infrastruktur werden später als Konfiguration eingesetzt. Fehlende Werte sperren ausschließlich die betroffene Integration und erscheinen als `not_configured`; sie werden nicht erfunden. - -| Bereich | Verbindlicher Startentscheid | -| --- | --- | -| Architektur | Modularer Monolith mit getrennt startbaren Rollen API, Gateway, Worker und später Relay. Keine zusätzliche Brokerpflicht. | -| Backend und Agenten | Rust; kompatible stabile Toolchain beim Bootstrap prüfen und anschließend exakt in `rust-toolchain.toml` festschreiben; `Cargo.lock` einchecken. | -| API und UI | HTTP JSON unter `/api/v1`; React/TypeScript; REST-Schemas und TypeScript-Typen aus denselben Verträgen ableiten. | -| Agenttransport | Protobuf über ausgehendes WSS, zusätzlich HTTPS Long Polling; TLS 443 und mTLS nach Enrollment. | -| MCP | rmcp und ein ausdrücklich getestetes Streamable-HTTP-Profil unter `/mcp`; SDK- und Protokollversion festhalten. | -| Daten | PostgreSQL für Stammdaten, Jobs, Inventar und Auditmetadaten. Für den ersten technischen Abschnitt nur begrenzte Testmetriken in PostgreSQL; vor produktivem Metrikbetrieb VictoriaMetrics über den Zugriffsdienst integrieren. | -| Artefakte | Ein `ArtifactStore`-Vertrag; Dateisystemadapter ausschließlich im lokalen Entwicklungsprofil, S3-kompatibler Adapter für Produktion. Keine lokal gespeicherten Artefakte in der Cloud-DB als Base64. | -| Anmeldung | OIDC mit validiertem Aussteller und Audience; lokale Testidentitäten ausschließlich in einem expliziten Entwicklungsprofil. Produktion darf mit diesem Profil nicht starten. | -| Mandanten | Zwei getrennte Testkunden von Anfang an; getrennte Infrastrukturzuordnung für gemeinsam betriebene Hosts. | -| Erste Linux-Paketfamilie | APT/dpkg auf einer dokumentierten, tatsächlich verfügbaren Debian-/Ubuntu-Testmatrix. Andere Paketfamilien werden als nicht unterstützt gemeldet, bis ein Provider abgenommen ist. | -| Erste Windows-Pakete | Geprüfte MSI-/EXE-Rezepte mit festem Installationskontext. WinGet ist keine Voraussetzung. | -| Plattformreihenfolge | Alle Features zuerst auf tatsächlicher Linux-Test-VM; Linux-MVP M0–M5 x86-64, erst danach Windows x86-64 mit nativen Abnahmen; PVE noch später. Physische Hardware oder beliebige VMs ohne bekannten Hypervisor. ARM64 bleibt bis zur späteren nativen Abnahme geplant. | -| Proxmox | PVE-Modul/-Client, Cluster, Backup und deren Abnahmen ausdrücklich nach MVP; gleicher Linux-Agent mit Zusatzmodul. PBS optional in dieser späteren Stufe. Gastagenten benötigen nichts davon. | -| RustDesk | Aus dieser Umsetzung/MVP ausgeschlossen; spätere optionale Integration. Bekannte Serveradresse `rust.ease-technologies.de` erhalten. Edition, Ports, öffentlicher Serverschlüssel und Version unbekannt; bei späterer Integration fehlende Werte als `not_configured`. Jetzt keine Installation, Profile/Provisionierung oder externe Desktopabnahme. | -| Automatisierung | Darf Pläne und `pending_approval`-Anträge erzeugen; jeder Job benötigt menschliche WebUI-Genehmigung. Policies begrenzen/verweigern nur, keine Dauer-/Wildcardfreigabe. | -| Repository | HTTPS: `https://gitea.incoso.eu/kevin_janssen/rust-discovery`; SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`. | -| Lokaler Zugangspfad | `credentials/` im Projekt; durch `.gitignore` ausgeschlossen und niemals committen. Keine Secrets in Logs oder MCP-Kontexte übernehmen. Dateien nur als Daten behandeln, niemals mit `source` oder `eval` ausführen. Die Dokumentation des Pfads ist keine Aufforderung, Secrets auszulesen. | -| Entwicklungswerkzeuge | Installation benötigter Entwicklungs-/Testtools ist ausdrücklich erlaubt. Dies genehmigt keine Änderungen, Installationen oder Neustarts auf Kundensystemen. | -| Lokale Entwicklungsumgebung | Server in Docker auf dem PC, veröffentlichte Ports nur Loopback; PC→VM SSH-Reverse-Forward `-R 127.0.0.1:18443:127.0.0.1:18443` mit `-N -T`, ExitOnForwardFailure und Keepalive. VM-Agent ausgehend über VM-Loopback; TLS E2E mit DNS SAN `rmm-dev.internal` und expliziter VM-Auflösung. SSH nur Dev/bootstrap, keine RMM-Sicherheitsabkürzung. | -| VM-Zugang und Grenzen | `credentials/linux-vm.conf`, `.gitignore`-Ausschluss, Verzeichnis 700/Datei 600; strikt Daten, kein `source`/`eval`, keine Secrets loggen/committen. Keine impliziten Ziel-Reboots, Updates oder destruktiven Tests. Geplante Befehle und reale Nachweisgates in `docs/development.md`. | - -### 18.1 Zentrale Defaultwerte - -Diese Werte sind Startentscheidungen für das Produkt, keine Herstellerzusagen. Sie stehen an einer zentralen Konfigurationsstelle und werden in Tests überschreibbar gehalten. - -| Parameter | Default | Bedeutung | -| --- | --- | --- | -| Heartbeat | 30 s mit Jitter | Frische Kontaktmeldung, nicht aus dem Offlinepuffer wiedergeben | -| Präsenz `stale` | 90 s ohne frischen Kontakt | Verbindung möglicherweise gestört | -| Präsenz `unreachable` | 180 s ohne frischen Kontakt | Gerät aktuell nicht erreichbar; kein Beweis für ausgeschaltet | -| Systemmetriken | 60 s mit Jitter | Erhebungszeit je Messung mitführen | -| Vollinventar | Bei Start und alle 24 h | Deltas ergänzen, ersetzen keinen vollständigen Abgleich | -| Enrollment-Nachweis | 15 min, einmal verwendbar | Größere Stückzahl nur ausdrücklich konfiguriert | -| Gerätezertifikat | 30 Tage, Rotation nach spätestens 20 Tagen beginnen | Geregelte Wiederaufnahme nach Ablauf | -| Startgrant | 60 s Startgültigkeit | Erst unmittelbar vor Wirkung; kein neuer Offline-Start | -| Planfrist | Explizit je Plan; UI-Vorschlag 24 h | Nach Ablauf kein automatisches Verlängern | -| Reconnect | Exponentiell 1–60 s mit Full Jitter | Nach erfolgreicher stabiler Verbindung zurücksetzen | -| Long Poll | Höchstens 25 s | Leere Antwort ist normal, kein Jobfehler | -| Steuernachricht | Höchstens 1 MiB | Vor Parserallokationen prüfen; zunächst keine Kompression | -| Inventar-/Outputstück | Höchstens 512 KiB Nutzdaten | Große Inhalte in bestätigten Stücken übertragen | -| Listenseite | 100, maximal 500 Einträge | Stabile, kontextgebundene Cursor | -| Einzelne Logabfrage | Maximal 1.000 Zeilen und 256 KiB | Das zuerst erreichte Limit gilt; Trunkierung sichtbar | -| Inline-Skript im MCP-Aufruf | Maximal 32 KiB je Variante | Größere freigegebene Skripte als Artefakt referenzieren | -| Offline-Telemetrie | Maximal 256 MiB und 72 h | Jobjournal nicht nach Telemetrie-Verdrängungsregeln löschen | -| Reboot-Rollout | Ein Ziel gleichzeitig je Abhängigkeitsgruppe | Mehr Parallelität muss im menschlich genehmigten Plan stehen und innerhalb begrenzender Policies bleiben | -| Testszenarien für Größe | Einige Dutzend, dann 1.000 und 10.000 simulierte Agenten | Lastziele, keine bereits belegte Kapazität | - -RTO, RPO, Aufbewahrung, Datenschutzvorgaben und eine verbindliche Produktions-Supportmatrix werden vor dem Produktionspilot vereinbart. Sie blockieren den ersten lokalen Entwicklungsabschnitt nicht. - -## 19 Repository, Module und Abhängigkeitsrichtung - -Das Repository MUSS einen Cargo-Workspace, eine Webanwendung, versionierte Migrationen und Betriebsdokumentation enthalten. Die folgenden Pfade sind die geplante Projektstruktur, keine Behauptung bereits existierender Dateien. - -| Pfad | Typ und Verantwortung | -| --- | --- | -| `crates/domain` | Bibliothek: IDs, Zustände, Fachregeln, Policyentscheidungen; keine HTTP-, SQL- oder OS-Abhängigkeit | -| `crates/application` | Bibliothek: Anwendungsfälle und Ports für Repository, Clock, Signer, ArtifactStore und Provider | -| `crates/protocol` | Bibliothek: Protobuf-Vertrag, generierte Wire-Typen, gemeinsame Fehler- und Versionsregeln | -| `crates/persistence` | Bibliothek: SQLx, Repositories, Transaktionen, RLS-Kontext und Outbox | -| `crates/server-api` | Bibliothek: HTTP DTOs, OpenAPI, Authentisierung und Controller | -| `crates/agent-gateway` | Bibliothek: Enrollment, mTLS-Identität, Kanalverwaltung und Übernahme von Ereignissen | -| `crates/worker` | Bibliothek: Scheduler, Jobzustellung, Rollouts, Nachprüfung und Hintergrundaufgaben | -| `crates/mcp-adapter` | Bibliothek: MCP-Werkzeuge; ruft dieselben Anwendungsfälle wie HTTP auf | -| `crates/relay` | Spätere Bibliothek: begrenzte Terminalstreams, Ticketprüfung und Sitzungsende | -| `crates/server` | Binary: Konfiguration und Start ausgewählter Serverrollen; lokal alle Rollen, produktiv trennbar | -| `crates/agent-core` | Bibliothek: Verbindungsaufbau, Journal, Collector-/Executor-Traits und Synchronisation | -| `crates/agent-windows` | Bibliothek: Windows-Dienst, Win32/CIM/Event-Log-Provider; nur für Windows einbinden | -| `crates/agent-linux` | Bibliothek: systemd, Linux-Inventar, Journald und Paketprovider | -| `crates/agent-proxmox` | Spätere Bibliothek nach MVP: PVE-/optionaler PBS-Provider auf demselben Linux-Agenten; keine Gastagentabhängigkeit | -| `crates/agent` | Binary: gemeinsamer Agent mit zielabhängigen Adaptern; Proxmox aktiviert ein Modul | -| `crates/privileged-helper` | Binary: lokaler privilegierter Executor mit eigener Nachweisprüfung | -| `crates/updater` | Späteres Binary: unabhängiger Agentupdatepfad mit Signaturprüfung und Recovery | -| `web` | React/TypeScript, generierter API-Client, Kunden-/Geräte-/Auftragsansichten | -| `proto` | `.proto`-Dateien und Kompatibilitätsfixtures; Tags niemals unbemerkt wiederverwenden | -| `migrations` | Geordnete SQL-Migrationen, separate Migrationsidentität | -| `deploy` | Lokales Compose-Profil, produktive Konfigurationsbeispiele und Dienstdefinitionen | -| `tests` | Integration, Protokollkonformität, Fehlerszenarien, Simulator und reale OS-Abnahmen | -| `docs` | Supportmatrix, ADRs, Betriebsanleitung, Sicherheitsmodell und Implementierungsstand | - -Nicht jeder spätere Adapter muss sofort als leere Crate angelegt werden. Die erste Strecke erzeugt nur tatsächlich verwendete Module; die vorgegebenen Grenzen bleiben erhalten. `server-api`, `mcp-adapter` und `agent-gateway` dürfen keine parallelen Varianten derselben Fachlogik implementieren. - -Erstes natives Linux-MVP-Buildziel ist `x86_64-unknown-linux-gnu`; `x86_64-pc-windows-gnu` ist nach Kapitel 0.9 das offizielle Windows-x64-Ziel. Noch später folgen `aarch64-pc-windows-msvc` und `aarch64-unknown-linux-gnu`. Abhängigkeiten und Installationspakete müssen jeweils zum Ziel passen. Der Linux-Build richtet sich nach der ältesten freigegebenen glibc-Basis. Cross-Compilation ist ein Buildnachweis; Dienststart, Installer und Betriebssystemintegration benötigen Tests auf dem tatsächlichen Ziel. Alle Features sind zuerst auf der tatsächlichen Linux-Test-VM nachzuweisen. - -`docs/platform-support.md` führt je Kombination Betriebssystemversion, Architektur, Buildstatus, native Abnahme, verfügbare Capabilities, PVE/PBS-Kompatibilität und gegebenenfalls RustDesk-Kompatibilität. „Geplant“, „Build erfolgreich“ und „freigegeben“ sind getrennte Angaben. - -## 20 Normative Datenverträge - -### 20.1 IDs, Zeit und Generationen - -Fach-IDs werden als zufällige UUIDs erzeugt und in JSON als Strings ausgegeben. Externe Providerkennungen bleiben zusätzliche Attribute. Zeitpunkte werden intern in UTC gespeichert; JSON verwendet RFC-3339-Zeitpunkte mit Zeitzone. Standorte besitzen eine IANA-Zeitzone für Wartungsfenster und Darstellung. - -| Feld | Bedeutung und Änderung | -| --- | --- | -| `tenant_id` | Kunde beziehungsweise Infrastrukturmandant; aus authentisierter Zuordnung ableiten | -| `asset_id` | Verwaltete Ressource; weder Hostname noch MAC-Adresse | -| `agent_id` | Konkrete Agentinstallation; Zertifikatsrotation allein ändert sie nicht | -| `enrollment_generation` | Geräteidentitätsgeneration; wird bei autorisierter Identitätswiederherstellung erhöht | -| `assignment_version` | Version der Verwaltungs-/Kundenzuordnung; relevante Umbindung invalidiert alte Startgrants | -| `connection_generation` | Serverseitiges Fencing des aktiven Transportkanals; Reconnect oder Transportwechsel erhöht den Wert | -| `boot_id` | Identität eines Betriebssystemstarts, nicht eines Agentprozessstarts | -| `collector_generation` | Fencing einer gewählten clusterweiten Erhebungsinstanz | -| `plan_id` | Genau ein gespeicherter, unveränderlicher Plan für genau einen Mandanten | -| `operation_id` | Stabile Referenz auf einen eingereichten Genehmigungsantrag und seinen späteren Ausführungslauf mit fester Zielmenge | -| `job_id` | Genau ein fester Einzeljob für ein Gerät und eine Aktion innerhalb eines Laufs; mehrere feste Jobs je Gerät möglich | -| `attempt_id` | Ausdrücklich zugelassener Ausführungsversuch; erneute Zustellung erzeugt keinen neuen Versuch | -| `message_id` | Identität einer Nachricht; kein Ersatz für Job oder Ausführungsversuch | - -Ist eine belastbare Bootkennung auf einer Plattform nicht verfügbar, wird diese Capability als eingeschränkt gemeldet. Ein Agentprozessneustart darf nicht als Nachweis eines Rechnerneustarts gelten. - -### 20.2 PostgreSQL-Kernschema - -Die Migrationen müssen die folgenden fachlichen Verträge in der jeweils gelieferten Ausbaustufe abbilden. Provider-/Virtualisierungs-/Backupstrukturen sind erst für M6b erforderlich und dürfen weder Gastagenten noch MVP blockieren. Zusätzliche technische Spalten und normalisierte Tabellen sind erlaubt, eine stille Abschwächung der Invarianten nicht. - -| Tabelle/Gruppe | Kernfelder | Invarianten | -| --- | --- | --- | -| `tenants`, `sites` | ID, Name, Status, Zeitzone | Deaktivierung beendet neue Änderungen, löscht nicht stillschweigend Historie | -| `principals`, `memberships` | Externe Identität `(issuer, subject)`, Typ, tenant, Rolle, Zielbereich | E-Mail ist kein stabiler Identitätsschlüssel; keine globale Kundenzugehörigkeit durch Rolle | -| `assets` | tenant, asset, Typ, Rolle, site, Tags, Lebenszyklus | Eindeutige `(tenant_id, asset_id)`; Typ und Rolle getrennt | -| `agent_installations` | tenant, agent, asset, Schlüssel, Generation, Zuordnungsversion, Version, Capabilities, Widerruf | Neue Installation übernimmt keine alten Jobs allein wegen gleicher Hardwaremerkmale | -| `inventory_snapshots`, `observations` | Quelle, Generation, Erhebungs-/Empfangszeit, Schema, Daten, Vollständigkeit | Aktuelle Projektion bleibt von historischer Beobachtung unterscheidbar | -| `service_expectations`, `check_results`, `incidents` | Sollregel, Quelle, Messzustand, Zeit, Eskalation | Unterdrückte Meldung überschreibt nicht den ursprünglichen Messzustand | -| `provider_connections`, `provider_resources` | Providerinstanz, externe Identität, Lebenszyklus, Scope, Zuordnung | VMID allein ist nicht eindeutig | -| `backup_policies`, `backup_evidence` | Regel, Fälligkeit, Versuch, Gast, Abdeckung, Snapshot, Verify, Restore | Ein Gesamtjob ersetzt keinen Einzelnachweis | -| `package_recipes`, `artifacts`; später optional `rustdesk_profiles` | tenant/sichtbarer Katalog, unveränderliche Version, Hash, Plattform, Secret-Referenzen | Freigegebene Version wird nie in-place verändert; RustDesk-Profile nicht Teil dieser Umsetzung/MVP | -| `operation_plans` | tenant, Planpayload-Bytes, Hash, Ziele, Ablauf, Urheber | Inhalt unveränderlich nach Speicherung | -| `approval_requests` | operation_id, tenant, Planhash, feste Jobdefinitionen/Versuche, Urheber, Frist, Status, Idempotenznachweis | `pending_approval` erzeugt keine Ausführungsjobs/Outbox; abgelehnt/abgelaufen/widerrufen nicht ausführbar | -| `authorizations` | Planhash, menschlicher Freigeber und interaktiver WebUI-Kontext, Gültigkeit, begrenzende Policyversion | Nur explizite menschliche Genehmigung; Bindung an feste Ziele, Inhalte und Versuche | -| `operations`, `jobs`, `job_attempts` | Genehmigter Lauf, Gerät, Zustand, Fristen, Sperre, Versuch, Ergebnis | Anlage erst nach menschlicher Genehmigung; gleiche Zustellung startet keinen zweiten Versuch | -| `execution_permits` | Grant-ID, Job-/Payloadhash, Zielbindung, Gültigkeit, Signierschlüssel | Kurzlebig und nur für den angegebenen Start verwendbar | -| `outbox`, `message_receipts` | Ereignis-ID, tenant, Ziel, Payload, ACK, Zustelllease | Jobanlage und Outbox atomar; ACK erst nach der definierten dauerhaften Übernahme | -| `audit_events` | Principal, Kontext, Plan, Entscheidung, Wirkung, Ergebnis | Auditmetadaten ohne Secrets; kritische Kopien mit getrennten Löschrechten | -| `remote_sessions` | Principal, Ziel, Rechte, Ablauf, Status, Aufnahmeverweis | Keine Wiederaufnahme ohne erneute Sitzungsauthorisierung | - -Normale kundenbezogene Fremdschlüssel enthalten `tenant_id`. Querverbindungen zwischen Infrastrukturmandant und Kundengast liegen in ausdrücklich separaten Mapping-/Projektionsstrukturen mit einer eng begrenzten Dienstidentität. Sie dürfen nicht durch einen allgemeinen RLS-Bypass aller Worker realisiert werden. - -Der Scheduler liest ausschließlich das berechtigte Mandantenregister und bearbeitet jeden Kunden in einer eigenen Transaktion mit explizitem Kontext. Request- oder Tenant-Kontext wird mit transaktionslokalen Einstellungen gesetzt; nach Fehlern oder Rückgabe einer Poolverbindung darf er nicht fortbestehen. Anwendung und Worker besitzen keine Tabellen und haben keine Superuser-/BYPASSRLS-Rechte. - -### 20.3 Beobachtungen und Status - -Jede Datengruppe führt mindestens `source_id`, `observed_at`, `received_at`, `quality`, `completeness` und bei Bedarf `error_code`. `quality` unterscheidet `valid`, `unknown`, `unsupported`, `permission_denied` und `error`. Datenalter ist ein zusätzliches berechnetes Merkmal und kein Ersatz für diese Zustände. - -`completeness` unterscheidet `complete`, `partial` und `unknown`; ein begrenztes Ergebnis erhält außerdem `truncated=true`. Das ist besonders wichtig für Softwareinventar, Logs und Proxmox-Discovery. Ein unvollständiger Snapshot DARF NICHT als Beleg für die Löschung fehlender Einträge verwendet werden. - -Präsenz, Datenfrische und fachliche Gesundheit sind getrennte Felder. Der Kontaktstatus lautet `online`, `stale`, `unreachable`, `never_seen` oder `revoked`; ein Wartungsfenster ist ein eigenes Merkmal. Der Status einer Agentverbindung sagt nichts Endgültiges über den Power-State einer VM aus. Altes Telemetriereplay aktualisiert weder `last_contact_at` noch eine aktuelle Gesundheit zu grün. - -## 21 Normativer Agentprotokoll-Vertrag - -### 21.1 Endpunkte und Transport - -| Endpunkt | Vertrag | -| --- | --- | -| `POST /agent/v1/enroll` | Serverauthentifiziertes HTTPS; Enrollment-Nachweis, CSR/öffentlicher Schlüssel und Metadaten; atomarer Verbrauch des Nachweises | -| `WSS /agent/v1/connect` | mTLS; binäre Protobuf-Nachrichten; aktive Verbindungsgeneration durch Server vergeben | -| `POST /agent/v1/messages` | mTLS; derselbe logische Nachrichtenvertrag als Protobuf-Batch; für HTTPS-Modus und Wiederholung | -| `POST /agent/v1/poll` | mTLS; Long Poll mit Cursor/Generation und begrenzter Antwortzeit; leeres Ergebnis ist erlaubt | -| `POST /agent/v1/certificates/renew` | mTLS mit noch gültiger Geräteidentität; neuer Schlüssel/CSR und gültige Zuordnung prüfen | -| `GET /agent/v1/artifacts/{artifact_id}` | mTLS und Zielberechtigung; gestückelter Bezug, Hashkontrolle; kein freier Objektpfad | -| `WSS /agent/v1/sessions/{session_id}` | Späterer, vom Agenten eröffneter Terminalstream; mTLS plus gebundenes Sitzungsticket | - -Kontrollnachrichten verwenden `application/x-protobuf` über HTTP. HTTP-Batching hat ein eigenes versioniertes `MessageBatch`-Schema; das Gesamtlimit wird ebenfalls geprüft. Im WebSocket entspricht ein vollständiger binärer Message genau einem `Envelope`; Netzwerkfragmentierung ändert diesen logischen Vertrag nicht. Der Receiver prüft Limits während der Rekonstruktion, nicht erst nach unbegrenzter Allokation. - -WSS und Long Polling sind funktional für Inventar und Jobs gleichwertig. Pro Agent darf nur eine Verbindungsgeneration neue Arbeit erhalten. Ein alter Poll oder Stream bekommt keine neuen Aufträge. Nachgewiesene verspätete Ergebnisse können weiterhin anhand von Agent, Job und Versuch verarbeitet werden; sie werden nicht allein wegen eines neuen Transportkanals verworfen. - -TLS-Clientidentität muss bis zur fachlichen Geräteprüfung verlässlich erhalten bleiben. Wenn ein Reverse Proxy mTLS terminiert, ist dessen Verbindung zum Gateway ebenfalls authentisiert; vom Internet eingesandte Identitätsheader werden verworfen. Der Proxy ist dann Teil der Vertrauensgrenze. Ein ungeprüfter Header ist kein Ersatz für mTLS. - -### 21.2 Umschlag - -`Envelope` enthält `protocol_major`, `protocol_minor`, `message_id`, `agent_id`, `enrollment_generation`, `connection_generation`, `boot_id`, `sequence`, `observed_at` und ein typisiertes Protobuf-`oneof payload`. Während des ersten Hello kann die neue Verbindungsgeneration noch fehlen; der Server vergibt sie mit `ServerHello`. `tenant_id` wird serverseitig aus der registrierten Identität abgeleitet, nicht aus einer beliebigen Agentbehauptung. - -`sequence` ist innerhalb einer Agentinstallation monoton und wird für dauerhafte Ereignisse gemeinsam mit dem Journal fortgeschrieben. Lücken durch flüchtige Nachrichten sind zulässig. ACKs benennen konkrete `message_id`-Werte; ein pauschales „alles bis Sequenz N“ darf nur für eine tatsächlich lückenlos bestätigte durable Teilfolge verwendet werden. Ein Snapshot-Restore des Journals erfordert den Wiederabgleich aus Abschnitt 22. - -### 21.3 Nachrichtentypen - -| Typ und Richtung | Mindestinhalt | Dauerhaftigkeit und Antwort | -| --- | --- | --- | -| `ClientHello`, Agent → Server | Unterstützte Protokollversionen, Agentversion, OS/Architektur, Capabilities, Journal-/Syncstand | Frisch je Verbindung; `ServerHello` oder erklärbarer Fehler | -| `ServerHello`, Server → Agent | Gewählte Version, Verbindungsgeneration, Serverzeit, Limits, Konfigurationsversion | Frisch; mutierende Starts erst nach erfolgreichem Wiederabgleich | -| `Heartbeat`, Agent → Server | Frische Instanzkennung, Boot-ID, Laufzeit, begrenzter Agentzustand | Flüchtig; niemals als Offlinehistorie wiedergeben | -| `InventorySnapshot`, Agent → Server | Snapshot-ID, Scope, Schema, Chunkindex/-anzahl, Erhebungszeit, Vollständigkeit, Gesamthash | Stücke dauerhaft übernehmen; aktuelle Projektion erst nach vollständiger validierter Assemblierung aktualisieren | -| `InventoryDelta`, Agent → Server | Basis-Snapshot, neue Generation, Änderungen | Durable ACK; fehlende Basis → `SnapshotRequired` | -| `SnapshotRequired`, Server → Agent | Betroffener Scope und fehlende/ungültige Basisgeneration | Vollständigen neuen Snapshot anfordern; ändert selbst keine Inventarprojektion | -| `MetricsBatch`, Agent → Server | Quelle, Messnamen, Werte, Einheiten, Erhebungszeiten | Nach definierter dauerhafter Aufnahme in begrenzten Ingestpfad bestätigen; spätere Lücken sichtbar | -| `JobOffer`, Server → Agent | Genehmigter Job/Versuch, Genehmigungsreferenz, Plan-/Jobpayloadhash, Inhalte/Artefaktreferenzen, Fristen | Erst nach menschlicher WebUI-Genehmigung zustellen; Agent nach lokalem Journaleintrag mit `JobAccepted` bestätigen | -| `JobAccepted`, Agent → Server | Job, Versuch, Journalnachweis | Dauerhaft; ist keine Ausführungserlaubnis und kein Erfolg | -| `ExecutionPermitRequest`, Agent → Server | Job, Versuch, aktuelle Identitäts-/Zuordnungsgeneration, Payloadhash | Frisch unmittelbar vor dem Start; keine Offlinepufferung zur späteren Freigabe | -| `ExecutionPermit`, Server → Agent | Signierter, kurzlebiger Startnachweis oder strukturierte Verweigerung | Agent/Helper prüfen Inhalt, Frist und einmaligen Verbrauch | -| `JobStateChanged`, Agent → Server | Job, Versuch, monotone Zustandsrevision, lokaler Zustand und Zeitpunkt | Verpflichtendes dauerhaftes Zustandsereignis; bis ACK wiederholen, bei Wiederholung deduplizieren | -| `JobProgress`, Agent → Server | Job, Versuch, Stufe, begrenzte Zähler | Optional zusammenfassbar; Fortschritt ist kein terminales Ergebnis | -| `JobResult`, Agent → Server | Job, Versuch, Ausgang, Nachprüfungen, Zeitpunkte, Outputreferenzen, Neustartbedarf | Dauerhaft bis ACK wiederholen; deduplizieren | -| `CancelRequest`, Server → Agent | Job, Versuch, Grund und Entscheidungskontext | Durable; Ergebnis benennt tatsächlichen Abbruch oder fehlende Abbruchmöglichkeit | -| `ConfigUpdate`, Server → Agent | Version, vollständige validierte Konfiguration oder Basisdelta | Atomar übernehmen; letzte gültige Konfiguration erhalten | -| `SyncRequest` / `SyncResponse`, beide Richtungen | Journalzusammenfassung, bekannte Versuche, offene Zustände | Nach Restore/Reconnect Abgleich; keine neue Ausführung durch bloße Synchronisation | -| `Ack`, beide Richtungen | Konkrete Nachricht-IDs und Übernahmezustand | Kein ACK-von-ACK; Bedeutung ist ausdrücklich Empfang/Übernahme, nicht fachlicher Erfolg | -| `ProtocolError`, beide Richtungen | Code, betroffene Nachricht, Wiederholbarkeit | Keine Secrets oder ungefilterten Backtraces | - -Ein dauerhafter ACK bestätigt entweder die endgültige Speicherung oder eine zuvor klar definierte durable Ingest-Stufe. Geplante Telemetrieverwerfung durch Quoten erzeugt einen expliziten Drop-/Gap-Nachweis; sie darf nicht als dauerhafte Speicherung behauptet werden. Jobergebnisse werden niemals nach Telemetrie-Verdrängungsregeln verworfen. - -Die Erteilung eines Startgrants ist kein bestätigter Prozessstart. Erst ein passender dauerhafter Zustands-, Ergebnis- oder Syncnachweis belegt die lokale Ausführung. Zustandsrevisionen verhindern eine Rücksetzung durch verspätete Ereignisse. Ein früher eintreffendes gültiges Endergebnis darf fehlende Zwischenereignisse nachvollziehbar ergänzen; es wird nicht allein wegen einer verlorenen Startmeldung verworfen. - -Neue Protobuf-Felder werden additiv eingeführt. Entfernte Tags und Enumwerte werden reserviert. Eine unbekannte Hauptversion führt zu `UNSUPPORTED_PROTOCOL`; unbekannte Aktionscapabilities zu `UNSUPPORTED_CAPABILITY`. Der Agent darf niemals stillschweigend einen anderen Interpreter oder Paketprovider wählen. - -## 22 Pläne, Ausführungserlaubnis und Jobzustände - -### 22.1 Unveränderlicher Plan und Transaktionsgrenzen - -Ein Plan umfasst genau einen Mandanten und ein transparentes Paket fester Einzeljobs auf festen Zielgeräten. Im einfachen Fall ist dies eine Aktion je Ziel; verschiedene Aktionen oder feste Folgejobs sind zulässig, wenn jeder Job, Versuch, seine Abhängigkeiten und Parameter vor Genehmigung einzeln sichtbar und gebunden sind. Plattformvarianten werden vor Speicherung eindeutig je Job aufgelöst. Sämtliche Jobpayloads werden vorher erzeugt; der Plan enthält je Job den `job_payload_hash` und die feste Versuchsidentität. Freigabe und Startgrant dürfen ausschließlich diese Bindungen verwenden. Jede spätere Änderung erzeugt einen neuen Plan. Beispiel: Ein Skriptplan bindet jedes Ziel an genau eine PowerShell- oder POSIX-Shell-Variante. Eine unbestimmte Zahl künftiger Retries ist kein fester Einzeljob. - -1. **Planen:** Rechte und begrenzende Policies prüfen, dynamische Auswahl auflösen, Fähigkeiten prüfen, Parameter/Artefaktversionen normalisieren, feste Einzeljobpayloads einschließlich Versuch und Nachbedingungen erzeugen und Plan speichern. Noch keine Ausführungsjobs. -2. **Beantragen (`operations.submit`):** Aktuelle Rechte und Planfrist prüfen; atomar einen persistenten `approval_request` mit stabiler `operation_id`, Planhash, Idempotenznachweis und `pending_approval` speichern. Keine Ausführungsjobs, ausführbare Outbox, JobOffers oder Startgrants. Jeder Submit ist ein Antrag, auch aus der UI; kein alternativer direkter Ausführungspfad. Derselbe Plan wird nur einmal beantragt; Wiederholung liefert denselben Antrag samt aktuellem Status. -3. **Menschlich genehmigen und einreihen:** Ausschließlich ein berechtigter Mensch im interaktiven WebUI-Kontext genehmigt den unveränderlichen Plan nach Anzeige aller festen Einzeljobs, Zielanzahl, Inhalte/Hashes, Fristen und Auswirkungen. Rechte, Policygrenzen, Zuordnung und Planfrist erneut prüfen. In einer Transaktion Genehmigung, Ausführungslauf unter derselben `operation_id`, feste Jobs/Versuche und Outbox erzeugen und den Antrag als `approved` markieren. Fehler rollt alles zurück. Keine dauerhafte oder Wildcardfreigabe; MCP-/Automatisierungstokens werden selbst mit Approver-Rolle abgewiesen. Ablehnen ist ohne Jobanlage möglich. -4. **Zustellen:** Nur genehmigte Jobs lease-basiert koordinieren. Der Agent übernimmt dauerhaft ins Journal und bestätigt. Eine verlorene Lease oder erneute Zustellung erzeugt weder einen neuen Versuch noch eine neue Genehmigung. -5. **Starten:** Aktuellen Startgrant mit Referenz auf die weiterhin gültige menschliche Genehmigung beziehen, lokal prüfen und Verbrauch journalisieren; erst dann ausführen. -6. **Nachprüfen:** Im genehmigten Job gebundene Nachbedingungen erheben und Ergebnisse dauerhaft übermitteln. Separate Diagnose-, Reboot- oder Retryjobs benötigen eigene feste, menschlich genehmigte Pläne; bereits im transparenten Sammelpaket enthaltene feste Folgejobs dürfen dessen Genehmigung nutzen. Neue Wirkung/neuer Versuch ist nie durch bloße Wiederholung der Zustellung erlaubt. - -Antragszustände sind `pending_approval`, `approved`, `rejected`, `expired` und `revoked`, ausgegeben als `approval_state`. Aus `pending_approval` sind diese vier Übergänge möglich; `approved` kann bei Genehmigungsentzug nach `revoked` wechseln. `rejected`, `expired` und `revoked` werden nicht reaktiviert. Genehmigungsentzug sperrt neue Starts; laufende Wirkungen folgen den sicheren Abbruchregeln. Der Ausführungslauf und seine Aggregation (`execution_state`) bleiben getrennt erhalten. `jobs.get(operation_id)` zeigt den Antrag auch ohne Jobs (`job_count=0`, `planned_job_count` separat, `execution_state=null`). Eine neue/verlängerte Frist oder geänderte Jobdefinition erfordert neuen Plan und Genehmigung. Ausführungseinreihung findet ausschließlich in Schritt 3 statt; parallele Genehmigungsklicks werden transaktional dedupliziert und erzeugen nur einen Lauf. - -Idempotenzschlüssel werden an Principal, Tenant, Operationstyp und Requesthash gebunden. Gleicher Schlüssel mit anderem Inhalt ergibt `IDEMPOTENCY_CONFLICT`. Ein absichtlich neuer Lauf/Versuch nach unbekanntem Ausgang benötigt zuerst Abgleich und einen neuen explizit menschlich genehmigten Plan, keinen stillschweigend neuen Schlüssel. - -### 22.2 Exakte Bytes, Hashes und Signaturen - -Der Server normalisiert den Plan über genau einen versionierten Codec. Er serialisiert den Plan einmal in eine definierte Bytefolge, speichert diese unveränderlich und berechnet `plan_hash = SHA-256(plan_payload_bytes)`. Keine Komponente berechnet den Hash durch beliebiges Neuformatieren der JSON-Ansicht. Der Codec legt Feldreihenfolge, fehlende Werte, Listenreihenfolge, Zahlen und Zeitdarstellung fest und erhält Golden-Files für Interoperabilität. - -Für jeden festen Einzeljob wird ein unveränderlicher `job_payload` mit Ziel, festem Versuch, Interpreter/Provider, Argumenten, Ausführungsidentität, Limits, Artefakthashes, Secret-Versionreferenzen und Nachbedingungen erzeugt. Job-/Versuchs-IDs dürfen dafür im Plan reserviert werden, ohne bereits Ausführungsjobs oder eine Queue anzulegen. Der Startgrant bindet dessen `job_payload_hash`. Skriptartefakte werden über die exakten auszuführenden Bytes gehasht; BOM, Encoding und Zeilenenden werden nach Freigabe nicht mehr verändert. - -Für Startnachweise wird ein versioniertes signiertes Envelope mit einem festgelegten Standardalgorithmus und geprüfter Bibliothek verwendet; als Ausgangsprofil ist Ed25519 vorgesehen. Es gibt keine vom Aufrufer frei wählbare Algorithmusverhandlung. Signiert werden die gespeicherten exakten Grantpayload-Bytes einschließlich Domain-/Typkennung und Schemaversion. Schlüssel-ID und bekannte Vertrauenskette erlauben Rotation; Transport-, Update- und Auftragschlüssel bleiben getrennt. - -### 22.3 Startgrant und Offlineverhalten - -Ein `ExecutionPermit` MUSS mindestens folgende Bindungen enthalten: `grant_id`, `authorization_id` der menschlichen Genehmigung, `tenant_id`, `asset_id`, `agent_id`, `enrollment_generation`, `assignment_version`, `job_id`, `attempt_id`, `plan_hash`, `job_payload_hash`, `action`, `execution_identity`, `not_before`, `start_before`, `max_runtime_seconds`, `key_id` und Schemaversion. Der Helper erhält genug Payload, um Ziel, Aktion, konkrete Parameter und Hash selbst zu prüfen. - -**Kein Ausführungsjob, auch kein Diagnosejob, beginnt ohne aktuellen Kontakt zur Zentrale und gültige menschliche WebUI-Genehmigung.** Der Server prüft vor der Signatur Genehmigungsbindung an Plan, feste Jobs und Versuch, heutige Zuordnung, Benutzer-/Automatisierungsrechte, begrenzende Policy, Stopps, Planfrist, Wartungsfenster, Ressourcen- und Rolloutgrenzen. Lange wartende Jobs erhalten den Startgrant erst dann. Nur technische Neuausstellung für denselben nachweislich ungestarteten Versuch braucht keine neue Genehmigung; sie darf keine neue Wirkung oder neuen Versuch ermöglichen. - -Ein einmal verwendeter Grant darf nach Prozessneustart nicht erneut verwendet werden. Die Einmaligkeit gilt zusätzlich für den Ausführungsversuch `(agent_id, enrollment_generation, job_id, attempt_id)`. Der Server speichert die Startreservierung und den ausgegebenen Grant dauerhaft vor dessen Übermittlung. Eine neue Grant-ID setzt einen gestarteten oder möglicherweise gestarteten Versuch nicht zurück. Ist ein vorheriger Start nicht zuverlässig ausgeschlossen, folgt zuerst Abgleich und gegebenenfalls `unknown`; es wird kein weiterer startberechtigender Grant ausgegeben. Nur nach belegtem Nichtstart kann ein abgelaufenes technisches Ticket für denselben noch ungestarteten Versuch ersetzt werden. - -Der Verbrauch und der Versuchszustand liegen zusätzlich dauerhaft im lokalen Journal. Bei unklarer Uhrabweichung wird die Ausführung mit `CLOCK_UNTRUSTED` zurückgestellt; Telemetrie darf weiterlaufen. Ein bloß vom Agenten behaupteter neuer Zeitpunkt verlängert keinen Grant. - -Eine bereits begonnene Installation darf bei Verbindungsverlust gemäß Providerregeln weiterlaufen. Der Agent puffert Ergebnisse. Ein abgelaufener Startgrant beendet eine laufende Aktion nicht rückwirkend; dafür gelten Laufzeit- und Abbruchregeln. Offline-Widerruf wirkt spätestens vor dem nächsten online autorisierten Start; bereits ausgeführte Änderungen können nicht rückwirkend ungeschehen gemacht werden. - -### 22.4 Normative Jobzustände - -| Zustand | Bedeutung | Zulässige nächste Zustände | -| --- | --- | --- | -| `queued` | Dauerhafter Job, noch nicht lokal angenommen | `accepted`, `cancelled`, `expired`, `failed` bei eindeutigem Vorprüffehler | -| `accepted` | Im Agentjournal; Beginn noch nicht bestätigt | `running`, `unknown` bei möglichem Start; `cancelled`, `expired` oder `failed` nur bei nachgewiesenem Nichtstart beziehungsweise bestätigtem Abbruch | -| `running` | Lokale Ausführung hat begonnen | `verifying`, `awaiting_reboot`, `failed`, `cancelled` bei bestätigtem Abbruch, `unknown` | -| `verifying` | Nachbedingungen werden geprüft | `succeeded`, `failed`, `awaiting_reboot`, `unknown` | -| `awaiting_reboot` | Für Abschluss benötigter autorisierter Reboot beziehungsweise Wiederanmeldung ausstehend | `verifying`, `unknown`, `failed` bei eindeutigem Nachweis | -| `succeeded` | Definierte Nachbedingungen bestätigt | Terminal | -| `failed` | Bekannter Fehlschlag mit strukturiertem Grund | Terminal | -| `cancelled` | Vor Start gestrichen oder Abbruch tatsächlich bestätigt | Terminal; bereits eingetretene Teilwirkungen gesondert ausweisen | -| `expired` | Startfrist ohne begonnene Wirkung abgelaufen | Terminal | -| `unknown` | Wirkung oder Ergebnis nicht zuverlässig bestimmbar | Nur durch dokumentierten Abgleich nach `verifying`, `succeeded`, `failed` oder tatsächlich bestätigtes `cancelled` | - -`cancel_requested` ist ein separates Feld, kein Beleg für Beendigung. `pending_reason` erklärt Wartezeiten wie `device_offline`, `maintenance_window`, `resource_locked`, `rollout_paused` oder `authorization_revoked`. `pending_approval` gehört ausschließlich zum Antrag, niemals zu einem bereits vor Genehmigung eingereihten Job. Zustellleases sind technische Metadaten, keine fachlichen Zustände. - -Die Tabelle beschreibt den fachlichen Verlauf, nicht eine Pflicht zur verlustfreien Reihenfolge aller Netzwerknachrichten. Dauerhafte Ergebnis- oder Syncnachweise dürfen fehlende Zwischenzustände nachvollziehbar ergänzen. Bei einem zentral noch als `queued` geführten Job wird zuerst der nachgewiesene lokale Annahme-/Startverlauf rekonstruiert. Wurde ein Startgrant ausgegeben und ist dessen Nichtverbrauch unklar, darf der Job nicht allein wegen fehlender Startmeldung als `expired` oder `cancelled` abgeschlossen werden. - -`reboot_required` ist ein eigenständiges Ergebnisfeld. Kann eine Installation vollständig nachgeprüft werden, darf sie mit `succeeded` und `reboot_required=true` enden. Verlangt ihre Nachbedingung einen Neustart, bleibt sie `awaiting_reboot`; der Neustart ist ein fester, explizit menschlich genehmigter Folgejob, im ursprünglichen transparenten Sammelpaket oder in einem neuen Plan. Kein Installer darf durch einen unbeachteten Standardparameter ungeplant neu starten. - -Timeout nach möglicher Wirkung bedeutet `unknown`, sofern kein eindeutiger Fehlschlagnachweis vorliegt. Ein Reboot ist erst nach authentisierter Wiederanmeldung mit plausibel neuer Boot-ID und erfolgreicher Nachprüfung abgeschlossen. Ausbleibende Wiederanmeldung ist kein bestätigter Erfolg. - -### 22.5 Abgleich, Sperren und Restore - -Vor Wiederholung wird zwischen erneuter **Zustellung** desselben genehmigten Versuchs (keine neue Genehmigung, keine zweite Wirkung) und einem neuen **Ausführungsversuch** (neuer menschlich genehmigter Plan) unterschieden. Gebundene Nachprüfungen von `ensure_package`/`ensure_rustdesk` sind Teil des genehmigten Jobs; neue Diagnosejobs zum Istzustand brauchen eigene Genehmigung. Kein Job wird nach unklarer Wirkung blind wiederholt, auch kein idempotent wirkender Provider ohne Genehmigung eines neuen Versuchs. - -Paketmanager, Agentupdate und Reboot erhalten gerätebezogene Konfliktsperren. Serverseitige Sperre allein reicht bei einer Netzpartition nicht aus; der lokale Executor hält dieselbe Ressourcensperre während der Wirkung. Bereits laufende, fremd gestartete Paketmanager werden respektiert. - -Nach Snapshot-Restore, Journalinkonsistenz oder zentralem Restore sind neue Änderungen gesperrt, bis offene Versuche und Generationen abgeglichen sind. Zurückgerollte Journale dürfen keine historische Aktion allein wegen fehlenden lokalen Eintrags erneut starten. Serverledger, Gerätegeneration und aktuelle Startprüfung bilden gemeinsam die Wiederholungssperre. - -Ergebnisse und deduplizierende Tombstones werden nur nach einer dokumentierten, beidseitigen Kompaktierungsregel entfernt. Jobjournalplatzmangel sperrt neue Änderungen und meldet einen Fehler; er löscht keine unbestätigten Ergebnisse zugunsten neuer Telemetrie. - -**Technische Präzisierung 1.30, normale geschlossene Kontrollfortsetzung:** Bei -genau einer fehlenden SYSTEM-Applybestätigung darf ausschließlich ein neuer -frischer Sync vorbereitet werden, wenn der OS-Actor vollständig idle ist, -keine offenen Intents/Grants/unklaren Wirkungen oder Updates bestehen und die -kanonischen Originalrequests, signierten Antworten, byteidentischen lokalen -Consumption-ACKs, aktuellen Helperhistorien und identischen effektiven -Abschlüsse genau diese Teilkante beweisen. Identität, Boot, Journale und -monotone Checkpoints müssen erhalten sein. Nie gestartete terminale Versuche -ohne Grant brauchen keinen erfundenen Outcome. Historisches Unknown221 gilt -nur mit seinem gültigen signierten Zusatzabschluss als effektiv geschlossen. -Die rein lesende Beweisprüfung verändert keine Historie, Heads oder Faults. -Der unveränderte Server prüft beide Vorgänger getrennt; nur seine neue Antwort -mit aktuellen unabhängigen Uhren und neuer tatsächlicher Helperbestätigung -darf anschließend Bereitschaft herstellen. Alte Signaturen sind nur -historische Authentizitätsbelege, keine wiederbelebte Apply- oder Startbefugnis. -Die administrativen Ausnahmen aus Kapitel0 bleiben auf ihre festen Fälle -beschränkt. Bei fehlendem Beleg bleibt der bisherige Verweigerungspfad aktiv. -Ein typisierter Uhrfehler vor dem ersten SQLite-BEGIN darf innerhalb derselben -authentisierten Applyanfrage mit exakt gleichen Originalbytes/Capture höchstens -drei Sekunden und nur innerhalb ihrer ursprünglichen Frist erneut geprüft -werden; keine Execute-/Installer-/Skriptausführung wird wiederholt. Details und -tatsächliche Nachweise: `docs/windows-closed-control-online-continuation.md`. - -## 23 HTTP API, MCP und Berechtigungen - -### 23.1 Gemeinsamer Vertrag - -HTTP und MCP verwenden dieselben DTOs, Validierungsregeln und Anwendungsfälle. OpenAPI- und MCP-JSON-Schemas werden aus gemeinsamen Typen erzeugt oder durch Konformitätstests gegeneinander geprüft. Jeder neue Toolpfad muss denselben Mandantentest bestehen wie der entsprechende HTTP-Pfad. - -Listen liefern `items`, `next_cursor`, `completeness`, `truncated` und `as_of`; fachliche Beobachtungen führen zusätzlich ihre eigene `observed_at`. Cursor werden an Tenant, Filter und Sortierung gebunden und dürfen keine unberechtigten Daten offenlegen. Fehler verwenden `code`, `message`, `retryable`, `correlation_id` und unkritische strukturierte `details`. - -Fremde Objekt-IDs erhalten dieselbe äußere Antwort wie nicht vorhandene Objekte. Authentisierungsausfälle bleiben davon unterscheidbar. Relevante Fehlercodes sind `NOT_FOUND`, `UNAUTHENTICATED`, `FORBIDDEN`, `VALIDATION_ERROR`, `AMBIGUOUS_TARGET`, `UNSUPPORTED_CAPABILITY`, `AUTHORIZATION_REQUIRED`, `PLAN_EXPIRED`, `IDEMPOTENCY_CONFLICT`, `DEVICE_OFFLINE`, `POLICY_DENIED`, `QUOTA_EXCEEDED`, `DEPENDENCY_UNAVAILABLE` und `RESULT_UNKNOWN`. - -### 23.2 Rollen und Sonderrechte - -| Rolle | Defaultrechte innerhalb ihrer ausdrücklich zugewiesenen Kunden/Zielgruppen | -| --- | --- | -| Viewer | Inventar und Monitoring lesen | -| Operator | Zusätzlich berechtigte Logs lesen, Pläne erstellen/einreichen und berechtigte Aufträge abbrechen | -| Approver | Als Mensch ausschließlich im interaktiven WebUI-Kontext konkrete Pläne im eigenen Bereich genehmigen; MCP-/Automatisierungstokens niemals freigabefähig | -| TenantAdmin | Kundenmitgliedschaften, eigene Richtlinien und freigegebene Profile verwalten | -| PlatformOperator | Explizite Plattform- und Infrastrukturaufgaben; keine automatische Einsicht in jeden Kunden | - -Zusatzrechte werden getrennt vergeben, insbesondere `scripts:execute`, `sessions:open`, `sessions:privileged`, `logs:read_sensitive`, `hypervisor:operate` und `data:send_to_external_ai`. Eine Operatorrolle allein autorisiert keine beliebige SYSTEM-/Root-Skriptausführung. - -Eine TenantAdmin-Rolle darf nur innerhalb eines vom Plattformbetrieb eingeräumten delegierbaren Bereichs neue Rechte vergeben. Policyänderungen werden auditiert. Automatisierungsprincipals sind eigenständige Identitäten mit begrenztem Scope; das Audit bewahrt gegebenenfalls zusätzlich den menschlichen Auftraggeber. - -### 23.3 Endpunkte und Werkzeuge - -| HTTP-Fachendpunkt | MCP-Werkzeug | Wichtige Ein-/Ausgabe | -| --- | --- | --- | -| `GET /api/v1/tenants` | `tenants.list` | Name/Filter, Cursor → berechtigte eindeutige Kunden-IDs | -| `GET /api/v1/tenants/{tenant_id}/devices` | `inventory.list_devices` | Rolle, Tags, Plattform, Präsenz → Geräte mit Aktualität | -| `GET /api/v1/tenants/{tenant_id}/devices/{asset_id}` | `inventory.get_device` | Asset → Inventar, Quellen, Capabilities, Alter | -| `GET /api/v1/tenants/{tenant_id}/health` | `monitoring.get_health` | Zielbereich, Zeitraum → Vorfälle und begrenzte Metriken | -| `POST /api/v1/tenants/{tenant_id}/log-queries` | `logs.query` | Gespeicherte Daten → `ready`; Live-Erhebung → fester Diagnoseplan und persistenter Antrag `pending_approval` mit operation_id, noch kein Job | -| `POST /api/v1/tenants/{tenant_id}/operation-plans` | `operations.plan` | Aktion, Zielauswahl, Varianten, Fristen → Plan, Hash, feste Ziele, erwartete Auswirkungen, Autorisierungsbedarf | -| `POST /api/v1/tenants/{tenant_id}/operation-plans/{plan_id}/submit` | `operations.submit` | Plan-ID, Idempotenzschlüssel → operation_id, `pending_approval`, planned_job_count, job_count=0; nur persistenter Antrag, keine ausführbare Outbox | -| `GET /api/v1/tenants/{tenant_id}/operations/{operation_id}` | `jobs.get` mit operation_id | Antragsstatus einschließlich `pending_approval`, Planhash und geplante Jobs; nach Genehmigung zusätzlich Ausführungsaggregation, Zähler und paginierte Jobs | -| `GET /api/v1/tenants/{tenant_id}/jobs/{job_id}` | `jobs.get` mit job_id | Einzelzustand, Versuch, Nachprüfungen, begrenzte Ausgaben | -| `POST /api/v1/tenants/{tenant_id}/jobs/{job_id}/cancel` | `jobs.cancel` | Abbruchgrund → tatsächlicher Zustand und cancel_requested | -| `POST /api/v1/tenants/{tenant_id}/sessions` | `sessions.request` | Asset, Stufe, Dauer, Zweck → Entscheidung/Sitzungsreferenz | -| `POST /api/v1/tenants/{tenant_id}/operation-plans/{plan_id}/authorizations` | Kein MCP-Werkzeug | Nur interaktiver menschlicher WebUI-Kontext; Antrag/Planhash, Entscheidung genehmigen/ablehnen; bei Genehmigung atomar Nachweis, Ausführung, feste Jobs und Outbox | -| `POST /api/v1/tenants/{tenant_id}/artifacts` | Kein allgemeiner Secret-/Dateiupload durch das Modell | Berechtigter Artefaktimport mit Limits, Hash und Herkunft | - -Für `jobs.get` ist genau eine der beiden IDs zulässig. Der Kunde muss im Request explizit gewählt und im Authentisierungskontext erlaubt sein. Der Name „Kunde X“ wird zuerst eindeutig aufgelöst; gleiche Anzeigenamen dürfen keinen zufälligen Treffer für Änderungen auswählen. - -Der Endpunkt für menschliche Freigaben akzeptiert ausschließlich einen dafür vorgesehenen authentisierten interaktiven WebUI-Benutzerkontext mit Freigaberecht. MCP- und Automatisierungszugangsdaten werden unabhängig von der Rollenmitgliedschaft abgewiesen. Der interaktive Kontext wird technisch getrennt, etwa durch separate Audience und geschützte Websitzung mit CSRF-Schutz. Das bloße Weglassen eines MCP-Werkzeugs ist keine Zugriffssperre. Es gibt keine automatische Policyfreigabe; der Policyservice begrenzt oder verweigert nur. - -`logs.query` nutzt erlaubte Quellkennungen wie Event-Log-Kanal oder Journald-Unit, keine unbeschränkte vom Modell behauptete Datei. Gespeicherte Logs sind innerhalb der Leserechte ohne Einzelgenehmigung lesbar. Eine Live-Erhebung ist ein begrenzter Diagnosejob mit passenden Leserechten UND expliziter menschlicher WebUI-Genehmigung; der Aufruf beantragt ihn lediglich. Zurückgelieferte Logs bleiben nicht vertrauenswürdige Daten. - -### 23.4 Beispiel: Hello World auf Windows und Linux - -Die folgenden JSON-Blöcke zeigen die normativen fachlichen Felder mit fiktiven IDs und Beispielzeitpunkten. Für tatsächliche Tests werden neue IDs und passende zukünftige Fristen erzeugt. Die Beispiele sind keine bereits ausgeführten Aufträge. Die endgültigen Schemas müssen zusätzliche Integritätsfelder und serverseitig ermittelte Zuordnungen entsprechend den vorherigen Abschnitten enthalten. - -Anfrage an `operations.plan`: - -```json -{ - "tenant_id": "11111111-1111-4111-8111-111111111111", - "action": "run_script", - "targets": { - "asset_ids": [ - "22222222-2222-4222-8222-222222222222", - "33333333-3333-4333-8333-333333333333" - ] - }, - "parameters": { - "variants": [ - { - "os_family": "windows", - "interpreter": "powershell", - "encoding": "utf-8", - "script_utf8": "Write-Output 'Hello World'\n" - }, - { - "os_family": "linux", - "interpreter": "posix_sh", - "encoding": "utf-8", - "script_utf8": "printf '%s\\n' 'Hello World'\n" - } - ], - "execution_identity": "agent_service", - "timeout_seconds": 60, - "max_output_bytes": 65536 - }, - "schedule": { - "not_before": "2026-11-12T12:00:00Z", - "start_before": "2026-11-13T12:00:00Z", - "offline_policy": "wait_until_deadline" - }, - "rollout": { - "max_parallel": 5, - "halt_after_failures": 1 - }, - "reason": "Hello-World-Abnahme auf zwei Testgeräten" -} -``` - -Der Server speichert die Skripte als unveränderliche Artefakte, wählt je Ziel die passende Variante und liefert unter anderem `plan_id`, `plan_hash`, `resolved_targets`, `excluded_targets`, `authorization_status` und `expires_at`. Nicht unterstützte Ziele werden mit Gründen sichtbar. Standardmäßig ist der Plan nicht einreichbar, solange ein angefordertes Ziel nicht abgedeckt ist; ein bewusst reduzierter Plan ist eine neue feste Zielmenge. - -Einreichen des Genehmigungsantrags mit `operations.submit` (noch keine Ausführung, auch nicht bei passender Policy): - -```json -{ - "tenant_id": "11111111-1111-4111-8111-111111111111", - "plan_id": "44444444-4444-4444-8444-444444444444", - "idempotency_key": "hello-world-abnahme-001" -} -``` - -Antwort von `operations.submit`: - -```json -{ - "operation_id": "55555555-5555-4555-8555-555555555555", - "plan_id": "44444444-4444-4444-8444-444444444444", - "planned_job_count": 2, - "job_count": 0, - "approval_state": "pending_approval", - "execution_state": null -} -``` - -Ein berechtigter Mensch öffnet anschließend den Antrag in der WebUI. Er sieht beide Zielgeräte, Zielanzahl 2, Interpreter, exakte Skriptinhalte und Skript-/Jobpayload-/Planhashes, Fristen und Auswirkungen und genehmigt explizit dieses feste Paket. Erst diese Aktion erzeugt atomar Genehmigung, Ausführung, zwei Jobs und Outbox. `jobs.get(operation_id)` zeigt dann `approval_state=approved`, `job_count=2` und `execution_state=queued`; zuvor zeigt es `approval_state=pending_approval`, `execution_state=null` und keine Jobs. MCP kann diese Entscheidung nur abfragen, nicht treffen. - -Die Ausführungsaggregation unterscheidet `queued`, `running`, `succeeded`, `partially_succeeded`, `failed`, `cancelled` und `needs_attention`; sie ist getrennt vom Antragsstatus. Sie liefert Zähler pro Jobzustand. `unknown` erzeugt `needs_attention`; „alle erfolgreich“ gilt nur bei bestätigten Erfolgen. Gemischte endgültige Ergebnisse mit mindestens einem Erfolg ergeben `partially_succeeded`. Übersprungene/abgelaufene Jobs zählen nicht als Erfolg. Wiederholtes Submit liefert dieselbe operation_id und den aktuellen Antrags-/Ausführungsstatus, niemals neue Jobs. - -## 24 Aktions-, RustDesk- und Providerverträge - -### 24.1 Typisierte Aktionen - -| Aktion | Wesentliche Parameter | Erfolgsnachweis | -| --- | --- | --- | -| `refresh_inventory` | Scope, gewünschte Quellen, Zeitlimit | Neue Beobachtung mit Erhebungszeit; bei Teilfehlern vollständige Qualitätsangabe | -| `ensure_package` | Unveränderliche Rezeptversion, Paketversion, Architektur, Installationskontext | Produkt/Version unabhängig vom Installerexitcode festgestellt | -| `ensure_rustdesk` (nur später optional, keine MVP-Pflicht) | Unveränderliche Profilversion, dazugehörige Paketrezepte, erlaubte Reparaturschritte | Bei späterer Integration Paket, wirksame Konfiguration, Dienst und ID getrennt nachgewiesen | -| `set_service_state` | Eindeutige Dienstkennung, gewünschter Zustand, Timeout | OS-Dienststatus und gegebenenfalls definierter Funktionscheck | -| `reboot` | Grund, frühester Zeitpunkt, Abhängigkeitsgruppe, Wiederanmeldefrist | Authentisierte Wiederanmeldung, neue Boot-ID, Nachprüfung | -| `run_script` | Exakte Artefakte, Interpreter, Argumente, Identität, Laufzeit, Outputlimit | Ausführungsergebnis plus ausdrücklich definierte Nachbedingungen | -| `apply_updates` | Unterstützter Provider, Auswahl, Regeln zu Reboot und Wartungsfenster | Aktualisierte Inventur, Ergebnis je Update, Scan-/Neustartzustand | -| `query_logs` | Erlaubte Quelle, Zeitfenster, Cursor, Filter und Limits | Quelle, Zeit, Ergebnisgrenzen und neuer bestätigter Cursor | - -Ein Shell-Exitcode 0 belegt den erfolgreichen Prozessabschluss, aber nicht automatisch eine beliebige fachliche Wirkung. Für das Hello-World-Beispiel genügen Exitcode 0 und die erwartete Ausgabe. Für Installationen, Dienstaktionen und Reboots gelten die getrennten Nachbedingungen. - -Freie Skripte laufen als temporäre, zugriffsgeschützte Dateien mit festgelegtem Interpreter und strukturiert übergebenen Argumenten. Standardaktionen werden nicht in einen frei zusammengesetzten Shellstring umgewandelt. Nicht vorhandenes Bash wird nicht mit einer vermeintlich kompatiblen Shell ersetzt. Windows-PowerShell und PowerShell 7 sind unterscheidbare Fähigkeiten. Konfiguration und Policy bestimmen den erlaubten Interpreter; lokale Ausführungsbeschränkungen werden nicht stillschweigend abgeschaltet. - -Für diese Spezifikation bezeichnet die Kennung `powershell` Windows PowerShell 5.1, `pwsh` PowerShell 7 und `posix_sh` `/bin/sh`. Fehlende Interpreter erzeugen `UNSUPPORTED_CAPABILITY`. Der Adapter dokumentiert Encoding und Ausgabeverhalten für den konkreten Interpreter und prüft sie nativ; eine notwendige Encodingtransformation geschieht vor Hashbildung und Planfreigabe. Die Rohbytes der Ausgabe bleiben erhalten. Ein fachlicher Textvergleich darf dokumentiert CRLF und LF normalisieren, verändert aber weder gespeicherte Skriptbytes noch deren Hash. - -### 24.2 RustDeskConfigProfile - -**Historischer Architekturvertrag für eine spätere optionale Integration.** Gemäß Useroverride in 0.1 vollständig aus dieser Umsetzung/MVP ausgeschlossen: keine Profile/Provisionierung, Installation oder externe Desktopabnahme. Die folgenden Anforderungen gelten erst bei gesonderter späterer Beauftragung, nicht als offenes MVP-Gate. - -Ein Profil enthält mindestens `profile_id`, `tenant_id`, `version`, `desired_package_version`, je Plattform die geprüfte Rezept-/Artefaktreferenz, `id_server`, optional `relay_server` und `api_server`, `server_public_key`, Installationskontext, erlaubte Zugriffseinstellungen, Secret-Versionreferenzen und zulässige Reparaturschritte. Ein öffentlicher Serverschlüssel ist kein privater Zugangsschlüssel. - -`ensure_rustdesk` führt folgende Schritte aus: - -1. Betriebssystem, Architektur, Desktopfähigkeit, bestehende Installation und Profilberechtigung prüfen. -2. Freigegebenes Paket beziehen und Herkunft/Hash prüfen; keine frei vom LLM gelieferte Download-URL als privilegierten Installer starten. -3. Paket im definierten Kontext installieren beziehungsweise Sollversion herstellen. -4. Bei Bedarf den Dienst einrichten; Serverkonfiguration, Einstellungen für unbeaufsichtigten Zugriff und Secret-Anwendung als getrennte Schritte durchführen. `--config` wird nicht pauschal als vollständige Einrichtung aller Zugriffsregeln behandelt. -5. Effektive Konfiguration in den tatsächlich genutzten Dienst-/Benutzerkontexten prüfen. -6. Ergebnis mit Einzelprüfungen und Fehlern zurückmelden; Zugangsdaten nie als normales stdout oder MCP-Ergebnis ausgeben. - -Das Ergebnis enthält `package_installed`, `observed_version`, `config_applied`, `profile_id`, `profile_version`, `service_running`, `rustdesk_id`, `reboot_required` und `connection_test_status`. Letzteres verwendet `not_tested`, `passed`, `failed` oder `not_applicable` samt Zeitpunkt und Prüfer. Ein Dienststart allein darf keinen bestandenen externen Verbindungstest erzeugen. - -Ein wiederholter Auftrag darf keine neue RustDesk-Identität erzwingen und kein Passwort unbeabsichtigt rotieren. Gewollte Rotation ist ein eigener profilgebundener Schritt. Fehlt eine passende RustDesk-Plattformunterstützung, lautet das Ergebnis `UNSUPPORTED_CAPABILITY`; der RMM-Agent kann auf demselben Gerät dennoch weiter funktionieren. - -Die End-to-End-Abnahme verwendet einen tatsächlichen RustDesk-Client außerhalb des Zielgeräts und die vorgesehene Server-/Relaykonfiguration. Sie wird nach einem autorisierten Geräte-Reboot wiederholt. Ein WSS-/443-only-Profil darf erst nach Prüfung der eingesetzten Edition und Version als unterstützt erscheinen. - -### 24.3 Proxmox- und PBS-Verträge - -Dieses gesamte Kapitel und seine erste Connectorabnahme gelten erst nach dem MVP, einschließlich Backup- und Clusterprüfungen. Kein hier genannter Client ist für Windows-/Linux-Gastagenten erforderlich. - -Jeder Discoverylauf führt `scope`, `started_at`, `completed_at`, `completeness`, erfolgreiche Teilabfragen und Fehler. 403, Timeout oder Rechtefilter dürfen vorher bekannte Gäste nicht löschen. Fehlende Ressourcen werden erst aus einem erfolgreichen vollständigen Abgleich des betreffenden Bereichs als `missing` gekennzeichnet; Historie bleibt erhalten. - -Provideridentitäten sind mindestens: - -- PVE-Gast: Provider-/Clusterinstanz, Gasttyp, VMID und eigener Ressourcenlebenszyklus. -- PVE-Task: Provider-/Clusterinstanz, Knoten und UPID. -- PBS-Snapshot: PBS-Instanz, Datastore, Namespace, Backup-Typ, Backup-ID und Backupzeitpunkt. - -Gast-Agent-Zuordnung und Backupzuordnung führen Herkunft, Vertrauens-/Prüfstatus und Gültigkeitszeitraum. Ein gleicher Name oder eine gleiche VMID in einem anderen Cluster ist kein Match. Innerhalb eines Clusters verändert Migration die Hostbeziehung, nicht automatisch die Assetidentität. - -Lokale PVE-/PBS-TLS-Verifikation nutzt einen zum Zertifikat passenden Servernamen und eine konfigurierte vertrauenswürdige CA oder einen kontrolliert provisionierten Pin. Ein Zugriff über `localhost` darf Namensfehler nicht durch `accept_invalid_certs` umgehen. Token sind Secrets; Rechte und benötigte Endpunkte stehen je getesteter Version in der Supportmatrix. - -Backupzustände werden getrennt in `schedule_evaluation`, `attempt_result`, `coverage`, `snapshot_presence`, `verification_result` und `restore_test_result` geführt. Jeder Teil kann `unknown` oder `not_applicable` sein und trägt Quelle und Zeit. Ein erfolgreiches Gesamtbackup wird nicht automatisch auf alle Gäste übertragen; nicht interpretierbare Taskdaten erzeugen keinen erfundenen Einzelerfolg. - -Für die erste Abnahme genügt eine ausdrücklich konfigurierte maximale Backupalter-Regel mit zuverlässigem historischem Abdeckungsfenster. Automatischer Import aller Proxmox-Zeitplanvarianten ist ein separater, versionsgeprüfter Provider. Eine fehlende konfigurierte PBS-Verbindung beeinträchtigt den optionalen PBS-Status, macht aber den PVE-Connector nicht insgesamt defekt. - -## 25 Implementierungsreihenfolge und Abnahmekriterien - -Die M0–M8-Tabelle beschreibt die ursprüngliche Roadmap. Für den Lieferumfang 1.33 gilt die [aktuelle Schrittfolge](docs/mvp-completion-plan.md). Die nachstehenden Abnahmen dienen als Referenz für tatsächlich betroffene Verträge. - -### 25.1 Arbeitspakete - -Jedes Arbeitspaket wird als vollständige, lauffähige Erweiterung abgeschlossen. Sicherheits- und Autorisierungsgrundlagen werden vor dem ersten schreibenden Pfad umgesetzt. Ein späteres UI oder MCP darf keine neue Ausführungsabkürzung schaffen. - -| Paket | Lieferung | Verbindliche Abnahme | -| --- | --- | --- | -| M0 Repository und lokale Umgebung | Workspace, gepinnte Toolchain, Fehler-/Konfigurationsmodell, Migrationen, PostgreSQL, Dev-Identitäten, CI-Grundlagen | Frischer Checkout lässt sich nach README starten; zwei Testkunden; keine Secrets im Repository; Dev-Auth in Produktionsprofil verweigert | -| M1 Ausgehende Agentstrecke | Zuerst echter Linux-x86-64-Dienst auf tatsächlicher Test-VM, Enrollment, Zertifikate, WSS, Heartbeat und Basisinventar | Reale Linux-VM meldet OS, Hostname und freien Speicher; unbekannter Host ohne PVE-Zugang zulässig; Rotation/Widerruf; keine eingehende RMM-Firewallfreigabe; Windows-Dienstabnahme erst in späterer Windows-Phase | -| M2 Dauerhafte, menschlich autorisierte Jobs | Plan, begrenzende Policy, persistenter Antrag, minimale interaktive WebUI-Genehmigung, Outbox, Journal, Startgrant, Zustände, Ressourcenlocks und Hello World | Vor Genehmigung keine Ausführungsjobs/Outbox/JobOffers/Startgrants; erster Hello-World-Job erst nach menschlicher Genehmigung; Redelivery ohne zweite Wirkung; ACK, Abbruch und Wiederanlauf geprüft | -| M3 API, MCP Lesen und Verwaltungsoberfläche | Gemeinsame DTOs, Kundenauswahl, Geräteansicht, Datenalter, Jobs, lesende MCP-Werkzeuge | Derselbe Bestand über UI, HTTP und MCP; fremde Kundenbestände unzugänglich; Bereitstellung der Plattform-/Capability-Matrix | -| M4 Paketverwaltung ohne RustDesk | Zuerst Linux-Rezeptkatalog/APT, ensure_package, Paketversions-/Nachprüfung; MSI/EXE erst in Windows-Phase | Allgemeine Paketstrecke auf tatsächlicher Linux-Test-VM mit festem UI-genehmigtem Plan, unabhängiger Versionsprüfung und sicherer Wiederholung nachgewiesen; keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme | -| M5 MCP und Sammelaktionen (Linux-MVP-Abschluss) | operations.plan/submit als Antragsstrecke, Linux-Skripte, Reboot, Rolloutlimits, Teilergebnisse; ohne RustDesk | Linux-Varianten der drei Referenzabläufe 0.3 Nr. 1–3 mit echtem MCP-Client und WebUI-Genehmigung gemäß 0.1; alle Features real auf Linux-VM nachgewiesen; MCP genehmigt niemals; Diagnose/Retry/Folgejob ebenso geschützt; Offlinegerät wartet nur bis Frist; RustDesk-Referenz Nr. 4 ausgeschlossen | -| W Windows nach Linux-MVP | Erst nach Linux-MVP-Abnahme Windows-x86-64-Dienst, Adapter, MSI/EXE und PowerShell sowie M0–M5-Funktionen | Native Windows- und Mischplattformabnahmen, einschließlich AT-15; kein vorgezogener Windows-Abnahmezwang im Linux-MVP | -| M6a Monitoring und ARM64 (nach MVP) | Erwartete Dienste, Alarme, produktiver Metrikpfad, native ARM64-Abnahmen | Keine erfundenen Patchwerte; ARM64 nur auf tatsächlich nativ getesteten Zielsystemen freigegeben | -| M6b Proxmox, Cluster und Backups (nach MVP) | PVE-Modul/-Client auf demselben Linux-Agenten, Discovery, Cluster und Backups; optional PBS | Migration, VMID-Wiederverwendung, Clusterrechte, fehlende Backups, Abdeckung und ACL-Verlust korrekt; keine Abhängigkeit eigenständiger Gastagenten | -| M7 Terminal und produktionsfähiger Betrieb | Relay, begrenzte Shells, Agentupdate, Restoreabgleich, Betriebsdokumentation und Lasttest | Rechteentzug beendet Sitzung; Updatefehler/Restore erzeugen keine Doppelwirkung; dokumentierte Recovery und gemessene Kapazität | -| M8 Optionale Erweiterungen | Geschäftsleistungen, zusätzliche Distributions-/Paketprovider, weitere Integrationen | Eigene Anforderungen und Plattformabnahmen; keine Änderung der Mandantengrenzen | - -**MVP-Grenze und Reihenfolge:** Erst Linux-MVP M0–M5 x86-64 ohne RustDesk, mit WebUI, MCP und autorisierten dauerhaften Jobs; jedes Feature zuerst tatsächlich auf Linux-Test-VM nachweisen. WebUI-Bedienungsausnahme ausschließlich gemäß 0.1. Erst nach dokumentierter Abnahme beginnt W (Windows x86-64); danach folgen M6a/M6b, M7 und M8. PVE-/PBS-/Backup-/Clusterabnahmen sind noch später und blockieren Linux-MVP nicht; keine vorgezogene PVE-Implementierung. Windows-/Mischplattformbeispiele bleiben Zielverträge der Windows-Phase, keine Linux-MVP-Pflicht. RustDesk bleibt spätere optionale Integration und ist weder hier noch automatisch in W Pflicht. Ausgelassene RustDesk-Nachweise sind keine bestandenen Tests und keine offenen MVP-Gates. - -### 25.2 Erste vertikale Strecke - -Für den ersten vollständigen Durchlauf werden zwei Testkunden und die tatsächliche Linux-x86-64-Test-VM genutzt; ein Hypervisor muss weder bekannt noch erreichbar sein. Server lokal in Docker auf dem PC und VM-Anbindung gemäß `docs/development.md`. Die Strecke lautet: Enrollment → ausgehende Verbindung → passives Inventar → feste Zielauswahl → Hello-World-Plan → begrenzende Policyprüfung → `operations.submit` mit persistentem `pending_approval` → berechtigter Mensch prüft und genehmigt in minimaler WebUI feste Linux-Jobs samt Skriptbytes/Hashes → atomar Genehmigung, Ausführung, Jobs und Outbox erzeugen → Job zustellen → Agentjournal → `JobAccepted` → aktuellen Startgrant beziehen und Verbrauch journalisieren → Ausführung auf tatsächlicher VM → gebundene Nachprüfung → Ergebnis. Vor Genehmigung nachweisen, dass kein ausführbarer Job, JobOffer oder Startgrant existiert. Keine erlaubende Testpolicy oder Linux-Dev-Abkürzung; auch Testjobs benötigen menschliche Genehmigung. Passives Standardinventar benötigt keine Jobfreigabe. Windows ergänzt diese Strecke erst nach Linux-MVP-Abnahme. - -Die erste Lieferung muss diese Strecke wirklich ausführen. Danach dieselbe Strecke mit HTTPS Long Polling und einem neu menschlich genehmigten Plan prüfen. Die minimale interaktive Genehmigungs-WebUI ist bereits in M2 Pflicht; die umfassende Oberfläche folgt in M3. Ein Simulator ergänzt reale Tests, ersetzt aber keine native Dienst- oder Installerabnahme. - -### 25.3 Fehler- und Sicherheitsabnahmen - -Alle Ausführungsjobs dieser Tests benötigen explizite menschliche WebUI-Genehmigung, außer wenn gezielt deren Fehlen geprüft wird (dann darf kein Job starten). Keine impliziten Reboots, Updates oder destruktiven Zieltests; Testumfang gesondert ausdrücklich abstimmen. Linux-MVP prüft zunächst Linux-Varianten auf tatsächlicher VM; AT-15 und Windows-Anteile folgen in W nach Linux-MVP-Abnahme. AT-03 gilt im Linux-MVP nur für Gerätezertifikate; der PVE-Anteil, AT-16 und AT-19–AT-23 gehören ausschließlich zu M6b nach der Windows-Phase. AT-25/AT-26 sind Betriebsreifeabnahmen in M7; übrige Fälle werden mit der jeweils gelieferten Capability geprüft, nicht durch spätere Module zum MVP-Blocker. - -| ID | Test | Erwartete Reaktion | -| --- | --- | --- | -| AT-01 | Agent hinter NAT; eingehende Verbindungen blockiert | Inventar und Jobausführung funktionieren ausschließlich über ausgehende Verbindungen | -| AT-02 | WSS blockiert, HTTPS erlaubt | Long-Poll-Strecke funktioniert; Terminalverfügbarkeit wird getrennt angezeigt | -| AT-03 | Geräte- oder PVE-Zertifikat ungültig | Verständlicher Verbindungsfehler, keine automatische Abschaltung der Prüfung | -| AT-04 | Kunde B fragt Asset, Job, Log oder Artefakt von A an | Kein Datenzugriff über HTTP, MCP, Worker- oder Objektpfad | -| AT-05 | Tenant-Kontext fehlt oder Poolverbindung wird wiederverwendet | Zugriff wird verweigert; keine Übernahme des vorherigen Tenant-Kontexts | -| AT-06 | Agent verliert Verbindung nach Annahme, vor Start | Kein neuer Jobstart offline, auch keine Diagnose; nach Kontakt Genehmigung und aktuelle Rechte erneut prüfen | -| AT-07 | Ergebnis-ACK verloren | Derselbe Ergebnisnachweis erneut übertragen; keine erneute Wirkung | -| AT-08 | Agentabsturz direkt nach möglicher Wirkung | `unknown` und Abgleich; freies Skript nicht blind wiederholen | -| AT-09 | Startfrist abgelaufen oder Kunde entzieht Rechte | Vor Beginn keine Wirkung; laufender Paketmanager nur sicher abbrechen | -| AT-10 | Identitätsklon oder Snapshot-Restore | Keine stille Zusammenführung oder historische Wiederholung; erneuter Abgleich | -| AT-11 | Agent meldet alte gepufferte Heartbeats/Messwerte | Keine falsche aktuelle Online-/Grünanzeige | -| AT-12 | Manipulierte Anweisung in Logtext | Daten bleiben Daten; nächster Toolaufruf benötigt unveränderte Autorisierung | -| AT-13 | Gleicher Idempotenzschlüssel mit geändertem Skript | `IDEMPOTENCY_CONFLICT`; keine Ausführung | -| AT-14 | Plan nach Freigabe verändert beziehungsweise Zielmenge erweitert | Hashbindung schlägt fehl oder neuer Plan nötig | -| AT-15 | Windows/Linux-Sammelskript, ein Ziel offline | Passende Interpreter; Ergebnis je Gerät; Offlineziel wartet nur bis zur Frist | -| AT-16 | Reboot von Gast und Hypervisor gleichzeitig angefragt | Abhängigkeiten und unterschiedliche Berechtigungsbereiche werden sichtbar und beachtet | -| AT-17 (später optional, nicht MVP) | RustDesk erneut installieren/konfigurieren | Nur bei späterer Integration: Sollzustand erhalten; keine unbeabsichtigte neue ID/Secretrotation; gesonderter Verbindungstest | -| AT-18 (später optional, nicht MVP) | Headless-/nicht unterstütztes RustDesk-Ziel | Nur bei späterer Integration: ehrliche Capabilitymeldung; keine automatische Desktopinstallation | -| AT-19 | PVE-Token verliert Rechte oder Discovery ist unvollständig | Bekannte Gäste bleiben bestehen; Datenqualität sinkt sichtbar | -| AT-20 | PVE-Collectorwechsel mit verspätetem Taskereignis | Ein historischer Nachweis; aktuelle Sicht nicht durch alte Generation überschrieben | -| AT-21 | VM migriert oder VMID wird neu vergeben | Migration erhält Ressource, Wiederverwendung erhält neuen Lebenszyklus | -| AT-22 | Fälliges Backup startet nie; ein Gast im Sammelbackup scheitert | Fehlende Sicherung und Einzelfehler unabhängig vom Gesamtjob erkennbar | -| AT-23 | Disk vom Backup ausgeschlossen oder LXC-Bind-Mount vorhanden | Abdeckung eingeschränkt/unklar statt uneingeschränkt grün | -| AT-24 | Gateway-/Serverausfall und anschließender Wiederanlauf | Reconnect mit Jitter; dauerhafte Jobs bleiben; keine automatische Doppelwirkung | -| AT-25 | Zentrale aus älterem Backup wiederhergestellt | Änderungen zunächst gesperrt; Journal-/Generationsabgleich vor Freigabe | -| AT-26 | Manipuliertes beziehungsweise unzulässig altes Agentupdate | Update verweigert; funktionsfähige erlaubte Version bleibt erhalten | -| AT-27 | Telemetrie-/Logflut eines Kunden | Quoten und Backpressure greifen; Jobjournal und andere Kunden bleiben geschützt | -| AT-28 | Ein Agent läuft, aber erwarteter Webdienst ist defekt | Verbindung online, fachliche Gesundheit kritisch; Zustände nicht vermischen | -| AT-29 | UI, MCP oder Automatik reicht ohne menschliche Genehmigung ein, auch Diagnose/Hello World | Nur Antrag `pending_approval`, in jobs.get sichtbar; keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung | -| AT-30 | MCP-/Automatisierungstoken mit Approver-Rolle ruft Freigabeendpunkt auf; Policy behauptet Erlaubnis | Token abgewiesen; keine Policyfreigabe; ausschließlich explizite menschliche interaktive WebUI-Genehmigung | -| AT-31 | Transparentes Sammelpaket genehmigen, danach Ziel/Bytes/Frist verändern oder Wildcard verlangen | Alle festen Jobs vor Genehmigung sichtbar; unveränderliche Bindung; jede Änderung neuer genehmigungspflichtiger Plan; keine Dauerfreigabe | -| AT-32 | Retry/neuer Versuch oder Reboot-/Diagnosefolgejob nach Fehler | Neuer fester genehmigter Plan, sofern Folgejob nicht bereits einzeln im genehmigten Paket gebunden; keine implizite Folge-/Retryerlaubnis | -| AT-33 | Derselbe genehmigte Versuch erneut zugestellt; nicht gestartetes technisches Ticket abgelaufen | Keine neue Genehmigung für Redelivery; kein zweiter Start; Ticketersatz nur bei belegtem Nichtstart und weiterhin gültiger Genehmigung | -| AT-34 | Windows-/Linux-VM mit unbekanntem Host und ohne PVE-Agent/-Zugang | Enrollment, Inventar, UI/MCP und genehmigte Jobs vollständig nutzbar; kein PVE-/Hypervisorzwang | - -### 25.4 Definition of Done je Lieferung - -- Tatsächliche Funktionen sind lauffähig; fehlende Fähigkeiten werden ausdrücklich als fehlend ausgewiesen. -- `cargo fmt --check`, sinnvolle Clippy-Prüfungen und die betroffenen Unit-/Integrationstests bestehen auf den passenden Plattformen. -- Datenbankmigrationen und eine Wiederherstellung auf einem frischen Entwicklungsbestand wurden für die betroffene Änderung geprüft. -- Authentisierung, Tenant-Grenzen und relevant veränderte Fehlerpfade sind getestet; eine bestandene Normalfall-Demo allein genügt nicht. -- Protokoll-/API-Änderungen besitzen Schemas, Kompatibilitätsregeln und angepasste Fixtures. -- Bei Windows-/Linux-Systemfunktionen liegt eine native Abnahme vor; Cross-Builds werden nicht als Laufzeittest ausgegeben. -- README und `docs/implementation-status.md` nennen Startbefehle, Konfiguration, implementierte Arbeitspakete und verbleibende Grenzen. -- Keine echten Secrets, Kundenlogs oder privaten Schlüssel im Repository und keine Defaultpasswörter im Produktionsprofil. -- Testergebnisse beschreiben, was tatsächlich geprüft wurde. Nicht ausgeführte Tests werden nicht als bestanden dargestellt. -- Jedes Feature ist zuerst auf tatsächlicher Linux-Test-VM ausgeführt und nachgewiesen; fehlender Realnachweis bleibt offen. Geplante Befehle als geplant, nicht getestet markieren. Keine impliziten Reboots, Updates oder destruktiven Zieltests aus einer Toolinstallationsfreigabe ableiten. - -Die Coding-KI implementiert und testet in dafür vorgesehenen Entwicklungsumgebungen; Installation benötigter Entwicklungs-/Testtools ist ausdrücklich erlaubt. Dies ist keine implizite Genehmigung von Kundensystemänderungen. Enrollment echter Kundengeräte, produktive Neustarts und Bereitstellung auf realer Infrastruktur bleiben gesonderte Betriebsaktionen. Jeder über die Plattform eingestellte Test- oder Kundenjob benötigt weiterhin menschliche WebUI-Genehmigung. - -## 26 Direkt verwendbarer Startauftrag für eine Coding-KI - -Beginne mit [AGENTS.md](AGENTS.md) und dem [aktuellen Lieferplan](docs/mvp-completion-plan.md). Übernimm den nächsten offenen Schritt samt Abnahmekriterium. Prüfe den letzten Originalbeleg und den betreffenden Code. Bei einem Geräteproblem unterscheiden sich Git-Stand, gebautes Artefakt, installierter Prozess und zuletzt gemeldete Serversicht. Der [Entwicklungsweg](docs/development.md) nennt die Standardbefehle für zielbezogene Builds und den direkten SSH-Transfer. Halte das Ergebnis im vorhandenen Plan fest. - -## Quellen und Referenzen - -Alle Quellen sind Primärquellen der jeweiligen Projekte oder Hersteller. Abrufstand ist der 12. November 2026. Architekturentscheidungen, Intervalle, Betriebsziele und Lastszenarien in diesem Dokument sind Empfehlungen; sie sind keine vom Hersteller zugesicherten Eigenschaften der entworfenen Plattform. - -[^1]: Rust Projekt. Rust Programming Language. - -[^2]: Model Context Protocol. Official Rust SDK. - -[^3]: Tokio Projekt. Tokio und Axum. und - -[^4]: Microsoft. Initializing the COM Library. - -[^5]: Microsoft. Working with software installations. - -[^6]: Microsoft. Troubleshooting Windows Package Manager. - -[^7]: Proxmox. QEMU/KVM Virtual Machines. - -[^8]: Proxmox. API Proxy Daemon. - -[^9]: Proxmox. User Management und Tasks API. und - -[^10]: Proxmox. Backup and Restore. - -[^11]: Proxmox Backup Server. User Management. - -[^12]: Proxmox Backup Server. Maintenance Tasks. - -[^13]: PostgreSQL. SELECT und SKIP LOCKED. - -[^14]: Amazon Web Services. Making retries safe with idempotent APIs. - -[^15]: RustDesk. Client Deployment und Client Configuration. und - -[^16]: Model Context Protocol. Streamable HTTP 2026-07-28. - -[^17]: Model Context Protocol. Authorization Security Considerations. - -[^18]: OWASP. MCP Security Cheat Sheet. - -[^19]: PostgreSQL. Row Security Policies. - -[^20]: VictoriaMetrics. Single Node Documentation und Multitenancy. - -[^21]: The Update Framework. Security. - -[^22]: RustDesk. Self Host und erforderliche Verbindungen. - -[^23]: Rust Projekt. Platform Support. - -[^24]: Proxmox. Hardware Requirements. +Für Erstinstallation und Update muss das Manifest zum Prüfzeitpunkt gültig sein. Beim bereits installierten Administrator-Helper prüft der Server die Gültigkeit zum gespeicherten Registrierungszeitpunkt des Releases und die Signatur gegen den aktuellen Schlüsselring. Der Ablauf des Manifests allein blockiert daher keinen Adminauftrag auf diesem Client. [Releaseprüfung](crates/server/src/agent_updates.rs) · [Build und Veröffentlichung](docs/development.md) diff --git a/crates/oidc-auth/POSTGRES.md b/crates/oidc-auth/POSTGRES.md deleted file mode 100644 index b93a82b..0000000 --- a/crates/oidc-auth/POSTGRES.md +++ /dev/null @@ -1,172 +0,0 @@ -# PostgreSQL pre-auth state adapter - -Enable package feature **`postgres-state`**. Dependencies: SQLx 0.8 (PostgreSQL and -Tokio/rustls only; no macros/automatic migrations), RustCrypto `aes-gcm` 0.10. -The default build still has no SQL dependency. No root-workspace changes are needed. - -## Migration and least privilege - -Export: `rmm_oidc_auth::postgres::MIGRATION_SQL`, exactly the package-owned file -`sql/001_oidc_login_states.sql`. Transfer this SQL into a future **normal server -migration** under the migration/owner identity; the adapter never runs it. It is -deliberately not idempotent and creates a dedicated schema/table: - -`rmm_oidc_auth.login_states(state_hash bytea PRIMARY KEY, binding_hash bytea, -expires_at bigint, created_at bigint, encryption_key_ref text, -encryption_nonce bytea, ciphertext bytea)` plus expiry index and integrity checks. - -This is **global PREAUTH state**, not tenant data: no tenant IDs, principal IDs, -memberships or user attributes. Use a separate global-auth-service pool/role, not a -tenant transaction with previous RLS context. Grant only: - -```sql -GRANT USAGE ON SCHEMA rmm_oidc_auth TO your_auth_service_runtime_role; -GRANT SELECT, INSERT, DELETE ON rmm_oidc_auth.login_states TO your_auth_service_runtime_role; -``` - -Replace the example role identifier through the normal deployment configuration, -not a request parameter. Runtime must be **non-owner, NOSUPERUSER, NOBYPASSRLS**, -without schema CREATE, UPDATE, TRUNCATE, tenant-table or migration permissions. -No RLS bypass is needed: the global table intentionally has no tenant RLS policy. -Membership and approval checks remain in the tenant-bound application layer. -Use verified PostgreSQL TLS for remote databases and restricted local transport -where appropriate. Never print DB URLs/passwords or enable parameter logging. - -## Configuration and public API - -```rust,ignore -use rmm_oidc_auth::postgres::PostgresStateStore; - -// Pool supplied by the backend with the dedicated restricted global-auth role. -// Configure bounded acquisition timeout (e.g. 5 seconds) and pool size there. -let state_store = PostgresStateStore::new( - global_auth_pool, - secret_resolver.as_ref(), - "secret-store:rmm/oidc-state-key/version-1".into(), - 10_000, // global outstanding-state capacity, including expired rows -).await?; -// Pass Arc::new(state_store) as the unchanged StateStore port to -// OidcAuth::discover(..., Profile::Production, ..., ...). -``` - -`PostgresStateStore::new(PgPool, &dyn SecretResolver, key_ref: String, -capacity: u32) -> Result` resolves exactly the configured reference, once. -The secret is **32 cryptographically random bytes encoded as unpadded base64url**. -Do not derive it from a password, the OIDC client secret, or a token claim. The -reference must identify an **immutable version**, not a mutable `latest` alias. -Store the key outside PostgreSQL and backups of login-state ciphertext. Ref strings -are metadata, not secret values. Never log the resolved key. - -The library does not automatically read environment configuration. A backend may -map e.g. `RMM_OIDC_STATE_BACKEND=postgres`, `RMM_OIDC_STATE_KEY_REF` and a private DB -connection reference to this constructor; these are integration examples, not -implemented server flags. Missing/invalid configuration must fail startup closed. -`is_persistent()` is true for this adapter; `Profile::Production` continues rejecting -the memory adapter independently. No production in-memory fallback is provided. - -## Confidentiality, atomicity and lifetime - -- The existing flow generates 256-bit opaque state/binding values and passes only - canonical SHA-256 base64url hashes to `StateStore`. PostgreSQL stores their decoded - **32-byte digests**, not raw handles/cookies. Nonce and verifier are validated as - canonical 32-byte random-value encodings before persistence. -- The complete `PendingLogin` JSON is encrypted with **AES-256-GCM**, a fresh random - 96-bit encryption nonce and authenticated associated data binding a fixed format - domain/version, state hash, browser-binding hash, expiry and configured key ref. - Plaintext serialization/decryption buffers and resolved key bytes are zeroized. - The store, pending records and key material have no Debug/log implementation. - Hashes, expiry, version reference and ciphertext length remain DB-visible. - A privileged DBA can delete/deny service, but cannot forge a valid encrypted login - without the external key. Protect the auth-service process and secret resolver. -- Insertion refuses expired states, TTL above **300 seconds**, duplicates and - capacity outside 1..=100,000. Database checks independently bound expiry relative - to creation (600 seconds for clock skew); DB clock also rejects expired insertions. -- A transaction-scoped, database-local advisory lock serializes admission checks - across adapter instances. A fresh READ COMMITTED snapshot prevents capacity races, - even on pools with a different default isolation level. All instances sharing a - table must use the **same capacity policy**. No upsert/overwrite path exists. -- Consumption is one parameterized **`DELETE ... WHERE state_hash=$1 AND - binding_hash=$2 AND encryption_key_ref=$3 AND expires_at > GREATEST($4, DB_now) - RETURNING ...`**. Exactly one concurrent callback receives a record. Wrong binding, - wrong key version, missing/replayed or expired state does not delete a valid row. - Thus a guessed-handle/wrong-cookie request cannot burn someone else's state. -- Delete is committed **before** authenticated decryption/parsing. Corruption, - nonce/code-exchange failure or later callback failure never restores state. A - connection failure during commit has uncertain delivery and fails closed: restart - login, never replay a potentially consumed flow. -- `cleanup_expired(batch: u32) -> Result` deletes only expired rows, at most - `batch` (1..=**1,000**), using the expiry index and one atomic CTE/DELETE. - It intentionally does not use SELECT FOR UPDATE, which would require granting - UPDATE privilege to this read/insert/delete-only role. Concurrent cleanup calls - may select the same expired batch; only one deletes it, another may return zero. - Call periodically from the global auth service; no background scheduler is spawned. - Each adapter transaction uses a 5-second statement timeout and 2-second lock - timeout; pool/network timeouts are the backend's connection policy. Expired rows - count against capacity until cleaned, deliberately failing closed under overload. - Rate-limit login start/callback independently; database capacity is not a rate limit. -- Key rotation for this first adapter is **drain then switch**: pause new logins, - allow outstanding flows to complete/expire, clean expired rows, switch all instances - to a new versioned external key, resume. Do not silently mutate a referenced key or - mix key versions during rolling deployment. Rotate well before 2^32 encryptions per - key. Old/incompatible ciphertext cannot be accepted by a differently configured key. - -All queries use fixed schema/table names and bound data. No runtime table/schema -name interpolation, DDL, role changes, tenant RLS changes or session approvals occur. - -## Explicit real PostgreSQL test - -```sh -python3 crates/oidc-auth/tests/run_postgres.py -``` - -The runner refuses an existing container named **`rust-discovery-oidc-test`**. It -creates only that disposable PostgreSQL 17.6 container, publishes an automatically -allocated port **only on 127.0.0.1**, generates a private ephemeral password in memory, -and removes its own container/anonymous volumes afterwards. Existing PostgreSQL and -RMM containers are never inspected for credentials, restarted, migrated or reset. -No credential file, stdout secret, host service package or VM change is needed. - -The Rust integration test is explicitly ignored in ordinary test runs. The runner -opts in with `RMM_OIDC_TEST_ALLOW_OWNER_DDL=isolated` and a private -`RMM_OIDC_TEST_DATABASE_URL` passed only through process environment; only the -disposable owner test identity applies fixture DDL and creates a separate restricted -runtime role. Do not point these variables at a real server database. - -Checks: runtime nonownership/no superuser/no BYPASSRLS/no schema CREATE and actual -DDL rejection; encrypted persistence; wrong-cookie non-burning; caller/DB expiry; -duplicate/replay rejection; exactly one winner among 16 callbacks; authenticated -ciphertext-tamper rejection and consumption; concurrent capacity 2/8; bounded TTL -cleanup; invalid hashes/TTL rejection. This is a local native PostgreSQL test, not -server/VM or external-IdP acceptance. Actual run results are recorded separately. - -## Actual local verification — 2026-11-12 - -Executed on the development Linux host, not the Linux test VM: - -- `cargo clippy --manifest-path crates/oidc-auth/Cargo.toml --all-targets --all-features --locked -- -D warnings`: passed. -- `cargo test --manifest-path crates/oidc-auth/Cargo.toml --all-features --locked`: - **13 unit tests passed**, 0 failed; the explicit-owner PostgreSQL test is ignored - in this general run; 0 documentation tests. -- `python3 crates/oidc-auth/tests/run_postgres.py`: **1 actual PostgreSQL integration - test passed**, 0 failed, 0 ignored. PostgreSQL 17.6; restricted non-owner role with - real DDL/UPDATE rejection; **1/16** concurrent consume winners; **2/8** concurrent - capacity admissions. Also checked ciphertext, binding non-burning, DB/caller expiry, - duplicates/replay, tamper consumption, cleanup limits, key-version mismatch, - invalid key/hash and overlong TTL rejection. Own disposable container removed. -- `cargo check --manifest-path crates/oidc-auth/Cargo.toml --lib --no-default-features --locked`: passed. -- `cargo fmt --manifest-path crates/oidc-auth/Cargo.toml --check`: passed. -- `cargo package --manifest-path crates/oidc-auth/Cargo.toml --allow-dirty --features postgres-state --locked`: - packaged **11 files** and verified the extracted package build successfully. - Non-failing warning: package metadata has no description/documentation/homepage/repository. - -The first Clippy run rejected a deprecated generic-array nonce constructor; replaced -with array conversion, no lint suppression. The first real database run reached -cleanup but failed there: SELECT FOR UPDATE required UPDATE permission. Cleanup -was changed to a bounded atomic CTE/DELETE, retaining the restricted role rather -than expanding its privileges. Both subsequent real PostgreSQL runs passed, including -the final expanded test. No server DB migration/reset, runtime server restart, -membership change, host package installation, VM effect or production acceptance. - -The migration has been applied only to the disposable test database. Applying it -through normal server migrations, provisioning the global auth role/key reference, -and wiring backend configuration/routes remain explicit integration work. diff --git a/crates/oidc-auth/README.md b/crates/oidc-auth/README.md index 8b0d5a7..2315b4e 100644 --- a/crates/oidc-auth/README.md +++ b/crates/oidc-auth/README.md @@ -1,164 +1,5 @@ -# RMM OIDC authentication adapter (standalone package) +# Authentisierung im MVP -Optional encrypted SQLx/PostgreSQL login-state storage and its migration/permissions -contract: **[POSTGRES.md](POSTGRES.md)** (`postgres-state` feature). +Die öffentliche WebUI verwendet ein lokales Konto mit Passwort und TOTP. Der MCP-Server prüft kundengebundene Bearer-Tokens. Die Einrichtung dieser beiden Zugänge steht in der [Betriebsanleitung](../../docs/public-access.md). -This crate is **not wired into the server** and does not change the root workspace. -It authenticates against a configured HTTPS OIDC provider using real RSA signatures, -discovery, JWKS and authorization-code exchange. It never grants tenant membership, -roles, approval authority or an RMM session by itself. External IdP configuration is -currently **not_configured**; no external-provider or VM acceptance is claimed. - -## Explicit supported provider profile - -- RS256 only, RSA signing JWKS with unique `kid`, `alg=RS256`, `use=sig`. - Mixed-algorithm JWKS are deliberately rejected by this initial strict profile. -- Configured issuer is the only authority. Discovery's issuer must match exactly; - authorization, token and JWKS endpoints must be HTTPS, same **origin** (including - port) as that issuer, with no userinfo, fragment or query. Providers using a separate - CDN/origin for JWKS are not supported, rather than automatically trusted. -- Normal rustls trust roots, optional explicitly provisioned CA roots; no HTTP, - insecure certificate mode, HTTP redirects or environment proxy. Administrators - must restrict configured issuers/network egress; user input cannot choose issuers. -- Browser: authorization code, `openid`, PKCE S256, random nonce/state/browser binding, - fixed registered HTTPS callback, `client_secret_post`. The IdP must advertise these - features. PKCE rejection surfaces as `CodeExchange`; response bodies are not logged. -- MCP: RFC 9068 JWT **access** token with `typ=at+jwt`, dedicated resource audience, - approved `client_id`, required `jti`, issuer/signature/expiry/nbf/iat checks, required scopes. - Opaque/introspected tokens and other JWT access-token profiles are unsupported. - Browser ID tokens are never accepted as bearer credentials. -- JWT validity uses zero clock leeway; synchronize clocks. Browser multiple audiences - require matching `azp`; any supplied browser `azp` must match the browser client ID. -- JWKS cache TTL 300 seconds; unknown-kid refresh throttled to once per second, - serialized across callers. A newly rotated key may require retry after one second. - Invalid JWKS/failed refresh clears the old key cache and fails closed. Revocation of - a cached key is bounded by the TTL, not instantaneous. Issuer operator must rotate - to a **new kid** (same-kid replacement is visible on the next TTL refresh). -- HTTP connect timeout 3 seconds, total request timeout 10 seconds, response 128 KiB, - JWT 32 KiB, code 4 KiB, maximum 64 signing keys. No refresh-token persistence. - -## Public integration API - -```rust,ignore -let auth = OidcAuth::discover( - Config { - issuer: Url::parse("https://idp.example/realms/rmm")?, - browser_client_id: "rmm-browser".into(), - client_secret_ref: "secret-store:rmm/oidc-client".into(), - redirect_uri: Url::parse("https://rmm.example/auth/oidc/callback")?, - mcp_audience: "https://rmm.example/mcp".into(), - mcp_client_ids: BTreeSet::from(["approved-mcp-client".into()]), - }, - Profile::Production, - persistent_state_store, - secret_resolver, - vec![], // normal roots; provision a private CA explicitly if necessary -).await?; -let start: LoginStart = auth.login_start().await?; -// Set start.binding_set_cookie and redirect to start.authorization_url. -let identity: Identity = auth.callback(Callback { - code: parsed_query_code, - state: parsed_query_state, - browser_binding: parsed_host_binding_cookie, -}).await?; -let bearer: BearerIdentity = auth - .verify_mcp_bearer(raw_bearer, &["inventory:read"]).await?; -``` - -`SecretResolver::resolve(reference)` returns `secrecy::SecretString`; resolve from an -authorized secret store, never from a token claim. The adapter exposes only coarse -typed `Error`s, not reqwest errors (which may contain URLs), codes or token bodies. -Do not log callback URLs, authorization URLs, cookies, state records, secrets or JWTs. -Sensitive flow types intentionally do not implement `Debug`. - -### Required server/cookie adapter work (not implemented here) - -1. Register login start and **GET** callback routes. Rate-limit both; do not allow - caller-supplied issuer, audience, scopes, redirect URI or post-login return URL. - Reject duplicate query/cookie parameters and provider error callbacks. Return - `Cache-Control: no-store` and `Referrer-Policy: no-referrer` on all auth routes; - avoid request/query logging and third-party resources there. -2. Set `LoginStart.binding_set_cookie` verbatim: `__Host-rmm_oidc_binding`, Secure, - HttpOnly, Path=/, **SameSite=Lax**, Max-Age=300, no Domain. Strict would omit this - cookie on the cross-site provider callback. Start replaces an outstanding binding; - multi-tab login is intentionally fail-closed, not a bypass. -3. Pass only parsed code/state and binding cookie value to `callback`. The store must - atomically consume state before token exchange. On terminal callback success or - failure, clear binding with `CLEAR_BINDING_COOKIE`; failures require fresh login. -4. Resolve `Identity { issuer, subject }` to a persistent principal and **current** - scoped memberships. Email and untrusted group/role claims are not identity keys or - memberships (this crate does not expose them). No implicit all-tenant role. -5. On browser success only, rotate/create a new opaque RMM session, bound to that - principal, with bounded expiry and the existing Secure/HttpOnly/host-only - **SameSite=Strict** final session cookie. Keep CSRF token + exact Origin checks - for writes, authorization checks and explicit UI plan approval. An ID token is - not an RMM session cookie or permission to approve a plan. -6. Bearer always wins over browser cookies. Use `verify_mcp_bearer` only for MCP/API - bearer paths; combine returned scopes with persistent memberships on **every** - request. Never construct an interactive browser session or approval context from - a bearer token, even if a principal has an approver membership. Preserve - `pending_approval` and all immutable plan/attempt bindings. -7. Logout must invalidate the **server-side RMM session**, clear the final cookie, - require its normal CSRF/Origin checks and prevent reuse. IdP logout is intentionally - not implemented or falsely advertised; local logout does not end an IdP session. -8. Disable dev identities/simulated principals in production independently of this - crate. Existing dev identity auth is not replaced until the backend is integrated. - -### Persistent state store port - -Alternative adapters must implement async `StateStore::{insert, consume}` plus `is_persistent() == true` using -shared durable storage. Do not merely return true for a memory-backed adapter. -State lookup keys and browser bindings supplied to the store are SHA-256 base64url -hashes; records contain nonce, verifier and absolute Unix expiry. Protect record -contents at rest and restrict database access. `insert` must enforce unique keys, -bounded capacity and expiry cleanup. `consume` must perform one atomic conditional -delete/return based on `(state_hash, binding_hash, expires_at > now)`; no read-then- -delete race, no restoration after exchange/nonce failure. A SQL transaction or -`DELETE ... WHERE ... RETURNING` is suitable. Store failures must fail closed. - -`dev::InMemoryStateStore::new(dev::DevTestOnly)` exists only under the explicit -`dev-memory-store` feature or unit tests. `Profile::Production` rejects it. This is -not a production SQL adapter. The optional PostgreSQL adapter below supplies durable -encrypted storage; applying its migration and server wiring remain integration work. - -## Targeted local verification - -```sh -cargo fmt --manifest-path crates/oidc-auth/Cargo.toml --check -cargo clippy --manifest-path crates/oidc-auth/Cargo.toml --all-targets --all-features -- -D warnings -cargo test --manifest-path crates/oidc-auth/Cargo.toml --all-features -``` - -Tests run a native loopback HTTPS OIDC provider with an ephemeral private CA, real -2048-bit RSA signing keys/JWKS, actual one-use authorization codes, real form-encoded -token exchange and server-enforced PKCE. The CA is added only to the test clients, -never to the host truststore. No checked-in private key, external IdP, VM modification, -host-service installation, Docker/server restart or reboot is needed. The provider -is a test double, not a claim of external-provider interoperability or VM acceptance. -Test assertions/counters contain no secret output. Run results are reported separately -by the implementation dispatch, not presumed by these commands. - -### Actual local verification (2026-11-12) - -Executed on the development Linux host, not the Linux test VM: - -- `cargo fmt --manifest-path crates/oidc-auth/Cargo.toml --check`: passed. -- `cargo clippy --manifest-path crates/oidc-auth/Cargo.toml --all-targets --all-features -- -D warnings`: passed. -- `cargo test --manifest-path crates/oidc-auth/Cargo.toml --all-features --locked`: - **13 passed, 0 failed**; 0 documentation tests. Covers real code exchange, - browser binding/replay/expiry/concurrency, PKCE failure, nonce/authorized party, - issuer/audience/expiry/nbf/iat/required claims/scopes, algorithm/signature/ID-token - confusion, JWKS caching/rotation, actual TLS trust/hostname rejection, discovery - origin restrictions, HTTP redirect rejection and response/token size limits. -- `cargo metadata --manifest-path crates/oidc-auth/Cargo.toml --no-deps --format-version 1`: - independent workspace at `crates/oidc-auth`, exactly one member and own lockfile. - -Initial build checks found missing URL serde and JWT PEM feature flags; both were -fixed. Clippy found an unnecessary test `format!`, also fixed. The final commands -above passed after those corrections. Pinned lockfile resolves jsonwebtoken 10.4.0, -reqwest 0.12.28 and rustls 0.23.46 on the repository's Rust 1.99.1 toolchain. - -Not executed in that initial verification: external real-IdP interoperability, production SQL state adapter, -server routes/cookies/sessions/membership integration, VM execution or browser UI -login against the running RMM server. Timeout values are configured; a deliberately -stalling provider timeout test has not been run. No production acceptance claimed. +Dieses Rust-Paket wird vom Server als lokale Abhängigkeit eingebunden und enthält den separat konfigurierbaren OIDC-Adapter. Im öffentlichen MVP ist dieser Adapter deaktiviert. [Server-Abhängigkeiten](../server/Cargo.toml) · [Authentisierung im Server](../server/src/auth.rs) diff --git a/crates/server/OIDC.md b/crates/server/OIDC.md deleted file mode 100644 index d5a8847..0000000 --- a/crates/server/OIDC.md +++ /dev/null @@ -1,200 +0,0 @@ -# Integrated OIDC/OAuth authentication - -The server now wires `rmm-oidc-auth` into real browser, HTTP and MCP paths. External -IdP deployment is **not_configured** unless the administrator supplies configuration. -No external-provider interoperability or production/VM acceptance is implied. - -## Configuration - -Set `RMM_OIDC_CONFIG_FILE` to an absolute, regular non-symlink **0600** JSON file -with a same-owner, non-group/world-writable parent. All secret references are absolute -0600 private files with that same owner and safe parent. Their contents are never -passed as argv, logged, reflected in errors or read as shell. Example (placeholders): - -```json -{ - "issuer": "https://idp.example/realms/rmm", - "browser_client_id": "rmm-browser", - "client_secret_ref": "/private/rmm/oidc-client-secret-v1", - "redirect_uri": "https://rmm.example/auth/oidc/callback", - "mcp_audience": "https://rmm.example/mcp", - "mcp_client_ids": ["approved-mcp-client"], - "auth_database_url_ref": "/private/rmm/oidc-auth-database-url", - "state_key_ref": "/private/rmm/oidc-state-key-v1", - "extra_ca_file": null, - "testsimulation": false -} -``` - -`RMM_UI_ORIGIN` must be the exact HTTPS origin without trailing slash. The callback -must equal that origin plus `/auth/oidc/callback`. Normal roots are used; optional -`extra_ca_file` explicitly provisions a private IdP CA, never an insecure TLS mode. -Issuer discovery/JWKS/endpoints use configured-issuer same-origin HTTPS, no redirects, -fixed RS256 and bounded requests. The supported provider profile is documented in -`../oidc-auth/README.md` (PKCE S256, nonce, client_secret_post; RFC9068 access tokens). - -`state_key_ref` contains 32 random bytes encoded as unpadded base64url, with an -immutable versioned reference. The package's AES-256-GCM state protection, 300-second -TTL, atomic binding/consume, capacity and drain-before-key-rotation rules remain intact. -Global state cleanup runs in bounded 1,000-row batches every 30 seconds. - -Production requires `RMM_PROFILE=production`, `RMM_DEV_AUTH=false`, configured OIDC -and **no** RMM_DEV_USERNAME/PASSWORD, RMM_OPERATOR_A/B or RMM_VIEWER_A/B values. -Production with dev auth is rejected before connecting. `testsimulation=true` is -accepted only in the explicit development profile, never derived from token claims. -Development retains the existing separately credentialed browser/viewer/operator -paths. Neither profile silently falls back after invalid explicit bearer credentials. -Non-OIDC production gaps remain: the local ArtifactStore is still development-only; -artifact-dependent features fail closed until a production adapter is supplied. -Root/APT selected policies remain development-only and unchanged in their authority. - -## Migration and provisioning - -Normal migration **0011_oidc_auth.sql** creates global encrypted pre-auth state and -the administrator-maintained external identity index, extends membership kind with -`human` and constrains authorization audit pairs to exactly: - -- `dev_test_browser_simulation` + `testsimulation=true` -- `human_webui` + `testsimulation=false` - -The runtime does **not** create schemas, tables, identities, memberships or roles. -Apply normal migrations without resetting DB/PKI. Provision a separate global-auth -login identity with only schema USAGE and table SELECT/INSERT/DELETE on -`rmm_oidc_auth.login_states`. The server verifies that this pool is neither superuser, -BYPASSRLS, table owner nor schema creator, and cannot SELECT tenant memberships. -The tenant application pool remains `rmm_app`, nonowner and RLS-bound. Neither needs -a general RLS bypass. Do not reuse the tenant application's database URL for auth state. - -An administrator explicitly registers each external `(issuer,subject)` in -`public.oidc_principals` and assigns tenant routing references; the principal ID is: - -`oidc:` + lowercase SHA-256 hex of compact UTF-8 JSON `[issuer,subject]`. - -Rust helper: `oidc::principal_id`. Email/group claims are never identity or membership. -The index is routing metadata only: each chosen tenant still requires a current, -unrevoked `memberships` row with explicit permissions. Browser login additionally -requires membership kind **human**. No auto-registration, tenant or role grants occur. -Disabling the index entry revokes subsequent auth and persisted permission rechecks, -including start-time rights checks for existing plans. Membership revocation is read -on every authenticated HTTP/MCP call, not cached from an ID token or browser session. - -Only narrow, fixed-search-path SECURITY DEFINER lookup functions expose identity -routing/enabled status to rmm_app; they do not bypass/query memberships RLS or return -foreign inventory. MCP/HTTP permissions intersect the validated access-token scopes -with current membership. Script/root operations retain their additional permission -and selected-helper checks. Bearers have no interactive session context, even with -an approver membership/scope plus a valid browser cookie. - -## UI-compatible routes and cookie contract - -- `GET /auth/config`: `{oidc_configured,oidc_login_url,dev_login_enabled}`. - `oidc_login_url` is `/auth/oidc/login` when configured, otherwise null. UI can show - a nonempty configured-provider sign-in link without knowing secrets. -- `GET /auth/oidc/login`: code-flow redirect, binding cookie - `__Host-rmm_oidc_binding`, Secure/HttpOnly/Path=/, **SameSite=Lax**, 300 seconds. -- `GET /auth/oidc/callback`: code + state (optional issuer response check), duplicate - query/cookie rejection, one-use DB state, token exchange and nonce/PKCE/signature - checks, persistent principal/membership mapping. Clears binding on success/failure. - Establishes a new opaque RMM session and redirects only to `/`, never user input. -- `GET /auth/session`: existing DTO retained (`principal`, `tenant_id`, `permissions`, - `roles`, `csrf_token`, `testsimulation`, `approval_origin`). Final cookie remains - `__Host-rmm_session`, Secure/HttpOnly/host-only, **SameSite=Strict**, one hour. - Sessions remain in memory; restart requires fresh OIDC login, not job resubmission. -- `POST /auth/logout`: exact Origin + session CSRF; server-side invalidation and cookie - clearing. Local RMM logout only; no false claim of IdP logout. - -All auth responses are no-store/no-referrer. Do not enable callback/query logging, -browser traces, HAR, screenshots or third-party resources on auth pages. Browser -writes and plan authorizations retain exact Origin/CSRF and immutable plan binding. - -Tenant selection comes from the API path, overriding an incoming X-RMM-Tenant header; -MCP dispatch selects its explicit tenant_id. X-RMM-Tenant is only a selection hint for -other calls, never authority: it must exist in the mapped index AND current tenant -membership. `/api/v1/tenants` lists current readable memberships using separate RLS -transactions. Foreign tenant/asset paths remain not-found, not token-controlled routing. - -## Targeted integration tests - -`python3 tests/oidc/server_integration.py` starts an ephemeral native TLS mock IdP -and native loopback API instance against the existing development PostgreSQL. It -provisions/removes only its own synthetic identity/human membership and a distinct -restricted auth-state login role. No approval/job/permit/VM fixture is fabricated. -It uses a private ephemeral CA, real RSA signatures/JWKS, actual one-use code exchange -and PKCE. The Chromium step uses a temporary NSS truststore, no TLS bypass/artifacts, -and actual provider UI navigation/cross-site callback; **no job approval** occurs. -It also starts a configured production-profile API with simulation false to check -the production auth path, not to claim real-provider/human production acceptance. -Credentials are parsed internally from local private development configuration; -never printed, sourced, passed in argv or included in test failure output. - -Existing backend contract, transport, pages/catalog, sync and local integration tests -remain required after deployment. Actual commands/counts are returned by the dispatch; -the descriptions here are not presumed successful test results. - -## Verified local auth increment (2026-11-12) - -- Native server build and `cargo clippy -p rmm-server --all-targets --locked -- -D warnings` - passed; changed server files passed targeted rustfmt checking. -- Targeted Rust tests: server **7**, domain **11**, protocol **3**, persistence **0**; - all passed. Three server tests cover the added cookie/scope/identity contracts. -- Standalone OIDC package: **13** unit tests passed; the ordinary run explicitly - ignores its owner-opt-in database test, then `tests/run_postgres.py` ran that **1** - real PostgreSQL integration test successfully (1/16 consume, 2/8 capacity). -- Integrated native server/real mock TLS/real PostgreSQL/Chromium test: - **35 assertions passed**, including production-profile startup with OIDC configured, - simulation false and dev login absent, and actual MCP tool scope enforcement. - No plan was approved or executed by this increment. -- Python syntax checks and Node browser-script syntax check passed. - -Initial build/harness failures were corrected without weakening checks: root Cargo -needed to exclude the nested standalone OIDC workspace; Python environment merging -needed to avoid duplicate keywords; dev login must not register its JSON extractor -route in production; MCP testing must consume a concrete SSE response instead of -waiting for stream closure. A backend regression also exposed that tenant-denied -authentication must preserve NOT_FOUND in the MCP/HTTP structured error code; the -shared mapper now preserves it instead of calling every failure UNAUTHENTICATED. - -External IdP configuration and all VM/real-human production-approval acceptance -remain open. The running development deployment intentionally retains its existing -dev identities unless an administrator provisions the OIDC configuration and the -separate state-pool identity; no sample provider is silently enabled there. - -### Final deployed backend verification - -Normal additive migrations **0009, 0010 and 0011** were applied without DB/PKI -reset; successful migration history is **1 through 11**. Docker release build of -server **and agent** succeeded after adding the exact embedded helper unit -`deploy/linux/rmm-apt-helper.service` to the Docker COPY/context whitelist. The -unit/helper/provider source and its hardening were not altered by this auth work. - -`python3 deploy/dev.py up` rebuilt/recreated only the project server/migration service; -existing PostgreSQL stayed running. Final server observation: - -- started **2026-11-12T19:12:38.969913632Z**, status running; -- image `sha256:545318218433a5d0be96c9368096cb2850b059be0b690bee5044ab28aad5cb82`; -- published TLS port only `127.0.0.1:18443`; PostgreSQL has no published port; -- actual `/auth/config` returns dev login enabled, OIDC not configured, login URL null. - -All five affected backend integration programs then passed against that deployment: - -| Program | Actual PASS assertions | -| --- | ---: | -| `tests/backend_contract.py` | 42 | -| `tests/backend_transport.py` | 20 | -| `tests/backend_pages_catalog.py` | 25 | -| `tests/backend_sync.py` | 28 | -| `tests/local_integration.py` | 35 | -| **Total** | **150** | - -These are assertion counts in five integration programs, not 150 Rust test cases. -They cover unchanged immutable pending/approval boundaries, mTLS and rotation, -fencing/housekeeping, catalog/pagination/membership, signing-key/bootstrap, -Sync/reconnect/restore denial, extended native inventory and tenant isolation. -The final NOT_FOUND mapper correction passed the previously failing MCP foreign- -tenant contract. Four additional actual database-boundary assertions passed: -rmm_app cannot directly read pre-auth state or the external identity index, the -narrow lookup rejects a missing identity, and rmm_app remains non-superuser/non-BYPASSRLS. - -No VM/systemd/root/APT effect, positive plan approval or privileged-helper execution -was performed by this dispatch. Linux-MVP, positive consumed-job/helper SyncAck and -real external-IdP/human production-approval acceptance remain separate gates. diff --git a/crates/updater/src/lib.rs b/crates/updater/src/lib.rs index 50e4150..ed97751 100644 --- a/crates/updater/src/lib.rs +++ b/crates/updater/src/lib.rs @@ -1,7 +1,7 @@ //! Pure release verification. This crate does not install, stage, start services, //! grant approval, persist antirollback state, or trust keys from the network. //! -//! See docs/agent-updater-proposal.md for the separate, unfinished integration. +//! The release catalog and deployment workflow are described in `docs/development.md`. mod bootstrap; mod manifest; diff --git a/deploy/browser/README.md b/deploy/browser/README.md index c23c215..83b42ea 100644 --- a/deploy/browser/README.md +++ b/deploy/browser/README.md @@ -1,54 +1,21 @@ -# Isolated local browser integration — no VM execution +# WebUI im Browser prüfen -`run_pending.py` uses existing test bootstrap helpers to enroll a real mTLS device -fixture on the local dev backend, never a forged database agent identity. It sends -a ClientHello advertising `run_script` only to exercise plan validation; it does -not implement an executor, ask for a permit, authorize or report an execution. -The browser sends a durable pending request via the actual UI. The fixture is -revoked afterwards; its pending request and enrollment history are retained. -An artifact-count guard checks that jobs/outbox/grants did not increase. +## Oberflächentests mit Testdaten -Requirements: initialized/running dev Docker backend on loopback 18443, built UI -served from `web/dist`, public CA `devstate/pki/ca.pem`, private existing browser -login `devstate/browser-login.json` (owned, mode 0600). Credential values are never -CLI arguments, printed or copied into source. No VM credentials are used. - -Project-local tools (commands for reproducing setup; actual execution occurred in -the implementation session): +Die Playwright-Spezifikationen für Auftragsdialog, Genehmigungseingang, Kunden und MCP-Tokens starten einen lokalen Testserver und liefern kontrollierte API-Antworten. Sie prüfen die Oberfläche ohne Zugangsdaten und ohne Aufträge auf realen Geräten. Die Befehle beginnen im Repository-Stamm. ```sh cd web -npm ci --ignore-scripts -PLAYWRIGHT_BROWSERS_PATH="$PWD/node_modules/.cache/playwright-browsers" npx playwright install chromium -mkdir -p node_modules/.cache/nss-tools -cd node_modules/.cache/nss-tools -apt-get download libnss3-tools -dpkg-deb -x libnss3-tools*.deb root +npm ci +export PLAYWRIGHT_BROWSERS_PATH="$PWD/node_modules/.cache/playwright-browsers" +npx playwright install chromium +npm run test:browser -- approval-inbox.spec.ts customer-management.spec.ts mcp-token-management.spec.ts order-composer.spec.ts ``` -No package installed globally. The runner uses installed `certutil` if available, -otherwise the locally extracted binary. It imports the **public** CA into isolated -`web/node_modules/.cache/browser-home/.pki/nssdb`, with browser HOME restricted to -that directory. Existing global browser/user trust and hosts files are untouched. -DNS overrides map only fixed test names to 127.0.0.1; TLS/SNI still verifies the -original DNS name. No certificate bypass flag or ignoreHTTPS option exists. +Die [Playwright-Konfiguration](../../web/playwright.config.ts) verwendet einen Worker und den projektspezifischen Reporter. Bei Tests mit Zugangsdaten die vorgegebenen Einstellungen für Reporter, Trace, Video und Screenshots verwenden. Private Browserdaten und Fehlerartefakte liegen im lokalen Cache. -From repository root: +## Abnahme auf Testgeräten -```sh -python3 deploy/browser/run_pending.py -``` +Für den fachlichen Ende-zu-Ende-Nachweis auf einem Testgerät den gespeicherten Plan prüfen, die persönliche WebUI-Entscheidung abwarten und das Ergebnis des gebundenen Versuchs auswerten. Bei einem Neustart zusätzlich Bootwechsel, erneuten authentisierten Kontakt und Erfolg des Folgeauftrags erfassen. Die Nachweise für Linux und Windows enthalten Plan-, Auftrags- und Versuchskennungen. [Produktabnahme](../../docs/mvp-completion-plan.md) -Real Playwright tests verify normal trusted HTTPS plus rejection of wrong DNS name -and an untrusted CA. The positive UI case only plans/submits and never clicks -approval. CSRF is tested by deleting the token from an actual logout UI request; -403 and continued session visibility are required, followed by valid logout. -No direct API/DB approval path is used. Reporter suppresses raw errors, action logs, -stdout/stderr; traces/screenshots/video are off. Failure artifacts remain private -and must not be published. Sanitized evidence records booleans/statuses only, no -hostnames/keys/passwords. Bounded retries are not automatic: a failing run fails; -a separate rerun must reauthenticate and creates a new explicit pending plan. - -`RMM_E2E_MODE=execute` is an additional separate opt-in for the prepared positive -approval/result test, to use only after a real authorized agent path is ready. -This pending-only run is neither native VM evidence nor positive approval proof. +Ein simulierter Testprincipal ist ausschließlich im getrennten dev/test-Profil zulässig. Dessen WebUI und Audit kennzeichnen die Simulation. Den internen Entwicklungszugang und dessen eigene TLS-Vertrauensstellung beschreibt die [Betriebsanleitung](../../docs/operations-access.md). diff --git a/deploy/cloud_script_console_upgrade_v1.py b/deploy/cloud_script_console_upgrade_v1.py index 41e9c1b..ee58fea 100644 --- a/deploy/cloud_script_console_upgrade_v1.py +++ b/deploy/cloud_script_console_upgrade_v1.py @@ -3,8 +3,7 @@ prepare is offline. inspect/status are remote read-only. build/deploy each launch one durable, create-once case worker. Lost replies permit status only, not retry. -The notebook never runs an RMM server/client. Existing deployment tools remain -unchanged. See docs/script-console-cloud-upgrade-v1.md before actual use. +The current server deployment workflow is documented in docs/development.md. """ import argparse import base64 diff --git a/deploy/cloud_script_console_upgrade_v2.py b/deploy/cloud_script_console_upgrade_v2.py index 602699c..f170328 100644 --- a/deploy/cloud_script_console_upgrade_v2.py +++ b/deploy/cloud_script_console_upgrade_v2.py @@ -3,8 +3,7 @@ prepare is offline. inspect/status are remote read-only. build/deploy each launch one durable, create-once case worker. Lost replies permit status only, not retry. -The notebook never runs an RMM server/client. Existing deployment tools remain -unchanged. See docs/script-console-cloud-upgrade-v2.md before actual use. +The current server deployment workflow is documented in docs/development.md. """ import argparse import base64 diff --git a/deploy/linux/README.md b/deploy/linux/README.md index 1edacd9..5b6aa50 100644 --- a/deploy/linux/README.md +++ b/deploy/linux/README.md @@ -1,277 +1,26 @@ -# Linux agent/helper bootstrap contract (not a VM acceptance) +# Linux-Agent betreiben -**Current integrated runtime contract:** [runtime-README.md](runtime-README.md). -The module-only blockers and integration steps below record the earlier increments; -they are historical and superseded by that runtime document. In particular Sync, -HTTPS, rotation and authenticated helper apply are now wired in source, not VM- -accepted. Use the current document and installed units for new bootstrap work. +Der Linux-Client für `x86_64-unknown-linux-gnu` meldet sich ausgehend per mTLS am Gerätegateway. Als Systembenutzer `rmm-discovery` liefert er Heartbeats und Inventar, holt genehmigte Shell-Skripte ab und meldet Ausgabe und Exitcode zurück. Der optionale Root-Helper gehört zur gleichen signierten Releaseversion wie der Agent. -Dedicated APT runner, exact config/unit/CLI/readiness/agent-routing preflight: -[`apt-helper-README.md`](apt-helper-README.md). This newer profile does not weaken -the existing general/readiness helper unit. Native VM measurements remain open. +## Installation -No install/start/reboot command in this document has been executed on the VM. -No RustDesk component is installed. Deploy only the artifacts/configuration for -the explicitly agreed test; do not copy central signing/TLS private keys. +1. In der WebUI den Zielkunden wählen, **Gerät aufnehmen** öffnen und einen Einmalcode erzeugen. +2. Auf dem x86-64-Linux-Gerät mit systemd und Python 3 den dort angezeigten Linux-Befehl ausführen. Er lädt `/install/linux.sh` über HTTPS und ruft es mit `sudo sh` und dem Bootstrap-Ursprung des Servers auf. Den Einmalcode am verdeckten Prompt eingeben. +3. Für Root-Skripte die Administratoroption der WebUI wählen. Sie ergänzt `--enable-admin-scripts`. Auf einem bereits eingeschriebenen Gerät lässt sich der Installer mit demselben Ursprung und dieser Option erneut ausführen. Die Geräteidentität bleibt erhalten. +4. Im Gerätedetail Hostname, Kunde, Agentversion und letzten authentisierten Kontakt kontrollieren. Für einen Root-Auftrag braucht das Gerät den gemeldeten Root-Kontext und eine passende zentrale Geräteregel. Ein MCP-Token benötigt zusätzlich die passenden Rechte für diesen Kunden. [MCP-Zugang](../../docs/public-access.md) -## Built artifacts and process configuration +## Selbstupdate und Diagnose -Planned build command (the debug test/build commands actually executed are listed -in `tests/agent_jobs/README.md`): +`rmm-discovery-update.timer` ruft den Releasebestand nach dem Booten und anschließend alle fünf Minuten mit einer zufälligen Verzögerung von bis zu 20 Sekunden ab. Vor dem Wechsel prüft der Updater das signierte Paket und die Auftragsjournale. Eine neue Generation wird durch den frischen Kontakt des Agenten bestätigt. Scheitert die Aktivierung, wählt der Updater den Vorgänger. Ein über den Installer aktivierter Helper wechselt zusammen mit dem Agenten. [Installer und Aktualisierungslogik](../../crates/server/src/bootstrap/lifecycle.py) -```sh -cargo build --release -p rmm-agent -p rmm-privileged-helper -``` +| Am Gerät prüfen | Befehl oder Pfad | +| --- | --- | +| Agent und letzter Update-Lauf | `systemctl status rmm-discovery-agent.service rmm-discovery-update.timer` und `journalctl -u rmm-discovery-update.service -n 50` | +| Installierter Root-Helper | `systemctl status rmm-discovery-managed-script-helper.service` | +| Aktive Generation | `readlink -f /opt/rust-discovery-client/current` | +| Zustand und Identität | `/var/lib/rmm-discovery` gehört dem Dienstkonto. Bei einem Binärwechsel bleiben Gerätedaten, Schlüssel und Journal erhalten. | +| Tatsächlicher Neustart | `cat /proc/sys/kernel/random/boot_id` vor und nach dem Neustart vergleichen. Anschließend denselben Agenten am Gateway und das Ergebnis eines nachfolgenden Skripts prüfen. | -Both binaries are environment-configured, **not** positional-argument CLIs. +Die Bibliotheksrevision „Linux neu starten“ kündigt den Neustart mit einer Minute Vorlauf an. Eine Datei unter `/tmp` kann beim Booten gemäß lokaler Systemkonfiguration verschwinden. Für die Beurteilung eines Auftrags zählt die Ausgabe seines konkreten Versuchs. [Native MCP-Abnahme](../../docs/evidence/mcp-scoped-script-requests-20261118.json) -Agent: `RMM_AGENT_STATE` (default `devstate/agent`), `RMM_CA_FILE` (default -`devstate/pki/ca.pem`), `RMM_CONNECT_ADDR` (default `127.0.0.1:18443`), -`RMM_ENROLLMENT_TOKEN_FILE` (first registration only), and optional -`RMM_JOB_BINDING_FILE`, plus optional `RMM_HELPER_SOCKET` for explicit-root grants. -The TCP override never changes the TLS DNS/SNI name -`rmm-dev.internal`. No proxy or invalid-certificate bypass. Without a binding, -the agent remains passive. It refuses to advertise/execute actions as UID 0. - -Provision a dedicated unprivileged `rmm-agent` system account/group. Install the -agent binary root-owned and non-writable by that account at -`/usr/local/libexec/rmm-agent`. State must be owned by that account, mode 0700; -its files are 0600. The sample service uses systemd `StateDirectory` and no -ambient capabilities. Install only the public CA at `/etc/rmm/ca.pem`. An -optional root-owned 0600 `/etc/rmm/agent.env` supplies the first-enrollment token -**path**, never an inline token. Remove that bootstrap token after registration. -Retain the enrolled VM-generated private device key on the VM. - -The operator must provision the job signing key over the authenticated bootstrap -channel: authenticated `GET https://rmm-dev.internal:18443/api/v1/job-signing-key` -using the verified CA, checking `algorithm == "Ed25519"`, `schema_version == 1`, -32-byte `public_key_hex` and `key_id == SHA256(raw_public_key)`. Do not trust a key -sent alongside a job, use an unauthenticated GET, put bearer credentials in -command arguments, or substitute TLS/update keys. This increment does not -rotate this trust anchor. Optional automatic agent fetching is described below; -the helper remains independently provisioned. The authenticated operator/bootstrap -must also resolve the enrolled agent's tenant, asset, generation and assignment -from server records, not accept an offer as identity provisioning. - -Agent binding JSON, owned by `rmm-agent`, 0600, in a root-owned configuration -directory (replace every placeholder; invalid placeholders intentionally fail): - -```json -{ - "tenant_id": "PROVISIONED-TENANT-UUID", - "asset_id": "ENROLLED-ASSET-UUID", - "agent_id": "ENROLLED-AGENT-UUID", - "enrollment_generation": 1, - "assignment_version": 1, - "public_key_hex": "AUTHENTICATED-32-BYTE-KEY-IN-HEX" -} -``` - -The agent additionally compares asset/agent IDs to its enrollment response. -Generation/assignment changes require an authenticated re-provisioning procedure, -not an in-band config assertion. State lock, integrity check and journal capacity -errors fail closed; never delete journal/consumption files to force a retry. - -## Independent helper boundary - -Helper: `RMM_HELPER_CONFIG`, default `/etc/rmm/helper.json`. It requires UID 0, -a root-owned 0600 config, root-owned private 0700 state directory, and a -root-owned socket parent not writable by group/others. `/run/rmm-helper` may be -0750 with group `rmm-agent`. The root-owned socket is 0660 with the configured -group; `SO_PEERCRED` additionally requires **exactly** the configured non-root -agent UID. Group membership alone grants no execution authority. - -Example `/etc/rmm/helper.json` (root:root, 0600): - -```json -{ - "binding": { - "tenant_id": "PROVISIONED-TENANT-UUID", - "asset_id": "ENROLLED-ASSET-UUID", - "agent_id": "ENROLLED-AGENT-UUID", - "enrollment_generation": 1, - "assignment_version": 1, - "public_key_hex": "AUTHENTICATED-32-BYTE-KEY-IN-HEX" - }, - "agent_uid": 12345, - "socket_gid": 12345, - "socket": "/run/rmm-helper/control.sock", - "state": "/var/lib/rmm-helper", - "allowed_services": ["rmm-acceptance.service"], - "allow_reboot": false, - "allow_root_scripts": false -} -``` - -Use the actual dedicated account's numeric UID/GID, not the example numbers. -The helper re-verifies exact Ed25519 bytes, all identity/hash/action/parameter -bindings, a <=60-second grant interval, synchronized bounded host clock, explicit -`execution_identity:"root"`, local action policy and its **own** SQLite consumption -ledger before invoking the typed OS provider. A request-provided bearer, key or -identity assertion is never an authority. The config has a separate, default-off -root-script permission; enabling it is consciously broad administration, still -subject to the sample service sandbox. Only exact allowed service units with -running/stopped state and >=180s runtime are accepted; restart is not silently -rewritten as start. Reboot is default-off and never yields exit-code success. - -IPC framing: one big-endian u32 length plus JSON `Request` (<=512 KiB) per Unix -connection. Fields are `job_bytes`, `permit_bytes`, `signature` (JSON byte arrays), -`plan_hash`, `authorization_id`. Response has the same framing and an `Outcome`. -Read/write deadlines are 5s. No request errors/secrets are echoed. The server -process is serial; unknown effects retain its global device resource lock, even -after restart. Duplicate consumed grants return stored evidence/unknown, never -execute again. A new grant for an already consumed attempt is also refused. -The helper refuses a preexisting socket; systemd removes its RuntimeDirectory -on stop. Manual stale-socket recovery requires checking that no helper is alive, -not blindly unlinking a path at startup. - -## Explicit integration/acceptance blockers - -* Backend currently permits only `agent_service`. Network agent intentionally - advertises only `run_script` and `refresh_inventory`, not privileged actions. - Network-agent → Unix-helper invocation is wired for explicit-root signed jobs - when `RMM_HELPER_SOCKET` is configured, with root socket/peer authentication. - A backend-authorized explicit root identity plus helper capability negotiation - must land before service/reboot/root-script E2E tests. Helper policy denies - unconfigured actions independently; the agent never relabels a service-identity - grant into root authority. -* Real APT mutation remains unsupported. A simulation followed by `apt-get` - cannot guarantee exact approved resolution under dpkg fcntl locks or suppress - arbitrary maintainer-script reboots. Neither `ensure_package` nor - `apply_updates` is advertised. No false flock-on-dpkg-lock implementation. -* No backend SyncRequest/Response exists. Only the **first** authenticated session - of a journal may start effects. On reconnect/restart new effects are blocked; - in-flight reservations become unknown, durable evidence still replays and - heartbeats remain fresh. No DB deletion/new-grant shortcut. Existing previously - connected state also needs real synchronization before jobs can be enabled. -* Running-script cancellation is recorded but not claimed as confirmed abort; - bounded execution finishes and reports its real result. A reboot does not - complete without authenticated new-boot evidence; automatic reboot recovery - synchronization is not implemented. -* Extended collectors now map to bounded per-source observations inside the - existing `linux.base` JSON, not new protobuf scopes/tags. Enable only after - backend JSON-extension acceptance is confirmed, as described below. -* No VM deployment, systemd install, root action, package/update/reboot host - effects or real UI approval were performed by this increment. - -## Additional environment variables and bootstrap (second increment) - -* `RMM_JOB_SIGNING_KEY_BOOTSTRAP=1`: after enrollment, use **device mTLS** to GET - `/api/v1/job-signing-key` over verified TLS. DNS/SNI remains `rmm-dev.internal`; - `RMM_CONNECT_ADDR` changes TCP only. Built-in roots, proxies and redirects are - disabled. The response is bounded to 4096 bytes and Ed25519/schema/key-hash - checked. No bearer is copied into the agent. A preconfigured binding key must - match; an empty key allows initial authenticated provisioning. The resulting - `RMM_AGENT_STATE/job-signing-key.json` is private and create-only. A changed - existing pin **fails**, never silently rotates. Keep the bootstrap flag enabled - on subsequent starts when the binding's key is empty, so the endpoint is - reauthenticated and checked against the cached pin. If the current backend - endpoint accepts bearer identity only, bootstrap fails closed; backend must - explicitly authorize the authenticated enrolled device at that endpoint. -* Helper config optional `"signing_key_file":"/etc/rmm/helper-signing-key.json"`: - root-owned 0600 JSON with `key_id`, `algorithm`, `schema_version`, - `public_key_hex` in the GET response shape. Provision via the trusted operator - bootstrap, **not** from an agent-provided file/path/request. If an inline helper - binding key is present it must match. The helper has no network key-fetch or - auto-replacement operation; agent cache changes cannot change helper trust. -* `RMM_LOG_UNITS_FILE`: private, agent-owned 0600 JSON array of 1–128 exact - `.service` names. `query_logs` is advertised only when this allowlist and a - native journald executable/runtime exist. The signed action must bind an - allowlisted unit, nonnegative UTC window <=24h, <=1000 lines, >=20s runtime and - bounded output. No arbitrary paths or caller-defined journal arguments. - Access/JSON/output failures retain quality/error metadata. The current action - has **no cursor input field**; no cursor is fabricated or advanced. Results - explicitly report `cursor_status:not_advanced_no_ack_contract` and partial - coverage until a concrete durable cursor-ACK contract exists. -* `RMM_EXTENDED_INVENTORY=1`: opt-in additive snapshot JSON fields `observations`, - `collection_started_at`, `collection_completed_at`. Every observation has - `scope`, source, real RFC3339 observation time, quality, completeness, - truncation, error and data. CPU, memory, OS, interfaces, routes, DNS, volumes, - installed packages, local update metadata and DMI are mapped; SMART remains - explicitly unsupported. Per-scope output is <=32 KiB and entire data <=512 KiB. - **Do not enable against a gateway deserializing the old deny-unknown-fields - Inventory struct.** Confirm backend storage accepts these additive JSON fields - first. Default remains compatible base JSON; no wire/protocol file changed. - -Passive collection now runs in one bounded-inflight blocking worker with a -bounded completion channel, not inside the network/heartbeat loop. A reconnect -does not spawn a second collector while one is already running. A refresh job -still collects a **new** base observation for its signed `linux.base` scope; -it never returns an old stored passive snapshot as a live measurement. - -Awaiting-reboot evidence now persists before effect: original native boot ID, -exact signed request, reservation time and reconnect deadline in each process's -own `execution_evidence` ledger. Awaiting/unknown outcomes persist without -unlocking the consumed attempt. Neither exit code nor a process restart supplies -authenticated new-boot completion. Cancellation arriving while a permit is -outstanding is checked before effect; running cancellation remains conservative. -An earlier future-scheduled job no longer starves later ready jobs. - -## Offline package installer (not executed on VM) - -`deploy/linux/install.py` is create-only. Planned invocation: - -```sh -python3 deploy/linux/install.py --root /PATH/TO/STAGING \ - --agent-binary target/release/rmm-agent \ - --helper-binary target/release/rmm-privileged-helper --ca-file /PATH/TO/PUBLIC-CA.pem -``` - -Staging writes only the x86-64 ELF artifacts, public CA and unit files. A live -installation additionally requires root, `--root / --install-live` and an already -provisioned unprivileged `rmm-agent` account. It refuses overwrites, writable or -symlinked install directories, non-x86-64 artifacts and private-key CA inputs. -It does **not** create accounts/config/identities/state, call systemctl, enable or -start anything, install packages, change the network or reboot. Configure trust -and enrollment first; systemd StateDirectory/RuntimeDirectory creates the correct -runtime state when a later explicitly authorized bootstrap starts the units. -The units retain empty agent capabilities, NoNewPrivileges, private temp, -read-only system/home protection and no privileged-shell bypass. Privileged -scripts are separately default-off and remain subject to the helper sandbox. - -## Concrete backend contracts needed next - -### APT bridge increment (not installed or VM-tested) - -The helper's typed APT bridge is implemented at -`crates/privileged-helper/src/apt.rs`, through its existing SO_PEERCRED/signature/ -parent-consumption boundary. Root config has optional `apt_provider`; default is -disabled. The exact schema-2 signed manifest, additive domain action fields, -compile-time-known create-only provider installation, pre-grant sealed archive/ -baseline layout, context/ledger mapping and conservative outcome contract are -documented in [`../../tools/apt-transaction/HELPER-CONTRACT.md`](../../tools/apt-transaction/HELPER-CONTRACT.md). - -This does not remove the package-capability blocker: the domain must preserve -the complete typed `action.apt_manifest`, validate the narrow fixture closure, -and support dedicated `apt_native_acceptance`; the agent remains unchanged. -Legacy package/update actions without this field fail closed. No RunScript -conversion, arbitrary archive URL or unsigned IPC manifest is accepted. - -Planned root-only `rmm-privileged-helper --install-apt-provider` installs only -embedded reviewed provider/hook bytes and fixed metadata, create-only. It does -not start services, create grants, install .deb packages or create acceptance. -`provision-fixture-store` prepares only the pinned fixture artifacts before any -final grant. Neither command was executed in this increment. - -The existing helper unit's ProtectSystem=strict/other protections are **not** -an APT write/setup profile. A reviewed native fixture runner/unit configuration -and actual VM tests are still required; no unit restriction was relaxed here. -Do not advertise APT merely because the Rust bridge and local tests compile. - -Before removing `begin_session`'s fail-closed reconnect gate, agree a versioned -authenticated SyncRequest/Response carrying device identity/assignment and -connection generation, journal identity/checkpoint, fixed job/attempt, payload -hash, grant ID/bytes or reservation ambiguity, local revision/state, original -boot ID, persisted outcomes and concrete durable event receipts. Server must -return an explicit reconciled/fenced decision, not a blanket `ok`. Unknown or -missing old reservations must retain resource locks; no response may authorize a -new attempt or silently manufacture a replacement grant. Restored/mismatched -generations must stay blocked. Reboot success requires authenticated current -envelope boot ID different from persisted original boot and bound postconditions. - -Long-poll must deliver the same typed envelopes and concrete ACKs with one active -generation, including late evidence ingestion; no new endpoint/wire assumption -is implemented here. Root planning must bind explicit root identity and local -helper capabilities/policy, never reinterpret `agent_service`. The public key -GET must authorize enrolled device mTLS. Additive inventory JSON acceptance must -be confirmed before enabling extended collection in a real agent. +Für einen neuen Release oder eine direkte Entwicklungsbereitstellung den gemeinsamen [Entwicklungsweg](../../docs/development.md) verwenden. diff --git a/deploy/linux/ROOT-READINESS.md b/deploy/linux/ROOT-READINESS.md deleted file mode 100644 index 61ad45e..0000000 --- a/deploy/linux/ROOT-READINESS.md +++ /dev/null @@ -1,60 +0,0 @@ -# Dev/test root-helper readiness, not package acceptance - -`python3 deploy/vm_root_bootstrap.py inspect` is read-only. `build` creates a -private minimal Docker context containing only Rust sources, pinned Cargo files, -migrations and the reviewed APT-tool sources; it never includes credentials. -`install` is the separately authorized create-only systemd bootstrap. It refuses -existing root-helper paths, unresolved VM jobs, an active agent/tunnel, changed -agent identity/signing authority or incompatible artifacts. It never resets an -identity/journal or authorizes a job. Do not retry a partial install blindly. - -Fixed resources: `/usr/local/libexec/rmm-privileged-helper`, root-owned 0600 -`/etc/rmm/helper-dev-test-v1.json` and `helper-signing-key-v1.json`, private root -state `/var/lib/rmm-helper`, `rmm-helper-dev-test.service`, and root-owned agent -drop-in `10-dev-helper-v1.conf`. The drop-in adds only -`RMM_HELPER_SOCKET=/run/rmm-helper/control.sock`; it does not restart the agent. -The helper's root-owned socket is 0660/group `rmm-agent` in a 0750 root-owned -runtime directory. `SO_PEERCRED` separately checks exactly the provisioned -non-root agent UID; a connect-only readiness probe is not a signed IPC test. - -Public signing authority comes from the authenticated, CA/name-verified server -GET and must match the preserved agent binding. No server private key is copied. -Helper trust/ledger remain inaccessible to the network service. The helper is -enabled for its expressly named dev/test service but stopped after readiness -only when its own consumption ledger is confirmed empty. No agent/tunnel is -started. Creation lists, native measurements and sanitized failure class/line -numbers are stored privately; raw stderr, payloads and exceptions are withheld. - -## Intentionally disabled execution gates - -The dev/test config allows only the future exact `rmm-mvp-test.service` unit; -this bootstrap **does not create or start that test service**. Root scripts and -reboot are disabled. `apt_provider` is null. Installing the compiled-in provider -via `--install-apt-provider` creates trusted code/hook and empty sealed-store -directories/metadata only. No package, fixture archive, baseline, active context, -grant or native-acceptance record is generated. `inspect-runtime` and -`print-config` are measurements, not authority. Their hashes belong to a future -explicitly UI-approved immutable plan. - -`inspect-sandbox` is invoked read-only as root in the parent environment. A veto -there is expected and reported as **not passed**, never bypassed with fabricated -`host-namespaces.json`/sandbox-ready files. The actual provider requires its -signed worker context before building the final sandbox. - -The new readiness unit preserves restrictive protections; it is deliberately -**not APT-execution-capable**. Package setup requires CAP_SYS_ADMIN for private -mount/PID/network namespaces and mount setup, CAP_MKNOD for the four basic device -nodes, and write access to the actual fixture package payload/dpkg/APT stores. -The final package child must then retain exactly CHOWN, DAC_OVERRIDE, FOWNER, -FSETID, SETGID, SETUID, SETPCAP and SETFCAP, NNP and seccomp; no SYS_ADMIN, -SYS_BOOT, KILL or MKNOD may remain. Host control sockets must be hidden and the -private PID1/mount/network checks must pass. The readiness unit's deny-mount -syscall policy and ProtectSystem=strict prevent this setup. Do not loosen them -blindly: a separately reviewed native APT runner/profile is still required. - -Future backend root planning, manifest preservation, helper policy changes and -agent capability negotiation do not follow from installation. Reconnect/sync -must be ready before starting new jobs. Every service/package/update/reboot or -new attempt still needs its own fixed plan and actual dev/test WebUI approval. -Actual commands/results are recorded in `docs/implementation-status.md`; this -document alone claims no VM execution or Linux-MVP acceptance. diff --git a/deploy/linux/apt-helper-README.md b/deploy/linux/apt-helper-README.md deleted file mode 100644 index 10ee1ba..0000000 --- a/deploy/linux/apt-helper-README.md +++ /dev/null @@ -1,227 +0,0 @@ -# Dedicated APT runner / VM preflight contract - -**Implemented, built and locally tested, not deployed or measured on a VM.** -Every command below is **planned, not executed here**. No host package, service, -reboot, root installation or acceptance operation was executed in this dispatch. -Readiness is not package acceptance or authorization. Existing readiness/general -helper unit is unchanged: no broadening its write paths/capabilities/filters. - -## Architecture and fixed paths - -Same helper binary, two separate daemon profiles: - -| Profile | Socket | Allowed operations | -|---|---|---| -| general (existing/default) | existing configured general socket | existing explicitly permitted root operations, never APT | -| `apt_only` | `/run/rmm-apt-helper/helper.sock` | read-only readiness and typed fixture APT jobs only | - -APT profile requires agent UID **993**, root-owned agent-group socket ACL, -empty allowed_services, allow_reboot=false, allow_root_scripts=false and a valid -apt_provider policy. Unknown profiles/actions/CLI programs fail closed. No shell, -service, reboot or generic-program dispatch exists in apt_only. Root administrative -CLI modes are fixed install/probe/inspect operations, not network-callable argv. - -**Both daemons must run the same new helper build** and use the exact same -`/var/lib/rmm-helper/consumption.sqlite` and `executor.lock` inodes. All SQLite -sidecars stay in that shared directory (current ledger uses synchronous FULL / -DELETE journal mode; no database/WAL/SHM copy or private bind). Flank lock is now -per actual request/effect, not daemon lifetime, allowing coexistence. Startup DDL -is locked; consume/execute/finish are locked. An unresolved consumed row blocks -all new effects across both profiles, including reboot/package conflicts. -No tombstone deletion, marker reset, database copy or grant replacement shortcut. - -APT-owned store: `/var/lib/rmm-apt-transaction` (0700), including archives, -baselines, history, probes, state, log and active handoff. The child sees neither -the shared ledger nor `/etc/rmm` keys/config, `/var/lib/rmm-agent`, home directories, -host manager sockets or inherited private fds. Only the trusted outside root -controller sees the signing-key pin/ledger. Central private signing keys must -never be deployed to the VM. - -## Installation order (planned) - -1. Authenticated operator installs the reviewed newly built helper at fixed - `/usr/local/libexec/rmm-privileged-helper` using the existing controlled - artifact deployment process. Both helper daemons need this same build; do not - blindly overwrite an active old helper or restart away unknown effects. -2. Before starting the new unit, run the root-only known-payload installer: - - ```text - /usr/local/libexec/rmm-privileged-helper --install-apt-provider - ``` - - It exclusively creates known embedded provider/hook files, schema-2 install - metadata, the exact `rmm-apt-helper.service` at `/etc/systemd/system/`, private - store directories and empty `/usr/share/rmm-mvp-test`. It does NOT install a - .deb, start systemd, create grants or create an acceptance record. Existing/ - partial paths are refused, not overwritten, chmod-repaired or deleted. -3. Root-provision `/etc/rmm/apt-helper.json` (0600) from - `apt-helper.example.json`; replace all invalid placeholders and verify actual - rmm-agent UID is 993 and socket_gid is the actual rmm-agent group GID. Keep - the existing separately authenticated Ed25519 key pin/binding procedure. -4. Inspect the installed provider/config/runtime, including installed helper - binary and exact unit profile: - - ```text - /usr/bin/python3 -I /usr/lib/rmm-apt-transaction/apt_transaction.py print-config - /usr/bin/python3 -I /usr/lib/rmm-apt-transaction/apt_transaction.py inspect-runtime - ``` - - Set approved apt_config_sha256 from exact config bytes. Set runtime_sha256 - from the canonical runtime object **without its trailing newline**. Review - the contents/code/configuration; blindly hashing unreviewed configuration is - not a security review. No timestamp/hash placeholder can enable execution. -5. After valid private config/key provisioning, inspect the helper identity pin: - - ```text - RMM_HELPER_CONFIG=/etc/rmm/apt-helper.json /usr/local/libexec/rmm-privileged-helper --inspect-apt-profile - ``` - - Operator installs its exact JSON output at e.g. - `/etc/rmm/apt-helper-proof.json`, root:rmm-agent 0640, in root-owned, - non-group/world-writable configuration parents. This pin contains public - identity/hash metadata, no grant or secret. Agent must be able to read it but - not alter it. The inspected executable must match the installed daemon bytes. -6. Validate the unit on the VM before start (`systemd-analyze verify`), then - perform the separately authorized unit bootstrap. `ExecStartPre` executes: - - ```text - RMM_HELPER_CONFIG=/etc/rmm/apt-helper.json /usr/local/libexec/rmm-privileged-helper --probe-native - ``` - - **The probe runs under the actual dedicated service profile**, not a generic - root shell: controller verification requires NoNewPrivileges, exact ten-bit - setup capability set, zero inherited/ambient caps, the actual - rmm-apt-helper.service cgroup and readonly /usr, /etc and /var. Direct daemon/ - probe invocation outside that profile is rejected. `--inspect-apt-profile` - remains a read-only administrative metadata operation and is not readiness. - Controller verification also requires an outer seccomp filter, actual writable - declared targets, and rejects unexpected writable submounts below /usr,/etc, - /var. Inspect effective systemd configuration (`systemctl cat/show`) on the VM; - do not introduce unreviewed drop-ins or substitute a root-shell launch. - -## Unit and irreversible worker sandbox - -`rmm-apt-helper.service` provides NNP, PrivateTmp/PrivateNetwork, strict readonly -system/home/kernel/control-group protection, AF_UNIX only, native syscall ABI, -mount/PID/net namespaces only, no ambient caps. Bounding set is filesystem/UID -bits 0,1,3,4,6,7,8,31 plus SYS_ADMIN/MKNOD for trusted setup; no SYS_BOOT, -SYS_CHROOT or SYS_TIME. DevicePolicy=strict permits only null/zero/random/urandom -rwm; PrivateDevices=no permits trusted construction of a minimal private /dev. - -Outer filter allows mount/unshare/fork/capset/prctl/seccomp trusted setup instead -of an outer @mount prohibition. Reboot/module/raw-io/swap/debug and clock setters -remain denied. The narrow adjtimex exception is necessary for the existing -read-only modes=0 trusted-clock query; mutating adjtimex still needs CAP_SYS_TIME, -which is absent. This is not a clock-verification bypass. - -Write paths are **only** `/var/lib/dpkg`, shared helper ledger, private provider -store and precreated `/usr/share/rmm-mvp-test`. No whole /usr, /etc or /var writes. -APT terminal/history logs and dpkg log are explicitly under provider `log/`; -APT cache/state and extended_states are private, no default /var/log/apt write. -These are configured paths, **not natively proven log/write requirements** yet. -Unexpected native write failures must be reported, not fixed with blanket writes. - -One common Python setup function serves mutation and readiness. It makes mount -propagation private, hides keys/ledger/sockets/fds, mounts minimal devices and -kernel controls, then irreversibly drops E/P/B to the original eight caps, -clears I/A, retains NNP and installs seccomp. Both clone namespace flags -(including NEWUSER/NEWTIME) and clone3 pointer flags are closed: clone3 returns -ENOSYS for libc's ordinary fork fallback; clone namespace flags return EPERM. -Ordinary fork/exec remains allowed. No reconfiguration/reboot/kexec escape is -allowed after setup. Trusted setup with SYS_ADMIN is explicitly in the TCB. - -## Readiness probe: no package transaction - -`--probe-native` does NOT create jobs, grants, receipts, launch/effect markers or -native-acceptance records. It exclusively creates a generated private probe dir, -copies host dpkg status (host opened read-only), binds the copy over /var/lib/dpkg -inside the worker namespace, uses source/hook-isolated private APT config, tests -private-db frontend lock conflict and runs positive `apt-get check` on that copy. -The host frontend lock is only observed with O_RDONLY/F_GETLK: never F_SETLK, -flock/lockf, deletion or killing an owner. Invalid-magic/flags reboot/kexec probes -must return EPERM; no valid calls or PID1 signals are attempted. - -The worker checks namespaces/PID1, capabilities/NNP/seccomp, readonly control -mounts, hidden sockets and masked sysrq. Parent verifies complete result and -private namespace identities, unchanged host status/runtime and publishes only -root-private `native-readiness.json` (readiness_only=true, native_acceptance=false). -It is boot-/code-/OS-/binary-/unit-bound and invalidated by changes. Partial, -failed or malformed results do not publish new readiness. Acceptance/bootstrap -attempt tombstones are neither created nor reset by this operation. - -## Agent environment / read-only IPC API - -``` -RMM_APT_HELPER_SOCKET=/run/rmm-apt-helper/helper.sock -RMM_APT_HELPER_PROOF_FILE=/etc/rmm/apt-helper-proof.json -``` - -`RMM_HELPER_SOCKET` remains the general route. Typed ensure_package, -apply_updates and apt_native_acceptance exclusively use the dedicated socket. -Missing/wrong APT socket/pin/readiness never falls back to general helper, SSH, -shell or local execution. The unprivileged agent obtains a fresh read-only probe -before capability advertisement and before use; it authenticates root SO_PEERCRED, -root-owned safe socket/parents and independent root-provisioned pin. - -Same u32-big-endian framed JSON socket, a distinct read-only request shape: - -``` -operation: "apt_readiness_v1" -challenge: fresh nonnil UUID -identity: {tenant_id,asset_id,agent_id,enrollment_generation,assignment_version,signing_key_id} -expected_stack_sha256: independently pinned helper/identity/policy/unit stack hash -``` - -Response strictly binds nonce, identity, apt_only profile and provider stack; -includes shared ledger/lock dev/inodes and separate fixture_acceptance_ready, -bootstrap_recipes and accepted_recipes. Wrong nonce/identity/generation/profile/ -stack/root peer is rejected. An unresolved shared ledger suppresses all APT -readiness/capabilities. This API never consumes a grant or authorizes a job. - -Readiness alone advertises **only apt_native_acceptance** for fixed allowed -fixtures. Valid native acceptance records enable only matching fixture recipes: -ensure_package, and apply_updates only for the accepted update recipe. Agent -also checks each actual typed job's manifest recipe, not just aggregate action -capability names. No production/arbitrary catalog capability is manufactured. - -## Actual jobs remain UI-authorized - -Domain's additive typed schema-2 apt_manifest and dedicated AptNativeAcceptance -are now present; local tests roundtrip the actual domain variant through exact -signed bytes into the helper validator. See -`tools/apt-transaction/HELPER-CONTRACT.md` for the full immutable payload/context -schema. Readiness does not replace independent Ed25519 verification, all target/ -tenant/generation/plan/job/attempt/authorization/action/hash/time bindings, -current trusted clock, parent consumption and immutable WebUI approval. - -Use provision-fixture-store / prepare-baseline **before** final grant to stage -the two known archives and snapshot. One UI-approved dedicated fixture job may -install 1.0, another may update 1.0 -> 1.1. Same guard/native lock/deadline/hash/ -postcondition pipeline, no weak path. Failed/stale/partial/unknown never acceptance. -Armed/unknown outcomes retain both parent resource fencing and effect markers. -One-time failures are not blindly reset: technical no-start recovery needs a -separate durable signed reconciliation procedure, not implemented as a shortcut. - -No actual native namespace/APT/service/root execution has been measured here. -The subsequent VM worker must execute this profile/probe and UI-authorized -fixture jobs, retain actual evidence and report all native failures separately. - -## Executed local verification (this increment) - -* Source-tree rustfmt check passed for helper lib/main and agent main/modules. -* Targeted Clippy `-p rmm-privileged-helper -p rmm-agent --lib --bins -- -D warnings` - passed. -* `cargo test -p rmm-privileged-helper -p rmm-agent --lib --bins`: **37 passed** - (20 helper library, 3 helper binary, 14 agent). -* `PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/apt_transaction -p 'test_*.py' -v`: - **48 passed**; AST syntax checks **7 Python files**; example JSON syntax passed. -* Local unprivileged seccomp invalid-input/clone-flag denial and ordinary - fork/exec really ran. Root setup/installer/APT/probe unit execution was mocked - where unsafe. Temporary mock readiness files are not deployed native evidence. - -Package-wide verification has a concurrent-work limitation: the last full -`cargo fmt --check` encountered formatting in the other worker's -`crates/privileged-helper/tests/reconcile.rs`; the last all-target Clippy attempt -failed on missing `validate_history` in its included `src/reconcile.rs`. Those -Sync files were not edited here. The focused source checks/tests above passed -afterwards; this is not a claim that the parallel Sync integration suite passed. diff --git a/deploy/linux/full-maintenance-README.md b/deploy/linux/full-maintenance-README.md deleted file mode 100644 index 885ffe7..0000000 --- a/deploy/linux/full-maintenance-README.md +++ /dev/null @@ -1,241 +0,0 @@ -# Explizite Hostwartung mit full_maintenance_v1 - -Stand 2026-11-14, Spezifikation1.20. Die Batch-Skriptkonsole und der unabhängig -geprüfte Fullhelper-Binärpinfix sind implementiert, neu quellqualifiziert und nach -tatsächlichem Linux-Unitlauf erhaltend auf der Cloud-Linux-VM bereitgestellt. -Agent, General und Full laufen mit den geprüften Images; signierter Folgeabgleich -und WebUI-genehmigter Fulljob bleiben separat offen. Tatsächliche Teilfehler, -Fortsetzungen und unveränderte Originalbelege: -[Bootstrap-Ergebnisse](../../docs/script-console-bootstrap-results.md). -Cloud-Linux-VM zuerst, Windowsgast separat; Notebook ausschließlich Entwicklung. - -## Aktueller korrigierter lokaler Nachweis - -Der neue eigenständige Pack liegt privat unter -`devstate/script-console-qualification/run-29461892-343f-42f4-b469-88703535425e/`. -Manifest-SHA256: -`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`. -158 vollständige Compiler-/Include-/Fixture-/Deploymentinputs vor/nach identisch. -Sourcearchiv-SHA256: -`fcb57f69ad81ea4acde15af6022d5c2da32f5699ebd39886c530c77882b369cc`. - -Tatsächlich ausgeführt: Formatprüfung, Linux-Workspace-Alltargets-Clippy mit -`-D warnings`,285 lokale Tests bestanden (5DB-Fälle zunächst ausgelassen), danach -sämtliche45 Serververträge inklusive dieser5 gegen frisches isoliertes PostgreSQL -bestanden (0ignored). Windows-GNU-Alltargets-Clippy mit -Dwarnings im Default- -und SYSTEM-Helperprofil bestanden. Kein geänderter Test unterdrückt; die neue -Imageprüfung führt auch bei nicht vertrauenswürdigem Dateibesitz echte -Verweigerungsassertions aus, keinen stillen Early-return-Skip. - -Neue tatsächliche Linux-Unitlisten: Domain22, Linuxruntime16, Helperpolicy6, -Serververträge45. Auf Cloud-Linux ohne isolierte DB erwartet:84PASS und5explizite -DBignored; diese5 sind separat im lokalen45er-DB-Lauf tatsächlich bestanden. -Alle vier vollständigen Listen müssen vor irgendeinem Unitstart geprüft sein. -Linux-Release-Helper SHA256 -`79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf`; -Agent `0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f`; -Server `610017637a9f9e55a6cb3cd8264937b953996af84e86dd49f2ea00c8e59739cd`. -Keine dieser neuen Binaries ist durch den Builder auf einem Ziel installiert. -Native Cloud-Linux-Units bestanden anschließend tatsächlich; siehe den separaten -Beleg unten. Auch die späteren 36+7 Windows-Units bestanden separat nativ: -[Windows-Nachweis und Grenzen](../../docs/script-console-windows-link.md). -Laufende Windows-SYSTEM-Runtime und WebUI-genehmigter FullMaintenancejob sind -eigenständige, dadurch nicht ersetzte Nachweise. - -## Frühere lokale Nachweise und der danach behobene Binärpinbefund - -Das eingefrorene Paket liegt ausschließlich privat unter -`devstate/script-console-qualification/run-de34d47c-985e-460c-b18c-3f0d1b3fd315/`. -Manifest-SHA256: -`60a50262f9f8d85c11eb58e1a9e0f6e03be6cd5db7a59bc1745fb7d9dc8a6f65`. -157 Compiler-, Include-, Fixture- und Deploymentinputs wurden vor/nach dem -vollständigen Lauf identisch geprüft. `reviewed-sources.tar.gz`: -`ef822b2e2ec6f8ad3d828f0923b2aa886d462fba328affb61bd80e98acf2c357`. - -Tatsächlich lokal ausgeführt: Formatprüfung; Linux-Workspace-Clippy mit allen -Targets und `-D warnings`; Workspace284PASS bei fünf zunächst ausgelassenen -DB-Fällen; anschließend sämtliche45 Servertests mit `--include-ignored` in -frischem isoliertem PostgreSQL17.6:45PASS,0ignored. DB ohne veröffentlichten Port, -Netzwerknamespace ausschließlich intern, frische Rollen/Migrationen, danach -entfernt. Keine Produktionsdatenbank. Windows-GNU-Alltargets-Clippy separat im -Default- und SYSTEM-Helperprofil jeweils bestanden; keine native Windowsausführung. -Linux-Releasebinaries und vier native Linux-Testprogramme dieses früheren -Quellenstands sind gebaut/gehasht, noch nicht auf der Cloud-VM ausgeführt oder -installiert. **Nachträglicher unabhängiger Reviewblocker:** Dieser Pack bindet -noch nicht den tatsächlichen laufenden Linux-Fullhelpercodehash. Er berechtigt -keine Fullprofilaktivierung. Der danach separat geprüfte und im neuen Pack qualifizierte enge Corefix ergänzt ausschließlich -im Fullprofil tatsächliches gehaltenes `/proc/self/exe`, geschützten Binärpin, -authentisierte Probe, zusätzliche Binärcapability und zentrale Hashprüfung. -General/APT lassen neue Metadaten vollständig aus. Der neue lokale Stand steht -oben; dieser alte Pack bleibt ausdrücklich der ursprüngliche Beleg. - -Die ersten Packvorbereitungen erzeugten kein qualifiziertes Manifest: Der erste -before/after-Schutz bemerkte die währenddessen vervollständigte Builderinputliste; -der zweite hielt bei PostgreSQLs temporärer Initialisierungsphase an. Der finale -oben genannte Lauf wartet auf den endgültigen TCP-Endpunkt und besteht vollständig. -Diese Vorbereitungsläufe werden nicht zu bestandenen Abnahmen umgedeutet. - -## Separater Linux-first-Unitrunner - -Der Runner `deploy/script_console_acceptance.py` ist separat reviewbar und kein -Teil der158 eingefrorenen Compilerinputs; er baut und verändert diese nicht. -Er ist ausdrücklich auf den neuen Pack29461892 und dessen Manifestddd1a78d… -gebunden; bei veränderten Compilerinputs wird ein neuer Start verweigert. Die -ursprüngliche Vorbereitung für Packde34 bleibt ein früherer, nie ausgeführter -Runnerstand. Die jetzigen Counts beruhen auf den tatsächlich erzeugten Listen. -Runnerquellhash: -`2b3ba8d548d18627643a9f73c9a4f7bacce4ac2cd5495745c6760d088e078145`. -Supportquellen werden vor Import und jedem Zielaufruf inklusive Readback exakt -geprüft und in Intent/Payload/Result gebunden: Runtime-Bootstraphelper -`833ad8806c90a19342aa6fbc71c33e81975caffb1746550e9b0fbdca7fa0c7ab`, -Zugangsparser -`5c8107ea9151a9f498b2530cdc61c1a7a6d745aff853a9b05710f3395838c0dd`. -Der finale Readback verlangt product_state_writes, rmm_jobs, -capabilities_activated und approvals ausdrücklich jeweils false. -Er verwendet ausschließlich den vorhandenen strikten Bootstraptransport und -`credentials/linux-vm.conf` im ursprünglichen Hauptcheckout, ausschließlich als root auf der festgelegten Linux-Test-VM, mit vorhandenem -SSH-Key und strenger Hostprüfung. Keine -Zugangsdatenkopie ins Scriptworktree, keine alternative IP oder Passwortfallback. - -**Tatsächlich ausgeführt:** Alle vier Listen wurden vor jedem Unitstart geprüft; -84 Tests bestanden, fünf ausdrücklich ausgelassene DB-Verträge waren zuvor im -isolierten lokalen PostgreSQL-Lauf bestanden. Fall -`7b61ce46-7913-492b-9c6b-414a0c2b6ffc`, Beleg-SHA256 -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`. -Der verwendete Aufruf war: - -```bash -python3 deploy/script_console_acceptance.py execute-linux -``` - -Es entstehen nur neue private Scratchdateien unter -`/var/lib/rmm-script-console-contracts//`. Erst werden alle vier exakten -ELF-Hashes und vollständigen Listen geprüft; kein Unitstart vor dem gesamten -Listenbeleg. Danach feste Testargumente, geleerte Umgebung, eigenes TMPDIR, -eigener Netzwerknamespace und CPU-/Speicher-/Dateilimits. Erwartet werden84PASS -und fünf ausdrücklich ausgelassene DB-Fälle auf der VM ohne DB; dieselben fünf -DB-Verträge sind bereits im isolierten lokalen45er-Lauf belegt. Keine Installation, -Enrollment-, Dienst-, Policy-, Paket-, Schlüssel-, Journal- oder Capabilityänderung. - -Bei verlorenem Ergebnis ausschließlich denselben ursprünglichen Fall lesen: - -```bash -python3 deploy/script_console_acceptance.py read-linux --case -``` - -Readback erzeugt keinen zweiten Remote-Start. Ein vorhandener Create-once- -Startmarker erlaubt kein erneutes `run`; Teilergebnisse bleiben erhalten. Ein -unvollständiger/fehlender Beleg ist keine bestandene Abnahme und wird nicht blind -wiederholt. Native Units sind keine RMM-Dienst-/WebUI-/FullMaintenanceabnahme. - -## Bootstrapvorbereitung nach gesondertem Erhaltungsreview - -Der ursprüngliche Erhaltungsplan und die weiterhin geltenden Schutzgrenzen -folgen unten; tatsächliche Ausführung samt fehlgeschlagenen Teilphasen und -separaten Erststartfortsetzungen steht in den -[Bootstrap-Ergebnissen](../../docs/script-console-bootstrap-results.md). -Aktuelle Cloudbelege, Geräte-/Boot-/ -Journalidentitäten, Inodes, Verbrauchszeilen und Dienstzustände werden vor einer -Änderung durch den verantwortlichen Rootprozess unabhängig gegengeprüft. Die -bisherigen General-/APT-Units und Pins sowie deren Historie bleiben erhalten; -keine Ledgerkopie, kein Reset und kein stilles Öffnen alter Scopes. - -Die neue Unit ist `deploy/linux/rmm-full-maintenance-helper.service` mit eigenem -Runtimeverzeichnis `/run/rmm-helper-maintenance`. Sie verweist auf -`/etc/rmm-remote/helper-full-maintenance.json`. Diese Konfiguration erhält exakt -die bestehende provisionierte öffentliche Bindingidentität und dieselben -Root-Sharedledger-/Lockdateien; neue Auswahl: - -```json -{ - "profile": "full_maintenance_v1", - "allowed_services": [], - "allow_reboot": false, - "allow_root_scripts": true, - "allowed_script_profiles": ["full_maintenance_v1"], - "helper_binary_sha256": "" -} -``` - -Das ist ein Ausschnitt, keine vollständige einsatzfähige Konfiguration. Socket, -Agent-UID/GID, Zustandspfad und bestehendes Binding müssen aus dem tatsächlich -geprüften Bestand kommen. Kein `apt_provider`. `allow_reboot=false` verweigert -nur die typisierte Rebootaction; genehmigter Rootcode besitzt volle Hostautorität. - -Der separat geschützte Policy-Pin bindet Profil `full_maintenance_v1`, bestehende -Identität, tatsächlichen lokalen Policyhash und unabhängig beobachteten -laufenden Binärhash. Das neue Fullprofil benötigt Schema2 im Pin; der Helper -kann diesen nach selbst geprüftem Rootimage mit dem ausdrücklich getrennten -Bootstrapmodus `--inspect-full-maintenance-profile` ausgeben. Generalpin -Schema1 bleibt unverändert. Agentumgebung ausschließlich -additiv um `RMM_FULL_MAINTENANCE_HELPER_SOCKET` und -`RMM_FULL_MAINTENANCE_POLICY_FILE` ergänzen. Kein Fallback auf General/APT und -keine Änderung deren bestehender Umgebung. Die zentrale Rootpolicy braucht -Schema2 und einen ausdrücklich begrenzten Scope mit neuen exakten Helperpins -sowie `allowed_script_profiles=["full_maintenance_v1"]`. Aktuelle Rechte beider -Planakteure, Helper-Sync, TrustedClock, ursprünglicher Grant und Einmalverbrauch -bleiben zusätzlich erforderlich. Eine Policy ist keine Jobgenehmigung. - -Vor Installation werden zusammengesetzte systemd-Unit und etwaige Drop-ins -geprüft: Vollwartung darf keine General-Sandbox erben, die Hostdateisystem oder -Netzwerk unerwartet sperrt. Dienst- und Binärwechsel nur mit qualifizierten -Artefakten und explizitem Erhaltungsplan. Insbesondere darf eine neue allgemeine -Helperbinary nicht still die alten APT-Codepins überschreiben/öffnen. Gegebenenfalls -eigenen qualifizierten Binärpfad für die neue FullMaintenanceunit wählen und die -bestehenden Providerpfade unverändert erhalten. Native Erhaltung und Sync nachweisen, -bevor neue Capabilities/Scopes geöffnet werden. - -Erster tatsächlicher FullMaintenancejob nur nach bereitgestellter WebUI und -expliziter Genehmigung der unveränderlichen Skript-/Profil-/Ziel-/Rechtebytes. -Abgestimmter Scope: harmlose Identität/stdout/stderr und kontrollierte lesende -Dateisystem-/Netzwerkbeobachtung; kein Betriebssystemupdate oder Neustart. Volle -Hostautorität wird sichtbar erklärt; kein Sandbox-, No-Reboot- oder Rollbackversprechen. -Windows-SYSTEM folgt nach eigenem Clock-/Pipe-/Profilnachweis. Die vorhandene -PipeV2-Datei ist unverändert SHA256 -`ce525dab23f2e4faa2c9816280c1a5a8b40e56d0e63a350256e83b2df1d9229d`; -ursprüngliche native Pipebelege werden nicht als Belege der neuen Runtime ausgegeben. - -## Anschließend auf der tatsächlichen Cloud-Linux-VM bestanden - -Root führte ausschließlich den korrigierten Pack29461892 nativ aus: Fall -`7b61ce46-7913-492b-9c6b-414a0c2b6ffc`, **84PASS,5explizite DBignored**. -Die vier vollständigen tatsächlichen Listen wurden vor irgendeinem Unitstart -exakt geprüft; anschließend liefen alle vier festen ELFs im eigenen Scratch, -mit geleerter Umgebung, Netzwerknamespace und Ressourcenlimits. Die5DB-Verträge -bleiben diesem VM-Lauf ausdrücklich nicht zugerechnet; sie sind im separaten -isolierten45er-PostgreSQL-Lauf belegt. Kein stiller Testskip oder Produktjob. - -Beleg `passed-e214cd9b-21ac-48ce-82dc-d10364329d04.json`, SHA256 -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`. -Keine Agent-/Helperinstallation, Änderung bestehender Dienste/Policies/PKI/ -Datenbanken, veröffentlichte Capability oder WebUI-Genehmigung durch diesen -Unitlauf. Der oben ursprünglich geplante Unitaufruf ist damit abgeschlossen. -Der inzwischen erhaltend ausgeführte Bootstrap steht in den separaten -[Bootstrap-Ergebnissen](../../docs/script-console-bootstrap-results.md); -signierter Folgeabgleich und tatsächlicher FullMaintenancejob sind dadurch -noch nicht abgenommen. - -## Verbindlicher Generationsentscheid vor dem Bootstrap - -Ein eigener neuer Fullhelper bei weiterlaufendem altem Generalhelper reicht -nicht: Alle aktiven Leser des gemeinsamen Root-Ledgers müssen neue -`privileged_script_profile`-Jobbytes unabhängig dekodieren und prüfen können. -Alte Decoder verweigern selbst geschlossene neue Zeilen und können beim -Snapshot/Sync einen sticky Fault schreiben. Deshalb neuer Agent und aktive -General-/Fullhelper gemeinsam auf die neue qualifizierte Generation; bestehende -Generalunit/Sandbox/Config/Policy-/Pinbytes unverändert. APT bleibt disabled/ -inactive, ohne Endpoint und mit geschlossenen Scopes. Seine aktuelle Generation -war bereits laut vorherigem Runtimeindex nicht qualifiziert; historische -Abnahmen bleiben erhalten. Vor späterer Wiedereröffnung eigener APT-Stackpin- -/Generationnachweis, kein alter Helper gegen neue Ledgerzeilen. - -Der Rootprozess hat die84 native Cloud-Linux-Units tatsächlich ausgeführt: -Fall `7b61ce46-7913-492b-9c6b-414a0c2b6ffc`, Proof-SHA256 -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`, -84PASS und5 ausdrücklich ausgelassene DB-Fälle. Diese5 sind im isolierten lokalen -45er-Lauf bestanden. Keine RMM-Jobs oder neue Capabilities aus diesem Unitlauf; -der inzwischen ausgeführte Runtimeaustausch ist separat belegt. Tatsächlicher -signierter Folgeabgleich und genehmigter Fulljob bleiben eigene offene Schritte. - -Details und Nach-MVP-Entdeckung: -[script-console-helper-generations.md](../../docs/script-console-helper-generations.md). diff --git a/deploy/linux/runtime-README.md b/deploy/linux/runtime-README.md deleted file mode 100644 index 976c166..0000000 --- a/deploy/linux/runtime-README.md +++ /dev/null @@ -1,311 +0,0 @@ -# Agent/helper runtime — integrated source, VM acceptance pending - -This is the current runtime contract. It supersedes the earlier module-only -handoffs in `README.md` and `tests/agent_sync/README.md`. No installation, target -job, service/reboot/package mutation, SSH tunnel or server restart was performed -by this integration. Actual VM execution/acceptance belongs to the next worker. -Nothing here approves an RMM job or substitutes for the WebUI approval boundary. - -## Binaries and complete CLI/environment - -Both binaries support `--help`; unknown arguments fail closed. Normal agent -operation has no positional arguments. Planned bootstrap invocation: - -```text -RMM_AGENT_STATE=/var/lib/rmm-agent -RMM_CA_FILE=/etc/rmm/ca.pem -RMM_CONNECT_ADDR=127.0.0.1:18443 -RMM_TRANSPORT=https -/usr/local/libexec/rmm-agent -``` - -These are environment assignments, not an instruction to source a credential -file. The trusted CA and TLS name **rmm-dev.internal** are always checked. TCP -override changes neither DNS/SNI nor certificate verification. No proxy trust, -invalid-certificate bypass or public Docker port is introduced. - -| Variable | Meaning/default | -|---|---| -| `RMM_AGENT_STATE` | Private 0700 owned agent state; default `devstate/agent` | -| `RMM_CA_FILE` | Public trusted CA; default `devstate/pki/ca.pem` | -| `RMM_CONNECT_ADDR` | Parsed TCP SocketAddr; default `127.0.0.1:18443` | -| `RMM_TRANSPORT` | `auto` (default), `wss`, or `https`; HTTPS can be explicitly selected for VM acceptance | -| `RMM_ENROLLMENT_TOKEN_FILE` | First registration only; remove the bootstrap token after enrollment | -| `RMM_JOB_BINDING_FILE` | Optional private agent-owned JSON Binding; absent means passive, no job capabilities | -| `RMM_JOB_SIGNING_KEY_BOOTSTRAP=1` | Authenticated device-mTLS GET, using the current rotation-store identity; pins without replacing existing trust | -| `RMM_HELPER_SOCKET` | Configured general helper socket, e.g. `/run/rmm-helper/control.sock` | -| `RMM_HELPER_POLICY_FILE` | Root-owned, agent-readable public general policy pin; required with general socket | -| `RMM_APT_HELPER_SOCKET` | Dedicated fixed `/run/rmm-apt-helper/helper.sock`, never generic fallback | -| `RMM_APT_HELPER_PROOF_FILE` | Root-owned public APT stack/profile/identity pin; see `apt-helper-README.md` | -| `RMM_LOG_UNITS_FILE` | Private agent-owned JSON array of exact allowed service units for unprivileged live logs | -| `RMM_EXTENDED_INVENTORY` | `1` by default with the now-compatible backend, `0` for legacy base-only JSON | -| `RMM_AGENT_PROFILE` | `development` required only for the rotation-test interval override | -| `RMM_ROTATION_TEST_AFTER_SECONDS` | Positive development-only certificate-age trigger; never bypasses chain/expiry/EKU/key/identity verification | - -Binding fields: tenant_id, asset_id, agent_id, enrollment_generation, -assignment_version, public_key_hex. Device/asset must match enrollment. Empty key -is allowed only with authenticated signing-key bootstrap; later startup must -reauthenticate that bootstrap or use a fully provisioned binding. Key response is -Ed25519/schema 1/raw 32-byte key with SHA-256 key ID, bounded and no redirects. -The immutable agent cache is `job-signing-key.json`. Signing-pin replacement and -identity/assignment recovery are controlled provisioning operations, not automatic -trust in a key from a job. Helper trust stays independently root-provisioned. - -The unit leaves the job-binding optional in `/etc/rmm/agent.env`, allowing a first -passive enrollment. Set binding/key-bootstrap/helper variables only after the -authenticated operator resolves the enrolled IDs and provisions their pins. -Do not delete an old identity/journal to get a new first-session shortcut. - -## Integrated transport and sync - -One bounded actor and one dispatcher serve WSS and HTTPS with identical envelopes, -journal, result receipts, cancellation and signature checks. `auto` tries WSS -first and falls back only after two typed HTTP upgrade-block classifications; -401/403, TLS/identity failures and ambiguous errors never select a bypass. -WSS Ping/Pong are handled. HTTPS uses the existing MessageBatch/25-second poll -contract. Poll cancellation cannot create a new attempt; fresh heartbeat IDs/ -sequences are never reused or queued as offline telemetry. Actor queues are bounded. - -Every authenticated Hello advertises `rmm.sync.v1` and closes all local effect -gates. Agent obtains actual root snapshots, durably reserves the fresh SyncRequest, -checks exact signed SyncResponse bytes and all device/channel/boot/checkpoint/ -request-hash/time bindings, commits targeted journal/receipt changes, applies its -own consumption decisions, forwards the **original** signed response plus original -request protobuf to every configured helper, then confirms actual applied root -checkpoints. No generic ready boolean opens either process. - -Both root profiles share actual DB/lock inodes. They join an unchanged pending -root capture created after both process births, so ONE signed response/checkpoint -can be independently applied by both. A new process never inherits readiness -from the shared DB. Stale process captures are fenced; known outcomes may unlock -specifically while an unknown retains the resource and global gates stay closed. -Consumed grant/attempt tombstones are never removed. - -Scheduler AND immediate worker effect admission check the current signed lease; -the worker also rechecks fresh grant/time and the disconnect/rotation atomic fence. -Helper checks its own process gate under the same executor guard before consumption. -Unknown, missing authoritative history, clock failure and rollback remain closed. -Clock/helper sync failure does not stop independent passive heartbeat/inventory -traffic. Sync retries are bounded, happen on fresh inventory/result ACK and on a -lease timer, and never retry a lost permit request as a new grant. - -After reboot, old/new boot ID alone is not success. Fresh current-boot inventory -is durably ACKed, a new signed decision must bind the persisted original boot and -current authenticated boot plus inventory evidence, then each helper independently -applies that specific canonical terminal outcome/unlock. Thus an initial negative -sync does not deadlock waiting forever without the post-inventory resync. - -Result envelopes are archived before concrete ACK deletion in one SQLite -transaction. Historical message identity/output is retained for reconciliation. -Inventory mapping preserves source/time/quality/completeness and unsupported states. -Live journal permission warnings become permission_denied, not a fake empty success. - -## Helper bootstrap/policy inspection - -Helper normal daemon: `RMM_HELPER_CONFIG=/etc/rmm/helper.json` (root-owned 0600). -Both profiles use `/var/lib/rmm-helper/consumption.sqlite` and `executor.lock`. -Helper config uses the existing binding, optional independent signing_key_file, -agent_uid, socket_gid, socket, shared state, allowed_services, allow_reboot, -allow_root_scripts; APT adds its existing sealed apt_provider configuration. - -Public general pin, **planned command, not executed on VM here**: - -```text -RMM_HELPER_CONFIG=/etc/rmm/helper.json /usr/local/libexec/rmm-privileged-helper --inspect-general-profile -``` - -Install the exact JSON as root:rmm-agent 0640 in non-writable root-owned parents, -then set RMM_HELPER_POLICY_FILE. It binds profile, device identity/key and exact -policy hash. General policy probe uses root socket/peer credentials and a fresh -challenge; capabilities reflect actual policy/interpreter availability. Root -scripts remain default-off broad administration. Services are exact allowed -running/stopped units with >=180s runtime, reboot separately enabled with >=60s. -Root jobs are NEVER relabelled into agent_service. - -APT install/probe/inspection modes and profile sandbox remain exactly documented -in `apt-helper-README.md`. Both daemons need this same installed build and reviewed -new proof hashes (binary bytes are part of the APT proof). Prefetched sealed -archives, receipts predating the grant and exact baselines are still prerequisites; -this integration introduces no unsafe generic APT download/install/simulation path. -Root native-acceptance and accepted-recipe/manifest capabilities come only from -authenticated real readiness. Successful native acceptance triggers a controlled -reconnect to advertise newly accepted recipes; periodic safe capability refresh -also reconnects rather than silently changing the Hello contract. - -## Passive APT planning and declarative no-change - -The normal extended inventory worker now runs at startup and every 60 seconds -(one inflight collector; not in the heartbeat handler). Unacknowledged durable -traffic backpressures new collection without deleting old data; job results and -control receipts retain priority. It includes the fixed -`linux.apt.planning` scope from `root-helper:apt_planning_v1`. This currently -refreshes the existing extended inventory scopes too; their actual individual -source timestamps/quality remain intact. There is no arbitrary package query, -requested live diagnosis or software effect hidden in this collector. - -`apt_planning_v1` uses the existing UID-authenticated dedicated Unix socket, -fresh challenge, device/generation/signing-key identity, root peer and separately -root-provisioned stack pin. Its response is the readiness envelope with a typed -`planning` result and **empty capability/acceptance fields**. It does not depend -on a prior native-acceptance record and cannot create one. Root validates the -installed code, exact runtime/config policy pins and actual archive bytes, sizes, -ownership/modes/link count and private prefetch receipts. No artifact is fetched -or installed by this RPC. Administratively stage the known fixture archives via -`provision-fixture-store` before planning/the final 60-second grant. - -The fixed metadata child has a 4-second whole-process/output budget (32 KiB), -the socket has 5-second IO limits, and root measurement timestamps are preserved. -Dirty dpkg updates/triggers, foreign locks, unsafe/missing receipts, permission -failure, timeout or missing helper yield an unknown observation with null data, -not fake hashes or accepted capability. Runtime policy drift fails closed. -Complete observations contain the suite's `fixture_package`, `baseline_sha256`, -`sealed_baseline_sha256`, `status_fingerprint`, `dpkg_updates_empty`, -`pending_triggers_empty`, `runtime`, `runtime_sha256`, `provider_sha256`, -`hook_sha256`, `apt_config_sha256` and `prefetch`. The full package baseline stays -root-private at `baselines/.json`; only hashes, fixture projection and -minimal public runtime/artifact pins cross the wire. Stable sampling is checked -before and after content-addressed exclusive write/file+directory fsync; existing -identical seals are verified, never overwritten. This is passive metadata, not -job authority. The ordinary durable inventory outbox/ACK path persists it. - -Normal accepted fixture `ensure_package`/`apply_updates` may return -`POSTCONDITION_ALREADY_MET`, `changed=false`, `already_desired=true`, -`postcondition_already_met=true`, `transaction_executed=false` only when the -**entire selected set** is independently installed at its exact target version -and architecture, clean, matches the current approved baseline/fingerprint and -has the expected fixture payload. Root signature, all original bindings, -expiry/sync/local-policy/resource gates, all manifest/code/runtime/artifact pins, -native accepted-recipe record and durable grant/attempt consumption remain -mandatory. Only the historical `old_version` condition is skipped in this -no-mutation branch. No APT/hook/native launch/effect marker is created. A foreign -lock, dirty/unknown state or changed baseline cannot become success; native -acceptance itself never uses this branch. Other versions still follow the -unchanged no-reinstall/no-downgrade/no-remove mutation guards. - -VM suite owner must update its absent/1.0-only adapter: after native update to -1.1, a normal exact desired-1.1 job must use the accepted update recipe with a -fresh planning seal. A desired-1.0 job on 1.1 is still correctly denied; this -implementation does not authorize removal/downgrade to make a stale test pass. -No backend/domain/protobuf signatures or plan bytes have been changed. - -Provider source changes change the embedded provider/helper/stack/runtime pins. -Deploy both helpers from this build and provision reviewed new proof/policy -pins **before** native acceptance; old native records cannot silently certify -new runtime bytes. Manifest schema 2 / transaction schema 1 / fixture archives -1.0 and 1.1 (20,672 bytes, unchanged hashes) remain unchanged. - -These are implemented source/local-fixture semantics, not VM or MVP acceptance. - -## Certificate rotation and recovery - -`RMM_AGENT_STATE/certificates/current.json` is the authoritative atomic selector -over private versioned device key/cert files. Existing enrolled files initialize -the store exactly once; later connections/bootstrap use the selected identity. -Rotation checks chain, current validity, exact agent CN, clientAuth purpose and -public/private key match. It persists one pending key/CSR and retries those SAME -CSR bytes after response loss. A verified swap closes the old actor/effect fence -and requires a new Hello/Sync. Agent/enrollment IDs and independent job/helper -signing pins do not change. Expired/revoked/invalid certs remain blocked and need -authorized identity recovery; no auto-reenrollment or TLS downgrade. - -## Verification boundaries / concrete remaining policy issue - -Local Rust source/unit/integration tests cover actual loopback mTLS dispatcher -WSS/HTTPS clean reconnect, Ping, forged sync rejection, passive traffic with an -untrusted effect clock, journal reopen/replay and independent helper checkpoint/ -outcome/boot checks. Unsafe OS providers are mocked or denied; no local service, -APT install or reboot was executed. This is not a real WebUI-approved VM result, -native package acceptance, production auth acceptance or full Linux-MVP sign-off. - -Concrete backend policy limitation, not bypassed here: `RootScope::permits` in -`crates/server/src/root_policy.rs` does not match `Action::QueryLogs` and falls -through to false. The typed, bounded root helper log handler exists, and the -unprivileged allowlisted path is live, but a root live-log plan will be denied by -that backend policy until its owner adds an explicit permitted scope. Do NOT -work around it by relabelling identity, direct approval or a generic root shell. - -## Executed local verification - -Using `/home/Kevin/.cargo/bin/cargo`, actually passed during integration: - -```sh -cargo test -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux --all-targets --locked -cargo clippy -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux --all-targets --locked -- -D warnings -cargo build -p rmm-agent -p rmm-privileged-helper --locked -cargo fmt -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux -- --check -python3 tests/agent_jobs/test_install.py -target/debug/rmm-agent --help -target/debug/rmm-privileged-helper --help -``` - -111 executed Rust test cases passed (including reused transport tests), two -create-only installer guard tests passed, both debug binaries built and both -help commands returned successfully without loading secret configuration. No -warnings/type errors were suppressed. A boxed tungstenite HTTP-response test -constructor was corrected, not bypassed. No coverage percentage was measured. - -Coverage boundaries: real loopback TLS/dispatcher WSS and HTTPS reconnect and -forged sync rejection are exercised; helper cryptography/checkpoints/two-process -shared signature and replay/unknown/reboot decisions use real SQLite/signatures -with local fixtures. Native service/APT/reboot effects and positive root UID-0 -daemon/VM RPC acceptance are NOT substituted by these tests. The built artifacts -are `target/debug/rmm-agent` and `target/debug/rmm-privileged-helper`; a reviewed -VM-compatible release artifact still needs the target worker's ELF/glibc/library -preflight and actual authorized VM run. - -## Executed local verification — planning/no-change increment - -After **all** source changes, the following complete targeted block passed with -`/home/Kevin/.cargo/bin` on PATH (2026-11-12): - -```sh -cargo test -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux --all-targets --locked -PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/apt_transaction -p 'test_*.py' -v -cargo clippy -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux --all-targets --locked -- -D warnings -cargo fmt -p rmm-agent -p rmm-privileged-helper -p rmm-agent-linux -- --check -cargo build -p rmm-agent -p rmm-privileged-helper --locked -cargo build -p rmm-agent -p rmm-privileged-helper --release --locked -python3 tests/agent_jobs/test_install.py -target/debug/rmm-agent --help -target/debug/rmm-privileged-helper --help -``` - -Results: **115 Rust tests**, **56 Python APT tests**, **2 installer guard tests** -passed; warning-denying all-target Clippy and formatting passed; both Debug and -Release binaries built; both help commands succeeded. Separate final AST parsing -passed for **8 Python files**. No full workspace/backend/web test suite was run. - -New regressions cover shared Python/Rust canonical golden bytes/hash, receipt -and timestamp freshness, private content-addressed seal reuse/change without -full-baseline disclosure, sampling drift/dirty/foreign-lock/bad-artifact failure, -normal exact already-desired install/update postconditions, no launch/effect -markers, old-version mutation rejection, wrong architecture/newer version, -audit/payload/expiry rejection, no-change outcome binding and durable duplicate -grant/attempt rejection, honest missing-helper data and collection backpressure. -Root ownership/kernel state and unsafe native package processes are mocked; -existing harmless unprivileged seccomp tests really execute. No native host -package mutation, root systemd/probe/VM action, approval or reboot was performed. - -Earlier intermediate failures were corrected, not suppressed: the inherited two -unformatted source edits, a mock reader missing the `limit` keyword argument, -and a newly inserted function accidentally inheriting a test-only cfg attribute. -The final complete block above passed after these corrections. - -Final artifact SHA-256 (native developer-PC builds; **not** Bookworm/VM proof): - -| Artifact | SHA-256 | -|---|---| -| `target/debug/rmm-agent` | `90a4eab064301740cd938a41a76a510ad3b4abc3e48a188ba12bfe22f123266c` | -| `target/debug/rmm-privileged-helper` | `54db2fe17841fef9af48bbeb446f45bda52f62e442a4900e0543e358095900b7` | -| `target/release/rmm-agent` | `eac5434fd7a1e509c0971e4e05d4e1aedbde1bb90f7d7a8f9ec4d48ab4d34597` | -| `target/release/rmm-privileged-helper` | `581a033478b41365066df2dc9ac0d11e314160909b5fab612be0be97be1bbbdc` | -| `tools/apt-transaction/apt_transaction.py` | `57b695bf57ea2703393e39f92a1b6ef2314b4838f3dfb29e4e70da79687c9987` | - -Remaining: suite-owner adapter update for exact desired 1.1 after native upgrade, -reviewed deployment/new pins, actual dedicated-profile metadata RPC and native -UI-approved fixture/no-change VM proof, target ELF/library compatibility, and -VM resource/retention measurements for the new 60-second extended collection. -No real current baseline change was induced on the host/VM: freshness tests use -changed temporary/mock package state, not a disguised package installation. -Linux-MVP and production acceptance remain open. Backend Root QueryLogs policy -is owned by its separate worker and was neither changed nor reverified here. diff --git a/deploy/shared-core-acceptance.md b/deploy/shared-core-acceptance.md deleted file mode 100644 index ff2305b..0000000 --- a/deploy/shared-core-acceptance.md +++ /dev/null @@ -1,100 +0,0 @@ -# Native gemeinsame Core-Unitabnahme - -**Persistenzprofil tatsächlich ausgeführt, 2026-11-14:** -Fall `08a9be72-dd7c-46b7-a2c6-7d17424533c2`, Linux76 vor Windows54, ohne Skip. -Getrennte eigene SQLite-/Signaturfixturen, keine native Job-/Dienstabnahme. - -**Helper-Sync-Profil tatsächlich ausgeführt, 2026-11-14:** -Fall `5704073c-a135-431c-aa84-fedc68a3de0b`, Linux 69/69 vor Windows 47/47, -keine Skips oder RMM-Wirkung. Auch dies ersetzt keine Windows-SYSTEM-Dienstprobe. - -`shared_core_acceptance.py` führt ausschließlich die zwei source-/hashgebundenen -Testprogramme `contracts` und `reconcile` aus: eigene temporäre SQLite-Fixturen, -Testsignaturen, Fake-Clock und Fake-Channel. Keine RMM-Jobs, Hello-Wirkung, -Enrollment, Schlüsselzugriffe, Runtimeersetzung, Dienste oder Serverkontakte. -Die Tests enthalten keine Netzwerkstrecke; der Runner behauptet keine zusätzliche -OS-Netzwerksandbox. Bootstraptransport bleibt vorhandenes hostkeygeprüftes SSH/SFTP. - -**Tatsächlich ausgeführt, 2026-11-14:** - -```sh -python3 deploy/shared_core_acceptance.py linux -python3 deploy/shared_core_acceptance.py windows --case-id 4bc4db12-2990-4e93-bb86-8fbd94b691fb -``` - -Fall `4bc4db12-2990-4e93-bb86-8fbd94b691fb`: Linux 25/25 und danach Windows -24/24 nativ bestanden, jeweils ohne Skip. Permanente Dienste wurden nicht -ersetzt; insbesondere kein Windows-Job- oder Dienst-Syncnachweis daraus. - -Der Runner prüft beide privaten Qualifikationsmanifeste, sämtliche gebundenen -Quellhashes und genau zwei Artefakte. Linux läuft zuerst (5+20 Fälle). Windows -(4+20 Fälle) verlangt denselben gespeicherten vollständigen Linux-Nativbeleg und -bindet dessen SHA256. Alle Fälle müssen erfolgreich und ohne Skip ausgeführt sein. -Exakte Testargumente: ausschließlich `--test-threads=1`. - -Lokale Intent-/Start-/Readback-/PASS-Dateien unter -`devstate/shared-core/acceptance//` entstehen create-only. Remote nur eigene -geschützte Bootstrap-Testverzeichnisse: Linux -`/var/lib/rmm-shared-core-acceptance///`, Windows bestehendes -`C:\ProgramData\RustDiscoveryBootstrap\\windows-core-*.exe` und eigener -`shared-core-`-Fall. Ausgaben/Fehler bleiben privat; stdout enthält nur -sanitisierten Status und bei PASS Fall-/Artefakt-/Nachweishashes. - -Bei verlorener Ausführungsantwort **nicht erneut starten**. Ausschließlich -vorhandene Remotequittungen lesen: - -```sh -# GEPLANT, NICHT AUSGEFÜHRT: keine erneute Testausführung. -python3 deploy/shared_core_acceptance.py finish-linux --case-id -python3 deploy/shared_core_acceptance.py finish-windows --case-id -``` - -Fehlt eine Quittung, bleibt die Abnahme unvollständig; kein automatisches Resume, -keine Bereinigung oder Wiederholung. Native Unittests ersetzen weder den späteren -Linux-Dienst-Syncnachweis des extrahierten Kerns noch Windows-WebUI-/Clock-/ -Prozess-/Jobabnahmen. Der aktuelle Windowsclient erhält dadurch keine Jobfähigkeit. - -## Nachfolgendes festes Profil `helper-sync-v1` - -Eigenständige neue Qualifikationsmanifeste/Artefakte unter -`devstate/shared-core/helper-sync-v1/` und `devstate/windows-core/helper-sync-v1/`; -Originalartefakte, Manifeste und deren native Fälle bleiben unverändert. -Das feste Profil prüft Linux **5+21+22+21=69** Fälle, zuletzt den bestehenden -Linuxhelper mit echtem Unix-ExecutorGuard und Bootquelle an eigenen Fixturen. -Erst dessen vollständiger Nativbeleg erlaubt Windows **4+21+22=47** Fälle. -Portable Helperfälle verwenden einen ausdrücklich simulierten Ledgerguard und -qualifizieren keine Windows-Pipe, Volume-/File-ID oder SYSTEM-Wirkung. - -```sh -# GEPLANT, NICHT AUSGEFÜHRT: Parent übernimmt tatsächliche VM-Ausführung. -python3 deploy/shared_core_acceptance.py linux --profile helper-sync-v1 -python3 deploy/shared_core_acceptance.py windows --profile helper-sync-v1 --case-id -# Bei verlorener Antwort weiterhin nur lesen, mit demselben festen Profil: -python3 deploy/shared_core_acceptance.py finish-linux --profile helper-sync-v1 --case-id -python3 deploy/shared_core_acceptance.py finish-windows --profile helper-sync-v1 --case-id -``` - -Profil, Quellen und Artefakte sind an den privaten create-only Intent gebunden. -Es gibt weiterhin keinen frei wählbaren Programmpfad oder Argumentvektor. - -## Persistenzkorrektur `durable-outcome-v1` - -Neue unveränderliche Qualifikation unter `devstate/*core/durable-outcome-v1/`. -Das feste Profil erwartet Linux **7+26+22+21=76**, danach Windows **6+26+22=54**. -Lokale Regressionen und Cross-Builds sind im Manifest separat von der noch -geplanten tatsächlichen VM-Ausführung ausgewiesen. Kein früherer Nachweis wird -umgeschrieben. Vorläufige verworfene Builds sind ausdrücklich unqualifiziert. - -```sh -# GEPLANT, NICHT AUSGEFÜHRT: tatsächliche VM-Ausführung durch Parent. -python3 deploy/shared_core_acceptance.py linux --profile durable-outcome-v1 -python3 deploy/shared_core_acceptance.py windows --profile durable-outcome-v1 --case-id -``` - -Die gezielten Fälle prüfen atomaren Verbrauch+Startzeugen, Original-Outcome-CAS, -Crash vor/nach Resultcommit, Reconnect-Unknown mit späterer Originalcompletion -und die weiterhin verweigerte Freigabe bei fehlendem lokalen Outcome. -Startup journalisiert ausschließlich bereits gebundene gespeicherte Belege neu; -Unknown ohne solchen Beleg bleibt gesperrt. Server-/Unlockregeln bleiben strikt. -Dies simuliert Commitgrenzen mit eigenen Fixtures; es ersetzt keinen späteren -wirklichen Agentprozessabsturz oder unabhängigen SYSTEM-Helperabschlussnachweis. diff --git a/deploy/shared-core-upgrade.md b/deploy/shared-core-upgrade.md deleted file mode 100644 index 7747568..0000000 --- a/deploy/shared-core-upgrade.md +++ /dev/null @@ -1,108 +0,0 @@ -# Preserving Linux shared-core runtime qualification - -The notebook only builds and orchestrates. The fixed Cloud Linux VM remains the -client; `discovery.ease-technologies.de` remains the server. These bootstrap -tools never create or approve an RMM job, enroll, reset a journal, install a -package or reboot the guest. - -The original `cloud_shared_core_upgrade.py` remains frozen at SHA-256 -`09b60e99e1bf92dbaa60f0b0a64f9b94e3cefebb110d558b14c381293cbde873`. -Its case `2f8de8b9-2abe-4125-aa12-ae38332a32c6` stopped before any binary exchange: -the generic `nlink == 1` check rejected an existing valid APT publication pair. -The original failed report, staged binaries and APT records remain retained. -`cloud_shared_core_failed_restore.py` restarts only the verified original -runtime, once; its saved actual readback is required before a new V2 case. - -V2 is a source copy with a narrow alias admission and earlier object checks: -`cloud_shared_core_upgrade_v2.py`, SHA-256 -`d4f857b8ff6e7d9802f863a120a1576ffac5b36facb6a259149409ef25bfbc91`. -The only permitted alias paths are under `/var/lib/rmm-apt-transaction/`: - -- `acceptance-rmm-apt-fixture-update-1.1.json` -- `pending-acceptance-rmm-apt-fixture-update-1.1.json` - -Both must retain device `2049`, inode `1028362`, UID `0`, GID `984`, regular-file -mode `0600`, link count `2`, and SHA-256 -`a88d6b10bbf6c36eaa8dee87eb1a381f2becc36297db8df2b4189791b9165506`. -That content hash comes from the original verified, UI-approved native APT -update result. The mode is the actual stored `lstat` value `33152` (`0100600`). -Neither name is rewritten, unlinked or chmodded. Other hardlinks, symlinks and -unexpected nonregular state objects remain rejected. - -The qualified `durable-outcome-v1` release artifacts remain: - -| Artifact | SHA-256 | -|---|---| -| Linux agent | `c9c09de0ecb52b556d707cf45accb69186c73b8ec9baeeabfaeff220fafb1d4e` | -| Linux helper | `51c3142ab332216d6a94ff64ff15cbc37ee1d5a99896c14c87bb6f62e63bb946` | -| Unchanged APT provider | `1dc0237dd8df9c9d22568bb1f6b047ede73bc2a5fca5c7fcedb7f24ab2a58b1e` | - -Planned, not executed by this preparation: - -```text -python3 deploy/cloud_shared_core_upgrade_v2.py prepare --restore-readback -python3 deploy/cloud_shared_core_upgrade_v2.py install -python3 deploy/cloud_shared_core_upgrade_v2.py finish -``` - -Each new intent binds both runner hashes, the restore readback, actual alias -metadata, original APT checkpoint, release qualifications and the Linux-MVP -closeout. Local cases use `devstate/shared-core/runtime-upgrade-v2/`; remote -cases use `/var/lib/rmm-bootstrap-history/shared-core-v2-`. A durable -installation receipt forbids repeating installation, including after a lost -reply; only readback/finish of that same case is permitted. - -The pre-restart preservation checks run under both existing locks. Old -consumptions, outcomes, signatures, database identities, trust and backup -witnesses remain bound. Private key contents are never read or exported. -General policy/pin remain unchanged, `allow_reboot=false`; the APT endpoint -stays closed and its historical runtime pins remain stale. Native mTLS/Sync, -MCP and central-count qualification are separate final acceptance steps. - -V2 preparation checks passed locally: Python syntax, fixed RPC globals, source -format, all 65 qualified release source bindings and the existing native Linux76 -core-unit receipt. This document does not claim native V2 installation success. - -## Retained native bootstrap assertion failures - -The original V1 failure above was a bootstrap verifier error: the existing -legitimate APT hardlink publication was rejected. Neither alias was repaired or -rewritten. Its original-runtime restart and actual readback were separately -recorded before the new V2 case. - -V2 case `a2423612-721f-4a6c-a832-b9eef549c41e` subsequently reached the persisted -`installed_preserved` stage: both new binaries were installed, all pre-restart -data witnesses matched, and both daemons started. Its last verifier assertion -incorrectly compared process GID with the account's primary passwd GID. Actual -readback showed the expected service identity, UID993/GID984, matching the -independently verified Linux-MVP closeout. This was a second bootstrap verifier -error; the report remains `completed=false` and is never rewritten as success. - -`cloud_shared_core_upgrade_attestation.py` is a separate read-only supplement -for that exact case. It rechecks preserved rows/schema/inodes/trust/backups and -the actual process identity, and binds the stored native VM/server Sync114 -evidence to the retained exact signed decision and request. It does not start -services, retry installation, change SQL, alter the original report, or create -jobs. Its prepared SHA-256 is -`59b20ecd2d32ea3b37f2840868eb67ce677ffdb967e079a667e53c7907fce86b`. - -## Actual read-only closeout, 2026-11-14 - -The supplemental attestation was actually executed and passed; its protected -receipt is `readonly-attestation-63730c38-327e-4635-802f-8289c28081de.json` -inside the V2 case. A prior strict row-hash readback rejected28 cached outcome -references that normal signed Sync had renewed. Only those reference changes -were then independently proven: reconstruct the original complete row hash with -identical job/attempt/outcome bytes and the preserved original decision ID; -verify both original Ed25519 decisions and the exact applied request/response, -grant/plan/outcome binding and monotonic journal history. All other historical -rows remain byte-identical. No general outcome exemption or state rewrite. - -Native MCP subsequently read the existing Linux device online, rejected the -foreign tenant, and confirmed unchanged30/30/26/0 central counts. Agent/helper -and server share the ready signed Sync114; original18 Root consumptions remain -closed. `devstate/cloud-shared-core-current-runtime.json` binds both actual -attestation and MCP receipts. It supplements the preserved historical MVP -closeout and does not requalify APT for the new binary hashes. All original -failure reports remain unchanged, and no installation or service start was -repeated to obtain this read-only closeout. diff --git a/deploy/windows/CLIENT.md b/deploy/windows/CLIENT.md deleted file mode 100644 index 1c536d5..0000000 --- a/deploy/windows/CLIENT.md +++ /dev/null @@ -1,231 +0,0 @@ -# Windows-Client: erster nativer Entwicklungsstand - -Stand 2026-11-13, Spezifikation 1.15. Windows-11-Gast und Notebook-Host sind -verschiedene Geräte. Auf dem Notebook laufen ausschließlich Entwicklungstools; -der Client verwendet den endgültigen Cloudserver `discovery.ease-technologies.de`. - -Neuer Quellenstand 2026-11-15: [passive Zertifikatserneuerung](../../docs/windows-certificate-renewal.md) -mit geschützter Keydatei und atomarer Versionswahl ist implementiert; native -Windows-Renewal-/Abbruch-/DACLabnahme und Freigabe der permanenten Identität -bleiben offen. Frühere Transportabnahmen darunter bleiben historische Belege. - -## Aktueller Dienst dauerhaft auf Auto — 2026-11-13 - -Nach dem bestandenen Fallbacktest wurde die bestehende VM im separaten Fall -`422562e8-18eb-4865-977d-ab2af65f510b` dauerhaft auf `transport=auto` gestellt. -WSS bleibt bevorzugt; zwei frische WSS-Heartbeats und ein konkretes Inventar-ACK -sind unter dem tatsächlichen LocalService (`S-1-5-19`) nativ nachgewiesen. -Binary, Geräteidentität, CA, Zertifikat, Schlüssel, ACLs und Telemetriehistorie -blieben erhalten. Beide Server-Testhooks bleiben deaktiviert; Serverkonfiguration -und Rootpolicy wurden bei dieser Umstellung nicht verändert. Windows bleibt bei -0 Jobs/Outbox/Grants/ungeklärten Wirkungen, Linux unverändert bei 30/30/26/0. - -Der verifizierte geschützte Beleg liegt unter -`devstate/windows-client/auto-default/422562e8-18eb-4865-977d-ab2af65f510b/result.json`. -`devstate/windows-client/current-transport.json` bindet ihn per Hash und hält den -aktuellen Transport getrennt von historischen Abnahmen fest. Originalkonfiguration -und ACLs bleiben versioniert für eine ausdrückliche Wiederherstellung erhalten. -Die Installerquelle verwendet ebenfalls `auto`; eine frische Installation wurde -damit nicht ausgeführt. Fünf gezielte lokale Schutztests sowie Parserprüfungen -bestanden. Es wurden keine Windows-Jobs oder Reboots ausgeführt. - -## Automatischer WSS→HTTPS-Fallback nativ bestanden — 2026-11-13 - -Eigener Fall `2ff2e1aa-0037-4831-9bc2-31218bf1461c` auf derselben bestehenden -Windows-Identität unter LocalService. Nur der eigene Agenttransport wurde -versioniert auf `auto` gestellt. Zunächst zwei frische WSS-Heartbeats; -dann exakt gerätegebundene, zehn Minuten gültige dev/test-Störung. -Zwei tatsächliche mTLS-authentisierte HTTP503 bei WSS, mit unterschiedlichen -Handshake-IDs und den festen Slots1/2, Zertifikatsfingerprint und Config-Hash. -Der Agent wechselte selbst zu HTTPS; zwei frische HTTPS-Heartbeats und konkreter -Inventar-ACK nach beiden Verweigerungen tatsächlich gespeichert. - -Gleiche Agent-/Asset-/Enrollment-/Zuordnungsversion und Dateien/ACLs, monotone -Sequenz, TenantB weiter verweigert. Kein neuer RMM-Job: Windows vor/nach -0Jobs/0Outbox/0Grants/0offen; Linux unverändert30/30/26/0. Zentrale Rootpolicy -unverändert. Beide realen Serverrollen danach mit Faultflagfalse und ohne -konfigurierten Fault-Dateipfad; exakte ursprüngliche WSS-Konfigurationsbytes und -ACLs auf Windows restauriert, wieder zwei frische WSS-Heartbeats/ACK0. -Dies ist keine Behauptung eines automatischen HTTPS→WSS-Switchbacks: Rückkehr -folgte aus der ausdrücklichen operativen Wiederherstellung der Konfiguration. - -Ausgeführt: `python3 deploy/windows/auto_transport_acceptance.py start ---https-case 3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458`. -Sechs gezielte lokale Guards ergänzen den nativen Nachweis; kein neuer -Clientbuild und keine Windows-Syncbereitschaft erfunden. Geschützt: -`devstate/windows-client/auto-transport/2ff2e1aa-0037-4831-9bc2-31218bf1461c/result.json`, -verifiziert. Am Ende dieses Testfalls lief der Dienst wieder mit ursprünglichem -WSS. Die anschließende dauerhafte Auto-Umstellung ist oben separat dokumentiert. - -## TLS-Negativfälle auf Windows nativ bestanden — 2026-11-13 - -Feste getrennte Fixture `7b190a5c-c928-4348-bd0d-c9698dad5417`, Schlüssel auf -Windows erzeugt und dort behalten. Nur öffentliche CSR zum bestehenden -Cloudsignierer, ausschließlich öffentliche CA-/Clientzertifikate zurück. -Unregistrierte gültige Kontrolle vor und nach den Negativfällen: tatsächliches -HTTP401 nach erfolgreichem TLS. Falsche CA: `TLS_UNKNOWN_ISSUER`; falscher -Servername: `TLS_SERVER_NAME_MISMATCH`; abgelaufenes Clientzertifikat: -`TLS_PEER_CERTIFICATE_EXPIRED`, jeweils ohne HTTP-Antwort. Alle fünf nativen -Probeprozesse mit dem gemeinsamen `https_channel::mtls_client` bestanden. - -Dies sind ausdrücklich Admin-TLS-Proben, keine LocalService- oder -Rotationsabnahme. Der tatsächliche LocalService-HTTPS-Pfad ist separat unten -nachgewiesen. Permanenter Dienst samt PID/Startkonto, Identität, öffentliche -Zertifikatsdateien und private Schlüsseldateimetadaten vor/nach identisch. -Keine Dienstoperation, Registrierung, Jobs, Uhränderung oder TLS-Ausnahme. - -Erster Lauf blieb bei unbekannt klassifiziertem CA-Fehler sicher verweigert. -Typinformation wurde in verschachtelten io::Error-Quellen übersprungen; -gezielter get_ref-Fix samt Test erkennt den echten Rustlsfehler, ohne Timeout, -Reset oder Fehlertexte als Zertifikatsablehnung zu werten. Ein Retest wurde -vor TLS durch einen Bootstrap-Witness-Timeout unterbrochen. Kurzer begrenzter -Witness und erneute Prüfung derselben unveränderten öffentlichen Fixtures -bestanden, ohne neue CSR/Signierung/Keyerzeugung. Alte Ergebnisse bleiben erhalten. - -Verifiziertes Ergebnis unter -`devstate/windows-client/tls-negative/7b190a5c-c928-4348-bd0d-c9698dad5417/typed-retest-6dd51cc0-deb5-4020-afee-58dbb716cdbb/result.json`. -Qualifizierte Probe SHA256 -`33eb56500908a88e3ff30cc1e61f9416e38d94fbf27633ac6dfaf9903cd4ef1b`: -gelockter Windows-GNU-Releasebuild, Clippy mit-Dwarnings, gezielter verschachtelter -TLS-Fehlertest und Python-/PowerShell-Parserprüfungen bestanden. -Ausgeführt: `python3 deploy/windows/tls_acceptance.py --execute-native-tls-negative ---artifact devstate/windows-client/WindowsTlsProbe.exe --resume-case -7b190a5c-c928-4348-bd0d-c9698dad5417`. - -## Native HTTPS-Abnahme zusätzlich bestanden — 2026-11-13 - -Der bestehende LocalService-Agent wurde im festen Fall -`3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458` administrativ und versioniert von WSS auf -explizites HTTPS umgestellt. Keine neue Identität, kein Enrollment, kein RMM-Job. -Tatsächlicher serverseitiger Transport `https`, zwei frische Heartbeats um -22:21:14.183598 und22:21:45.234313 UTC. Der native Readonly-Journalbeleg bestätigt -Integrität, gleiche Identität, monotone Sequenz935→941 und0 ausstehende -Inventarereignisse nach konkretem ACK. Tatsächlicher Prozessowner `S-1-5-19` -(LocalService); unverändertes qualifiziertes Programm, CA, Zertifikat, privater -Geräteschlüssel und deren ACLs. Private Schlüssel blieben auf der VM. - -Anschließend exakt ursprüngliche WSS-Konfigurationsbytes und ACLs wiederhergestellt, -zweimal frischer WSS-Kontakt sowie abgeschlossener Inventar-ACK nachgewiesen. -Beide fremden Tenantzugriffe verweigert; vorher/nachher0Jobs/0Outbox/0Grants/ -0offene Versuche. `result.json` ist verifiziert. Geschützte Belege: -`devstate/windows-client/transport/3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458/`. - -Ausgeführt: `python3 deploy/windows/transport_acceptance.py start`. -Der Runner verwendet einen per Hash und SFTP gepinnten Bootstrap-PowerShellcode; -prozessbezogenes RemoteSigned ändert keine Maschinen-/Gruppenrichtlinie und -keine RMM-Jobausführung. Sieben gezielte lokale Runner-Guards und drei -PowerShell-Parserprüfungen bestanden; kein neuer Clientbuild für diese Abnahme. -TLS-Negativfälle und automatischer Fallback sind oben separat nativ abgenommen. -PowerShell-Jobs bleiben bis zu [ihren Voraussetzungen](../../docs/windows-job-boundary.md) -gesperrt. Die folgenden Erstnachweise bleiben historisch erhalten. - -## Tatsächlich nachgewiesen - -`rmm-agent-windows` als eigene Plattform-Crate mit gemeinsamen Domain-/Protobuf- -Verträgen und direkt wiederverwendeten WSS-/HTTPS-/TLS-Modulen des Linux-Agenten. -Isolierter Docker-Crossbuild mit Rust 1.99.1 für `x86_64-pc-windows-gnu`: -Debug und Release erfolgreich; Windows-target Clippy über alle Targets mit -`-D warnings` erfolgreich. Zwei gezielte Domain-Tests prüfen die unveränderte -Linux-Validierung, Windows ohne erfundene Inodes und abgewiesene Plattformmischung. -Das sind ergänzende lokale Prüfungen, keine nativen Windows-Dienstnachweise. - -Releaseartefakt SHA256 -`31e360e50b177b4d5729d24e436d4f25aeed7b1a7bd35f2a129841ba1abffd37` -auf der tatsächlichen Windows-11-Pro-VM (Version 10.0.26300, x64) gestartet: -`--native-probe` erfolgreich. Hostname und Systemvolume tatsächlich über Win32 -lesbar; Bootkennung aus `Win32_OperatingSystem.LastBootUpTime` abgeleitet statt -bei jedem Agentstart neu erzeugt. Inodes ausdrücklich `null`/nicht anwendbar. -Keine Schlüssel oder realen Hostnamen in der veröffentlichten Probeausgabe. - -Binärtransfer über bestehendes, hostkeygeprüftes SFTP mit SHA256-Nachprüfung. -Große PowerShell-Console-JSON-Eingaben waren als Bootstraptransport ungeeignet -(Timeout/Console-Reader-Ausnahme); deshalb nur kleine zeilenbegrenzte Metadaten -über stdin. SSH-/Hostkeyprüfung und Reverse-Portgrenzen bleiben unverändert. -Artefaktverzeichnisse werden nach Hash neu angelegt, keine vorhandene Identität -oder Historie gelöscht. Private Evidenz: `devstate/windows-client/`. - -## Nativer Dienst, Inventar und verbleibender Umfang - -- Nativer SCM-Dienstlebenszyklus als `LocalService` mit eigenem - Service-SID-Zugriff auf Zustand und ausschließlich lesbarem Programm/Config. -- Windows prüft Owner/DACL und verweigert Reparse-Points/breite ACLs. Geräteschlüssel - werden nur auf Windows erzeugt; Enrollment über CA- und namensgeprüftes TLS, - danach mTLS. Ein verlorener Enrollmentnachweis löst keinen Identitätsreset aus. -- SQLite mit FULL-Synchronisierung, Prozesssperre, monotoner persistenter Sequenz, - konkretem ACK und begrenzter Telemetriequeue. Kein Löschen für Platzgewinn. -- Separate `windows.base`-Beobachtungen mit Erhebungszeit/Quelle/Qualität; Server - bindet den Scope an die authentisierte Verbindung und deren Capability. - Geräte-API zeigt die gespeicherte Quelle statt eines festen Linuxlabels. -- Ausschließlich `windows.base/1` und `heartbeat/1` werden angeboten. - **Kein Jobexecutor, keine PowerShell-Jobfähigkeit, kein privilegierter Helper.** - Angebote/Startgrants werden verweigert. Es gibt keine Genehmigungsabkürzung. - -Tatsächlich installiert und gestartet: nativer SCM-Dienst mit eigenem Service-SID -unter `NT AUTHORITY\LocalService`; tatsächlicher Prozessowner `S-1-5-19`, nicht -Administrator/SYSTEM. Eigener Geräteschlüssel auf Windows erzeugt, einmaliges -Enrollment erfolgreich und Tokenkopie entfernt; mTLS-Hello und frischer Heartbeat -serverseitig bestätigt. Der erste `.ps1`-Aufruf wurde durch die lokale -Ausführungsrichtlinie vor jeder Installerwirkung verweigert. Verzeichnis, Dienst -und Identität waren nachweislich nicht angelegt; erst danach kontrollierte -Fortsetzung mit explizit **prozessbezogenem** `RemoteSigned` wie beim ursprünglichen -Bootstrap. Keine Änderung der Maschinen-/Gruppenrichtlinie, keine Jobausnahme. - -Native Rust-Testprogramme direkt über den gepinnten SSH-Zugang ausgeführt: -**3 Transporttests + 3 Bibliothekstests + 1 ACL-Integrationstest bestanden**. Diese prüfen Namens-/URL- -Validierung und sichere Fallbackauswahl, echte Windows-Inventardaten, zwei -unabhängige stabile Bootabfragen sowie SQLite-Reopen, monotone Sequenz, -Prozesssperre, gezielten ACK und Identitätsbindung. Der zusätzliche native ACL-Test -weist korrekte ACLs nach und verweigert breite ACLs, NULL-DACLs, falschen Pfadtyp -und Reparse-Points an ausschließlich neu erzeugten nichtgeheimen Tempfixtures. PowerShell-Pipelinewrapper -warteten bei nativen Testprogrammen; direkte native Ausführung lieferte Exit 0. - -Der tatsächliche Online-Lauf fand eine weitere echte Grenze: Migration 0001 -beschränkte `observations.source_id` auf `linux.base`. Daher bisher Heartbeats, -aber kein gespeichertes Windowsinventar. Additive Migration 0013 erweitert nur -diesen CHECK auf die beiden validierten Basisscopes. Echter isolierter PostgreSQL- -Test der Migrationen 1–13 bestanden: alte Linuxzeile bytegleich, Windows erlaubt, -beliebiger Scope verweigert, RLS bei fremdem/fehlendem Kontext und zusammengesetzter -Geräte-FK erhalten, keine Jobs/Outbox/Grants. Cloudmigration 0013 anschließend tatsächlich erfolgreich. Der ursprüngliche -Windows-Journaleintrag wurde ohne Neuerhebung/Identitätsreset erneut zugestellt -und gespeichert: ursprüngliches `observed_at` bleibt erhalten, `received_at` ist -separat. Geräte-API/MCP melden `source_id=windows.base`, korrektes Windowsinventar -und Inodes `null`; zwei verschiedene frische Heartbeats und `online` belegt. -Mandant B wurde sowohl für den A-Kontext als auch für seine eigene Mandantensicht -mit der fremden Asset-ID abgewiesen. Gerätespezifisch **0 Jobs / 0 Outbox / -0 Startgrants / 0 offene Versuche**. Keine WebUI-Genehmigung ausgeführt, weil diese -Strecke ausschließlich passive Standardbeobachtungen verarbeitet. - -Dieser erste Entwicklungsbuild ist **unsigniert**. Kein produktiver signierter -Installer/MSVC-Supportnachweis, keine Zertifikatsrotations-/Widerrufs-/Proxy- oder -Windows-Paket-/Dienstaktionsabnahme. Der erste native Onlinenachweis verwendete WSS. Explizites HTTPS und automatischer Fallback sind inzwischen oben separat nativ -abgenommen. Die passive SCM-/Enrollment-/mTLS-/Inventar-/Mandantentrennungsstrecke sowie -die oben benannten nativen Tests sind nun tatsächlich getrennt belegt. -Dies ist keine vollständige Windows-/Linux-MVP-Abnahme. - -## Ausgeführte und geplante Befehle - -Tatsächlich ausgeführt: Docker-Build und gezielte Rust-Prüfungen oben sowie -`python3 deploy/windows/client_bootstrap.py upload-agent --artifact ` -und `python3 deploy/windows/client_bootstrap.py probe` gegen ausschließlich den -Windows-Gast. Keine RMM-Jobs oder Genehmigungen wurden dabei erzeugt. - -Zusätzlich tatsächlich ausgeführt: native `test-lib`/`test-bin`/`test-acl`, Installer nach -nachgewiesenem Nichtstart mit `install-after-nonstart` und die oben benannte -PostgreSQL-Migrationsprüfung sowie `passive-acceptance` gegen den Cloudserver -mit gespeichertem Inventar, zwei Heartbeats, Tenant-B-Verweigerung und Null-Jobgate. -Installation ist create-only; bei Teilfehlern Zustand inspizieren und erhalten, -nicht blind neu enrollen oder den Bootstrap wiederholen. - -Native ergänzende Receiptprüfung: das separate Entwicklungstool -`examples/passive_state.rs` öffnete ausschließlich die vorhandene Windows-SQLite -im Read-only-Modus. Integrität `ok`, feste Geräteidentität identisch, Sequenz 59, -**0 ausstehende Inventarereignisse**: der konkrete Server-ACK wurde lokal verbucht. -Keine neue Erhebung, kein Journalreset und kein neues Enrollment für diesen Nachweis. - -Bekannte Darstellungsgrenze des ersten Collectors: `os` enthält den tatsächlich -ausgelesenen Registry-Produktnamen samt DisplayVersion/Build. Auf dieser Windows- -11-Pro-VM lautet der historische Registrywert noch `Windows 10 Pro`, mit -`DisplayVersion=26H2; Build=26300`. Die unabhängige native CIM-Probe bestätigt -Windows 11 Pro. Der Registrywert wird nicht stillschweigend als Marketingversion -uminterpretiert; eine einheitliche, quellenbewusste OS-Bezeichnung ist noch offen. -Die aktuelle Capability bleibt deshalb ausdrücklich partielles Basisinventar. diff --git a/deploy/windows/README.md b/deploy/windows/README.md index 8d4bf17..01c9f34 100644 --- a/deploy/windows/README.md +++ b/deploy/windows/README.md @@ -1,144 +1,38 @@ -# Windows-11-Entwicklungszugang +# Windows-Agent betreiben -**Historischer Erstbootstrap und Einrichtungsnachweise. Nicht erneut ausführen.** -Aktueller Einstieg für vorhandene Zugänge am 17. November 2026: -[Zugangsanleitung](../../docs/operations-access.md) und -[Übergabe](../../docs/handover.md). -Die Aussagen „noch kein Client“, frühere24-Stunden-Fristen und alte -Download-/Repairabläufe unten gelten nur für ihren jeweiligen historischen Stand. -Der permanente Entwicklungstransport ist eingerichtet, heute aber ohne aktiven -Server-Reverselistener; vorhandene Schlüssel/Identität erhalten. +Der offizielle Windows-x64-Kanal verwendet das GNU-Ziel `x86_64-pc-windows-gnu`. Der Dienst `RmmDiscoveryWindows` läuft als LocalService. Er meldet sich ausgehend per mTLS, liefert Inventar und führt genehmigte PowerShell-Skripte aus. Für Aufträge als SYSTEM verwendet er den pro Installation eingerichteten `RmmDiscoverySystemHelper`. +## Installation -Userentscheidung 2026-11-13 / Spezifikation 1.8: Windows darf parallel zur noch -offenen Linux-MVP-Abnahme entwickelt werden. Notebook-Host bleibt ohne Agent. -Dieser Bootstrap schafft SSH-Zugang zum Windows-Gast, keine RMM-Installation -und keine Ausnahme von der späteren WebUI-Jobgenehmigung. +1. In der WebUI den Kunden wählen und unter **Gerät aufnehmen** einen Einmalcode erzeugen. Auf der Windows-Maschine die 64-Bit-Windows-PowerShell 5.1 als Administrator öffnen. +2. Den angezeigten Windows-Befehlsblock für das GNU-Paket ausführen. Er lädt `/install/windows.ps1` per HTTPS und übergibt den Bootstrap-Ursprung. Den Code auf die Frage „One-time enrollment token“ eingeben. +3. Für administrative Skripte die Administratoroption im Aufnahmeformular wählen. Der zusätzliche Schalter `-EnableAdministratorScripts` richtet den SYSTEM-Helper mit Gerätebindung, lokalem Journal und signiertem Agent-/Helperpaar ein. Auf einem bereits aufgenommenen Gerät lässt sich derselbe Installer mit dem bisherigen Ursprung und diesem Schalter ausführen. +4. Im Gerätedetail den frischen Kontakt und die Agentversion prüfen. Für SYSTEM-Aufträge müssen der SYSTEM-Kontext gemeldet und die zentrale Geräteregel eingerichtet sein. Für MCP kommt das plattformspezifische Tokenrecht hinzu. [Installer](../../crates/server/src/bootstrap/install.ps1) · [MCP-Zugang](../../docs/public-access.md) -## Vorbereitet und tatsächlich geprüft +## Dienste und Selbstupdate -`python3 deploy/windows/prepare_dev_access.py` hat auf dem endgültigen Server -das separate Systemkonto `rmm-win-tunnel` und dessen SSH-Matchprofil angelegt. -`sshd -t` und effektive Benutzerkonfiguration bestanden; Root-SSH-Konfiguration -vor/nach identisch. Nur Remote-TCP-Forwarding auf `127.0.0.1:22240`, keine -Shell/SFTP/Sitzungen (`MaxSessions 0`), keine Local-/Streamlocal-/Agentforwards, -keine Passwortanmeldung. Noch kein Windows-Key hinterlegt, kein Windows- -Tunnel/Administrationszugang nachgewiesen. Keine neue öffentliche Portfreigabe. +`RmmDiscoveryReleasePull` prüft nach erfolgreichem Lauf regulär nach fünf Minuten erneut auf einen veröffentlichten Release. Er verifiziert Signatur, Plattform und Paketinhalt und stimmt den Wechsel mit laufenden Aufträgen ab. Ein neuer Release muss sich unter derselben Geräteidentität zurückmelden. Scheitert die Aktivierung, wählt der Updater den Vorgänger. Programmdateien liegen unter `%ProgramFiles%\RustDiscovery`. Konfiguration, Identität und Journale liegen unter `%ProgramData%\RustDiscovery`. [Nativer Release-Abruf](../../crates/agent-windows/src/release_service.rs) · [HTTPS-Aufnahme und Selbstupdate](../../docs/evidence/windows-gnu-official-vm-20261118.json) -Public-only Paket lokal unter `devstate/windows-bootstrap/windows-dev-access.zip`: -dieses Skript und `bootstrap-public.json` mit Notebook-Public-Key, bereits -unabhängig geprüftem Server-ED25519-Hostkey und 24-Stunden-Frist. Kein privater -Schlüssel und kein Cloud-Rootzugang werden verteilt. Der neue Tunnelschlüssel -wird ausschließlich auf der Windows-VM erzeugt und verlässt sie nicht. - -PowerShell-Parserprüfung mit offiziellem PowerShell 7.7.0 auf dem Notebook: -bestanden. **Kein nativer Windows-Ausführungs-/OpenSSH-/ACL-/Tasknachweis.** -Das Skript verwendet PowerShell-5.1-Syntax; die Ausführung auf Windows 11 muss -noch durch den User erfolgen. Vorhandene laufende SSH-Installation, gleichnamiger -Account/Task oder Teilbootstrap werden verweigert statt überschrieben. - -## In der Windows-Test-VM ausführen (geplant, noch nicht nachgewiesen) - -Paket auf die VM kopieren und entpacken. Erhöhte **64-Bit-PowerShell** im -entpackten Verzeichnis öffnen, Skript prüfen und dann: +Diese Befehle zeigen in einer administrativen PowerShell die beiden Standarddienste und den letzten Updaterstatus. ```powershell -Unblock-File -LiteralPath .\Bootstrap-DevAccess.ps1 -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\Bootstrap-DevAccess.ps1 +Get-Service -Name RmmDiscoveryWindows,RmmDiscoveryReleasePull +Get-Content -Raw (Join-Path $env:ProgramData 'RustDiscovery\release-state\release-status.json') ``` -`RemoteSigned` gilt ausschließlich für den gestarteten Prozess; keine Änderung -der systemweiten Ausführungsrichtlinie und kein Umgehen einer Gruppenrichtlinie. -Es installiert nötigenfalls ausschließlich die optionalen OpenSSH-Funktionen. -`RestartNeeded` stoppt die Vorbereitung; kein automatischer Neustart/OS-Update. +Bei eingerichtetem SYSTEM-Kontext zusätzlich `Get-Service -Name RmmDiscoverySystemHelper` prüfen. In der WebUI lassen sich für den konkreten Auftrag der gebundene Skripttext, der Exitcode und die Ausgabe nachlesen. Bei Windows-Updates „Windows-Updates installieren“ als SYSTEM planen. Die PowerShell-Vorlage meldet die Ergebnisse der Installation und den Neustartbedarf. [Abnahme einer echten Updateinstallation](../../docs/evidence/windows-update-installation-20261117.json) -Es erstellt den bis zur Paketfrist gültigen lokalen Administrator `rmm-dev` -mit zufälligem, ausschließlich VM-internem Passwort und Public-Key-only-SSH. -Authorized-Keys und Bootstrapstate sind nur für SYSTEM/Administratoren zugänglich -(SIDs statt sprachabhängiger Namen). Windows-SSH lauscht ausschließlich auf -`127.0.0.1:22222`; Standard-OpenSSH-Firewallregel wird deaktiviert. Konfigurations- -und Keydateien einer vorhandenen gestoppten Installation werden gesichert. +## Neustart und Wiederanmeldung prüfen -Ein SYSTEM-Task verbindet ausgehend zum bekannten Server und prüft dessen -Hostkey strikt. Reverse-Listener dort nur Loopback. Wiederverbindung alle 30s -ist ausschließlich Bootstraptransport, kein RMM-Job-Retry. Task beendet seinen -eigenen SSH-Prozess nach Frist; kein Reboot. Bestehende RMM-Policies bleiben. - -Das Skript druckt ausschließlich öffentliche Registrierungsdaten: -`windows_user`, `tunnel_public_key`, `windows_host_public_key`, `expires_at`, -`windows_architecture` sowie Hostkeyfingerprint. Diese Ausgabe von der tatsächlichen -VM-Konsole zurückgeben; keine privaten Schlüssel/Passwörter übertragen. -Nach Hinterlegung des Tunnel-Public-Keys und Prüfung/Pinnen des Windows-Hostkeys -kann der Entwicklungsrechner über den Cloudserver mit seinem vorhandenen Key -auf den Windows-Administrator zugreifen. Native Nachweise folgen erst dann. - -Grundlagen: [Microsoft OpenSSH-Installation](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse), -[Windows-Konfiguration und Administrator-Key-ACL](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh-server-configuration). - -## Öffentlicher Download auf dem Cloudserver — tatsächlich geprüft - -Auf Userwunsch Public-only Paket separat auf HTTPS **8443**, ausschließlich ein -exakter Downloadpfad bis Paketablauf. Gültige öffentliche Let's-Encrypt-Kette -mit normalem externem Truststore geprüft; heruntergeladene Bytes SHA256-identisch. -RMM-TLS/mTLS auf 443, Verwaltungszugang und Client-Truststores unverändert. -Keine Secrets im Bundle. Link und Belege geschützt unter -`devstate/windows-bootstrap/{publication.json,published-verified.json}`. - -`deploy/windows/publish_bootstrap.py`: ACME mit gepinntem, geprüftem -acme-tiny-Commit `dc2c102314a56580facafce2249b292cebcfc42b`; Account-/Domainkeys -bleiben auf dem Server in rootgeschütztem Verzeichnis. HTTP80 nur für ACME, -danach tatsächlich gestoppt und Firewallregel entfernt. Downloadserver mit -DynamicUser, readonly System, separaten systemd-Credentials für TLS-Key und -maximal 16 gleichzeitigen Verbindungen. Kein beliebiges Dateisystemhosting. - -Ein späterer Verbindungsversuch traf zunächst auf eine blockierende TLS-Annahme. -Server korrigiert: Timeout/Handshake je begrenztem Worker, Listener blockiert -nicht mehr. Danach externer HTTPS-Download während gleichzeitig offener langsamer -TCP-Verbindung erfolgreich; `/`, `/etc/passwd`, `/auth/config` und codierter -Traversalpfad jeweils 404. Drei lokale Pfad-/Frist-/ACME-Guards bestanden. - -Öffentliche Freigabe endet **2026-11-14 12:55:31 UTC**. Aktiver persistenter -systemd-Timer stoppt den eigenen Downloadservice und schließt dessen Firewallport -8443; auch die Anwendung verweigert nach Frist weitere Downloads. Dies ist -Bootstrapwartung auf dem Server, kein autorisierender RMM-Job oder VM-Reboot. -Windows-Ausführung weiterhin nicht nachgewiesen. - -## Tatsächlich hergestellter Zugang / Reparaturen - -Der User führte das erste Paket auf Windows aus. Dienst zunächst Exit 1067, -Vordergrundstart dagegen erfolgreich. `Repair-DevAccess.ps1` prüft die bestehenden -Skripte/Config gegen die ursprünglichen Hashes, sichert ACLs, setzt SYSTEM als -Eigentümer und SYSTEM/Administratoren als einzige Zugriffsberechtigte für -SSH-Verzeichnis, Config und Hostprivatekeys. Keine Schlüssel-/Kontoneuerzeugung. -Danach Dienst tatsächlich `Running`, Hostkey unverändert. Erstbootstrap-Quelle -für neue Pakete entsprechend korrigiert; historisches Public-ZIP unverändert, -separates Repair-ZIP mit eigener expliziter Downloadroute veröffentlicht. - -Cloud-Public-Key registriert; anfänglich ungültige Option `permitopen="none"` -aus `authorized_keys` entfernt. Sie ist ausschließlich im sshd-Matchprofil gültig -und dort unverändert aktiv. Zusätzlich öffentliche `.ssh`-Directorymodi explizit -gesetzt, statt sie einer umask zu überlassen. Remote-only/PermitListen/MaxSessions -bleiben erhalten. Private Keys wurden nicht übertragen. - -Windows-Tunnel anschließend automatisch durch den Hintergrundtask aufgebaut. -Notebook-SSH über Cloud-Loopback mit unabhängig aus der VM-Konsole bestätigtem -Hostkey und vorhandenem Notebook-Key erfolgreich. Echt beobachtet: **Windows 11 -Pro, Build 26300, 64 Bit, Administrator=true**. Zugangsdaten nur unter -`credentials/windows-dev-access.json`, Belege unter `devstate/windows-bootstrap/`. -**Noch kein RMM-Windows-Client installiert/enrolled/abgenommen.** Keine Änderung -am Notebook-Host als reinem Entwicklungsrechner. - -## Zugang bei Bedarf stoppen - -Auf der Windows-VM als Administrator, ausschließlich eigene Bootstrapressourcen: +Die Bibliotheksrevision „Windows neu starten“ Version 2 verwendet das systemeigene `shutdown.exe` mit einer Minute Vorlauf. Die folgende Abfrage vor und nach dem Neustart ausführen und den Startzeitpunkt des jüngsten Kernel-General-Ereignisses 12 vergleichen. ```powershell -Stop-ScheduledTask -TaskName RmmDevReverseTunnel -Unregister-ScheduledTask -TaskName RmmDevReverseTunnel -Confirm:$false -Disable-LocalUser -Name rmm-dev -Stop-Service -Name sshd +$event = Get-WinEvent -FilterHashtable @{LogName='System'; ProviderName='Microsoft-Windows-Kernel-General'; Id=12} -MaxEvents 1 +(([xml]$event.ToXml()).Event.EventData.Data | Where-Object Name -eq 'StartTime').InnerText ``` -Backups/Hostkeys und Zustandsdateien erhalten. Cloud-Tunnelkey separat sperren; -keine pauschale Änderung anderer SSH-Zugänge. Vollständige Entfernung einer -vorherigen SSH-Konfiguration ist ein eigener kontrollierter Vorgang. +Nach dem Bootwechsel den authentisierten Kontakt derselben Installation und einen Folgeauftrag mit Ergebnis prüfen. Bei einem Gatewaywechsel kann sich der Agent vorübergehend bereits melden, während er den signierten Zeit- und Journalabgleich für ausführbare Aufträge erneuert. Bei dauerhaft ausstehendem Abgleich den letzten authentisierten Kontakt, die Windows-Zeitsynchronisation (`w32tm /query /status`) und die Bereitschaft von Agent und optionalem Helper prüfen. Nach einer bestätigten Ergebnismeldung kann der Helper seinen Abgleich wieder aufnehmen. [Zeitabgleich](../../docs/evidence/windows-gateway-clock-recovery-20261117.json) · [Helper-Abgleich](../../docs/evidence/windows-helper-result-recovery-20261118.json) · [Native MCP-Abnahme](../../docs/evidence/mcp-scoped-script-requests-20261118.json) + +Für Störungen zwischen Agent und SYSTEM-Helper beschreibt die [Pipe-Dokumentation](../../docs/windows-helper-pipe-drain.md) die lokale Transportbestätigung. Für den Entwicklungsgast ohne dauerhaften Helper enthält das [Runbook für befristete Windows-Updatefenster](../../docs/windows-update-dev-window.md) die Voraussetzungen und den Rückbau. + +Build, Veröffentlichung und Entwicklungsbereitstellung stehen im [Entwicklungsweg](../../docs/development.md). diff --git a/deploy/windows/msvc/README.md b/deploy/windows/msvc/README.md deleted file mode 100644 index 424655b..0000000 --- a/deploy/windows/msvc/README.md +++ /dev/null @@ -1,238 +0,0 @@ -# Native Windows MSVC build - -Prepared 2026-11-14. The native `Prepare` phase was attempted in the retained -case `b208282f-d950-4f5a-bc5e-9e071ccb4d93` and stopped before any download or -installer: `SETUP_PREEXISTING_REBOOT_PENDING`. Separate read-only inspection -confirmed both the CBS `RebootPending` and Windows Update `RebootRequired` keys -already existed; PendingFileRenameOperations had24 entries (contents not read -into the report). No compiler installation, Windows update, restart, trust-store -change, daemon replacement or RMM job was performed. Agent PID5140 and helper -PID6240 remained running; W32Time remained stopped. This is an incomplete -prerequisite, not a successful MSVC qualification. No flag is cleared or ignored. - -`Build-NativeMsvc.ps1` is a development build runner, not an installer. Run it in -64-bit Windows PowerShell5.1 from a source bundle containing the exact repository -sources and this script. `Preflight` inventories installed tools and records -private source/tool hashes. `Build` requires an explicitly selected successful -preflight receipt, creates a different private case, and builds an isolated -source copy. It never reuses a partial build case. - -## Required native tools - -- Rust `1.99.1-x86_64-pc-windows-msvc`, including `cargo`, `rustc`, `rustdoc`, - `clippy-driver`, `rustfmt`, supplied by the official rustup installation. -- Installed Visual Studio C++ tools in the selected range `[17.14,19.0)`; - VS2022 or VS2026 is selected by its signed `vswhere.exe`. The actual product, - compiler version, signer thumbprints and tool hashes are recorded. The current - official [VS release history](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-history) - includes VS2026; the runner does not download a mutable latest bootstrapper. -- The x64 `cl.exe`, `link.exe`, `lib.exe`, `dumpbin.exe`, and Windows SDK - `10.0.26100.0` x64 `midl.exe`. Microsoft signatures must be valid. The selected - SDK is explicit through `vcvarsall.bat amd64 10.0.26100.0`; see Microsoft's - [native build environment](https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170). -- At least20GiB available on the evidence/build volume by default. This is the - runner's conservative admission threshold, not a measured installation size. -- The locked Cargo dependencies must already be available in the build user's - registry cache. Builds are `--locked --offline`. A missing crate is a failed - prerequisite, never a reason for an automatic online retry. An explicit - development preparation can populate the public dependencies with - `cargo +1.99.1-x86_64-pc-windows-msvc fetch --locked --target x86_64-pc-windows-msvc`. - Do not transfer an entire Cargo home containing credentials or configuration. - -The parent's actual read-only VM report -`devstate/windows-client/native-msvc-tools-readonly-20261114.json` now records -103300169728 free bytes, x64, no `vswhere`, no `rustup`, no SDK directories, -W32Time stopped and all execution-policy scopes undefined. No installation was -performed by this preparation. No extra private key, server token or production -signing certificate is needed for source build. -[Rust's MSVC target contract](https://doc.rust-lang.org/rustc/platform-support/windows-msvc.html) -defines native Windows support, Microsoft calling conventions and PE/COFF output. - -## Explicit tool-setup plan, not executed - -If preflight reports missing C++ tools, first select a **fixed-version** Build -Tools bootstrapper from Microsoft's release history, retain its download URL, -SHA-256, ProductVersion, valid Microsoft Authenticode signature and thumbprint. -Verify the intended absent/new install directory and sufficient disk before -starting setup. Reuse a suitable existing installation rather than updating it. -The exact required component IDs are: - -```text -Microsoft.VisualStudio.Workload.VCTools -Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -Microsoft.VisualStudio.Component.Windows11SDK.26100 -``` - -The planned bootstrapper arguments are: - -```text ---wait --passive --norestart --installPath C:\RmmBuildTools ---add Microsoft.VisualStudio.Workload.VCTools ---add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 ---add Microsoft.VisualStudio.Component.Windows11SDK.26100 -``` - -There is no `--force`, repair, OS update, automatic retry or reboot. Persist the -actual setup process/result before returning a bootstrap reply. `0` completes -the setup operation; `3010` means installation requires a restart **before use**, -so stop without building, clearing the flag or implicitly rebooting. `1641` -means a reboot was initiated and violates this no-restart plan. `1618`/`1001` -mean another installation is active; preserve the case and inspect, never kill -the other installer or blindly rerun. A lost SSH reply permits only process/log -readback of that same setup. The build runner itself never launches setup. -[Microsoft component IDs](https://learn.microsoft.com/en-us/visualstudio/install/workload-component-id-vs-build-tools?view=visualstudio), -[parameters and actual exit-code semantics](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022). - -## Build invocation and evidence - -Planned, not executed: - -```powershell -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery -# Review that exact private preflight.json, then use a NEW build case: -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Build -SourceRoot C:\Source\rust-discovery ` - -ExpectedPreflight C:\Users\Administrator\RmmNativeBuilds\\preflight.json -``` - -The runner imports only selected developer environment values, rejects caller -compiler flags/wrappers, pins the native compiler/linker/MIDL paths, and keeps -each process's stdout/stderr private. It copies only explicit source extensions -under `crates/` and `proto/`, root Cargo/toolchain files and the MSVC runner/probe; -no `credentials/`, `devstate/`, client key material, repository metadata or local -server state. A protected build root and new protected case prevent unrelated -service users from changing the copied inputs. Source/tool hashes must match -before and after the build. - -Before Cargo, Microsoft MIDL generates the real IDL with `/env amd64 /Oicf -/robust /Zp8`; `win64` is intentionally avoided because MIDL documents it as -IA64. The native C probe asserts Microsoft LLP64, numeric Rust ABI64 bytes, -wire-status ABI120 bytes and explicit field offsets. It raises/catches only a -local RPC exception1722 using the same SDK SEH macros/filter; it does not query -W32Time, contact RPC or claim trusted time. There is no vendored WIDL stub or -SEH workaround. [MIDL AMD64/packing](https://learn.microsoft.com/en-us/windows/win32/midl/-env), -[robust NDR checking](https://learn.microsoft.com/en-us/windows/win32/midl/-robust), -[C11 assertions](https://learn.microsoft.com/en-us/cpp/c-language/static-assert-c?view=msvc-170), -[SDK RPC SEH](https://learn.microsoft.com/en-us/windows/win32/rpc/rpctryexcept). - -The product build script adds only the native MSVC branch, preserving the GNU -WIDL/clang branch and the C exception boundary. Both still compile the actual -clock sources and preserve their static assertions; SDK or compiler failure is -fatal. The Clock readiness gate stays unqualified. The separate native -service-SID authentication candidate is not qualified by an ABI or build pass. - -Cargo then checks Windows Clippy with warnings denied, builds agent/helper and -examples in release, and **links without running** Windows/core unit tests. -The runner records AMD64 PE headers, artifact hashes, generated RPC hashes, -dependency listings and actual Authenticode status. Development output may be -unsigned; this is no signing/installer/production-PKI acceptance. Native unit -execution, LocalService/SYSTEM behavior and a preserving daemon deployment -remain separate explicit gates. A timeout retains its exact process/evidence; -no process-tree kill or retry is implied. - -Locally executed preparation checks: PowerShell AST parse; isolated compilation -and Clippy of `build.rs` using locked-version `cc1.11.1`; rustfmt/source checks. -These checks do not prove that Microsoft MIDL, MSVC, the ABI probe or the final -agent/helper builds have run successfully on Windows. - -## Concrete native tool bootstrap, prepared separately - -`Install-NativeBuildTools.ps1` supplies separate `Prepare`, `InstallVs`, -`InstallRust`, and read-only `Read` phases. Only `Prepare` has been attempted; -the pre-existing reboot need blocked it before downloads. Neither install phase -has run. Both install calls consume create-only start intents -before launching their fixed worker. Each worker runs in its own protected, -demand-only Task Scheduler entry as SYSTEM, without a trigger, automatic retry -or autostart; a second worker entry refuses before installation. This keeps a -long setup independent of the40s SSH/bootstrap reply limit. Results, actual -installer PID and exit code are retained, and the task is disabled after its -worker result. Lost reply/timeout permits readback only. These are explicitly -authorized development-tool bootstrap tasks, never WebUI/RMM jobs or a generic -SYSTEM execution provider. [Task registration](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/register-scheduledtask?view=windowsserver2025-ps), -[fixed service-account principal](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/new-scheduledtaskprincipal?view=windowsserver2025-ps). - -Inputs are fixed official TLS URLs with ordinary certificate/name validation: - -| Input | Pinned SHA-256 | -|---|---| -| Microsoft Build Tools18.11.4 LTSC bootstrapper, file version18.11.12405.450 | `386b5d9a3d6576eab3772c1ecaa7c107ded38146a9c483f41679c194ae1e63b4` | -| rustup1.29.3 Windows x64 MSVC bootstrapper | `38027d51d69a5d05493627a0634dbea52d6cd793c8f072d2373d3f4163eec7db` | -| Rust1.99.1 official distribution manifest | `fb152be80975c194aa5fc684b2aec3a6e14e2b855efe2faa4e5f8ae6e590f463` | - -The Microsoft EXE additionally requires valid Microsoft Authenticode and the -exact product/file version. Rustup is checked against its exact -[official archived checksum](https://static.rust-lang.org/rustup/archive/1.29.3/x86_64-pc-windows-msvc/rustup-init.exe.sha256), -with [official archive/install options](https://rust-lang.github.io/rustup/installation/other.html). -Its homes are private case subdirectories; `--no-modify-path`, -`--no-update-default-toolchain`, minimal profile and exactly clippy/rustfmt keep -the developer's default Rust installation/profile/PATH untouched. The fixed -Rust distribution origin is set only for that worker process. Using isolated -homes is an [official rustup option](https://rust-lang.github.io/rustup/installation/index.html). - -VS setup uses only `--wait --quiet --norestart --noUpdateInstaller`, the new -fixed target `C:\RmmBuildTools`, and the three components above. It relies on the -official installer's standard Microsoft metadata/package verification. No -custom channel/catalog, checksum override, certificate import or weaker -verification flag is supplied. Installed VS version must then match exactly -18.11.12405.450 and SDK26100 must be present; drift remains incomplete. Setup's -required transitive development dependencies remain Microsoft's responsibility; -this is no general production-installer trust acceptance. No Windows Update -command is invoked. Boot/OS build, machine trust-store fingerprints, machine -PATH, execution policies, W32Time and both exact RMM service states/PIDs are -observed before/after. Detected changes, unexpected setup version,3010/1641 or -restart need stop completion without resetting/undoing or retrying anything. - -Scope decision2026-11-14: an initial **custom manual catalog-bundle** design was -rejected. Its channel declared catalog size31851991 and hash -`ef56e369d92855a9667cd03602019375f42b3cd2145041df31cacc071a40e1af`; -the exact official URL instead returned18733589 bytes with hash -`805d16fd14a370cbeb6568179950826ba0cdc6e2cffa44936fddc408ef05cba3`. -Those inputs and rejected source remain privately retained; no mismatching -catalog was accepted or installed. The extra manual bundle was our design, -not an AGENTS/product requirement. The selected replacement uses the supported, -independently hash/Authenticode-pinned official EXE and its own verification, -not a checksum exception or undocumented JSON-signature workaround. -Microsoft documents [standard acquisition and fixed-version bootstrappers](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022). - -Future successful-case sequence; installation and build remain **not executed**. -The failed case above is retained and must not be reused after a prerequisite -change. A manual VM restart has been requested for later coordination; it is -neither implicitly authorized nor an RMM reboot acceptance. - -```powershell -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Prepare -# Review that exact printed private case and its prepared.json first: -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallVs -CaseDirectory -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory -# Continue only after verified VS exit0 and no restart need: -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallRust -CaseDirectory -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory -``` - -This uses the already authorized **development/bootstrap-only** process option -`-ExecutionPolicy RemoteSigned`, as in the previous Windows dev-access and -passive-client bootstrap. The worker uses that same process option and invokes -the hash-checked `.ps1` file normally with `& $p`; it never executes file content -through `ScriptBlock::Create`. A small encoded hash launcher is only transport -for that ordinary file invocation. There is no `Set-ExecutionPolicy`, registry -policy write, Machine/User/GPO change or Bypass option. Persistent scopes stay -unchanged; process scopes are consistently RemoteSigned and GPO precedence is -retained. This permission does **not** decide or authorize the separate RMM -PowerShell job executor's still-unqualified policy contract. - -After actual successful setup, pass the recorded private homes to the builder: - -```powershell -powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery ` - -RustupExe \cargo_home\bin\rustup.exe -RustupHome \rustup_home -CargoHome \cargo_home -``` - -Use those same arguments with `-Mode Build -ExpectedPreflight `. -Populate the isolated public Cargo cache explicitly before an offline build; -there is no automatic fetch/retry in the builder. Native setup, native MIDL/ABI, -unit execution and deployment results are still outstanding until actually run. - -On November 15, 2026 a read-only check on the running Windows test VM found -both CBS and Windows Update restart markers, 96 GiB free on C:, no vswhere -at its standard installer path, and no rustc on the development user's PATH. -No installer was launched. This check does not determine why the markers are -present. Receipt `04a56e7d8a8bf00a110558344248fbb0ca0c2234c5c1ea6e347306bcc84d5c55`. diff --git a/docs/agent-crash-acceptance.md b/docs/agent-crash-acceptance.md deleted file mode 100644 index 76b917e..0000000 --- a/docs/agent-crash-acceptance.md +++ /dev/null @@ -1,119 +0,0 @@ -# Agentabbruch nach möglicher Wirkung: native Abnahme bestanden - -Stand2026-11-13. Tatsächlicher Cloudfall -`644c06eb-24b0-41b0-9a90-f60ea1fe38a9` bestanden. Feste tatsächliche -dev/test-WebUI-Genehmigung0/0/0→1/1/1, ein Rootzähler-Effekt vor dem gezielten -SIGKILL ausschließlich des binär-/PID-/Startzeit-gebundenen Agentprozesses. -Unabhängiger Generalhelper blieb derselbe Prozess und bearbeitete den bereits -verbrauchten Versuch weiter. Native Agent-/Zentralzustände tatsächlich -unknown/revision2/`AGENT_PROCESS_INTERRUPTED`, kein zweiter Verbrauch/Effekt. - -Originalgrant`a3cbc544-0582-4d64-8237-017a82d7cddf`/Root16 anschließend über -independentes Helperergebnis und **gewöhnlichen signierten RootSync** desselben -Versuchs succeeded geschlossen. Eigener zweiter fester UI-Leseplan1/1/1 -bestätigte Zähler1; dies ist keine zweite Wirkung des ursprünglichen Jobs. -Beide Genehmigungsaudits sichtbar simuliert, Root-Testpolicy danach geschlossen. -Agent702/Helperbbd/Provider1dc unverändert, kein Paket-/Identitäts-/Journalreset. - -Geschützter verifizierter vollständiger Beleg: -`devstate/cloud-crash/644c06eb-24b0-41b0-9a90-f60ea1fe38a9/checkpoint.json`. -Der folgende Entwurf beschreibt die tatsächlich benutzte Strecke; bisherige -lokale Prüfungen bleiben von dieser nativen Abnahme getrennt. Reboot und -Endaudit sind noch offen. - -## Gefundene Lücke und minimale Korrektur - -`Agent::start_sync` wartet zuerst auf einen unabhängig authentisierten -Helper-Snapshot. Der Roothelper bearbeitet IPC seriell und hält den gemeinsamen -Executorlock während der Wirkung; ein Snapshot wartet deshalb oder läuft nach -10 Sekunden in einen Timeout. Nach Ende der Wirkung importiert -`reconcile::prepare` das gespeicherte Helperergebnis **vor** seiner bisherigen -Unknown-Konvertierung. Ein früherer Test hätte deshalb möglicherweise direkt -Erfolg statt eines nachweisbar dauerhaften Unknown ergeben. - -Der Agent hält nun genau einmal beim **neuen Prozessstart**, vor der ersten -Verbindung und jedem Helperzugriff, unterbrochene Versuche dauerhaft fest: - -- `running`/`verifying` mit bekanntem Grant: unveränderten Offer und ursprünglich - signierten Startrequest gegen tatsächlichen Verbrauch und Gerätebindung prüfen; - danach regulärer dauerhafter `JobResult=unknown`, eigener Fehlercode - `AGENT_PROCESS_INTERRUPTED`, höhere Revision, keine erfundene Wirkung/Ausgabe. -- `requesting` ohne bekannten Grant: nur lokal Unknown; keinen Grant oder - grantgebundenen Ergebnisnachweis erfinden. Der normale Sync bleibt zuständig. -- Verbrauch, Startnachweis und Ressourcensperre bleiben erhalten. Kein `finish`, - kein erneuter Permitrequest, keine Änderung erfolgreicher Endzustände. -- Normale erste Kanalwiedergabe sendet den dauerhaften Unknown vor dem - blockierenden Snapshot. Reconnect desselben Prozesses ruft diese Korrektur - nicht auf. Wiederholte Prozessstarts verändern einen vorhandenen Unknown - einschließlich Nachrichten-ID und Revision nicht erneut. - -Der Abschluss verwendet ausschließlich den vorhandenen Pfad: unabhängiger -Roothelper schreibt `finish` **vor** seiner IPC-Antwort; authentisierter Snapshot -importiert denselben ursprünglichen Request und dessen tatsächliches Ergebnis; -normaler signierter Sync bindet Revision, Ergebnis-/Plan-/Payloadhash, Agent, -Versuch und Grant und öffnet erst danach die Sperre. Eine neue Recovery-API, -administrative Ergebnisinjektion oder erneute Skriptausführung existiert nicht. - -Tatsächlich lokal bestanden: gezielter Dispatcher-/SQLite-Test für dauerhaften -Unknown vor jedem Helper-I/O, abgewiesene fremde Verbrauchsidentität, -grantlosen Antrag, erhaltene Verbrauchssperre und idempotenten Neustart; -vorhandener Integrationstest für authentisierten Helperimport als neuen -Ergebnisnachweis ohne erneute Wirkung; Agent-Clippy aller Targets mit -`-D warnings`. Dies sind keine VM-Nachweise. - -Ein qualifiziert gebautes x86-64-Releaseartefakt liegt geschützt unter -`devstate/cloud-apt-recovery/agent-interruption-recovery`, SHA-256 -`adc4ac0b35f7992300d82b0f263970246fdc0eaec0d2104e4ade22ae3f74d7b6`. -ELF-/Abhängigkeitsprüfung: x86-64, höchste benötigte GLIBC-Version 2.34, -OpenSSL 3. Noch nicht auf die VM übertragen oder dort gestartet. - -Vorbereitet, **nicht ausgeführt**: `deploy/cloud_crash_acceptance.py` mit -echtem zweiphasigem Browserablauf, `deploy/browser/cloud_crash_acceptance.cjs` -und exakt sichtbarem Payload `deploy/linux/agent-crash-counter.py`. -Python-/Node-Syntax sowie exakte Python-/Browser-Payloadgleichheit und -Shell-Parsing ohne Ausführung wurden lokal geprüft. Der Runner verlangt -unabhängig bekannte Agent-/Helper-SHAs und den bisherigen geschlossenen -Policyhash; er verändert weder Runtimeartefakte noch Providerpins. - -## Geplanter nativer Versuch, noch nicht ausgeführt - -1. Genau die vorhandene Cloud-VM und Geräteidentität verwenden. Zentral und im - erhaltenen Journal keine offenen Versuche, qualifizierter neuer Agent, - unveränderter gesunder Roothelper. Keine parallele VM-/Imageänderung. -2. Fester Root-RunScript-Plan erzeugt einen einmaligen privaten Testzähler unter - dem beschreibbaren Helper-StateDirectory, hält danach begrenzt 60–90 Sekunden - an und endet mit fest erwarteter Ausgabe bei Laufzeitlimit 120 Sekunden. - Alle Bytes, Ziel und Fristen stehen vor der tatsächlichen WebUI-Genehmigung - fest; vorher 0 Jobs / 0 Outbox / 0 Grants. Keine Paketmanagerwirkung. -3. Nach gespeichertem Verbrauch/Start und dem vom genehmigten Skript dauerhaft - geschriebenen Zähler den **exakten Agentprozess** kontrolliert beenden; - PID-/Startzeit-/Artefaktbindung prüfen, keinen Prozessbaum oder ganzen - systemd-Cgroup beenden. Roothelper und dessen Skript bleiben unbeeinflusst. - Die gespeicherten Test-/Ledgerdaten dienen nur der Fehlerorchestrierung. -4. Der vorhandene Agentdienst startet automatisch neu. Während der Helper noch - arbeitet, lokalen dauerhaften Unknown und dessen tatsächliche zentrale - Jobansicht erfassen: gleicher Versuch/Grant, höhere Revision, keine neue - Wirkung/Starterlaubnis. Startcapability-Probes können zusätzlich bis zu - 10 Sekunden Helper-Policy und zweimal 5 Sekunden APT-Probe benötigen; den - Zeitpuffer vorab berücksichtigen, keine Wartezeit als Ergebnis erfinden. -5. Roothelper darf genau einmal regulär fertig werden. Sein tatsächliches - gespeichertes Ergebnis, authentisierten Import, signierten Sync und endgültige - identische Ergebnisbindung nachweisen. Beide Journale/Tombstones behalten; - kein manueller Unlock und keine Wiederholung nach Fehler. -6. Ein **separater** fester WebUI-genehmigter Lesejob prüft abschließend den - erhaltenen Zähler exakt 1. Eigenen Antrag/Genehmigungs-/Grantnachweis getrennt - vom ursprünglichen Versuch führen. Erst bei keiner offenen Wirkung abnehmen, - dokumentieren und pushen. - -Ein frei laufendes `agent_service`-Skript, dessen Prozess vor dauerhafter -Ergebnisspeicherung stirbt, hat heute keinen unabhängigen Abschlussbeleg. -`expected_stdout` allein rekonstruiert weder Exitstatus noch Wirkung. Diesen -Versuch daher **nicht** als Ersatz ausführen. Der vorbereitete Roothelperfall -weist genau den Agentprozessabbruch bei unabhängig weiterlaufendem Executor -nach; ein gleichzeitiger Helper-/Maschinenabsturz bleibt ein anderer Fehlerfall. - -Nachfolgender Runtime-Stand: die tatsächlich auf Cloud installierte Variante -`agent-journal-capacity` (`2ce885cf…`) enthält dieselbe Startupkorrektur plus die -endliche Journalbudgetkorrektur. Normaler Sync und kopierte Sandboxprobe mit -erhaltener Historie bestanden. Das ist weiterhin **kein** nativer Crashversuch; -der oben beschriebene kontrollierte Versuch bleibt ein eigenes Gate. diff --git a/docs/agent-update-observation-scope.md b/docs/agent-update-observation-scope.md deleted file mode 100644 index eb03636..0000000 --- a/docs/agent-update-observation-scope.md +++ /dev/null @@ -1,89 +0,0 @@ -# Migration0016: passives Updateinventar annehmen - -Am2026-11-15 ist Migration0016 tatsächlich auf dem permanenten Server mit dem -regulären SQLx-Migrationspfad ausgeführt und separat nachgelesen worden. Der -bisherige Check `observations_source_id_check` ließ nur `linux.base` und -`windows.base` zu. Die laufende Gatewayversion kannte bereits die passive -`agent.update`-Beobachtung; der Datenbankcheck verweigerte deren Speicherung. -Nach dem neuen Windowsagentenwechsel waren15 entsprechende Fehler beobachtet -worden. Diese verweigerten Nachrichten werden nicht nachträglich als gespeichert -ausgegeben. - -Die additive Datei `migrations/0016_agent_update_observation_scope.sql` erweitert -ausschließlich diese feste Dreiermenge. Freie Scopes bleiben verboten. Im -normalen SQLx-Transactionrahmen wird der alte Check ersetzt und der neue Check -validiert; ein Fehler rollt die Transaktion zurück. `lock_timeout=3s` begrenzt -das Warten auf Tabellenlocks, `statement_timeout=15s` jedes DDL-Statement. -Keine DML-, RLS-, FK-, PK-, Tenant-/Geräte-/Zertifikats-, Job-, Grant- oder -Policyänderung gehört zur Migration. - -Tatsächlicher Fall: `cc3ea56d-6186-425a-8ef3-90562212fb1b`. Verwendet wurde das -bereits vom Orchestrator nativ ARM64 gebaute Image -`sha256:6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7`. -Es enthält den vorhandenen `rmm-server migrate`-Entrypoint und die echte -SQLx-`migrate!`-Migrationseinbettung. Es wurde kein zusätzlicher Builderlauf -gestartet und keine SQLx-Tabellenzeile manuell angelegt oder geändert. - -Ein eigenes privates Compose-Overlay wählte ausschließlich für den temporären -`migrate`-Container dieses bereits vorhandene Image (`pull_policy: never`, -read-only RootFS, CapDropALL, NoNewPrivileges). Die vorhandene Migration-URL -blieb im normalen Compose-/Prozesskontext; sie wurde nicht ausgegeben. Der -unterstützte `docker compose … run --no-deps … migrate` führte genau einen -wirklichen SQLx-Lauf aus, Exit0. Der eigene gestoppte Container wurde nach -seinem Exit-/Image-/Falllabelbeleg entfernt. Kein API-, Gateway- oder -PostgreSQLdienst wurde durch diesen Agenten ersetzt oder neu gestartet. -API-Filterung und API-only-Deployment sind ein eigener Orchestratorschnitt. - -Die tatsächliche SQLx-Historie besitzt danach Versionen1–16 jeweils mit -`success=true`; die alten15 Checksums stimmen unverändert mit den Quellinputs -überein. Version16 heißt `agent update observation scope` und besitzt SHA384 -`e66ec49233c210555b5107d20b925ca6715925871aa2bf94dfb86bd5cfb39c6dc769fdf0049b615fcad503332e1cd8fc`. -Die SQL-Datei hat SHA256 -`fa0953262e3a8da7f3f0366db6f3fa77ad7976ec04327b126036739eea46eebb`. - -Vor dem echten SQLx-Start wurden3127 bestehende Observationzeilen serverseitig -über ihre vollständige JSON-Zeilendarstellung gehasht; unmittelbar danach waren alle -unverändert. Der ursprüngliche Fallbaseline enthielt3123Zeilen. Deren -unveränderte Fingerprints und die vollständige RLS-/Owner-/ACL-/Policy-, -FK-/PK-/sonstige Check- und Job-/Plan-/Authorization-/Outbox-/Permit-/Receipt- -Zeugen wurden nochmals in einem getrennten Read-only-SQL-Aufruf bestätigt. -Neue passive Zeilen durften parallel regulär hinzukommen. Die neue Constraint -war tatsächlich `VALIDATED` und enthielt genau -`linux.base`, `windows.base`, `agent.update`. API und Gateway liefen während -dieser Migration unverändert mit Image422c2c28; PostgreSQL behielt seine -ursprüngliche Container-/Imageidentität. - -Ein weiterer lesender Serverabgleich fand bereits drei angenommene -`agent.update`-Zeilen, zuletzt15:40:50UTC. Das beweist die normale Speicherung -dieses Scopes nach der Migration, keinen separat geprüften Windows-ACK, -keine neue Basisinventarabnahme und keine Zeit-/Jobbereitschaft. - -Die Vorherarchive enthalten Katalog-/Migrations-/Policyzeugen und -Zeilenfingerprints; ein vollständiger **Vorher-`pg_dump` wurde nicht angelegt**. -Ein vollständiger privater Customformat-Dump wurde ausdrücklich **nach** der -Migration archiviert: `after-migration-0016.pg_dump`,49,455,447Bytes, SHA256 -`b89e74eaaea7ec2faa17a44358acca3aead1db0fcf9ccf673e2c5808b3259398`. -Er bleibt ausschließlich im Root0700-Fall auf dem Server, Datei0600, und wurde -nicht heruntergeladen oder als Vorherbackup bezeichnet. Ein Restoretest wurde -hier nicht ausgeführt. - -Zwei harmlose Vorbedingungen scheiterten vor dem eigentlichen SQLx-Lauf und -bleiben erhalten: zunächst die Annahme eines vollständigen Buildkontexts -statt des tatsächlichen Minimal-Kontexts; danach ein hier nicht unterstütztes -Compose-Flag `--no-build`. Für letzteren Fall waren Exit1, Ledger15 und die -Abwesenheit eines eigenen Containers belegt. Nach Roots konkreter Korrektur -wurde derselbe Originalfall mit einem neuen Create-only-Fortsetzungsintent -verwendet; alte Fehler-/Vorherdateien wurden nicht überschrieben. Ein weiterer -reiner Absenzmatcher wurde an die tatsächliche Kleinschreibung der Docker- -Fehlermeldung angepasst, ebenfalls vor jedem Container-/SQLx-Start. Keine -verlorene SQLx-Wirkung wurde blind wiederholt. - -Geschütztes Serverarchiv: -`/opt/rust-discovery/devstate/observation-scope-migration-cc3ea56d-6186-425a-8ef3-90562212fb1b/`. -Lokaler Belegordner im eigenen Worktree: -`devstate/observation-scope-migration/cc3ea56d-6186-425a-8ef3-90562212fb1b/`. -Die separate lokale `receipt.json` bindet Originalintent, Fehler, tatsächlichen -SQLx-Erfolg, getrennten Read und Nachbackup; SHA256 -`00ff8f8ffa689bf3917937ce14ae23457e464b921ae7793e9091eab9a83d76c7`. -Private Zugangsdaten und -Datenbankinhalte wurden weder veröffentlicht noch in Git aufgenommen. diff --git a/docs/agent-updater-handoff-linux-results.md b/docs/agent-updater-handoff-linux-results.md deleted file mode 100644 index 5647130..0000000 --- a/docs/agent-updater-handoff-linux-results.md +++ /dev/null @@ -1,59 +0,0 @@ -# Updater-Handoffkernel: tatsächlicher Cloud-Linux-Nachweis - -2026-11-14. Ausschließlich der isolierte Kernel aus Commit -`a2efb79` wurde geprüft. Kein Installer, kein Agent-Selbstaustausch und keine -RMM-Jobgenehmigung sind Teil dieses Schritts. - -Der unabhängig geprüfte Runner `deploy/updater_handoff_linux_acceptance.py`, -SHA256 `502ba0d6f5a653dae21ddc871f069e61cbe4217d67e28708d1c0cad8347826f1`, -prüft die acht originalen Gitblobs gegen den lokalen Qualifikationsbeleg -`e924471166e68629d27d6adae51ebac05a77f04426cdd427e844a9dfb4920f70`. -Die native Unitexe hat2261368Byte und SHA256 -`0c80a2107fff96d9e30aa02b1cb56071a0f7e2be2acb1bec6794324205af9c7a`. -Später parallel bearbeitete Runtimequellen wurden nicht erneut gebaut oder als -bereits nativ qualifiziert behandelt. - -## Tatsächlich ausgeführt - -Fall `03ddcaa5-84a7-4722-bfd3-55702c7bb67b`: feste Linux-x86-64-Unitexe einmal -auf die Cloud-Linux-VM übertragen, vollständige Testliste ohne Filter geprüft, -danach genau ein Lauf als UID/GID65534 mit geleerten Zusatzgruppen und -`no-new-privs`. Kein RMM-Agent läuft auf dem Notebook. Der Prozess verwendete -keine RMM-IPC-, Approval-, Dienststeuerungs- oder Applyroute. - -**8 bestanden,0 fehlgeschlagen,0 ignoriert,0 gefiltert.** Erfasst sind: - -- geschlossene General/Full/Agent-Dienstmenge und Verweigerung eines APT-Restarts; -- kanonische Eventkette, feste Zeit-/Mengengrenzen und vollständiger16-Eventpfad; -- Erhaltung der Full-Rawbytes einschließlich des tatsächlich provisionierten - öffentlichen Filekeys ohne Einsetzen in das leere Inlinefeld; -- Verweigerung fremder Pins sowie unbekannter, doppelter oder escaped Felder; -- getrennte frische Healthsignatur, unverändertes `ready:false` und terminales Unknown; -- Besitz erst nach Stop, vollständiges Dateipaar und Rückgabe vor Restart. - -Vorher/nachher gleich: drei tatsächliche Agent-/General-/Full-Prozessgenerationen -mit PID, Prozessgeburt, Image und Konten; vier bekannte Config-/Pin-/Unitdateien -mit Rohhash und Metadaten; drei DB- und die vorhandene Executorlock-Dateiidentität; -Boot und weiterhin deaktivierter/inaktiver APT-Dienst. Ein separater rein -lesender Same-case-Aufruf bestätigte danach den gespeicherten Erfolg und -diesen aktuellen Zustand. Die Zielwirkung beschränkte sich auf den eigenen -Unitfall unter `/var/tmp/rmm-updater-handoff-` und den Testprozess. - -## Grenzen und nächste Arbeit - -Prozessgeburt/PID wurden beobachtet, kein durchgehender nativer Prozesshandle -gehalten. Die Erhaltung prüft bekannte Kontrollbytes und Dateiidentitäten, -keine vollständige SQL-/PKI-Historie. Lokale Belege flushen ihre Datei; -der bestehende lokale Transporthelper fsynct nicht zusätzlich das Elternverzeichnis. -Der exklusive Remote-Fall und Einmalmarker sperren normale Wiederholung. -Bei verlorenem Reply gilt ausschließlich Same-case-Readback, kein neuer Run. - -Dies ist ein nativer **Vertragskernnachweis**, kein Apply-, dauerhafter -SQLite-/Inflight-, IPC-, Dienststop-/Dateitausch-/Health-/Rollbacknachweis und -kein Windowsnachweis. Die tatsächliche Updateaction mit Katalog, Streaming, -MCP, fester WebUI-Genehmigung und unabhängiger Runtime wird parallel integriert. -Der bestehende Releaseverifier und seine ursprünglichen Native-Runner wurden -nicht verändert. Private Intents, Transportrückgaben und Originalausgaben -liegen gitignoriert unter `devstate/updater-handoff-native/03ddcaa5…/`. -Endbeleg-SHA256 `3a390ab47f63f2be58ab56728a7382909ae5249f5217d6f312455c4b497c64e3`, -separater Readback `388f86d5563cb53e48cd87a9a7c9ce10b02b695bfe195e574b769798fb960e66`. diff --git a/docs/agent-updater-handoff.md b/docs/agent-updater-handoff.md deleted file mode 100644 index c0a75d6..0000000 --- a/docs/agent-updater-handoff.md +++ /dev/null @@ -1,231 +0,0 @@ -# Reviewstand: erhaltene Helper-/Updater-Übergabe - -2026-11-14. **Isolierter Quellvertrag, keine Produktnorm oder Applyruntime.** -Basis: vollständige Spezifikation1.19, vollständige1.20-/PD-Ergänzung des -Skriptconsole-Worktrees und [bisheriger Vorschlag](agent-updater-proposal.md). -Root hat den engen Kernel und den Fullrenderer zur Ausarbeitung beauftragt; -Runtimeintegration, Zielaktionen und Veröffentlichung erfolgen erst nach -dessen Koordination. Linux-first und die tatsächliche WebUI-Grenze gelten. - -Die neue Crate `rmm-updater-handoff` verändert weder den qualifizierten -Releaseverifier noch die beiden vorhandenen nativen Verifier-Abnahmerunner. -Sie enthält keinen Installer, Dateischreiber, Dienststart, IPC-Server, -Netzwerkclient, SQLiteadapter, Approver oder neuen Server-Journalslot. -Aus einem gültigen Handoff oder Healthreceipt entsteht keine Startberechtigung. - -## Konkreter Vorwärtsvertrag - -`Handoff` bindet ursprünglichen Tenant/Asset/Agent, beide Generationen, -Plan-/Job-/Versuchs-/Grant-/Authorization-IDs, exakte Originalrequest- und -Startzeugenhashes, beide vorhandenen Journal-IDs, Helpercheckpoint und letzten -signierten Entscheid, Boot, ursprüngliche Verbindungsgeneration, einmalige -Ownernonce, stabilen Updater-/Policyhash, Vorgängerrecord, erhaltene Zustands- -und Stagingzeugen sowie Vorgänger-/Zielcodepaar. Der Rendererbeleg und alle -benannten alten/neuen Dateihashes sind unveränderlicher Bestandteil. - -Die Helperintegration muss Verbrauch, bestehenden exakten Startzeugen und -Handoff **in derselben vorhandenen Ledgertransaktion** persistieren. Eine -zusätzliche Transaktion nach `ledger::begin_execution` wäre unzureichend: -ein Crash könnte einen Verbrauch ohne bestimmbaren Owner hinterlassen. -Jeder andere offene/Unknown-Versuch verweigert die Übergabe. Das Handoff -ersetzt weder den Originaljob/-grant noch dessen unabhängige Prüfung. - -Die Writergrenze ist ausdrücklich Bestandteil dieses Vertrags: Der alte -Helper persistiert auch den Stopintent vor der Übergabeantwort. Solange er -seinen lebenslangen Windowsguard hält, schreibt der Updater kein Event in -den gemeinsamen Ledger. Nach Stop/Guardübernahme kann der Updater All-stopped -und Ownership zusammen transaktional anhängen. Nach dauerhaftem Rückgabeintent -und tatsächlicher Guardabgabe stammen die weiteren Start-/Health-/Outcome- -Events ausschließlich vom neuen Helper unter dessen Guard. Der Updater -erhält nur die eng typisierte lokale Bridge; kein freies Ledger-Schreibrecht -parallel zum neuen Helper. Ein einheitlicher Ledger-/Lock-Inode-/FileID-Hash -ist vor Übergabe fest gebunden und wird bei Übernahme, neuem Servicepeer und -Health erneut verglichen; bloß ein gleichnamiger Dateipfad reicht nicht. - -Der begrenzte Journalcodec prüft kanonische Bytes, Hashvorgänger, monotone -Sequenz/Zeit und höchstens16Events. Für Linux Full sind dies genau: - -1. Stopintent, unabhängiger All-stopped-Zeuge, bestätigter Besitz des gleichen - Helperledgers durch den konkreten stabilen Updaterprozess. -2. Jeweils ein Intent und ein bestätigter Nachhash für Agent, Helper, - Fullconfig und Fullpin; keine neue Dienstgeneration vor vollständigem Paar. -3. Neues Code-/Pinpaar und erhaltener Zustandszeuge vollständig bestätigt. -4. Dauerhafter Ledger-Rückgabeintent unter gehaltenem Guard, danach Guard - tatsächlich abgeben; erst anschließend darf der neue Helper denselben - Guard erwerben und starten. -5. Konkrete neue Serviceprozesse mit Imagehash, PID und Prozessgeburt, - anschließend signierter Healthbeleg und ursprüngliches Outcome-CAS. - -Der Codec nimmt nur Beobachtungen entgegen. `prepare` liefert Bytes für ein -append-only CAS gegen den bestehenden Head, **keinen Haltbarkeitsnachweis**. -Der Plattformadapter muss Flush/Commit vor Wirkung, echte Service-/Peer- -und Guardbeobachtungen, Dateihandles/ACLs sowie ursprüngliche SQLrows und -Signaturen prüfen. Historischer Replay allein erkennt keinen abgeschnittenen -Suffix; er muss gegen den erhaltenen dauerhaften Head, Rowcount und -Ledger-/Inode-/FileID-/Kontrollkettenbeleg geprüft werden. Ein unbekannter -Stop/Teilwechsel/Start bleibt lesend zu diagnostizieren, kein erneuter Execute. -Ein expliziter Unknown ist im neuen Updatekernel terminal und wird durch -spätere Health nicht geheilt. Bestehende allgemeine Outcome-CAS-Regeln bleiben. - -## Fullhelper bleibt Teil des ersten Linux-Applyziels - -Die tatsächliche Zieltopologie hat General, Full und Agent aktiv. Daher ist -Full kein pauschaler Ausschluss. `linux_general_full_v1` erhält ein geschlossenes -Stopset Agent/General/Full; ein bereits installierter APT-Reader kann zusätzlich -als vierter Dienst im Stopset stehen, **nie im Startset**. Alle tatsächlich -installierten Shared-Ledger-Reader müssen vor Austausch erkannt und gestoppt -sein. Unbekannte Profile und ausgelassene Fullservices verweigern den Schnitt. -Agent/General/Full erhalten dieselbe neue Codepaargeneration vor Restart. -Die alte APT-Unqualifikation/-Deaktivierung bleibt bestehen; kein alter -Acceptancebeleg wird umgeschrieben oder auf die neue Helperdatei übertragen. -Zukünftiger APT-Start benötigt eine gesonderte passende Qualifikation. - -`render_linux_full` akzeptiert ausschließlich das bekannte Full-Configschema, -die daraus in fester Feldreihenfolge abgeleitete `control::Policy` Schema2 -und den zugehörigen `GeneralPin` Schema2. Alte Binär-/Policy-/Identitybindungen -werden vorher geprüft. Die Rendererdefinitionen sind eine explizite -Schemamomentaufnahme; Integration muss sie gegen die tatsächlichen Typen aus -dem1.20-Quellstand vergleichen, bevor sie Runtime werden. - -Der unabhängige Quellenreview fand einen echten Kompatibilitätsfehler des -ersten Entwurfs: Die aktuelle Full-Rawconfig enthält einen leeren Inlinekey -und einen `signing_key_file`-Pfad; die Runtime ergänzt den effektiven öffentlichen -Key vor der Policyhashbildung. Der reine Renderer erhält deshalb jetzt den -bereits provisionierten, **extern authentisierten** öffentlichen Signierkey -als expliziten Parameter. Er öffnet keine Datei. Bei vorhandenem absolutem -Keypfad darf der Raw-Inlinekey leer oder genau gleich sein; ohne Keypfad ist -der gleiche Inlinekey Pflicht. Effektive Policy und Pin werden wie in der -Runtime aus diesem Key abgeleitet; Raw-Inlinekey und Pfad bleiben unverändert. -Der Transitionbeleg bindet zusätzlich `effective_signing_key_id`. Ein bloß -geparstes `VerifyingKey`-Objekt authentisiert keine Provisionierung; der spätere -Adapter muss den Input unabhängig gegen die vorhandene geschützte Keydatei -und die gebundene öffentliche Identität prüfen. Eine neue lokale Vertragsprobe -belegt den Filekeyfall und gleiche Policy-/Pinbytes zum Inlinefall. Dies ist -weiterhin kein Lesen der realen Keydatei oder nativer Renderer-Nachweis. - -Der Renderer ändert nur benannte Top-Level-Wertspans: - -- Config: `helper_binary_sha256`. -- Pin: `helper_binary_sha256` und daraus exakt neu berechnetes `policy_sha256`. - -Alle anderen **rohen Config-/Pinbytes** bleiben erhalten, einschließlich -Formatierung, Identity, öffentlicher Schlüssel, Keypfad, UID/GID, Socket, -Statepfad und Rechtefelder. Er nutzt begrenzte typisierte Deserialisierung -und geborgte `RawValue`-Spans; keine globale Stringersetzung, kein JSONpatch. -Ein gleicher Hash innerhalb eines anderen Feldes bleibt erhalten. -Unbekannte/duplizierte Felder, abweichende Policy, zusätzliche Profile/Services, -fremde Identität und escaped Hashwerte werden verweigert. - -Der `LinuxFullTransition` bindet alte/neue Rawconfig-, Rawpin-, Policy- und -Helperhashes. Exakte Zielbytes samt Beleg müssen vor der WebUI-Genehmigung im -festen Plan aufgelöst und später unabhängig erneut geprüft werden. General- -und APT-Konfigurationen werden nicht gerendert. Die zentrale Fullscope wird -**nicht migriert**; künftige Fulljobs bleiben ohne neue konkrete Scopebindung -deny. Ein Codewechsel erteilt keine neuen Rechte. - -## Enger Health- und Syncanschluss - -Die eigene offene Updatezeile darf **keinen allgemeinen Readyzustand** erzeugen. -`HealthReceipt` ist separat domänengebunden (`rmm.agent-update-health.v1\0`), -mit strengem Ed25519 geprüft und an den gesamten Handoffhash, Ownernonce, -Boot, beide erhaltenen Journale, neue Verbindungsgeneration und sämtliche -konkreten neuen Agent-/Helperprozesse gebunden. Er enthält exakte Hashes des -tatsächlich angewandten SignedSync-Requests/-Responses, Decision-ID und -frisches Inventar samt ACK-Hash. `ready=true` wird ausdrücklich verweigert. -Sync und Inventarempfang müssen nach den bestätigten neuen Dienststarts -liegen. Health ist nur innerhalb180Sekunden gültig, Gesamtfrist höchstens600; -kein Receipt verlängert sie. Der öffentliche Verifikationsschlüssel wird -extern vertrauenswürdig provisioniert, nie aus dem Receipt übernommen. - -Noch vor Integration normativ zu bestätigen: - -| Anschluss | Erforderliche enge Änderung | -|---|---| -| `ledger::begin_execution` | Additive atomare Handoffanlage mit Originalverbrauch/-start im selben Ledger; keine Ersatzzeilen und kein Reset | -| Helper-/Agent-Startup | Nur exakt vollständiges, lebendes, gleichbootiges, fristgebundenes Updatehandoff als `inflight` erkennen; vorhandenes Unknown niemals umschreiben | -| `HelperSync`/Server-Sync | Typed Inflightdatensatz desselben Versuchs bei weiterhin geschlossenem Ready abgleichen; Originalkontrollkette erhalten | -| `ClientSync::confirm_helper` | Bestehende allgemeine Unresolved-Sperre erhalten; neuer expliziter read-only Updatekontrollpfad darf keine Startlease setzen | -| Lokales IPC | Eigener fest provisionierter Updaterparticipant mit Dienst-/UID/SID-/PID-/Geburts-/Imagebindung; Root/SYSTEM allein reicht nicht | -| Healthroute | Tatsächlich gespeicherter neuer Geräte-mTLS-/Inventory-/Syncbeleg; lokale aktuelle Peer-/Code-/Stateprüfung plus exaktes Receipt vergleichen | -| Finalisierung | Neuer Helper speichert ausschließlich das noch fehlende Originaloutcome per unverändertem CAS; danach bestehende Spiegelung/normaler Sync | - -Keine dieser Runtimeänderungen ist durch den isolierten Kernel implementiert. -Insbesondere ist ein Hash im Receipt kein Ersatz für die unabhängige Prüfung -des zugehörigen aktuellen lokalen Kontroll-/Inventarbelegs. Rotation/Revoke- -und Trustprovisionierung müssen den aktuellen sowie historischen Prüfkontext -beibehalten; der Kernel implementiert keinen neuen Trustdienst. - -Offen bleiben außerdem genehmigte typisierte Action/Plan/Grant-/UI-/MCP- -Integration, Updatekatalog und begrenzter eigener Streamingpfad, OSstaging, -stabiler Updaterbootstrap, Dienst-/Dateiaustausch, einmaliger zulässiger -Vorgängercode-Rollback, tatsächliche Linux-Abnahme und danach Windows. -Windows-Codepaar-/Settingsrenderer und Rollbackzustände sind hier **nicht** -implementiert. Der ursprüngliche reine Linux9-/Windows9-Verifiernachweis -bleibt unverändert; diese neuen Verträge haben noch keinen VM-Nachweis. - -## Tatsächlich ausgeführte lokale Prüfungen - -Offlinecontainer aus vorhandenem Image -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. -Kein Server oder Agent auf dem Notebook gestartet, keine Ziel-/Policyaktion. - -```text -cargo check --manifest-path /src/Cargo.toml --offline -p rmm-updater-handoff -cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater-handoff -cargo test --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets --release -cargo clippy --manifest-path /src/Cargo.toml --locked --offline -p rmm-updater-handoff --all-targets -- -D warnings -``` - -Bestanden: Check, Formatierung, Clippy ohne Warnungen und acht gezielte -Vertragsprüfungen ohne Skip. Diese prüfen den vollständigen16-Event-Fullpfad, -Originalketten-/Clock-/Limitgrenzen, Stop-/Lock-/Austausch-/Restartreihenfolge, -fehlende Fullprozesse/APT-Ausschluss, echte getrennte Healthsignaturen, -stale/fremde/ready-Health und terminalen Unknown sowie Rawbyteerhaltung, -extern gebundene File-/Inline-Signierkeys und feindliche Fullrenderer-Eingaben. -Nur lokale Vertragsnachweise; kein -Bootstrapping, dauerhafter SQLite-Commit, nativer Dienst-/Apply-/Rollback- -oder Produktionsnachweis. Der erste Formatbefehl scheiterte vor Cargo an -einem nicht überschriebenen Image-Entrypoint; mit `--entrypoint cargo` -anschließend tatsächlich ausgeführt. Keine Tests als Folge dieses Fehlers -erfunden oder Zielaktion wiederholt. - -## Fortschreibung: koordinierter Quellencheckpoint1.21 - -Der ursprüngliche a2efb79-Kernel und dessen Belegbytes bleiben unverändert. -Sein tatsächlicher enger Linux8-Nachweis steht in -[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md). -Die darauf aufbauende Coreintegration speichert Originalverbrauch, bestehenden -Startzeugen, Handoff, konkrete Delegation und Stopintent in einer IMMEDIATE- -Transaktion des vorhandenen Ledgers. Sie überträgt einen typisierten begrenzten -Präfix in Protofeld14 und bestätigt ihn ausschließlich bei beiden Readyflags=false -und unlock=false. Persistiertes Unknown bleibt terminal. Leere neue Felder -lassen die alten Grant-/Decision-/Startcodecbytes unverändert. - -Der Originalplan bindet separat provisionierten Healthpublickey und Rawpinhash; -Admission liest den lokalen Pin unabhängig, historische Prüfung benutzt diesen -Originalkontext. Server-Health verlangt originale gespeicherte SignedSync- und -Baseinventarbytes samt bestätigender Folgerunde; sie eröffnet keine Admission. -Der konkrete Helper muss dieselben lokal tatsächlich angewandten Bytes und -Applyzeit innerhalb der belegten Zeitspanne unabhängig nachweisen. - -Linux Full ist vorgesehener ursprünglicher Autorizer/Owner-/Healthguard. -General bleibt in diesem Fall geschlossen und darf Nichtzuständigkeit nicht -als OwnerLost terminalisieren. Das ist nötig, weil die tatsächlichen General- -Capabilities keine Imageprüfung eines breiter berechtigten Fullprozesses erlauben. -Kein Generalhärtungs-/Capabilitywechsel ist implementiert oder freigegeben. - -Native Unterintents und Nachlesezeilen hängen im selben Ledger am Originalgrant. -Feste Stop-/Dateischritte sind create-once, Rückgabe und genau drei Startclaims -committen atomar. Nur ein weiterhin lebender ursprünglicher Worker darf die -reservierte Folge nach tatsächlicher Lockabgabe einmal dispatchen. Neue Full- -Helper bestätigen echte Start-/Health-/Recordbeobachtungen unter ihrem Guard. -InstalledRecord/Floorcodec und separat signierter Bootstrapbaselinecodec sind -reine Parsingverträge und ersetzen keine Trust-, Floor- oder OSprüfung. - -Offen bleiben reale enge Fullbridge-/Owner-/Healthadapter, passive gültige -Updatezustände/Kandidaten, vollständige erhaltende Baselineprovisionierung, -Workerdispatch und End-to-End-Apply. Restore bleibt ausdrücklich verweigert: -der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackpfad. -Der Agent meldet bis zur echten Provisionierung nur agent.update/not_configured; -keine Applyfähigkeit aus Build/Katalog/Unitnachweis. Kein VM-Apply oder -Windows-Applynachweis dieses Checkpoints. diff --git a/docs/agent-updater-health-client.md b/docs/agent-updater-health-client.md deleted file mode 100644 index fd21da9..0000000 --- a/docs/agent-updater-health-client.md +++ /dev/null @@ -1,117 +0,0 @@ -# Erhaltener Inventarbeleg und Agent-Healthclient - -2026-11-14, Spezifikation1.21. Dieser enge Quellenschnitt ergänzt den bestehenden -Agentjournal- und SignedSyncvertrag. Er installiert oder startet keinen Dienst, -erhebt selbst kein Inventar und erzeugt weder Job, Grant, Bereitschaft noch -Helperwirkung. Registrierung und Aufruf im bestehenden Agent-/Corepfad werden -vom Laufzeitowner getrennt integriert; ein fertiger nativer Healthlauf ist damit -nicht behauptet. - -`update_health_inventory` erhält im selben gesperrten, begrenzten Agentjournal -höchstens zwei ursprüngliche Baseinventar-Envelopes je Originalgrant. Die -Retention prüft den vollständigen Inflightpräfix gegen den aus dem unabhängig -verifizierten ursprünglichen Updatejob stammenden Healthkey. Ein beliebiger -Aufrufer-/Netzwerkkey ist keine Provisionierung. Erforderlich sind -`ServicesStarted`, das letzte echte Dienststartereignis, passende Geräte-/Boot-/ -Journalbindung und eine neue Verbindungsgeneration. Plattformscope und echte -Erhebungszeit bleiben erhalten; ein `agent.update`-Paket oder ein vor Dienststart -erhobenes Baseinventar ersetzt diesen Nachweis nicht. Kein pauschaler60s-CIMscan -und kein Frischstempeln bereits gespeicherter Basewerte werden eingeführt. - -Gewöhnliche Transport-ACKs löschen weiterhin ihren normalen Queueeintrag, -aber keine Retentionbytes. Die ursprüngliche UUID bleibt zusätzlich für den -echten SignedSync ausstehend. Nur dessen interner Applyhook kann sie als signiert -bestätigt markieren: nach normaler unabhängiger Signatur-/Bindungsprüfung und -unter Vergleich der bereits gespeicherten Originalresponse und des normalen -konkreten `reconcile_receipts`-Datensatzes. Selbst danach bleibt das rohe Envelope -erhalten. Keine Caller-ACKliste, `applied=true`-Behauptung, neue Applyzeit oder -Tombstonelöschung ersetzt diese Zeugen. Das vorhandene Journalbudget bleibt -verbindlich; ein dritter Retentionssample oder geänderte ursprüngliche Bytes -werden verweigert. - -Der HTTPclient konstruiert seinen nicht öffentlich befüllbaren Kontext nur aus -dem lokalen laufenden Originaljob und zwei bereits gespeicherten tatsächlich -signierten Kontrollrunden. Er prüft beide mit dem normalen Coreverifier. Die -aktuelle bestätigende Runde muss in Agent- und Helper-Vorgängerlink genau die -erste Entscheidung nennen; beide müssen denselben vollständigen -`ServicesStarted`-Präfix bei `ready=false` bestätigen. Ein gerade offener nächster -Request, Fault, fehlender ACK, anderes Boot/Grant/Journal oder veraltete -Kontrollrunde erzeugt keinen Healthrequest. Ein fehlender Zeuge bleibt fehlend. - -Das tatsächlich in der ersten Entscheidung bestätigte, separat erhaltene rohe -Baseinventar wird mit den beiden ursprünglichen Requestbytes an die feste Route -`/agent/v1/update-health` geschickt. Der Aufruf benutzt ausschließlich den bereits -normal verifizierenden mTLS-Client aus `https_channel`, dessen geprüften DNSnamen -und TCP-Override; keine freie URL, Bearerweitergabe, Zertifikatsausnahme oder -Redirectfreigabe. Request maximal5MiB, Response maximal16KiB, Healthpayload -maximal4096Bytes und feste64-Byte-Signatur. Timeout und monotone Nachprüfung -begrenzen den Aufruf auf die verbleibende ursprüngliche180s-/600s-Frist und -beide noch gültigen normalen Syncentscheidungen. Es gibt keinen automatischen -Retry. - -Vor Rückgabe prüft der Client konkrete Inventar-/Sync-IDs und Originalhashes -und lässt den unveränderten Handoffkernel die separate Healthsignatur, -Dienstprozesse, Owner-/Boot-/Journal-/Codebindung und Fristen prüfen. -`Journal::prepare` ist dabei ausschließlich eine Prüfung; es appendet nichts -und schließt keinen Versuch ab. Tatsächliche lokale Helper-Applyzeit, Dateipaar, -Prozesse, Finalisierung und InstalledRecord/Floor bleiben bei den unabhängigen -lokalen Guards. Der Serverbeleg behauptet keine entfernte OS-Attestierung. - -Tatsächlich lokal ausgeführt: registrierter Agent-/Corecheck mit `--locked ---offline`, Core-Clippy für alle Targets mit `-D warnings` und zwei gezielte -Core-Retentiontests bestanden. Der erste benutzt den tatsächlichen normalen -`jobs::ack`: Queueeintrag verschwindet, Originalraw und SignedSync-Pending-ID -bleiben. Der interne SignedSync-Hook verweigert fehlende gespeicherte Response -und fehlenden Receipt; nach beiden bleibt der Rawbeleg erhalten. Diese internen -Hookfixturebytes haben ausdrücklich synthetische Signaturen und qualifizieren -keinen Kryptografiepfad. Der zweite Fall prüft Create-once, zwei Samples, -Fremdgrant und veränderte Rawbytes. - -Der erste `--locked`-Versuch lief vor der koordinierten Lockfortschreibung noch -nicht bis zum Compile. Der erste erreichte Agentcompile fand ein falsches -`Option`-Pattern; nach Korrektur bestand der Check. Der Client ist -registriert, sein tatsächlicher Mainaufruf wird noch separat integriert; -entsprechende unbenutzte Funktionen bleiben offen ausgewiesene Compilerwarnungen -und werden nicht unterdrückt. Unabhängiger Quellenreview und vollständiger -Agent-Clippy nach tatsächlicher Verdrahtung bleiben offen. Keine native VM-/ -Netzwerk-/Applyprüfung oder Zieländerung für diesen Teil erfolgt. - -## Spätere Ownerintegration - -Der nachfolgende Runtimeowner hat Registrierung und echte Agent-/Corehooks -inzwischen ergänzt. Der Ablauf läuft asynchron neben Heartbeats, behält echte -Basebytes/UUIDs und nimmt zusätzliche IDs nur für den verifizierten Original- -Inflight in normale SignedSync auf. Nach erfolgreichem HTTP wird ausschließlich -der erhaltene SignedHealth an den tatsächlich gebundenen neuen Fullhelper -gegeben; dieser prüft eigene Control-/Inventar-/Prozesszeugen unabhängig. -Der zuerst qualifizierte Deliveryschnitt oben bleibt historisch. Änderungen -und tatsächliche lokale Folgeprüfungen sowie offene native Gates stehen in -[agent-updater-runtime-source.md](agent-updater-runtime-source.md). - -## Exakte lokale Applyspanne statt Sekundenquantisierung - -Nachtrag2026-11-15: Der unveränderte eingefrorene Healthreceipt enthält -`signed_sync_applied_at` weiterhin als `u64` und unverändert als -`floor(confirming.issued_at)`. Dieser Scalar erteilt keine Zeitfreigabe. -Der neue lesende Coregetter `update_health_sync::read_round` prüft bounded -die vorhandenen Originalrequest-Protobufs, SignedResponsebytes und tatsächlich -im selben HelperSync-Commit gespeicherten Appliedwitnesses. Die bestehende -Signatur-/Kontextprüfung läuft unabhängig erneut; es wird weder ein ACKboolean -noch eine Callerzeit akzeptiert und kein Journal/Ready/Lease neu geschrieben. - -`verified_span` findet genau ein tatsächlich angewandtes bestätigendes D2 mit -beiden vorherigen Decision-IDs gleich D1, derselben Originalgeräte-/Boot-/ -Verbindungsbindung und identischem ServicesStarted-Präfix. Dieser Präfix muss -auch unverändert im aktuellen Originalhandoff enthalten sein. Der Fullguard -prüft jetzt `D1.issued_at <= actual_local_applied_at <= D2.issued_at` mit -den exakten ursprünglichen DateTimes. Erst danach folgt die bestehende lokale -Inventar-/Dienst-/Originalhealthprüfung. Der u64-Wert wird ausschließlich auf -Gleichheit mit dem ursprünglichen D2-Sekundenfloor geprüft. - -Der enge tatsächliche Grenzfall akzeptiert beide exakten Endpunkte und verweigert -eine um1ns zu frühe oder zu späte Anwendung trotz identischem Sekundenfloor. -Der vorhandene vollständige negative HelperSyncfall prüft zusätzlich den echten -Original-Roundgetter nach Signatur-/Applypersistierung. Lokaler Quell-/Testbeleg: -`devstate/updater-health-exact-span-6879f7cc-f284-4f50-b3e6-de321f3af6a2/`. -Kein nativer Health-/Applynachweis und keine Änderung an Frozenreceipt-/ -Kernelbytes oder an der WebUI-Grenze. diff --git a/docs/agent-updater-linux-native-results.md b/docs/agent-updater-linux-native-results.md deleted file mode 100644 index 48509ec..0000000 --- a/docs/agent-updater-linux-native-results.md +++ /dev/null @@ -1,206 +0,0 @@ -# Linux-Updaterport: native Fünfer- und Sechsertests bestanden - -2026-11-14. Dieser Schritt prüft ausschließlich die fünf isolierten OS-Units -des Linuxports. **Auf der Cloud-VM als UID0 bestanden:5/5, kein Skip/Filter.** Kein Apply-, Autoupdater- oder -Windows-Erfolgsnachweis. Der einmalige Lauf und der separate lesende Originalfall-Readback sind -abgeschlossen. - -## Feste Herkunft und Testmenge - -Der neue Runner `deploy/updater_linux_native_acceptance.py` kopiert beim lokalen -`prepare` die 22 Originalinputs aus dem eingefrorenen Korrektursnapshot -`devstate/updater-linux-execfix-aa106c58-8c96-4c8a-8490-635b1d143f07/source` -im benachbarten Updaterworktree. Er prüft deren einzelne Hashes und Längen gegen -den unveränderten Intent mit SHA256 -`4921dac74d57931ad1973b4e64409d231e02ab0cb264b35113292fc295840ad3`. -Kein Lesen aktueller WIP-Quellen oder Ersatz durch andere Gitblobs. -Der unabhängig geprüfte lokale Receipt ist -`f705ba03e5043a411fc3a0642197fc4f16da8627e1e5cbfbac78ed125ecb650c`; -die feste vorhandene Testexe hat1538320Byte und SHA256 -`b11b57e6399dcfcfb255619a8fba558beea6a57e4f1ee997ee9c63c769a1e882`. -Der Runner baut keine neue Exe. Sein eigener Hash, die Transportquellen und die -22 kopierten Inputs werden in einem eigenen lokalen Fallmanifest gebunden und -vor jedem späteren Aufruf erneut geprüft. - -Die komplette native Testliste muss vor Ausführung exakt diese fünf Namen haben: - -- `ipc::tests::framing_denies_large_duplicate_unknown_and_unbound_requests_before_dispatch` -- `ipc::tests::partial_socket_frame_does_not_extend_its_total_deadline` -- `tests::held_file_rejects_symlink_and_replaced_name_but_preserves_bound_hardlinks` -- `tests::pidfd_image_birth_account_and_exit_are_independently_observed` -- `tests::same_pid_exec_rejects_changed_image_despite_retained_pidfd_birth_and_credentials` - -Die letzte Probe hält tatsächlich dieselbe PID, Prozessgeburt und UID/GID beim -Wechsel von eigenem Bash zu eigenem Sleep. Sie verlangt die Ablehnung des alten -Imagebelegs. Lokal bestand die korrigierte Generation5/5; die zusätzliche Probe -scheiterte mit dem ursprünglichen Processcode gezielt an dieser Ablehnung. -Diese bestehenden lokalen Ergebnisse wurden nur gelesen, nicht erneut gebaut -oder ausgeführt und nicht zu einem nativen Cloudnachweis umgedeutet. - -## Enger Zielumfang und Ausführung - -Root ist hier erforderlich: Die vorhandenen Testquellen verlangen UID0, -erstellen eigene geschützte UUID-Verzeichnisse unter `/run` und prüfen eigene -UID/GID0-Prozesse. Der feste Prozess startet mit geleerten Zusatzgruppen, -`no-new-privs` und bereinigter Umgebung. Er benötigt weder Capabilities aus dem -RMM-Protokoll noch eine Dienstinstallation. Die Tests verwenden eigene Dateien, -Hardlinks, Symlinks, Socketpairs und eigene Bash-/Sleep-Kinder. Sie öffnen keinen -Updaterlistener, kein RMM-Ledger und keine tatsächlichen Installationsziele. -Der Runner hält seine eigenen Kommandogruppen bis zur Bereinigung gegen -PIDwiederverwendung fest und beendet bei Timeout ausschließlich diese Gruppen. - -Der Operator verwendet den bestehenden streng geprüften Cloud-Linux-SSH-Pfad -aus Main. Der Runner liest Credentials ausschließlich bei `execute`/`read` -über den vorhandenen Parser, keine kopierten Credentials, keine Hostkeyausnahme. -Nur die gebundene Testexe wird größenbegrenzt übertragen und auf der VM erneut -gehasht. Das neue Remoteverzeichnis ist exklusiv -`/var/tmp/rmm-updater-linux-os-`, Rootbesitz,0700. Binärdatei und Belege -werden create-only geschrieben und geflusht, einschließlich Elternverzeichnis. - -Vorher/nachher werden Ubuntu24.04/x86-64 und Boot, die drei tatsächlichen -Agent-/General-/Full-Prozessgenerationen mit Konten/Image/InvocationID, vier -bekannte geschützte Config-/Pin-/Unitdateien mit Rohhash/Metadaten sowie drei -DB- und eine Executorlock-Dateiidentität verglichen. APT muss weiterhin -inaktiv und deaktiviert sein. `systemctl show` wird ausschließlich lesend -verwendet; kein Start/Stop/Enable, kein Paketbefehl und kein Reboot. - -Tatsächlich einmalig ausgeführt (Originalfall -`ec030323-85df-4b38-9e70-87be330033c2`): - -```sh -python3 deploy/updater_linux_native_acceptance.py prepare -python3 deploy/updater_linux_native_acceptance.py execute --case ec030323-85df-4b38-9e70-87be330033c2 -python3 deploy/updater_linux_native_acceptance.py read --case ec030323-85df-4b38-9e70-87be330033c2 -``` - -Ein exklusiver lokaler Executeeintrag wird vor SSH dauerhaft geschrieben. -Bei verlorenem Reply ausschließlich denselben Fall lesen. Keine Wiederholung, -keine neue Testgeneration und kein neuer Fall zur Umgehung eines unklaren Laufs. -Fehlt ein Endbeleg, meldet Readback dies ausdrücklich; daraus entsteht kein -Erfolg. Der Remote-Einmalmarker und exklusive Ordner verweigern ebenfalls einen -zweiten Lauf. Ein vollständiger Erfolg verlangt5/5 ohne Ignored/Filter sowie -unveränderte Vor-/Nachzeugen und getrennten lesenden Readback. - -## Tatsächlich lokal geprüft und verbleibende Grenzen - -Python-Syntax, begrenzte Ausgabeerfassung, eigener Timeout samt -Kommandogruppenbereinigung und die feste Base64-Transferlänge wurden lokal -geprüft. Keine VM-/SSH-/Serveraktion, kein RMM-Job, keine WebUI-Genehmigung und -kein neuer Cargo-Build/-Test durch diesen Vorbereitungsschritt. - -Die Zeugen vergleichen bekannte Kontrollbytes und Dateiidentitäten, keine -vollständigen SQL-/PKI-Historien. Die drei Dienstprozesse werden vor und nach -beobachtet; der Runner hält deren Handles nicht durchgehend. Die innerhalb der -Unit geprüften pidfds betreffen ausschließlich eigene Fixtureprozesse. -Rootausführung eines vorab geprüften Testbinary ist keine Betriebssandbox. -Fehlschlag kann eigene Fixtureverzeichnisse hinterlassen; kein automatisches -Löschen oder Wiederholen nach unklarem Ende. - -Der isolierte Linuxport besitzt weiterhin keine vollständige ledgergebundene -Engine/Fence, keinen dauerhaften Updaterdienst und keinen freigegebenen -Dateipaarwechsel. Dienststop, Ledgerübergabe, Staging/Swap, Health, Rückgabe und -Rollback des tatsächlichen Agentupdates bleiben eigene offene Integration und -anschließende WebUI-genehmigte Linux-first-Abnahme. Der bestehende Acht-Kernel- -Runner, sein nativer Nachweis und die ursprünglichen Releaseverifier-Runner -bleiben unverändert. - -## Tatsächlicher nativer Endbeleg - -Der geprüfte Runner SHA256 `a13e3554d27fce14848ff30e2d86430bb462f45d19fcd9acca78480c970eeb38` -übertrug ausschließlich die feste Testexe, prüfte zuerst die vollständige -Fünferliste und führte sie einmal aus. Ergebnis5/5,0ignored/filtered, Exit0, -kein stderr. Der separate Readback meldet denselben abgeschlossenen Fall -und identische aktuelle Vor-/Nachzeugen. - -Execute-Beleg SHA256 `2b8bff59f158a204f669f1df9b022fac0024248de3fe035a1f11b7f532574a1a`; -Readback SHA256 `e9bdfed8919f283a917ebf06d5354832df8634a5cbb44210cdca6684e425931a`. -Die Rohbelege und22 eingefrorenen Inputs bleiben gitignoriert. - -Die Full-Helper-Unit war und bleibt aktiv, aber für Autostart deaktiviert. -Dieser isolierte Unitlauf ändert diese Einstellung nicht und belegt keine -Bereitschaft nach einem Neustart. Keine RMM-Jobs oder Servicekontrolle. -Der MVP einschließlich Windows und vollständigem Selbstupdater ist weiterhin -nicht abgeschlossen. - -## Separater lesender Dienstkontextbefund - -Nach dem isolierten Fünfertest wurde im eigenen Fall -`accb1ce1-9cbc-4301-bdfb-04a310c9e5a5` ausschließlich der tatsächliche -General-/Full-Prozessstatus gelesen: gleiche Usernamespace, aktuelle Images -jeweils79442727, stabile PID/Geburt/Invocation-ID vor und nach dem Lesen. -General-CapEff enthält weder die gesamte Full-CapPrm-Menge noch CAP_SYS_PTRACE. -Resultat-SHA256 `9c1629d6ec0d821b50912a2cb6932b6f263c945649a341c7b8f312832aac70c2`. -Keine neue Prozesseigenschaft, Unit, Capability oder Konfiguration verändert. - -Der Kernel verlangt beim entsprechenden Prozesszugriff eine ausreichende -Capabilitymenge oder CAP_SYS_PTRACE -([commoncap-Implementierung](https://github.com/torvalds/linux/blob/master/security/commoncap.c)). -Daraus folgt eine konkrete Integrationsgrenze für die gegenläufige -General→Updater→Full-Imageprüfung. Das ist eine aus tatsächlichen Masken und -Kernelvertrag abgeleitete Einschränkung; **kein im echten Generalkontext -bereits ausgeführter Open-/IPC-Nachweis**. Die Unitprobe ersetzt diesen nicht. -Konkrete Rollen-/Dienstkonfiguration und tatsächlicher wechselseitiger -Peerzugriff müssen vor Bootstrap geklärt werden. Kein PID-/Pfadfallback und -keine vorsorgliche Lockerung der Generalhärtung. - -## Herkunft nach Zusammenführung des Quellencheckpoints - -Die sieben OSportdateien dieses nativen Nachweises sind im gepushten -Checkpoint1e89c45 bytegleich erhalten. Von den22 eingefrorenen Eingaben stimmen -17 mit dem zusammengeführten Stand überein; fünf Domaininputs wurden für die -spätere Plan-/Health-/Provisionierungsintegration erweitert. Der neue gesamte -Workspace ist damit nicht pauschal nativ qualifiziert. Seine separaten lokalen -Compiler-/Prüfbelege bleiben von diesem ursprünglichen Fünfertest getrennt. - - -## Neuer Sechsernachweis nach gebundenem Stage-Reopen - -Der getrennte Quellenstand328e440 (Mainmerge7d328ee) ergänzt das gebundene -Wiederöffnen eines bereits verifizierten Stagings. Der neue Runner -`deploy/updater_linux_reopen_acceptance.py`, SHA256 -`8a27924b829946e24e9870b9e6af71508dee6495ee7840c51f809cfecf94c10a`, -bindet23 eingefrorene Inputs und die neue Sechserexe:1555392Byte, SHA256 -`c78d24d9b3f543fc4eba3fa1d02bf82e72aea26493ae689f2fc82ee1067d33fc`. -Der lokale Qualifikationsreceipt hat SHA256 -`c3e1ee619ef01630b296aaf7669d04f39ea952b1ec2d7adc1a791f69f6a6ee08`. -Die sieben OSportquellen entsprechen diesem öffentlichen Stand; spätere -Worker-/Runtimeänderungen sind dadurch nicht qualifiziert. - -Die ursprünglichen fünf Namen bleiben enthalten. Hinzu kommt exakt -`files::reopen_tests::bound_reopen_rejects_same_byte_name_substitution_and_added_stage_hardlink`. -Die Probe verwendet ausschließlich ein eigenes geschütztes UUID-Verzeichnis -unter `/run`: positive interne FD-Prüfung, Verweigerung eines gleichbyteigen -Namensaustauschs sowie eines nachträglich hinzugefügten Hardlinks. Der öffentliche -API verweigert den Fixture-Elternpfad. Noch kein positiver Produktpfadtest, -keine Autorität zur Wiederaufnahme eines unklaren Applys. - -Der erste lokale Prepareversuch stoppte vor Fallanlage und SSH: Das vom -Sourceworker erzeugte private Qualifikationspaket hatte zu offene Rechte -(Verzeichnisse775, JSON664). Im gesonderten lokalen Reparaturfallf3c44696 wurden -46 eigene Objekte auf700/600, die qualifizierte Exe auf500 begrenzt; Besitzer, -Inodes und Dateibytes blieben erhalten. Der Reader wurde nicht gelockert. -Erst danach entstand der neue Originalfall349ffb0b-ec46-4eb0-b0e6-0867f3cd392b. - -Tatsächlich einmal ausgeführt, anschließend separat nur gelesen: - -```sh -python3 deploy/updater_linux_reopen_acceptance.py prepare -python3 deploy/updater_linux_reopen_acceptance.py execute --case 349ffb0b-ec46-4eb0-b0e6-0867f3cd392b -python3 deploy/updater_linux_reopen_acceptance.py read --case 349ffb0b-ec46-4eb0-b0e6-0867f3cd392b -``` - -Ergebnis auf der Cloud-Linux-VM als UID0: **6/6,0ignored/filtered, Exit0**. -Originalmanifest SHA256 -`3278a9ffbcbf460f2304f570165a4c6cb4292ef22604b9639af82088ef9b046c`; -Execute-Beleg SHA256 -`0d9a522d7e25d49af47bbe4950bde544a0f84ba9d40a8f60d067512a9638433b`; -separater Readback SHA256 -`4fc2f86a18b83bfa536d1d657eee87304db8c7ce096459c5f366940241e0b6ba`. -Die bekannten Prozess-, Boot-, Kontrollbyte- und Dateiidentitätszeugen waren -vor/nach sowie beim Readback gleich. APT inaktiv/disabled; Full aktiv, weiterhin -Autostart disabled. Keine Dienststeuerung, RMM-Jobs oder Produktdateitausche. -Der eingefrorene Fünferrunner und sein ursprünglicher Beleg bleiben unverändert. - -Auch dieser Nachweis belegt keine vollständige SQL-/PKI-Historienprüfung, -keinen geschlossenen Readercensus und keine vollständige Apply-/Health-/ -Rollbackstrecke. Windows und der Selbstupdater bleiben offen. diff --git a/docs/agent-updater-linux-port.md b/docs/agent-updater-linux-port.md deleted file mode 100644 index 9cee8ff..0000000 --- a/docs/agent-updater-linux-port.md +++ /dev/null @@ -1,239 +0,0 @@ -# Linux-OS-Port des unabhängigen Updaters - -Stand2026-11-14: neue Bibliothek `rmm-updater-linux`, auf Auftrag des Hauptagenten -isoliert neben Domain/Core und Server/WebUI implementiert. **Noch kein laufender -Updaterdienst und keine Applyabnahme.** Native Linux-first-Abnahme und sämtliche -Zielaktionen bleiben beim Hauptagenten. Der vorhandene Releaseverifier, dessen -Native-Runner sowie der separat qualifizierte achtteilige Handoffkernel bleiben -unverändert. - -**Aktueller lokaler Quellenstand nach unabhängigem Review:** Der weiter unten -erhaltene4-Fälle-Beleg ist historisch. Ein echter Same-PID-Exec-Bindungsfehler -wurde korrigiert, mit dem alten Code reproduziert und im neuen lokalen -5-Fälle-Nachweis geschlossen. Dieser lokale Schritt allein ist kein nativer -VM- oder Applynachweis; die danach separat durch Root ausgeführte native -OS-Unitqualifikation ist am Ende ergänzt. - -## Implementierte Betriebssystemstrecke - -`files` öffnet jede Verzeichniskomponente mit gehaltenem `openat`-Dirfd, -`O_NOFOLLOW` und `O_CLOEXEC`. Rootgeschützte installierte Verzeichnisse dürfen -keine gruppen-/weltbeschreibbaren Vorfahren haben. Dateiprüfungen binden -Device/Inode, UID/GID, Modus, vorhandene Linkzahl, Länge und SHA256; Hashing -benutzt höchstens32KiB Lesepuffer. Historisch gebundene Hardlinks werden nicht -pauschal verboten. Neue Stages haben genau einen Link. - -Die vier Produktionsziele sind geschlossen: Agent, gemeinsame Helperbinary, -Fullkonfiguration und Fullpin. Aus einem Request kommt kein Zielpfad. -Staging entsteht exklusiv im **gleichen gehaltenen Installationsverzeichnis**, -mit exaktem EOF/Längen-/Hashnachweis, ursprünglichen Besitz-/Moduswerten und -Datei-/Directory-fsync. Fehlerhafte/partielle Stages bleiben erhalten und -werden nicht automatisch wiederverwendet oder gelöscht. Der eingebettete -Downloadreader muss selbst IOzeit und Kanalabbruch begrenzen; die Bibliothek -prüft das ursprüngliche Boot-/Monotonbudget zwischen IOschritten, kann aber -keinen beliebig blockierenden fremden `Read`-Aufruf unterbrechen. - -Ein Austausch verlangt einen tatsächlich gehaltenen `LedgerGuard`. Vor jedem -Namespaceeingriff werden dessen aktuelle Dateiidentität, weiterhin gestoppte -Reader und Budget geprüft. Der Vorgänger wird mit `RENAME_NOREPLACE` unter -seinem erhaltenen Inode auf einen festen Backupnamen verschoben; danach wird -die verifizierte Stage ebenfalls ohne Überschreiben an den Originalpfad -verschoben. Jede Phase benötigt vorher den dauerhaften `DurableEffectFence`. -Ein Crash zwischen den Renames ist ausdrücklich **kein atomarer Bundleswap**: -Vorgänger und Stage bleiben nachlesbar, neuer Execute-/Resumeversuch verboten. -Ein zulässiges einmaliges Rollback benötigt eine eigene vorab gebundene Fence; -es erhält beide Codegenerationen und verändert keine Zustandsdatei oder Floor. - -`process` bindet echte `pidfd`s, ein gehaltenes `/proc/PID`-Verzeichnis, -Prozessgeburt, alle UID/GIDwerte und ein gehaltenes Rootimage. Exithinweise -und nachträgliche Abweichung verweigern. Imagehashing verwendet `pread`, damit -parallele Nachlese keinen gemeinsam verschobenen Dateioffset verwendet. -Nicht unterstützte Kernel erhalten keinen PID-/Prozessnamenfallback. -Vor und nach dem Hashen wird das **aktuell ausgewählte** `/proc/PID/exe` -erneut durch das gehaltene Proc-Verzeichnis geöffnet und per Device/Inode -gegen das ursprüngliche Image gebunden; Geburt, Konten und pidfd werden -danach nochmals geprüft. Ein noch lesbarer alter Image-FD allein genügt nicht: -`execve` behält PID, Geburt und Credentials, wechselt aber die Codegeneration. - -`services` kennt ausschließlich Agent/General/Full und optional den bereits -inaktiven, deaktivierten APT-Reader. General und Full müssen dieselbe -Helpergeneration haben. Geladene Unit und sämtliche Drop-ins werden als -geschützte Fileproofs gebunden; Running/PID/Invocation-ID, native Prozesszeugen -und tatsächliche Konten werden unabhängig nachgelesen. Ein Rootpeer genügt -nicht: `SO_PEERCRED` muss zur aktuellen konkreten Helper-/Updater-Dienstinstanz -mit gehaltenem Prozess passen. Der stabile Updater ist getrennt, UID/GID0, -und gehört niemals zum Stopset. - -Stop und Start benutzen feste argv an `/usr/bin/systemctl`, keine Shell oder -freien Kommandos. Es gibt keine Enable-, Reboot- oder APT-Startoperation. -Stop startet genau eine Systemdanforderung pro gebundenem alten Dienst und -beobachtet danach dessen tatsächliches Ende. Nach vollständigem Code-/Pinpaar -und Ledger-Rückgabe startet der enge Anschluss General, Full und Agent einmal. -Timeout des eigenen Clients beendet nur dessen gehaltenen pidfd-Prozess; -Systemd kann den Auftrag bereits übernommen haben. **Jeder Fehler nach -möglicher Übergabe bleibt unklar; nie still wiederholen oder als Nichtstart -ausgeben.** - -`LedgerGuard` öffnet ausschließlich vorhandene `consumption.sqlite` und -`executor.lock` unter `/var/lib/rmm-helper`. Kein Create/Truncate, kein neuer -Journal-ID-Slot. Exklusive `flock`-Übernahme erfolgt erst nach bestätigtem Stop -aller installierten Reader und bindet beide exakten Dateiidentitäten. Die -Lebensdauer leiht `StoppedServices`; ein gleichzeitiger Start derselben -Kontrollinstanz ist so ausgeschlossen. Vor Abgabe muss die eingebettete Fence -den ursprünglichen `LedgerReturnIntent` dauerhaft gespeichert haben. - -## Lokaler Kanal und noch fehlende Integration - -Der implementierte IPC-Transport bindet ausschließlich den vorher separat -provisionierten privaten Rootpfad `/run/rmm-agent-updater/control.sock`. -Vorhandene Sockets werden weder entfernt noch wiederverwendet. Vor Parsing und -Dispatch wird der tatsächliche aktuelle Helperdienst mit SO_PEERCRED und -gehaltenen Prozess-/Unitzeugen authentisiert. Der Client authentisiert den -fest provisionierten Updater unabhängig vor dem Senden und vergleicht seine -Antwort mit genau diesem Participantbeleg. Ein begrenzter Längenheader erlaubt -höchstens32KiB und eine Anfrage pro Verbindung. Methods sind Describe, Activate, -Read und Health; keine Approval-, Pfad-, Befehls- oder neue Startgranterteilung. -`ready` bleibt zwingend false. Activate-IOfehler erlaubt ausschließlich Read. - -Es wird bewusst **keine permissive Engine/Fence und kein unfertiges Daemonbinary** -ausgeliefert. Der Core-Eigentümer integriert Originalsignaturen, aktuelle -TrustedClock/Trustpolicy, immutable Handoff/Delegation im bestehenden Ledger, -alleinigen logischen Owner, feste Staging-/Fullrendererzeugen und den -evidenz-only SignedSync-/Inventarhealthbeleg. Die beiden nativen Rename-Intents -pro Datei sind zusätzliche vorhandene-ledger-gebundene Effectintents, keine -Verdoppelung der begrenzten16 Handoffevents. Ein verlorener Writer oder -definitives Unknown wird niemals durch diese OSbeobachtungen geheilt. - -Noch offen: konkrete Core-Fence-/Engineimplementierung, monotone Floor- und -InstalledRecordpublikation, Dienstbootstrap/stabiles Binary, tatsächliche -Systemd-/IPC-/Staging-/Dateitausch-/Rückgabekette und zulässiger Rollback im -WebUI-genehmigten Updateversuch. Der Loopback-/Rootbootstrapweg ist keine -Jobgenehmigung. Notebook bleibt ausschließlich Entwicklungsrechner. - -## Tatsächlich lokal geprüft - -Isolierter Offline-Buildcontainer aus dem vorhandenen Image -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. -Private eingefrorene Quellkopie mit nur Domain/Handoff/Linuxport als -Workspacemembers, unveränderten Dependencyversionen; der private Lock wurde -dort offline aufgelöst, ursprünglicher Workspace/Lock durch diesen Subagenten -nicht verändert. Eigener Targetpfad `devstate/agent-updater-linux/target`. - -Bestanden: Releasebuild und **4/4** Prüfungen, keine Skips/Filter, Clippy mit -`-D warnings`, Formatcheck. Die beiden echten OSprüfungen betreffen ausschließlich -neue private `/run`-Unitfixtures und einen eigenen gehaltenen Sleep-Prozess: -Symlink-/Namensersatz-/Modusverweigerung, erhaltene gebundene Hardlinks, -PID-/Geburts-/Image-/Konten-/Exitbindung und ursprüngliche Deadline. Der dritte -Fall verweigert übergroße, doppelte, unbekannte und ungebundene IPCfelder. -Der vierte nutzt ausschließlich ein lokales Unix-Socketpaar und belegt, dass -fragmentierte Nachrichten die feste Gesamtlesefrist nicht durch einzelne -erfolgreiche Bytes verlängern können; es läuft kein lauschender IPCserver. -Die ursprüngliche Jobfrist begrenzt dabei auch jeden einzelnen blockierenden -Socketaufruf; der zweite Teilfall belegt die kürzere Jobfrist gegenüber der -längeren Framefrist. -Dabei fand er einen echten Serde-Fehler: eine leere Unitvariante ignorierte -Zusatzfelder; die strikte leere Structvariante ist korrigiert und nachgeprüft. -Erster Compilerlauf meldete einen mehrdeutigen `File::by_ref`; typisiert -korrigiert. Clippy forderte einen typisierten Stagingdescriptor statt acht -einzelner Argumente; kein Lint wurde unterdrückt. - -Keine lokale oder native Dienst-/IPCserversitzung, kein Aufruf von Systemd, -kein Zugriff auf echte RMM-Zieldateien, kein Releaseapply und keine VM-Aktion. -Diese Nachweise sind keine Abnahme der noch fehlenden Runtimeintegration. - -Der create-only Nachweis liegt privat unter -`devstate/agent-updater-linux/qualification-19449c78-6919-4e25-8750-cd3c450fb68e/`. -Er bindet die tatsächlich verwendete eingefrorene Quellkopie, Befehle, -Exitcodes und stdout/stderr. Linuxport-Quellsatz: -`699276d3d3e467143d8ccf0fcb3b51949d3c2fffb1f7d0f0a167239ea2b10404`; -Receipt: `ff569473d0ca8179948429f1fc78404e09c1666e4053b6efe672edf079696adc`; -qualifiziertes lokales Unitbinary: -`25e9de040b8a461291efb9566c02b6b3c2cb98d032ae8d071278dbbc0b2642cf`. -Der frühere lokale 3-Fälle-Nachweis bleibt unverändert als historischer Stand -erhalten und qualifiziert diese neuere Quelle nicht. - -## Fortschreibung: Same-PID-Exec-Gegenbeleg und Korrektur - -Der unabhängige Review fand, dass `HeldProcess::verify` zunächst nur das alte -gehaltene Image erneut hashte. Ein `execve` im gleichen Prozess blieb dadurch -unentdeckt. Die Korrektur bindet das aktuelle Kernel-Exeziel vor und nach dem -Hashen an den ursprünglichen Dateizeugen und prüft die übrige Prozessidentität -erneut. Es gibt keinen Prozessnamen-/PID-Fallback oder gelockerten Proc-Zugriff. - -Die neue echte OSprobe startet ausschließlich einen eigenen Bashprozess, -öffnet dessen pidfd/Image/Geburts-/UID-/GIDzeugnisse und lässt ihn über seine -eigene Pipe nach `/usr/bin/sleep` execen. Ein neuer unabhängiger Zeuge bestätigt -dieselbe PID, Geburt und Konten, ein weiter lebendes pidfd sowie den tatsächlich -geänderten Imagehash. Der alte Zeuge muss verweigern. Die Kindumgebung ist -geleert; ein RAII-Wächter beendet und wartet ausschließlich dieses eigene Kind -auch bei einem Testpanic. Keine RMM-Dienste oder fremden PIDs werden berührt. - -Tatsächlich lokal ausgeführt, isolierter Offlinecontainer mit eingefrorener -Domain-/Handoff-/Linuxport-Quellkopie: korrigiert **5/5 ohne Skips/Filter**, Clippy -`-D warnings` und Formatcheck bestanden. Danach wurde ausschließlich in dieser -privaten Kopie `process.rs` durch die Originalquelle des erhaltenen4er-Belegs -ersetzt. Die neue Execprobe scheiterte erwartungsgemäß mit Exit101 genau an -`held.verify().is_err()`. Nach Rückkehr zur korrigierten Quelle bestanden erneut -alle5Fälle. Das ursprüngliche4er-Receipt und dessen Binärdatei bleiben erhalten. -Enger unabhängiger Re-Review des Fixes und seiner Belege: **PASS**. - -Neuer create-only Beleg: -`devstate/updater-linux-execfix-aa106c58-8c96-4c8a-8490-635b1d143f07/receipt.json`, -SHA256 `f705ba03e5043a411fc3a0642197fc4f16da8627e1e5cbfbac78ed125ecb650c`. -Finale lokale Unitexe:1538320Bytes, SHA256 -`b11b57e6399dcfcfb255619a8fba558beea6a57e4f1ee997ee9c63c769a1e882`. -Snapshot und ursprüngliche Logs einschließlich des erwarteten Gegenfehlers -bleiben privat erhalten. Nicht ausgeführt: VM, Systemd, IPCserver, Daemon, -Releaseapply oder Deployment. Gerade der tatsächliche Generalhelperkontext -kann andere Proc-/Capabilitygrenzen besitzen; ein isolierter Rootcontainer -qualifiziert diesen noch nicht. Fehlender Proc-/Imagezugriff muss verweigern, -keine Sandboxlockerung aus diesem lokalen Erfolg ableiten. - -## Anschließend tatsächlich auf Cloud-Linux geprüft - -Root führte die eingefrorene finale5er-Unitexe anschließend separat auf der -festgelegten Linux-Cloud-VM als UID0 aus: Fall -`ec030323-85df-4b38-9e70-87be330033c2`, genau5bestanden,0Skips/Filter. -Eine getrennte Same-case-Nachlese war identisch. Keine RMM-Jobs, kein Apply, -keine Dienststeuerung oder Änderung der laufenden Agent-/Helpergenerationen. -Der Fullhelper blieb aktiv, seine Unit weiterhin disabled; daraus folgt kein -Autostartnachweis. Der vollständige von Root veröffentlichte Originalbericht -wird bytegleich übernommen: [Native Linux-OS5](agent-updater-linux-native-results.md) -(Maincommit `c35c440`). Historische lokale Belege bleiben unverändert. - -Das ist ein nativer OS-Unitnachweis, ausdrücklich **keine Qualifikation des -restriktiven tatsächlichen Generalhelper-Dienstkontexts**, der konkreten -IPC-Peers, Engine/Fence oder Releaseaktivierung. Diese Gates bleiben offen. - -## Enges additives Stage-Reopen: lokal6/6, native Folgeprüfung offen - -Nach dem erhaltenen nativen5er-Stand wurde ausschließlich `files.rs` erweitert. -`Staged::reopen_bound` rekonstruiert gehaltene Beobachtungen aus dem geschützten -Originalhandoffbundle: feste Rollenzielverzeichnisse, ursprüngliche Rootdatei, -exakte Stageidentität mit nlink1, gleiche Metadaten und Originalhashes. Bereits -vorhandene previous-/rejected-Namen verweigern; es wird weder geschrieben noch -ein teilweiser früherer Austausch als neuer Stageversuch interpretiert. - -Die zusätzliche echte lokale OSprobe verwendet nur neue öffentliche Dummydateien -in einem eigenen privaten `/run`-Verzeichnis des isolierten Rootcontainers. -Der öffentliche Einstieg verweigert dieses fremde Rollenzielverzeichnis; die -private gemeinsame FD-Prüfung besteht zunächst. Eine namensgleiche Stagekopie -mit gleichen Bytes und anderer Dateiidentität sowie danach ein zusätzlicher -Stagehardlink verweigern jeweils. Kein Agent/Helperdienst, Fremdprozess, Host- -Packageupdate oder RMM-Job wurde dafür gestartet. - -Tatsächlich lokal aus eingefrorenem Quellpaket ausgeführt: Release6/6 ohne -Skips/Filter, Clippy mit -D warnings und Formatprüfung PASS. Neuer Originalbeleg: -`devstate/agent-updater-linux/qualification-os6-0b3c8018-b08f-4917-80b8-0e3169a0f813/receipt.json`, -SHA256 `c3e1ee619ef01630b296aaf7669d04f39ea952b1ec2d7adc1a791f69f6a6ee08`. -Finale Unitexe `qualified-os6-tests`:1555392Bytes, SHA256 -`c78d24d9b3f543fc4eba3fa1d02bf82e72aea26493ae689f2fc82ee1067d33fc`. -OSquellsatzSHA256 `5ad19b05dbc1277d6fdbf29fa3bb852ac00b34d43af94fca3220617662ed45a3`. -Die einzige geänderte OSdatei `files.rs` hat27138Bytes und SHA256 -`f29a89d5e1a6fda9d24e74a0c0d4f2949d82e2e80c0052a11d1e3891467a69b7`. - -Die frühere native5er-Abnahme bleibt historisch und qualifiziert diese neue -Quelle nicht. Für genau diesen neuen6er-Stand ist der tatsächliche Cloud- -VMnachweis noch offen; ebenso tatsächlicher Full-/Updater-Dienstkontext, -geschlossene Readercensus, konkrete Engine und Apply. Ein erfolgreicher lokaler -Reopen verleiht keine Start-, Retry-, Restore- oder allgemeine Readyautorität. diff --git a/docs/agent-updater-native-contracts.md b/docs/agent-updater-native-contracts.md deleted file mode 100644 index 8a70ede..0000000 --- a/docs/agent-updater-native-contracts.md +++ /dev/null @@ -1,91 +0,0 @@ -# Reinen Updater-Prüfkern zuerst auf Cloud-Linux qualifizieren - -Stand 2026-11-14: Runner implementiert, lokal vorbereitet und anschließend vom -Eltern-Orchestrator **auf der Cloud-Linux-VM ausgeführt:9/9 bestanden**. -Dieser Schritt prüft ausschließlich die neun bereits lokal -bestandenen Verifierverträge. Er installiert weder Updater noch Agent/Helper, -öffnet keine Capability und führt keine Update-/Installer-/Skript-/RMM-Jobs aus. - -`deploy/agent_updater_contract_acceptance.py` bindet den unabhängig geprüften -Kerncommit `cc5c93596d0864c526b69a4f7efca805599b6ea1`, bestehende lokale -Qualification, Sourcehashes und unveränderte Testexe. Änderungen an späterer -Dokumentation erzeugen keinen falschen Rebuildbedarf. NativeDriver und die -wiederverwendeten geprüften SSH-/Receipt-Helpers erhalten eigene Sourcehashes. -Ein neuer Driverstand macht alte vorbereitete Manifeste absichtlich ungültig. - -Tatsächlich lokal ausgeführt: - -```text -python3 deploy/agent_updater_contract_acceptance.py --help -python3 deploy/agent_updater_contract_acceptance.py prepare-local --qualification /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater/local-qualification.json -``` - -Das bestehende Testimage wurde **nicht neu gebaut oder erneut ausgeführt**. -Originalbytes wurden create-only in den neuen geschützten Vorbereitungsordner -kopiert. Nur `readelf` lief im gepinnten Offline-Dockerimage. ELF-x64, maximale -GLIBC2.34 und benötigte dynamische Bibliotheken wurden ermittelt; native -Lader-/Ausführungsfähigkeit bleibt bis zum VM-Lauf offen. - -Lokales Manifest: -`devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json`, -SHA256 `a7f0903cea77c36c4d40df5ad486161c10e55bb9a9135629a555ffafd411d521`. -Testexe unverändert1544584Bytes, SHA256 -`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`. -Python-/erzeugte Remotequellsyntax sowie sechs Ergebnis-Verweigerungsfälle, -Readback-ohne-Upload/-Run und fehlendes Native-Opt-in wurden lokal mit -Transport-Mocks geprüft; keine SSH-Verbindung und kein erneuter Unitlauf. - -**Anschließend tatsächlich durch den Eltern-Orchestrator ausgeführt:** - -```text -python3 deploy/agent_updater_contract_acceptance.py linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests -``` - -Der Runner liest erst bei diesem expliziten Aufruf die bereits vorhandene streng -geparste Linuxzugangskonfiguration aus dem Maincheckout. Ausschließlich der feste -Cloudclient als root auf der festgelegten Linux-Test-VM, vorhandener SSH-Key und bestätigter Hostkey sind -zulässig. Keine Zugangsdaten im Argument-/Ergebnispayload oder Chat. - -Remote wird ein neuer rootprivater Fall unter -`/var/lib/rmm-agent-updater-contracts/` einmal angelegt. Die exakt gehashte -Testexe muss vor Start alle neun erwarteten Testnamen melden. Sie läuft mit -geleerter Umgebung, eigener Scratchdirectory, Netzwerknamespace und CPU-/RAM-/ -Outputlimits. Vor dem einzigen Lauf steht der dauerhafte Create-once-Startmarker. -Bei verlorenem Reply niemals `linux` erneut ausführen oder neu hochladen. -Die ursprüngliche UUID steht im lokalen -`devstate/agent-updater-native//intent.json`; anschließend ausschließlich: - -```text -python3 deploy/agent_updater_contract_acceptance.py readback-linux --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-native/prepared-37b4146d-cbef-431a-aa4a-9827841b8482/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case -``` - -Readback liest Ergebnis oder tatsächlichen Teilstatus desselben Falls. Es darf -weder Upload noch Unitstart fortsetzen. Fehlender/unklarer Abschluss bleibt -`verified=false`, `retry_allowed=false`. Erst vollständig geprüfte Original- -Ergebnisse9/9 ohne Skip schreiben `linux-passed.json`. Dieser Nachweis ist auch -dann **nur native Kernqualifikation**, keine erfolgreiche Agentaktualisierung, -WebUI-Abnahme, Windowsqualifikation oder Produktdienst-/Capabilityfreigabe. - -## Tatsächlicher Cloud-Linux-Nachweis - -Rootfall `420d53da-6e34-4e04-b871-0b571d8d3fc4` auf dem festgelegten Cloudclient -der Linux-Test-VM: Der Runner prüfte zuerst die vollständige tatsächliche Liste -der neun erwarteten Tests und führte danach exakt diese neun ohne Skip aus. -Exitcode0, kein Timeout und keine Fehlerausgabe. Geleerte Umgebung, -Netzwerknamespace und unveränderte gehashte Originaltestexe sind im Ergebnis -gebunden. Keine Produktzustandsänderung und kein RMM-Job durch diese Units. - -Der geschützte lokale Beleg `linux-passed.json` neben dem oben genannten -Manifest wurde zurückgelesen und unabhängig gegen erwarteten Fall, -Manifest-/Artefakthashes und alle neun Testnamen geprüft. Proof-SHA256: -`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`. -Die tatsächliche VM-Ausführung erfolgte durch Root; der Verifier-Subagent -führte weiterhin keine eigene SSH-/VM-Aktion aus. - -Damit ist der **reine Linux-Prüfkern nativ qualifiziert**. Der danach getrennt -ausgeführte Windows-GNU-Schritt bestand ebenfalls9/9; tatsächlicher Beleg und -Grenzen stehen in [Windows-Kernqualifikation](agent-updater-windows-contracts.md). -Selbstupdateinstallation, -Releasekatalog/Streamingtransport, feste Plan-/Grant-/WebUI-Bindung, -Updaterprozess und Code-/Pin-Aktivierung/Health/Rollback bleiben unverändert -offen. Dieser Erfolg bescheinigt keinen vollständigen Agent-Autoupdater. diff --git a/docs/agent-updater-passive-catalog.md b/docs/agent-updater-passive-catalog.md deleted file mode 100644 index 85c2d1a..0000000 --- a/docs/agent-updater-passive-catalog.md +++ /dev/null @@ -1,125 +0,0 @@ -# Normaler passiver Releasekatalogcheck - -Stand2026-11-15. Der Linux-Agent ruft den vorhandenen Releasekatalog jetzt aus -seinem normalen `queue_update_observation`-Pfad auf. Dies ist ein passiver -Metadatencheck, kein Artefaktbezug, Staging, Job oder ausgeführtes Selbstupdate. - -## Aufruf, Vertrauen und Grenzen - -Der Collector startet höchstens einen Hintergrundrequest. Erfolgreiche Checks -werden nach24h erneuert; fehlende Konfiguration oder Fehler frühestens nach60s. -35s Gesamtfrist und64KiB Antwortlimit gelten zusätzlich zu den vorhandenen -mTLS-/HTTPgrenzen. Heartbeats, Cancel und SignedSync warten nicht auf HTTP. -Die URL bleibt `/agent/v1/releases/current` am bereits konfigurierten TLSnamen; -der vorhandene Connectoverride ändert ausschließlich das TCPziel. Keine -Weiterleitung, Umgebungsproxy-, System-CA- oder Jobsigner-Ersatzannahme. - -Verwendet werden ausschließlich die bereits vorgesehenen geschützten öffentlichen -Dateien `/etc/rmm-agent-updater/policy.json`, `keyring.json` und -`/var/lib/rmm-agent-updater/installed-record.json`. Eigentümer/Eltern sindRoot, -keine Symlinks oder gruppen-/weltbeschreibbaren Pfade; reguläre Dateien, -ein Hardlink, feste Größenlimits. Gehaltene FD-/Inode-/Metadaten-/Rawbytezeugen -werden nach dem Request erneut geprüft. Es entstehen keine lokalen Dateien, -keine Schlüsselprovisionierung und keine geänderten Dateirechte. - -Policyidentität muss zum vorhandenen Gerätebinding passen. Separater -Releasekeyring, aktuelle Widerrufe/Sequenzbereiche, echte Baseline- und -Releasesignaturen, Linuxplattform, qualifizierter Protokoll-/Statevertrag, -Updaterversion, Fristen und unveränderter Floor werden unabhängig geprüft. -Serverzeit und die zusätzliche unsignierte Manifestansicht ersetzen keine -lokale TrustedClock oder signierten Originalbytes; beide Manifestansichten -müssen übereinstimmen. Fehlende Anker ergeben `not_configured`, Transport-/TLS-/ -Prüfprobleme `unavailable`; gültige Metadaten ergeben `available` oder `current`. - -Dieser enge Erstanschluss akzeptiert als Flooranker ausschließlich die exakten -separat signierten Bootstrap-InstalledRecordbytes. Ein späterer `Updated`-Record -benötigt die noch fehlende unabhängig authentisierte read-only Fullhelper- -Historybeobachtung; bloßes Parsen der neueren Recorddatei erzeugt keine -Vertrauens- oder Floorfreigabe. Eine tatsächliche geschützte Konfiguration muss -für den unprivilegierten Agent lesbar provisioniert sein. Unlesbare Dateien -bleiben ehrlich unavailable; dieser Code lockert keine ACL. - -## Übertragung und Darstellung mit älteren Servern - -Der unveränderte `agent.update`-Snapshot erhält **kein zusätzliches Top-Level- -Feld**. Seine qualifizierte Vorgänger-/Fullpreview bleibt `not_configured`; -Katalogmetadaten sind keine `CandidatePreview` und eröffnen keine Check-/Applycap. - -Der gespeicherte Katalogbericht wird ausschließlich beim ohnehin geplanten -normalen Linuxinventar als begrenzte bestehende Unterbeobachtung -`linux.agent_update.catalog` übertragen. Kein zusätzlicher Basiscollect wird -angefordert. Dieser `linux.base`-/`observations`-Vertrag wird bereits von älteren -Servern angenommen; kein neues Protobuftag und keine neue Servercap sind nötig. -Die äußere Beobachtungszeit bezeichnet das Lesen des Caches. Das innere -`checked_at` bleibt die tatsächliche ursprüngliche Checkzeit und wird beim -Übertragen nicht erneuert. Über72h alte Cachewerte werden nicht neu angehängt. - -Der aktuelle Domain-Ingest validiert zusätzlich den bekannten Berichtstyp, -Qualität, Zeit, Kandidatenform und geschlossene Feldmenge. Altclients ohne diese -Beobachtung bleiben gültig. Die bestehende tenantgebundene Inventoryspeicherung -und Geräte-API transportieren dieselben geprüften Daten. Die WebUI zeigt Status, -echten Checkzeitpunkt, spätere Cachelesezeit und gegebenenfalls Version/Hash als -Text. Sie erzeugt keine Requests oder Bedienung zur Ausführung aus dem Bericht. -Gemeinsame synthetische Codecfixture: -`tests/agent_update/catalog-check-inventory.json`. - -## Tatsächliche lokale Prüfungen - -Im vorhandenen isolierten Rust1.99.1-Buildcontainer, Netzwerk aus: - -```text -cargo test --release --locked --offline -p rmm-agent -p rmm-domain --all-targets -cargo clippy --locked --offline -p rmm-agent -p rmm-domain --all-targets -- -D warnings -cargo fmt -p rmm-agent -p rmm-domain --check -``` - -Abschließend89Tests bestanden,0Fehler/ignorierte/gefilterte im gesamten Lauf -(Agentbinary32, weitere Agentintegration34, Domain23). Clippy und Formatcheck -bestanden. Web55/55 und Typecheck bestanden. Die sechs gezielten neuen Fälle -enthalten echte synthetische Ed25519-Baseline-/Releasebytes und einen tatsächlich -laufenden lokalen mTLS-Testserver mit eigener CA/Geräteidentität: fester Pfad, -Clientzertifikat, Antwort-/Redirect-/Größenverweigerung, Floor/Protokoll/Schema/ -Ablauf/Keywiderruf, fehlender Anker, falsche Baseline und unzulässige Recordbytes. -Der Wirefall durchläuft echte Protobufbytes bis zum tatsächlichen -`validate_for_scope`; UI und Rust benutzen dieselbe statische Datenfixture. - -Zusätzlich wurde exakt der positive Kompatibilitätsfall mit dem ursprünglich -unveränderten Ingestvalidator aus `c1d8eea` als privatem Datei-Mount ausgeführt: -1/1 bestanden. Nach diesem Altvalidatorlauf schlug ein nachfolgender Negativfall -zunächst fehl. Nach gezieltem Bereinigen der beiden betroffenen Pakete im eigenen -Buildcache und vollständigem Neubuild bestand der gesamte89er-Lauf. Die -Altvalidator-, erste Fehler- und abschließenden Logs bleiben getrennt erhalten; -der fehlgeschlagene Lauf ist kein Erfolgsbeleg. Ein erster unbenutzter Import -wurde ohne Warnungsunterdrückung korrigiert. - -Der öffentliche Datei-Guardtest benötigt keinRoot: Unprivilegiert beweist er die -Verweigerung des eigenen unprivilegierten/beschreibbaren Pfads. Nur der gesonderte -lokale Rootlauf prüft zusätzlich ein eigenes geschütztes positives Dateifixture. -Keine ungekennzeichnete Rootpflicht im neuen Test. Lokale Belege: -`devstate/updater-passive-catalog-d86dc473-3e5f-48d4-a196-3a0d618a8e4e/`. - -## Tatsächliche Cloud-Linux-Qualifikation - -Root führte auf der festgelegten Cloud-Linux-Test-VM am2026-11-15 um13:07:09UTC -exakt die sechs `agent_update_catalog::`-Fälle alsUID65534 aufx86-64 aus: -6bestanden,0Fehler,0ignorierte,26übrige Tests bewusst gefiltert, Exit0, -0stderr-Bytes. Der unprivilegierte Datei-Verweigerungszweig ist hierbei geprüft; -der privilegierte positive Dateizweig stammt ausschließlich aus dem lokalen -Rootlauf. mTLS verwendet auch auf der VM nur den eigenen Loopback-Testserver. -Dies ist kein Katalogabruf durch den installierten Produktagenten gegen den -Internetserver, keine Clock-/Fullhelper-/Applyqualifikation und kein Windowsbeleg. - -Exakte Testbinary-SHA256: -`e8fc4249db06510b6b680f5ddf7e1d539305c54741d1dea2fdc348883f205956`. -Erhaltener privater nativer Beleg: -`devstate/updater-passive-catalog-linux/4f3e5a4b-98a9-4acf-9106-dcdd4d5d1823/result.json`, -SHA256 `332c8903506bf17fa8c9a9a0f512bb64ad82867513d2885359a54a80e4750e6d`. - -## Nächster tatsächlicher Lieferweg - -Noch offen sind der qualifizierte read-only Fullobserver für aktuelle -Vorgänger-/Pin-/Historypreview, die normale unverbrauchte Fulladmission, -Agent-/Helper-Artefaktstaging vor Handoff, stabiler Updaterbootstrap und der -vollständige dauerhafte Rückweg. Agent `supported/accept` und Fullpolicy geben -weiterhin keinen Updatejob frei. Es wurde kein Agent installiert, Dienst -geändert, Code getauscht, Job angelegt oder genehmigt. Notebook nur Entwicklung. diff --git a/docs/agent-updater-proposal.md b/docs/agent-updater-proposal.md deleted file mode 100644 index cb043a4..0000000 --- a/docs/agent-updater-proposal.md +++ /dev/null @@ -1,526 +0,0 @@ -# Agent-Selbstupdate: kleinster zusätzlicher Schnitt - -Stand 2026-11-14, **Integrationsvorschlag mit implementiertem reinem Prüfkern**, -keine neue Produktnorm und kein Installations-/Applynachweis. Die reinen -Linux-/Windows-Kernnachweise sind unten getrennt verlinkt. Basis: -Spezifikation1.19, Kapitel0,4,13,16,19,22,25. -Der User möchte den Agent-Autoupdater jetzt parallel zur Skriptkonsole. Damit -wird ausschließlich dieser Teil aus M7 vorgezogen; Restore, HA, Relay und Lasttest -werden dadurch keine zusätzlichen MVP-Aufgaben. APT-/MSI-Fixturerezepte verwalten -andere Software und implementieren **keinen Agent-Selbstupdater**. - -## Verhalten und Genehmigung - -Der installierte Agent prüft regelmäßig, ob ein passendes, freigegebenes Release -vorliegt. Der erste Vorschlag ist ein täglicher passiver Metadatencheck mit -Jitter, zusätzlich beim Prozessstart, über den bereits konfigurierten Server. -Dies sammelt ausschließlich feste Release-Metadaten und startet keinen Job, -Installer, Download beliebiger URLs oder Codewechsel. Fehlende Konfiguration -meldet `not_configured`, abgelaufene Metadaten `unknown` samt Zeitpunkt/Fehler. - -Ein Update erhält eine eigene typisierte Aktion `update_agent`. UI/MCP dürfen -einen festen Plan vorbereiten und als `pending_approval` beantragen. Der Plan -bindet pro Gerät Release-Manifesthash, Artefakte, exakten Vorgänger, Plattform, -Versuch, Frist, Parallelitätsgrenze und erlaubte einmalige Wiederherstellung. -WebUI-Genehmigung, aktuelle Startprüfung und dauerhafter Einmalverbrauch bleiben -erforderlich. Ein Mensch kann einen festen Rollout gemeinsam genehmigen; -`latest`, zukünftige Versionen, Wildcardziele und periodische Selbstfreigabe -sind keine zulässigen ausführbaren Parameter. `updates:apply` wird zusätzlich -zu den jeweiligen Root-/SYSTEM-Rechten geprüft; eine Policy begrenzt nur. - -Der UI-Text muss Agent-/Helper-Dienstunterbrechung und mögliche Management- -Unterbrechung anzeigen. Dieser Schnitt fordert keinen Hostreboot an und darf -keinen Installer wählen, der ungeplant neu startet. Notwendiger Hostreboot -verlangt einen eigenen festen genehmigten Job. Automatischer Versionscheck, -freigegebener Rollout und bestätigter Updateerfolg bleiben getrennte Zustände. - -## Festes Releaseformat1 - -Ein Release besteht zunächst aus genau zwei Rohdateien: Agent und privilegierter -Helper. Kein Archiv, Postinstall-Skript, freier Pfad oder beliebiges Kommando. -Linux verwendet `x86_64-unknown-linux-gnu`, Windows -`x86_64-pc-windows-msvc`. Die Plattformkennung ist eine geschlossene Auswahl. -Ein neuer Updater selbst ist **nicht** Teil dieses ersten Selbstupdatepfads. -APT-/MSI-Pakete können später denselben signierten Vertrag umschließen; der -erste Rohbinaryschnitt darf nicht als APT-/MSI-Upgrade beworben werden. - -Das Envelope enthält `schema_version=1`, `key_id`, `payload_bytes` und -`signature` (feste Ed25519-Signatur,64Bytes). Für JSON-Transport werden -`payload_bytes` und `signature` als kanonisches Base64url ohne Padding übertragen, -keine unbeschränkten Zahlenarrays. Der erste Bibliothekskern nimmt bereits -dekodierte begrenzte Bytes entgegen; die spätere Transportintegration muss das -Envelope vor Decodierung begrenzen. Der Payload ist streng typisiertes -JSON mit festen Feld-/Listenreihenfolgen, ohne unbekannte Felder, doppelte Keys, -Floats oder alternative Encodingform. Nach Parsen muss exakt dieselbe kanonische -Serialisierung entstehen. Signaturbytes sind die Domäne -`rmm.agent-release.v1\0` gefolgt von den unveränderten Payloadbytes. Der -Manifesthash ist SHA256 derselben Payloadbytes. Verifikation begrenzt das -Payload vor Parsen auf16KiB und verwendet `verify_strict` aus dem schon gepinnten -`ed25519-dalek=2.2.0`; keine Algorithmusverhandlung. - -| Payloadfeld | Festgelegte Bedeutung | -|---|---| -| `schema_version` | Genau1 | -| `release_id` | UUID; unveränderlicher veröffentlichter Datensatz | -| `release_sequence` | Positive monotone Veröffentlichungsnummer je Plattform; Versionsvergleich nutzt diese Nummer | -| `version` | Sichtbare nichtleere ASCII-Versionskennung; kein lexikografischer Semververgleich | -| `platform` | Eine der beiden festen x64-Plattformkennungen | -| `published_at`, `expires_at` | UTC-Epochsekunden, gültig nur mit vertrauenswürdigem Clockkontext | -| `protocol_major` | Exakte unterstützte Hauptversion; die erste Stufe erlaubt nur dieselbe aktuelle Version | -| `state_schema` | Exakte kompatible Zustandsversion; erste Stufe erlaubt **keine** Zustandsmigration | -| `minimum_updater_version` | Positive numerische Implementierungsversion des unabhängigen Updaters | -| `artifacts` | Genau Agent, danach Helper; je `role`, unveränderliche `artifact_id`, SHA256 und Länge | - -Artefakthashes sind64kleine Hexzeichen; Längen positiv und höchstens256MiB pro -Datei. Artefakt-UUIDs dürfen nicht doppelt sein. Rollen sind `agent` und `helper`, -keine eigenen Dateinamen aus dem Netzwerk. Die Veröffentlichung ist erst -verfügbar, wenn beide vollständigen Dateien existieren und deren Hash/Länge -mit dem signierten Manifest übereinstimmen. Serverkatalog und Tenantberechtigung -bestimmen Sichtbarkeit; das Manifest selbst verleiht keinerlei Ausführungsrecht. - -## Vertrauen, Ablauf und Versionsschutz - -Update-, Job-/Grant- und Geräte-/TLS-Schlüssel sind getrennt. Lokaler Bootstrap -provisioniert einen root-/SYSTEM-geschützten Update-Keyring mit SHA256-Key-ID, -rohem32Byte-Publickey, Plattformbindung und zulässigem Sequenzbereich. Kein -Schlüssel aus einem Job, Manifest oder Download wird automatisch vertrauenswürdig. -Veraltete/gesperrte Keys verweigern auch eine ansonsten passende Signatur. - -Erste kleine Stufe unterstützt Rotation/Widerruf durch kontrollierte, separat -provisionierte Keyringgeneration; neue Generation muss größer sein, alte -Schlüssel werden nicht implizit übernommen. Dynamisches Online-Rootrotation- -Protokoll ist noch offen und wird nicht als TUF-Implementierung ausgegeben. -Dies hat eine konkrete Grenze: Ein lange isolierter Client kennt einen späteren -Widerruf erst bei frischer authentisierter Trustprovisionierung. Daher beginnt -ohne frischen Kontakt und aktuellen Trustkontext kein Apply. - -Lokal gibt es getrennt (a) die aktuell aktive Manifest-ID/Sequenz, (b) die höchste -erfolgreich aktivierte Sequenz als Antirollbackgrenze, (c) den höchsten gesehenen -Katalogstand für Replaydiagnose und (d) einen offenen Übergabeintent. Bloßes -Ansehen eines neuen Releases autorisiert keine Wirkung. Ein älteres Release -unter der bestätigten Antirollbackgrenze ist niemals ein neues Updateziel. -Gleiche Sequenz mit anderen Manifestbytes ist ein Konflikt; dieselben Bytes sind -ein Metadatenduplikat, keine neue Wirkung. Versionslabels allein reichen nicht. - -`verify_release` prüft ausschließlich **zukünftige Updatekandidaten**. Nach -einem Code-Rollback (`active=3`, bestätigter Floor=5) verweigert diese Funktion -auch das aktive Manifest3 als erneutes Updateziel. Das bedeutet keine Korruption -oder Ungesundheit der aktuell laufenden Version. Passive Anzeige und Health -verwenden den gesonderten geschützten `InstalledReleaseRecord` mit explizitem -Rollbackstatus; sie dürfen diese Kandidatenprüfung nicht als Current-Healthcheck -verwenden. `SameActiveManifest` ist nur oberhalb/auf dem unveränderten Floor -erreichbar und bleibt ausschließlich ein Metadatenvergleich. - -Die einzige Rückkehr zu einer niedrigeren aktiven Sequenz ist die im selben -genehmigten Versuch vorab gebundene letzte bekannte Codeversion, deren Dateien -noch unverändert lokal vorhanden sind. Die Antirollbackgrenze wird dabei nicht -gesenkt. Widerrufene/ausdrücklich verbotene Vorgänger werden auch als Rollback -verweigert. Ein späteres Downgrade verlangt einen getrennten Recoveryvertrag. - -## Servertransport und UI/MCP-Vertrag - -Vorgeschlagener zusätzlicher lesender Endpunkt: -`GET /agent/v1/releases/current?platform=`, über vorhandenes -Geräte-mTLS, ohne Redirects, höchstens32KiB Envelope, Serverzeit und Katalog- -beobachtungszeit getrennt. Antwort enthält einen signierten festen Manifestenvelope -oder explizites `not_configured`/keine angebotene Version. Kein neuer öffentlicher -Login oder allgemein adressierbarer Installerdownload. Ein veraltetes aber noch -gültiges Manifest ist durch reine TLS-/Hashprüfung allein nicht als aktuellste -Version beweisbar; der Check meldet nur die tatsächlich beobachtete Version. - -Der vorhandene geräte-/Job-/Versuch-gebundene -`/agent/v1/artifacts/{artifact_id}`-Pfad kann derzeit nur Artefakte bis256KiB -beziehen: `LocalArtifacts::put/get` **und** das SQL-`CHECK` in -`migrations/0006_catalog.sql` begrenzen sie entsprechend. Sein512KiB- -Chunklimit erweitert weder Store noch SQL und lädt heute das ganze Objekt in -einen `Vec`. -**Damit kann er Agentbinaries nicht transportieren.** Die bis256MiB großen -Deskriptoren des neuen reinen Prüfkerns sind für eine noch offene, ausdrücklich -Update-spezifische begrenzte Streaming-Erweiterung vorgesehen. Weder Import, -Downloadroute noch Serverlimit werden in diesem Schnitt verändert. Spätere -Integration muss dieselben Geräte-/Job-/Versuchs- und exakten Manifestbindungen -auch für große Streams durchgehend erhalten. Kein vom LLM gelieferter -Downloadhost, TCP-Override, Dateipfad oder TLS-Ausnahmeschalter. -Der zukünftige Download wird gestreamt und vor Verwendung gegen -Länge/SHA256 geprüft; Zusatzbytes und vorzeitiges EOF verweigern. Nach Reconnect -stammt neue Startautorität immer aus dem normalen Plan-/Grantpfad. - -`operations.plan(action=update_agent)` erhält nur die gespeicherte Release-ID -und feste Ziele; Server löst unveränderliche Bytes aus dem berechtigten Katalog -auf und bindet tatsächlichen gespeicherten Vorgänger sowie beide Artefakte. -`operations.submit` bleibt Antrag; `jobs.get` zeigt Staging, Übergabe, -Dienstprüfung, erhaltene Identität, Rollback und tatsächlichen Ausgang. Vor -Genehmigung zeigt WebUI alle Hashes, Versionen, Rechte und Ausfall-/Rollbackgrenzen. -Neue Datenverträge sind mit dem Skriptkonsolen-Eigentümer abzustimmen; dieser -Vorschlag ändert noch keine Domain-/Protokoll-/Server-/Webdatei. - -## Unabhängiger Worker und erhaltende Übergabe - -Der Netzwerkagent bleibt unprivilegiert. Ein kleiner separat installierter -Updater wird unter Root/SYSTEM mit restriktiver IPC/Peerprüfung angesteuert. -Er prüft selbst Releasekey, Manifest, exakten Originaljob/-grant, aktuelle -Identitäts-/Zuordnungs-/Boot-/Clock-/Syncbindung und lokalen Policykontext. -Die schon vorhandenen Helperprüfungen dürfen nicht durch bloßes `approved=true` -oder einen Dateimarker ersetzt werden. Sein eigener Journal-/Verbrauchsbezug -muss vor Start serverseitig bekannt und unabhängig synchronisiert sein. - -Der Updater startet nicht aus der gerade zu ersetzenden Agent-/Helperdatei und -überlebt deren Stop. Geräteweite Locks serialisieren Paketmanager, Updates, -Root-/SYSTEM-Skriptwartung und Reboots. Offene oder unbekannte Versuche sperren -die erste Updateversion; keine Aktualisierung mitten in einer Wirkung. - -1. Exakten Vorgänger, Trust-/Policy-/Serviceidentitäten, freie Kapazität und - Zustandskompatibilität prüfen. Geschützte Stagingdateien create-only auf - demselben Dateisystem; Files und Verzeichniseinträge dauerhaft flushen. -2. Manifest und beide Dateien unabhängig prüfen; keine Wirkung vor Genehmigung. - Ein Downloadfehler vor Übergabe bleibt belegter Nichtstart der Aktivierung. -3. Vor Stop/Swap dauerhaften Intent mit Originaljob/Versuch/Grant und allen - Vorherzeugen schreiben, Grant/Versuch einmalig verbrauchen. Nach unklarem - Ausgang ausschließlich Zustand desselben Intents lesen, nie Execute wiederholen. -4. Dienste geordnet einmal stoppen; aktive handles/Locks und SQLiteintegrität - prüfen. Identitäten, Geräteschlüssel, Zertifikats-/Rotationstore, Konfiguration, - ACLs, DBinodes/FileIDs, Originaltabellen/-zeilen, Journale/Signaturen und offene - Outbox bleiben erhalten. Private Schlüsselbytes werden nicht exportiert. -5. Für den ersten Aktivierungsschnitt empfehle ich **bestehende feste - Service-Imagepfade erhalten**. Der unabhängige Updater stoppt und bestätigt - beide Dienste, tauscht alle gebundenen Code-/Pin-Dateien unter den Locks, - prüft vollständig die neue Kombination und startet erst dann einen Dienst. - So läuft kein altes/neues Paar gleichzeitig, obwohl die Dateiersetzungen - **kein atomarer Dateisystem-Bundleswap** sind. Der dauerhafte Intent benennt - jede bereits erfolgte Ersetzung; ein Absturz lässt beide Dienste bis zum - eindeutig belegten Abschluss oder Code-Rollback gesperrt. Vorhandene Runner - zeigen dieses Wartungsfenster bereits, sind aber noch kein Selfupdater. - Ein neuer Launcher würde Service-PID-/Image-/Peerprüfungen verändern und ist - für diesen ersten Schnitt unnötig. Ein einzelner atomarer Versionsselector - bleibt eine spätere Alternative mit eigener vollständiger Qualifikation. -6. Neue Dienste einmal starten; actual Imagehash/Identität, passive Heartbeats, - bestätigtes Inventar und erfolgreiches signiertes Sync mit geschlossenen - Effectgates bis zum vollständigen Abgleich nachweisen. `Running` allein reicht - nicht. Erst dann aktives Release/Antirollbackgrenze dauerhaft bestätigen. -7. Bekannter Fehlstart darf genau die vorab gebundene Codeversion einmal - zurückselektieren und starten; derselbe aktuelle Datenzustand bleibt liegen. - Keine DB-/Ledger-/Generation-/Clock-/ACLrücksetzung. Fehlender/unklarer - Rückkehrnachweis bleibt `unknown`, keine Schleife automatischer Startversuche. - -Vorhandene SSH-Bootstraprunner (`vm_runtime_upgrade.py`, -`cloud_shared_core_upgrade_v2.py`, `windows/runtime_feature_upgrade.py`) zeigen -nützliche erhaltene DB-/Inode-/FileID-/Schlüsselmetadatenprüfungen und dauerhafte -einmalige Intents. Sie sind administrative Einzeltools, keine ausgelieferten -Selfupdater und keine Ersatzgenehmigung dieses Produktpfads. Frühere fehlerhafte -Verifierberichte bleiben historisch; neue Abnahme muss konkrete aktuelle Daten -binden, einschließlich vorhandener zulässiger Hardlinkpublikationen. - -## Kleinster prüfbarer Quellschnitt und danach offene Arbeit - -Nach Entwurfsreview implementiert: neue kleine `crates/updater`-Bibliothek, -keine Daemonhülle. Dateien `Cargo.toml`, `src/lib.rs`, `src/manifest.rs` und -neun gezielte Vertragsprüfungen mit vollständiger kanonischer Goldenfixture. -Root-`Cargo.toml`/`Cargo.lock` nur für Workspacebindung; keine neuen fremden -Paketversionen. Alle benutzten Abhängigkeiten waren bereits im Lockfile. -Implementierte Funktion: bounded canonical manifest decode, strikte Ed25519-Verifikation gegen -getrennten übergebenen Keyring, Plattform-/Clock-/Kompatibilitäts-/Versionsprüfung -und begrenzte Streaming-Hash-/Längenprüfung von Artefakten. Keine Aktivierung, -kein Netzwerk, keine generische OS-Dateischreib-API. Ein validiertes Objekt -beweist nur gültige Releasebytes; dessen API darf weder Approval noch Startgrant -behaupten oder aus dessen Besitz ein Applyrecht ableiten. - -Der Kern wurde mit echten lokalen Signaturen und manipulierten/alten/falschen -Releasebytes geprüft, ohne einen Agenten auf dem Notebook zu starten. -Danach bleiben explizit offen: Serverkatalog/Veröffentlichung und echter -Releasekeybetrieb, täglicher Agentcheck und gespeicherte Updatebeobachtung, -typisierte Plan-/Grant-/UI-/MCP-Bindung, getrennte Updater-Verbrauchssynchronisation, -geschütztes OS-Staging, unabhängiger Updaterbootstrap, mehrstufiger Dateiaustausch, -Health-/Rollbackpfad, echte Linux-VM-Abnahme zuerst und Windows-VM-Abnahme danach. -Ein Bibliotheksbuild ist weder Autoupdaterinstallation noch AT-26-/MVP-Erfolg. - -Tatsächlich ausgeführt: vollständige Pflichtnormen gelesen und vorhandene -Upgrade-/Kryptoverträge untersucht; eigener isolierter Worktree ab287a784. -Der vorhandene Dockerbuilder mit Rust1.99.1 wurde offline, ohne Netzwerk und -mit nur lesbarem Quellmount verwendet, eigener Targetausgabe. Image-ID: -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. -Alle folgenden Prüfungen bestanden für `x86_64-unknown-linux-gnu`: - -```text -cargo fmt --manifest-path /src/Cargo.toml -p rmm-updater -- --check -cargo clippy --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets -- -D warnings -cargo test --manifest-path /src/Cargo.toml --locked --offline --target x86_64-unknown-linux-gnu -p rmm-updater --all-targets --release -``` - -Neun ausgeführte Vertragsprüfungen bestanden ohne Skip. Sie prüfen feste -kanonische Bytes, echte domänengetrennte Ed25519-Signaturen, falschen/gesperrten -Key und dessen Sequenzbereich, unbekannte/doppelte Felder,16KiB-Grenze, -Plattform/Clock/Trustgeneration/Protokoll/Zustand/Updaterkompatibilität, -Versionsfloor und gleichen Sequenzkonflikt, exakt zwei Artefaktrollen, -Hash-/EOF-/IOfehler sowie512KiB+7Bytes mit tatsächlichem32KiB-Readlimit. -Der verwendete private Testsignierschlüssel ist ausschließlich eine feste -öffentliche Testfixture und wird nie als Vertrauensanker ausgeliefert. - -Lokaler Beleg (gitignored): `devstate/agent-updater/local-qualification.json` -bindet Quellen, Image-ID, tatsächliche Befehle/Loghashes und alle neun Testnamen. -Die Linux-Release-Testexe ist1544584Bytes groß, SHA256 -`e3a1a3140da09de2f86055faa45faf7ba05ddddc2d92d23fef3df03a63bf2999`. -Das ist ein lokaler Container-/Vertragsnachweis, **kein Cloud-VM-Nachweis**. -Der danach durch Root ausgeführte eigene Native-Linux-Schritt bestand9/9 -auf der Cloud-Test-VM, Fall `420d53da-6e34-4e04-b871-0b571d8d3fc4`, -Proof-SHA256 `bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`. -Details und klare Grenzen: [Native Kernqualifikation](agent-updater-native-contracts.md). -Danach bestand derselbe Prüfkern als Windows-GNU-Unitbinary9/9 auf dem -Windowsgast, Fall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`, Proof-SHA256 -`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`; -[separater Nachweis](agent-updater-windows-contracts.md), kein MSVC-/Dienstbeleg. -Serverintegration und tatsächlicher genehmigter Codewechsel bleiben -offen. Kein Installer, keine Dienständerung, keine Freigabe und kein RMM-Job -durch diesen reinen Prüfkern; der Subagent führte keine eigene VM-Aktion aus. - -Zusätzlicher lokaler Reviewstand nach1.20: ein isolierter typisierter -Handoff-/Healthkernel und geschlossener Linux-Fullrenderer sind implementiert, -ohne den qualifizierten Verifier oder Runtime zu ändern. Die tatsächliche -Linuxzieltopologie General+Full+Agent wird ausdrücklich berücksichtigt; -Full bleibt kein pauschaler Ausschluss. Konkreter Vertrag, acht lokale -Prüfungen, notwendige Reviewentscheidungen und weiterhin fehlende Integration: -[Erhaltende Handoffgrenze](agent-updater-handoff.md). Dies ist keine neue -Produktnorm, Zielinstallation oder native Applyabnahme. - -## Nächster Integrationsschnitt zur Freigabe: fester Codepaar-Updatejob - -Die folgende Änderungsliste ist **nur Entwurf, nicht implementiert**. Sie -ersetzt keine Sourcefreigabe, Bootstrapabstimmung oder native Abnahme. Mit dem -Skriptkonsolen-Eigentümer abgestimmt: `update_agent`, `agent.update.apply/1` -und `updates:apply` kollidieren nicht mit `full_maintenance_v1`. Dessen separater -Helperpfad und das allgemeine/APT-Profil bleiben getrennt; alle benutzen dieselbe -geräteweite Wirkungssperre und erhaltene Verbrauchshistorie. - -### 1. Unveränderliche Action und Planbindung - -Vorgeschlagene additive `Action::UpdateAgent { update: ResolvedAgentUpdate }`, -eigener Modulvertrag `crates/domain/src/agent_update.rs`. Kein Aufruf von -`run_script`, APT oder MSI. Alte Action-/Job-/Plan-/Grantbytes bleiben exakt -erhalten. `JobPayload` behält seine bestehenden IDs, Identitätsgenerationen, -Zeitgrenzen und Limits; `ExecutionPermit.action` lautet `update_agent` und -bindet wie bisher den gesamten `job_payload_hash`. Vor Genehmigung erzeugt -der Server die vollständigen Bytes je festem Ziel/Versuch. - -`ResolvedAgentUpdate` hat in dieser festen kanonischen Feldreihenfolge: - -| Feld | Typ und Bindung | -|---|---| -| `schema_version` | Genau1 | -| `profile` | Genau `fixed_code_pair_v1` | -| `release_envelope` | Schema1, Update-Key-ID, Payload/Signatur als Base64url ohne Padding; keine freien URLs | -| `release_envelope_sha256` | SHA256 des kanonischen vollständigen Envelopes, einschließlich Signatur/Key-ID | -| `manifest_sha256` | SHA256 der dekodierten exakten Release-Payloadbytes | -| `predecessor` | Feste Release-ID, Sequenz, Manifesthash, `installed_record_sha256`, Agent-/Helperhash | -| `updater` | Exakter installierter Updaterbinaryhash, lokale Policyhash, Keyringgeneration und Keyringhash | -| `peer_pin_transition` | Typisierte Plattformvariante, feste Vorher-/Nachher-Settings-/Pinhashes; siehe unten | -| `recovery` | Genau `restore_exact_predecessor_once` | -| `health_profile` | Genau `mtls_inventory_sync_v1` | -| `health_timeout_seconds` | Genau180 im ersten Schnitt; gesamter Job maximal600Sekunden | -| `no_reboot` | Genau `true` | - -Die beiden Artefakte und ihre Reihenfolge kommen ausschließlich aus dem signierten -Manifest. `artifact_ids` als zusätzliche Requestparameter sind für diese Action -verboten. Der Plan enthält je Job/Versuch genau die beiden daraus abgeleiteten -`JobArtifactReference`s; generisches Nachladen weiterer Dateien ist verweigert. -Weil die bisherigen Resolver kleine `artifacts` voraussetzen, erhält ausschließlich -`update_agent` einen eigenen Resolver gegen den Updatekatalog. Alte Resolver und -ihre Grenzen bleiben bestehen. Fehlende/doppelte/fremde Referenzen, geänderter -Vorgänger oder ein von der Plattform abweichendes Release sperren bereits Planung -und nochmals Submit, WebUI-Genehmigung, Revalidation, Startgrant und Download. -Der vollständige Job muss weiter in die vorhandene64KiB-Helpergrenze passen. - -Erste Einrichtung importiert die tatsächlich installierte bekannte Codepaar- -Baseline als separat release-signierten Datensatz mit eigener Sequenz, prüft -ihre Dateien und provisioniert daraus `InstalledReleaseRecord` und Floor. -Dadurch besitzt auch das erste Update einen exakten bekannten Vorgänger; kein -`unknown`, frei vom Agenten behaupteter Hash oder ungeprüftes Legacy-Downgrade. -Dies ist Teil des gesonderten erhaltenden Updaterbootstraps, kein Codeupdate. - -Windows benötigt einen festen Pure-Renderer: ausschließlich -`Settings.agent.binary_sha256` und `Settings.helper.binary_sha256` werden aus -den Zielartefakten ersetzt; alle Rechte, Dienste, Identitäten, Pfade, Runtime- -und Clockflags bleiben gleich. Der daraus kanonisch abgeleitete Settingshash -und öffentliche `Pin`-Hash stehen **vor Genehmigung** fest. Grundlage ist ein -typisierter aktueller öffentlicher Deploymentbeleg des bestehenden Helpers, -keine Secretdatei. Der lokale Updater prüft vor/nach unabhängig, dass exakt diese -beiden Felder geändert werden. Der Server darf nur die exakt genehmigte neue -Code-/Policybindung aktivieren; dadurch entstehen keine neuen Aktionsrechte. -Linux verwendet bei unverändert codeunabhängigen Generalpins die Variante -`unchanged_general_pin_v1`. APT-Akzeptanzbelege werden nicht neu signiert oder -als für neue Codebytes gültig ausgegeben; gegebenenfalls bleibt APT geschlossen. -Nicht unterstützte weitere Pinprofile sperren dieses erste Update, statt sie -automatisch mitzunehmen oder neue Akzeptanznachweise zu erfinden. - -### 2. Rechte, Beobachtung und Capability - -Planurheber und Freigeber benötigen jeweils die üblichen Operationsrechte plus -`updates:apply` und Linux `root:execute` beziehungsweise Windows `system:execute`. -`scripts:execute` wird nicht daraus abgeleitet. Eine zusätzliche versionierte -zentrale/local-Updaterpolicy begrenzt exakte Geräte-/Generations-/Principal-, -Updater-/Keyring-/Manifest-/Vorgänger- und Pinbindungen. Standard bleibt deny. -Die WebUI zeigt Ziel und Vorgänger, beide Binärhashes, Rechte, Unterbrechung, -Rollback, Pinänderung und Fristen; MCP verwendet nur Plan/Submit/Status. - -`agent.update.check/1` wird nach tatsächlich funktionierendem reinem Metadaten- -Check gemeldet. `agent.update.apply/1` erst nach nativer aktueller Qualifikation -des installierten unabhängigen Updaters, IPC-/Peer-/Lock-/Ledgerprüfung und -bestätigtem signiertem Sync. Ein Librarybuild erzeugt keine Capability. Check -speichert Quelle, tatsächlich beobachteten Manifesthash, Zeit, Qualität und -`available`/`same`/`not_configured`/`error`; er lädt keine großen Dateien und -legt weder Jobs noch Outbox für Wirkungen an. `rolled_back` beim installierten -Record ist von der angebotenen Kandidatenversion getrennt sichtbar. - -### 3. Begrenzter Releasekatalog und eigener großer Artefaktpfad - -Neue immutable Tenanttabellen `agent_releases` und `agent_release_artifacts` -mit zusammengesetzten Tenant-FKs, RLS/FORCE-RLS und ohne UPDATE/DELETE für die -Anwendungsrolle. Release-ID/Sequenz/Plattform sind eindeutig; Publizieren -verifiziert Signatur, kanonische Bytes, Rolle, Länge und Hash beider Dateien. -Keine Änderung am262144Byte-`CHECK` der bestehenden `artifacts`-Tabelle. -Ein tenantgebundener `AgentReleaseStore` arbeitet mit bereits geprüften -content-addressierten, unveränderlichen Objekten und begrenzten Readhandles; -kein `get()->Vec` für bis256MiB. Publikation ist ein Plattformbetriebsrecht, -kein vom Modell befüllbarer allgemeiner Upload-/Signierdienst. - -Neuer `GET /agent/v1/update-artifacts/{artifact_id}` mit `job_id`, `attempt_id`, -`offset`, `length`: Geräte-mTLS, genau genehmigter aktueller `update_agent`-Job, -aktuelle Tenant-/Geräte-/Generations-/Rechte-/Planbindung und exakt eine der -beiden Referenzen. Jeder Chunk prüft diese Bindung erneut; höchstens512KiB, -Gesamtobjekt höchstens256MiB, begrenzte Parallelität/IOzeit und kein Redirect. -`Content-Range`, Gesamtgröße und SHA256 sind an den Deskriptor gebunden. -Server verifiziert Objektidentität/-länge vor Read und streamt begrenzt; -Agent/Updater prüft unabhängig den vollständigen Gesamt-SHA256 und exaktes EOF. -Nach Antwortverlust dürfen nur fehlende Downloadbytes desselben geschützten -Stagingobjekts weiterbezogen werden, niemals ein neuer Installer-/Aktivierungs- -versuch. Eine fortgesetzte Datei wird vor Verwendung vollständig neu gehasht. - -### 4. Stabiler Updater, einmalige Übergabe und Absturzverhalten - -Separat bootstrapped stabiles Updaterbinary; dieser erste Updatejob verändert -es nicht. Feste Linux-UID-/Windows-Dienst-SID-/PID-/Image-/ACLprüfungen, keine -vom Agenten gewählten Programme/Pfade. Bestehende Agent-/Helper-Servicepfade -bleiben erhalten. Alle tatsächlich installierten Profile, die dieselbe -Helperbinary verwenden, müssen im fest provisionierten Dienstset stehen und -vor Austausch bestätigt gestoppt sein; unbekanntes Profil verweigert. Der -Updater gehört selbst nicht zu diesem Stopset. - -Die erste Empfehlung ist **denselben bestehenden Helperverbrauchsledger und -`executor.lock`** zu verwenden, wie heute schon mehrere Helperprofile, statt -einen ungebundenen neuen Ready-/SQLitepfad zu eröffnen. Bootstrap fügt nur eigene -append-only Updateintents hinzu, ohne alte Zeilen/Schemaobjekte zu ersetzen. -Updater prüft seinen aktuellen Prozess-/Boot-/Clock-/Signatur-/Syncbezug selbst; -ein anderer Prozess vererbt keine Bereitschaft. Ob der vorhandene gemeinsame -Helpersnapshot dies ohne Wireerweiterung vollständig bindet, ist vor Runtime- -Code anhand `HelperSync`/`ExecutorLedgerGuard` zu prüfen. Falls nicht, bleibt -Apply geschlossen bis zu einer separat versionierten Participantbindung; -kein weiterer Journal-ID-Slot wird stillschweigend in alten Tags versteckt. - -Der Updater darf seinen eigenen Updateversuch nach Verbrauch als einzigen -offenen Versuch führen; jeder **andere** offene/unknown-/unsettled-Versuch -sperrt. Root-/SYSTEM-Wartungsskripte und Paket-/Rebootwirkungen verwenden -dieselbe Sperre. Nach Übergabe überlebt der Updater Agent-/Helperstop und -journalisiert im eigenen erhaltenen Intent die folgenden Phasen: - -| Phase | Dauerhafter Beleg und zulässige Folgerung nach Absturz | -|---|---| -| `staged_verified` | Nur geprüfte Dateien vorhanden, noch kein Stop/Swap; Nichtstart nur mit unabhängig belegtem Nichtdispatch | -| `handoff_consumed` | Originaljob/Grant/Versuch und vollständige Vorherzeugen fest, kein zweites Execute | -| `stop_intent` / `all_stopped` | Einmaliger Stop angekündigt/bestätigt; unklare Dienste erst lesen, nicht blind erneut stoppen/starten | -| `replace_intent(role)` / `replaced(role)` | Jede einzelne Code-/Pinersetzung bindet Original-/Zielhash, ACL und retained Backup; tatsächliche Datei entscheidet über Teilzustand | -| `pair_verified` | Gesamtes neues Code-/Pinset vollständig geprüft, vor jedem neuen Dienststart | -| `start_intent(service)` / `started(service)` | Jeder Start nur einmal, tatsächliche SCM-/systemd-/PID-/Imagebelege, kein Retry bei verlorenem Reply | -| `health_verified` | Neues mTLS, tatsächlicher Codepaarbeleg, Inventar-ACK und signierter Sync für selben Originalversuch innerhalb180Sekunden | -| `rollback_intent` / `rollback_verified` | Ausschließlich gebundene Originalcode-/Pinbytes einmal zurück, gleicher aktueller Datenzustand und unveränderter Floor | -| `outcome_persisted` | Originalerfolg oder bekannter Fehlstart samt Rollbackresultat dauernd gespeichert; unverändert bis ACK erneut übermitteln | - -Anwendungsweite Effectgates bleiben während Wechsel und Health geschlossen; -der eigene bereits verbrauchte Updateversuch darf gezielt abgeglichen werden, -ohne dadurch neue allgemeine Starts zu erlauben. Sonst würde die eigene offene -Updatezeile Health-Sync dauerhaft blockieren. Nach frischem Prozessstart ist -kein alter Gate-/Leasezustand gültig. Ein unbekannter Teiltausch/Start bleibt -`unknown`; Recovery liest vorhandene Dateien/Intents und darf daraus keine -neue Wirkungserlaubnis konstruieren. Allgemeines Resume bei ungeklärtem -Dispatch und Endlosschleifen automatischer Rollbacks gehören nicht dazu. - -### 5. Konkrete Datei-/Abnahmefolge nach erneutem Review - -| Lieferung | Geplanter enger Dateiscope und überprüfbares Ergebnis | -|---|---| -| Gemeinsamer Vertrag | Additives `domain/src/agent_update.rs`, zugehörige `Action`-Matches und Golden-/Legacyfixtures; `updater` bleibt eigenständiger Verifier, keine OSwirkung | -| Katalog und feste Planung | Neue Migration, `server/src/agent_releases.rs`, eigener Store/Streaminghandler, begrenzte Ergänzungen in `jobs`, `job_gateway`, Policy und MCPschema; alte Paketlimits bleiben bestehen | -| Passive Agentbeobachtung | Bestehende Transport-/Inventarworker ergänzen festen Releasecheck und gespeicherte Beobachtung; keine angeforderte Liveaktion als Telemetrie tarnen | -| Geschlossener Updaterworker | Neues unabhängiges Binary/OSadapter und versionierte Bootstrapdefinition, feste IPC/Locks/Ledger/Intents/Pinrenderer; keine offenen neuen Capabilities vor Qualifikation | -| Linux-Abnahme zuerst | Reine Kernunits nativ auf Cloud-Linux; danach ein fixes WebUI-genehmigtes Update samt getrennten belegten Fehler-/Redelivery-/Stateerhaltungsfällen | -| Windows danach | Native Kern-/IPC-/SCM-/Pin-/Codepaar-/Rollbackabnahme auf Windowsgast, dieselbe WebUI-/Tenantgrenze; keine Notebookdienste | - -Vor Runtimefreigabe sind vor allem gemeinsamer Syncteilnehmer, exakt erlaubte -Pinprofile und erfolgreiche Health bei ausschließlich eigenem offenen -Updateversuch zu entscheiden. Diese Liste enthält keine neue Terminalengine, -generischen Paketprovider, Keyrotationplattform, Restorefunktion oder weiteren -Produktumfang. Alle genannten Dateien/Befehle/Abnahmen dieses Abschnitts sind -**geplant, nicht ausgeführt**. - -## Geprüftes Runtimegate: eigener offener Versuch und Health - -Sourcebefund, **Entwurf ohne Produktänderung**: `HelperSync::apply` in -`crates/agent-core/src/helper_reconcile.rs:482` darf einen gültigen negativen -signierten Abgleich dauerhaft übernehmen. Die Startlease bleibt geschlossen: -`apply_inner` verlangt definitive Outcomes für sämtliche Zeilen und -`can_start` zusätzlich null offene `consumed.result IS NULL`-Zeilen -(`:575`, `:666`, `:696`). Deshalb darf Update-Health niemals allgemeines -`ready=true` voraussetzen oder trotz eigener offener Zeile erzeugen. - -Der normale Wiederabgleich macht gestartete unvollständige Versuche bewusst -unknown (`agent-core/src/reconcile.rs:233`, `server/src/synchronization.rs:717`) -und `ClientSync::confirm_helper` verweigert offene Helperwirkungen (`:127`). -Dies zu ignorieren wäre keine Healthimplementierung. Benötigt wird ein neuer, -ausdrücklicher **dauerhafter `pending/inflight`-Handoffvertrag** des genau -genehmigten Updateversuchs. Er muss kontrollierte Eigentümer-/Prozessübergaben -von einer tatsächlich unklaren Wirkung unterscheiden, ohne frühere Unknown- -Events, definitive Unknown-Outcomes, Startzeugen oder Deadlines umzuschreiben. -Fehlender Owner-/Handoff-/Zeitnachweis bleibt unknown und geschlossen; ein -späterer Healthbeleg heilt ihn nicht und berechtigt keinen erneuten Start. - -Windows hält `LedgerGuard` während der gesamten Helper-Dienstlebensdauer -(`agent-windows/src/helper_system.rs:222`, `:822`). Der separate Updater kann -denselben echten Lock daher nicht gleichzeitig erwerben und über den neuen -Helperstart halten. Empfohlener enger Pfad: alter Helper prüft Originalgrant -und verbraucht genau einmal, speichert immutable Delegations-/Ownerintent; -stabiler Updater übernimmt denselben Ledger ausschließlich während bestätigtem -Helperstop, prüft/tauscht Code+Pins und gibt die Ownership vor dem neuen -Helperstart ausdrücklich zurück. Der neue Helper hält danach wieder seinen -bestehenden Guard. Kein globaler Umbau zu schwächeren Locks pro Einzelrequest. - -Vorhandene IPC vertraut ausschließlich dem Netzwerkagenten: Linux verweigert -Root-Peers ausdrücklich (`privileged-helper/src/main.rs:92`), Windows bindet -Agent-Service-SID/SCM-PID/Peerimage (`agent-windows/src/helper_ipc.rs:227`). -Ein Updater darf sich nicht als dieser Agent ausgeben. Er benötigt eine neue -eng typisierte **lokale Participantbindung** mit festem eigenem Dienst, -UID/SID, tatsächlichem PID-/Image-/Prozessgeburts-/Policybeleg und ausschließlich -Original-Handoff, Healthbezug und Finalisierung dieses einen Versuchs. Root -oder SYSTEM allein sind kein ausreichender Peerbeleg. Bestehende ACL-/FileID- -Prüfungen dürfen dabei nicht stillschweigend gelockert werden. - -Gemeinsames erhaltenes Helperledger und aktueller Sync-Wirevertrag reichen für -die Historie grundsätzlich; eine zweite ungebundene Server-Journal-ID ist -für diesen Pfad nicht erforderlich. Ein negativer aktueller SignedSync ist -nur Kontrollkettennachweis. Zusätzlich vorgeschlagen: ein **evidenz-only** -signierter `UpdateHealthReceipt` mit eigener Domäne, Originalplan/Job/Versuch/ -Grant, Manifest/Codepaar/Pins, Ownernonce, Boot/Verbindung, tatsächlich -angewandtem SignedSync und frisch serverseitig gespeicherten Inventarbelegen. -Er ist weder ExecutionPermit noch Startlease, reaktiviert keine Genehmigung -und verlängert weder Originalstart- noch Health-/Gesamtdeadline. - -Erst nach unabhängigem lokalem Code-/Peer-/Intenterhaltungsnachweis und gültigem -Receipt dürfte der neue Helper das **noch ausstehende ursprüngliche** definitive -Outcome create-once speichern. Originale Signaturen/Events bleiben erhalten; -generisches Ersetzen eines vorhandenen Unknown-Outcomes ist ausdrücklich -ausgeschlossen (`ledger::persist_outcome`/Completion-CAS). Anschließend sollen -vorhandene Helper→Agent-Spiegelung und normaler signierter Abgleich die gleiche -Outcome-Bytefolge übernehmen und gezielt entsperren -(`agent-core/src/reconcile.rs:898`, `helper_reconcile.rs:616`). Die vorhandenen -Reboot-Sonderregeln für geänderte Outcomebytes werden nicht auf Updates -verallgemeinert (`helper_reconcile.rs:1312`, `reconcile.rs:1237`). - -Vor Applycode sind Pending-/Inflight-Lebenszyklus, Ownershipwechsel, neue lokale -IPC-/ACLbindung und die rein beweisende Receiptsemantik normativ zu prüfen. -Dieser Befund ist **keine Freigabe oder Implementierung** dieser Erweiterungen. diff --git a/docs/agent-updater-reader-census-results.md b/docs/agent-updater-reader-census-results.md deleted file mode 100644 index f03816b..0000000 --- a/docs/agent-updater-reader-census-results.md +++ /dev/null @@ -1,108 +0,0 @@ -# Linux-Readercensus: lokaler Quellenstand und geplanter nativer Nachweis - -Stand2026-11-15, Spezifikation1.22. Keine Zielinstallation, Dienständerung, -RMM-Ausführung oder Applyabnahme wurde in diesem Arbeitsschritt vorgenommen. -Die WebUI-Genehmigungsgrenze bleibt unverändert. - -Registry und Census sind mit der vorhandenen Worker-Enginequelle verbunden. -Die Registry bindet Originalrohbytes, Bootstrapreceipt, Readervertrag, -Hostnamespaces und exakte Unit-/Dropinkomposition. Aktuelle TGIDs und sämtliche -Task-FD-Tabellen werden begrenzt und erneut auf Identität geprüft; auch eine -Datei mit geschlossenem FD bleibt über ihren mmap-Inode ein Reader. Unbekannte, -unlesbare, wechselnde oder unvollständige Beobachtungen verweigern. Fremde -Cmdlines, Umgebungen und map-Pfade werden nicht ausgegeben. - -Der vorhandene Root-Executorflock und die ursprüngliche Agent-Singletonsperre -bleiben beide unter dem nicht frei konstruierbaren `ClosedReaders`-Beleg gehalten, -bevor der Updater SQLite öffnet. Der Readervertrag fordert außerdem den -Roothelperflock vor seinen SQLiteöffnungen und jeder SQL-/Effektoperation und -die Agent-Sperre lebenslang vor beiden Agentdatenbanken. Dies ist kein globales -Versprechen über zukünftige privilegierte Fremdprozesse. - -## Tatsächlich lokal geprüft - -Im isolierten Offline-Rustcontainer, Quellmount read-only, unveränderte -Docker-Seccomp-Policy, eigene tmpfs für `/run`, `/tmp` und `/var/lib`: - -- Locked all-targets Check, Release-Link, Clippy `-D warnings`, Formatcheck: PASS. -- Vollständige Release-Workerliste10, tatsächlich10bestanden,0Fehler, - 0ignoriert,0gefiltert. -- Die Prozessfixtures belegen bestehende FDs, anschließend mmap nach FDclose - sowie einen Reader in einer privaten FD-Tabelle eines einzelnen Threads. - Der TGID-only-Gegenfall findet diesen Threadreader ausdrücklich nicht; - die vollständige Taskprüfung findet ihn. - -Der erste Lauf unter `reader-census-ba31b221-79c4-4702-b6d6-09bb94bba7fc` -bestand9/10. Der eigene Threadfixture wurde am Docker-Seccomp-Verbot für -`unshare(CLONE_FILES)` mit EPERM abgewiesen. Ausschließlich im Testfixture wurde -stattdessen `close_range(UINT_MAX,UINT_MAX,CLOSE_RANGE_UNSHARE)` verwendet: -die gleiche eigene FD-Tabellenseparation, ohne eine tatsächlich mögliche -FDnummer zu schließen. Keine Sandboxregel, Capability oder Produktionsprüfung -wurde gelockert. Die Produktionsbytes vor `#[cfg(test)]` blieben identisch. -Die Semantik folgt [close_range(2)](https://man7.org/linux/man-pages/man2/close_range.2.html). -Der ursprüngliche Fehlerbeleg bleibt erhalten. - -Finaler eingefrorener Privatfall: -`devstate/agent-updater-worker/reader-census-final-da31051b-269f-4fb5-947d-94c8ad162c2a/`. -Er enthält71Originalinputs mit Vor-/Nachhashprüfung, alle Logs und das tatsächlich -lokal ausgeführte Release-Test-ELF. Receipt SHA256 -`9020992e888d0b22e71db88cab78f255e273be2a4a7856d43616b387c36c74ae`, -Inputs SHA256 `382714b09349e448441345abbac6d99c0d523e98bdabaa78290b400768bac8f7`, -ELF7.888.096Bytes/SHA256 -`e83fd334b005d81ac917389de2a1c7486bea3f62ae45d77bccbd331e131e4304`. - -## Geplant, nicht ausgeführt: zwei Cloud-Linux-Prozessguards - -`deploy/updater_reader_census_linux_acceptance.py` ist lokal vorbereitet im -Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`. Vor Zielausführung muss Root -seinen unabhängigen Runnerreview abschließen. Keine Zugangsdaten wurden für -Prepare gelesen, kein Zielaufruf vorgenommen. - -Der Runner prüft zuerst die vollständige Liste aller10Tests des exakt gebundenen -ELF. Anschließend läuft ausschließlich der feste Filter `census_process::tests::`: - -- `actual_proc_probe_detects_existing_descriptors_and_mapped_inode_without_exporting_paths` -- `private_thread_fd_table_cannot_hide_a_reader_from_the_group_probe` - -Erforderlich sind2bestanden und8gefiltert. Die anderen acht Tests dürfen auf der -VM nicht laufen: Einige lokale Fixtures verwenden feste Produktzustandspfade. -Die zwei ausgewählten Tests verwenden nur eigene Create-once-UUIDdateien unter -`/run`, eigene FDs, eigenen mmap und einen eigenen Fixturethread. Keine SQLopen, -Jobs oder Dienststeuerung. Der Runner läuft als Root mit NoNewPrivileges und -führt nach einmaligem Eintritt keine Wiederholung aus. Nach verlorener Antwort -ist ausschließlich Read des Originalfalls zulässig. - -Vorher/Nachher werden Boot, Ubuntu24.04/x86-64, drei bekannte Dienstgenerationen -mit Konten/Images, geschlossener APT-Helfer, vier geschützte Control-Dateien, -drei DB-Identitäten sowie ursprünglicher Root- und Agentlock verglichen. -Control-Bytes sind gehasht; bei den laufenden DBs werden Identitäten geprüft, -keine Bytegleichheit oder vollständige SQL-Historie behauptet. Der begrenzte -Prozessnachweis ersetzt weder einen kompletten Hostcensus noch native -Full-/Updaterdienstkontexte oder einen Updatejob. - -## Weiterhin offen - -Extern qualifizierte kompatible Bootstrapregistry und geschützter Hostkontext, -native Dienst-/Namespace-/Capabilitykontexte, ursprüngliche Full-Admission und -Runtimeentrypoint, Staging-/Downloadproducer, gültige passive Updatebeobachtung, -Unknown-only-Recordnamespace-Adjudikation, ein vor dem ersten Apply lesbarer -V2-Rollbackvertrag sowie tatsächlicher WebUI-genehmigter Linux-Apply mit -Health-/Erhaltungsnachweis. V1-Restore bleibt deny. Kein erfolgreicher nativer -Apply und keine fertige Updaterbereitschaft folgen aus diesen lokalen Guards. - -## Tatsächlich auf Cloud-Linux ausgeführt - -Originalfall `168a4171-dbe3-46ef-8978-850797d0625c`: vor Ausführung volle -10er-Liste verglichen, danach genau beide Prozesscensus-Guards tatsächlich -als UID0 bestanden;2PASS/0failed/ignored,8andere ausdrücklich gefiltert. -Execute-Receipt -`d6bdda0bddac74f9364fa6ec3287ed0cfa9964ae02a98cc174e95929dc94f9d5`. -Separater Originalrückabruf bestätigte das Ergebnis und erhaltene aktuelle -Runtime-/Control-/State-/Lockidentitäten, Receipt -`8cbe7f4d79c238e3ad73a9c7152dcb415decbeeb1a8a1691fcc43ae4ee6c6a47`. - -Die eigenen kurzlebigen Prozess-/Thread-/FD-/mmap-Fixtures wurden geprüft; -keine RMM-Dienste gesteuert, keine Projekt-SQLite geöffnet oder Agentdatei -ersetzt. Dieser Nachweis qualifiziert weder den vollständigen Host-/ -Dienstcensus noch Admission, Apply, Record-Unknown-Adjudikation oder Rollback. -Die zuvor genannten offenen Gates bleiben offen. diff --git a/docs/agent-updater-reader-registry.md b/docs/agent-updater-reader-registry.md deleted file mode 100644 index 3942d2f..0000000 --- a/docs/agent-updater-reader-registry.md +++ /dev/null @@ -1,108 +0,0 @@ -# Geschützte Linux-Readerregistry: Quellenbaustein - -Stand2026-11-15, Spezifikation1.22. `worker::reader_registry` implementiert nur -Registry-/Unit-/Aktivierungspfadprüfung. Kein Bootstrap, Dienstcontrol, SQLopen, -Updaterstart, Apply oder Capability folgt daraus. Die vollständige aktuelle -Task-/FD-/maps-Census und die tatsächlich gehaltenen ursprünglichen Root- und -Agentlocks sind zusätzlich Pflicht. Die lokale Enginequelle verbindet diese -Bausteine inzwischen; ohne extern qualifizierte Bootstrapregistry, tatsächliche -Dienst-/Hostkontexte und ursprünglichen Admissionanschluss bleiben die -Produktcapabilities `not_configured`. Siehe -[aktuellen Readercensusnachweis](agent-updater-reader-census-results.md). - -Der Aufruf `QualifiedRegistry::load(&LocalUpdatePolicy)` liest ausschließlich -`/etc/rmm-agent-updater/reader-registry.json` unter root-eigener, gegen fremdes -Schreiben geschützter Ancestry. Originalrohbytes höchstens64KiB, root0, regulär, -ein Link; deren exakter SHA muss `policy.reader_registry_sha256` entsprechen. -Damit bindet der vor WebUI-Genehmigung gespeicherte Policyhash die Registry -transitiv. Gehaltene Dateien/Parent-FDs, Rawbytes und aktuelle Metadatastempel -bleiben erhalten; `verify_protected()` prüft unveränderte originale Namen, -Device/Inodes, Konten/Modi/Linkzahlen, Größe, Zeitstempel und Bytes. Kein Caller- -Boolean oder aus einem Registryfeld abgeleitetes Alleinvertrauen. - -Schema1 und Profil `linux_shared_readers_v1` besitzen exakt: - -- `bootstrap_receipt_sha256`: exakt der Bootstrap-Qualificationreceipthash aus - `policy.initial_baseline.decode().record.activation_evidence`. -- `reader_contract_sha256`: Hash der unveränderlichen öffentlichen Bytekonstante - `READER_CONTRACT`, über `reader_contract_sha256()` unabhängig berechenbar. -- `host_context`: `census::HostContext` mit extern bootstrapqualifizierten - Proc-/User-/PID-/Cgroup-Namespace-Device/Inodes; aktuelle eigene gleiche - Metadaten allein sind keine Bootstrapqualifikation. -- `units`: die unten festgelegten21 Units in dieser Reihenfolge. -- `rollback_timers`: höchstens32 weitere historisch bekannte, sortierte eindeutige - `rmm-general-startup-rollback-.timer`-Einträge. - -Jeder Uniteintrag enthält `unit`, `unit_file_state`, `composition`, `triggers` -und `triggered_by`. Beziehungen sind sortierte eindeutige bekannte Registrynamen, -keine freie Dateiauswahl oder zukünftige Readererlaubnis. `composition` ist exakt -wie im unveränderten OSport die geordnete `Vec<(path, FileProof)>`: Fragment -zuerst, dann tatsächliche DropInPaths-Reihenfolge. Der Hash derselben JSON- -Bytefolge muss bei den Policydiensten passen; FileProof enthält insbesondere -Original-Device/Inode, nicht nur ContentSHA. Geschützte systemd-Fragmente und -höchstens16 `.conf`-Dropins werden unter den bekannten systemd-Systemverzeichnissen -gebunden, insgesamt höchstens128 Blätter. Global-/Prefixdropins sind möglich, -aber kein unbekannter Zusatz wird ignoriert. Leere Komposition und leerer -UnitFileState sind ausschließlich bei einem absent/not-found-Nichtreader gültig. - -Die21 Einträge sind zunächst diese7 Services: Agentremote, Helpercloud, -Fullmaintenance, Updater, APThelper, Legacy`rmm-agent` und -Legacy`rmm-helper-dev-test`. Danach folgen für dieselben7 Basen jeweils `.socket` -und `.timer`. Vollständige feste Namen stehen in der Quellkonstante `SERVICES`. -`rmm-mvp-test.service` ist eine Wartungsfixture, kein registrierter Reader; -dieser Baustein fragt sie nicht ab und steuert sie niemals. - -Der feste Readervertrag bindet: Roothelper erwerben das bestehende -`executor.lock` vor SQLiteopen und jeder SQL-/Effektoperation; der Agent hält -die vorhandene `agent.lock` schon vor Öffnung beider Agentdatenbanken lebenslang; -alle erlaubten Reader verstehen Update-/Handoff-/Inflightdecoder. Registry- -Parsing beweist diese Code-/Bootstrapeigenschaften nicht selbst. Die tatsächliche -separat qualifizierte Baseline, Originalsignaturen und Census/Locks bleiben -Pflicht. Eine Registry oder ein flock allein verspricht keine globale Abwesenheit -zukünftiger exec-Aufrufe oder willentlicher vertrauenswürdiger Rootneustarts. - -`verify_admission` verlangt genau Agent/General/Full/Updater loaded/active/running -mit echten ServiceMainPIDs, ControlPID0, ohne ausstehenden Start-/Controljob. -`verify_stopped` verlangt Agent/General/Full inactive/dead mit tatsächlichen -Main-/ControlPIDs0; der Updater bleibt aktiv. Der originale UnitFileState bleibt -für alle vier exakt gebunden, enabled oder disabled. Ein aktivierter Full- oder -Updaterdienst muss deshalb nicht heimlich enabled werden. APT ist optional nur -als tatsächlich gebundener Policydienst vorhanden, bleibt geschlossen und -gehört niemals ins Startset. Legacyservices und Gegenstücke sind absent oder -loaded/inactive/dead/disabled; aktuelle unbekannte Rollbacktimer verweigern. - -Die read-only Systemdaufrufe sind ausschließlich `/usr/bin/systemctl --system ---no-ask-password --no-pager --full show --all` mit festen Properties/Namen und -zwei begrenzte `list-units`-/`list-unit-files`-Aufrufe mit festem historischem -Rollbacktimerpattern. Kein Shellglob, Pager, Authdialog, start/stop/enable oder -freie Commandline. Jede eigene Abfrage hat10s und das zusätzliche ursprüngliche -`Budget`; stdout/stderr je16KiB. Nur der eigene gehaltene pidfd-Prozess wird bei -Abbruch beendet, keine fremde PID übernommen. Statuswerte und fremde Prozess- -oder Mappfade werden nicht in Fehlermeldungen ausgegeben. - -Typen werden nicht erfunden: Service besitzt MainPID und ControlPID, Socket -nur ControlPID und eine tatsächliche aktuelle Verbindungsanzahl; Timer besitzt -keine PID-Eigenschaft. Fehlende anwendbare Properties verweigern. Timer/dead -bedeutet im [Systemd-Primärvertrag](https://github.com/systemd/systemd/blob/main/src/core/timer.c) -disarmierte Timereventquellen; Socket/dead ist keine Listenactivation. Es wird -kein nicht vorhandenes MainPID als gemessene0 ausgegeben. -[DBus-Typvertrag](https://www.freedesktop.org/software/systemd/man/latest/org.freedesktop.systemd1.html). -Die ausgewählte `Job`-Property muss vorhanden sein; deren leere Ausgabe mit -`--all` ist Systemctls Darstellung des tatsächlichen Nulljobs. -[Primärformatter](https://github.com/systemd/systemd/blob/main/src/systemctl/systemctl-show.c). - -`Triggers`/`TriggeredBy` sind strukturelle Beziehungen und werden exakt gegen -die Registry gebunden. Ihre Namen allein werden nicht als laufendes Ereignis -missverstanden. Alle relevanten registrierten Aktivierungsquellen müssen -unabhängig geschlossen sein; offene oder unbekannte Pfade verweigern. Allgemeine -WantedBy-Systemtargets werden damit nicht pauschal zu zu stoppenden Readern. -Alle Statusfelder werden vor und nach der Prüfung identisch erneut gelesen, -Registry/Unitblätter sowie aktueller Hostkontext erneut geprüft. Das ist eine -begrenzte Momentaufnahme unter den weiteren Originalgrenzen, kein Futureexec- -oder lückenloser Kernel-Snapshotbeweis. - -Dieser Worker hat keine Target-/SSH-/Job-/Scope-/Dienst-/Policyaktion oder -Systemdprobe ausgeführt. Compiler-/Format-/Clippyprüfung und unabhängiger -Quellenreview werden durch den koordinierenden Owner nach diesem Quellenhandoff -ausgeführt und separat berichtet. Die kleine Parserprobe verwendet ausschließlich -synthetische Statusbytes, keine tatsächliche Registry oder laufende Units. diff --git a/docs/agent-updater-rollback-decoder.md b/docs/agent-updater-rollback-decoder.md deleted file mode 100644 index 83322f0..0000000 --- a/docs/agent-updater-rollback-decoder.md +++ /dev/null @@ -1,89 +0,0 @@ -# Erhaltener Decodervertrag und weiterhin gesperrte Rückkehr - -Stand2026-11-15, enger lokaler Quellschnitt im bestehenden Worker. Keine neue -Journalversion, kein gestarteter Updater, keine VM- oder Applyabnahme. - -## Konkreter Befund und Änderung - -`history::verify_history` authentisiert die separat release-signierte -Bootstrapbaseline, die vollständige aufsteigende InstalledRecord-Kette und die -ursprünglichen Job-/Handoff-/Health-/Publikationszeugen im erhaltenen Helperledger. -Die bisherige Releaseprüfung übernahm jedoch Protokollhauptversion und -Zustandsschema aus genau dem Nachfolgermanifest, dessen Kompatibilität sie prüfte. -Eine echte Signatur authentisiert einen Releaseinhalt; sie beweist nicht, dass -dieser Inhalt den Decodervertrag des erhaltenen Zustands unterstützt. - -Die bestehende Prüfung bekommt jetzt beide Vergleichswerte ausschließlich aus -dem separat signierten qualifizierten Bootstrapmanifest. Jeder historische -Nachfolger muss diese Werte erhalten. Aktuelle Keywiderrufe, Schlüsselbereiche, -Manifest-/Job-/Healthsignaturen, unveränderte Originalbytes und monotoner Floor -bleiben zusätzliche Bedingungen. Die Funktion schreibt weiterhin keine SQLzeile. -Es gibt keinen neuen Manifest-/Job-/Handoffcodec und keine Datenmigration. - -Dies schließt eine konkrete Kompatibilitätslücke in einem bereits aufgerufenen -Reader: `TrustState::qualify_history` verwendet `verify_history` vor neuer -Admission sowie unter dem übernommenen Guard vor dem Austausch. Es ist keine -Aussage, dass gleiche Versionsnummern die gesamte tatsächliche Decoderfähigkeit -beweisen; diese bleibt Bestandteil der unabhängig qualifizierten Bootstrap- und -Releaseartefakte. Eine zukünftige ausdrücklich beauftragte Protokoll- oder -Zustandsmigration braucht einen eigenen Vertrag. - -## Weshalb damit noch kein Rollback freigegeben ist - -Im vorhandenen Datenvertrag existiert kein normierter V2-Rückkehrzeuge: - -- `Handoff`, `Event` und `Journal` verstehen nur Schema1 und die Vorwärtsfolge. - Ein endgültiges `Unknown` bleibt terminal. -- `ActivationEvidence` kennt `Bootstrap` und `Updated` mit positivem Healthbeleg; - das Feld `rolled_back` allein authentisiert keine Rückkehrwirkung. -- Core verweigert `NativeEffect::RestorePredecessor` sowohl beim Claim als auch - bei der Beobachtung. Ein vorhandener Linux-Dateiport ist keine Genehmigung. -- History verweigert rückkehrende Records und alte Recorddateien, welche die - inzwischen vollständig abgeschlossenen Verbräuche/Publikationen auslassen. - -Der ursprüngliche signierte Job bindet bereits -`restore_exact_predecessor_once`. Es fehlen jedoch dessen vollständig gebundene -dauerhafte Rückwegphasen, belegter eindeutiger Fehlstart, exklusive Guard-/Owner- -Übergabe, jede einzelne native Rückkehrbeobachtung, neuer Prozess-/Healthbeleg, -Record-/Floorpublikation und failed-Originaloutcome. Vor erster Applybaseline -müssen sämtliche tatsächlich installierten Agent-/General-/Fullreader genau -diesen noch fehlenden Vertrag verstehen. Das alte1.20-Paar ist kein Rückkehrziel. -Kein paralleles unbeobachtetes Journalformat wird als Ersatz eingeführt. - -## Tatsächliche lokale Prüfungen und Grenzen - -Die neuen Fälle verwenden synthetische, aber echte Ed25519-Release-, Baseline-, -Job- und Healthsignaturen samt vollständigen in-memory SQLiteoriginalen. Sie -prüfen inkompatible Protokoll- und Zustandsschemas, die unveränderte positive -Vorwärtskette, eine vorgeschlagene exakte Vorgängerrückkehr mit erhaltenem -höherem Floor sowie gespeichertes Unknown. Vor/nach jeder Readerprüfung bleibt -`total_changes` gleich; Unknown-Originalbytes und Floors bleiben erhalten. - -Tatsächlich im vorhandenen isolierten Buildcontainer, Netzwerk aus: - -```text -cargo test --release --locked --offline -p rmm-updater-worker --all-targets -cargo clippy --locked --offline -p rmm-updater-worker --all-targets -- -D warnings -cargo fmt -p rmm-updater-worker --check -``` - -Abschließender normal paralleler Testlauf:12/12 bestanden,0Fehler,0ignoriert; -Clippy und Formatprüfung bestanden. Eine private Quellrückmutation ausschließlich -auf den alten selbstreferenzierenden Vergleich macht den neuen signierten -Kompatibilitätstest erwartungsgemäß rot: Exit101, `unwrap_err` erhält `Ok`. -Die Produktionsquelle wurde hierfür nicht zurückgeändert. Dies belegt den -konkreten Readerfehler; es ist keine simulierte Updatewirkung. - -Der erste parallele Lauf hatte10/12 bestanden; zwei vorhandene Selbstprozess- -Censusfixtures verweigerten eine während anderer Unitfälle wechselnde FD-Tabelle. -Der unveränderte Produktguard bestand im seriellen12er-Lauf. Die beiden Fixtures -laufen jetzt je in einem eigenen exakt ausgewählten Testprozess, mit unverändertem -Censuscode und echten privaten Thread-FD-/mmap-Proben. Danach bestand der normale -parallele12er-Lauf. Der erste Clippylauf fand zwei unnötige Testdatenklone; -sie wurden ohne Warnungsunterdrückung entfernt. Alte Fehlerlogs bleiben erhalten. - -Geschützter lokaler Belegpfad: -`devstate/updater-history-contract-73511ace-428f-4aaf-8742-720619459907/`. -Native Linux-/Windowsqualifikation, Codeaustausch und WebUI-genehmigter Updatejob -sind nicht ausgeführt. Frühere native Censusberichte qualifizieren nicht die -neue Testbinary. Notebook bleibt ausschließlich Entwicklungsrechner. diff --git a/docs/agent-updater-runtime-source.md b/docs/agent-updater-runtime-source.md deleted file mode 100644 index 0304129..0000000 --- a/docs/agent-updater-runtime-source.md +++ /dev/null @@ -1,252 +0,0 @@ -# Koordinierter Updater-Quellencheckpoint1.21 - -2026-11-14. Dieser Checkpoint verbindet den unveränderten signierten Verifier, -den eingefrorenen Handoffkernel, Linux-OSports sowie Domain-/Core-/Protokoll-, -Server-/MCP-/WebUI-Quellen. Er enthält keine ausgelieferte Applyruntime und -keinen erfolgreichen Updatejob auf der Cloud-VM. - -Implementiert sind der feste Updateplan mit zwei eigenen streambaren Artefakten, -immutable Tenantkatalog, zusätzliche deny-only Rechte-/Policyprüfung für Ersteller -und Freigeber, genaue WebUI-Byte-/Hashanzeige und der eigene passive agent.update- -Scope. Der Agent meldet dafür derzeit ausschließlich not_configured; qualifizierte -Apply-/Checkcapabilities werden daraus nicht abgeleitet. Der vorhandene kleine -Paketartefaktpfad bleibt unverändert. - -Im bestehenden Helperledger werden Verbrauch, alter Startzeuge, Handoff, -Delegation und Stopintent atomar gespeichert. Typisierte Inflightkontrolle hält -beide Readyflags und Unlock geschlossen. Native Unterintents sind create-once, -rollen-/Head-/Nonce-gebunden und erhalten Originalhistorie. Getrennter geschützter -Healthkey und Originalplanpin ersetzen jede frühere Jobsignerannahme. Die neue -Serverroute prüft gespeicherte Original-Sync-/Baseinventarbelege; der konkrete -lokale Fullguard muss diese unabhängig gegen eigene tatsächlich angewandte -Rawbytes und Applyzeit prüfen. General ist dafür nicht zuständig und darf ein -Originalupdate aus diesem Grund nicht zu Unknown machen. - -Der Worker enthält echte geschützte Dateizeugen, historischen Originalrequest- -Replay, Uhr-/Boot-/Deadlineprüfung, tatsächliche Prozess-/Dienstidentitäten, -Originalledger- und native Dateieffektzäune sowie lokale Trust-/Baselineprüfung. -Diese Bibliotheksbausteine sind kein aktivierter Daemon oder qualifizierter -End-to-End-Dispatcher. - -Lokal tatsächlich ausgeführt im vorhandenen Rust-Buildcontainer, Netzwerk aus: - -- Gemeinsamer all-targets Check für Agent, Windowsquellen unter Linux-cfg, - privilegierten Helper, Worker und Server: PASS. -- Core64, Domain23 und Server45 Tests: PASS; fünf vorhandene Server-DB-Harnesstests - ausdrücklich ignored. Diese5 sind kein DB-Abnahmenachweis. -- Betroffene gemeinsame all-targets Clippyprüfung mit -D warnings: PASS. -- Formatprüfung der betroffenen Pakete: PASS. -- Echter separat baseline-/release-signierter Worker-Gegenfall:1/1 PASS. - Exakte historische aktive Sequenz/Manifest bestehen; gleiche oder niedrigere - Kandidaten am unveränderten Floor, Ablauf und Keywiderruf verweigern. - Private Rückmutation auf den früheren Fehler active_release=None scheitert - reproduziert mit Exit101. Das ist ein lokaler Trusttest, keine VM-Anwendung. - -Lokale Befehls-/Logbelege liegen geschützt im ignorierten Verzeichnis -`devstate/updater-checkpoint-090e6ad9-c88e-4f38-b6e1-f7fc1f189244/`. -Die getrennte Deliveryqualifikation dokumentiert PostgreSQL15-Migrations-/RLS- -und Webprüfungen in [agent-updater-server-console.md](agent-updater-server-console.md). -Der tatsächliche Linux8-Kernel- und Linux5-OSnachweis ist separat in -[agent-updater-handoff-linux-results.md](agent-updater-handoff-linux-results.md) -und [agent-updater-linux-native-results.md](agent-updater-linux-native-results.md) -dokumentiert. Root-OSfixtures ersetzen keinen General-/Full-Dienstkontextnachweis. -Historische Belege bleiben unverändert. - -Für eine wirkliche erste Anwendung fehlen weiterhin die enge Fullbridge mit -qualifizierter Owner-/Healthguard-Implementierung, atomar übergebene live -Workerdispatchstrecke, Record-/Floorpublikation, erhaltende1.21-kompatible -Bootstrapbaseline, gültiger passiver Kandidatenzustand, ein neuer konkreter -WebUI-genehmigter Linux-Apply sowie dessen unabhängiger Health-/Erhaltungsnachweis. -Restore/Rollback bleibt deny, weil der unveränderte Vorwärtskernel noch keinen -qualifizierten Rückweg besitzt. Windowsapply ist separat offen. Kein Zielhost -wurde durch diesen lokalen Checkpoint installiert, gestoppt oder aktualisiert. - -## Fortschreibung: zweiter lokaler Quellencheckpoint - -Die nächste Teilstrecke verbindet jetzt erhaltene Stage-/Statezeugen, den -gebundenen Full-Controlkanal, echte Dienst-/Prozessprüfungen, lokale -SignedSync-Applyzeugen, Inventarretention und den asynchronen Agent-Healthclient. -Full ist der einzige ursprüngliche Updateautorizer; General kann einen -Originalhandoff nicht aufgrund fehlender Zuständigkeit zu Unknown herabstufen. -Lesender historischer Replay bleibt von aktueller Wirkungsautorität getrennt: -auch nach verlorener Frist/Owner soll Unsicherheit unter demselben erhaltenen -Guard adjudiziert werden können. Sämtliche Forwardeffekte prüfen zusätzlich -aktuelle ursprüngliche Clock-/Boot-/Release-/Revocationbedingungen. - -Die feste Fullbridge prüft die tatsächlichen PID-/Birth-/Image-/Unitzeugen. -Dienststartergebnisse müssen exakt den weiterhin gehaltenen einmaligen -Workerresultaten entsprechen. Nach ServicesStarted müssen gerade diese neuen -Agent-/General-/Fullgenerationen weiterleben; Ersatz-PIDs sind kein Erfolg. -Health vergleicht die separat signierten Originalserverbytes mit den lokal in -derselben echten Helper-Sync-Transaktion gespeicherten Request-/Responsehashes -und Applyzeit sowie dem behaltenen Originalbaseinventar und dessen echtem -SignedSync-ACK. Der vorhandene normale Transport-ACK löscht diese Belege nicht. - -Der Agent lässt ausschließlich den signatur-/consumed-/start-verifizierten -ursprünglichen Updatekandidaten ohne vorhandenes Outcome beim eigenen Startup -auf tatsächliche unabhängige Helperkontrolle warten. Dies ist kein laufender -Handoffbeweis, keine Ausführung und keine Bereitschaft. Ein bereits vorhandenes -Unknown wird nicht geheilt. Der Kandidat kann nur neue negative Kontrollrunden -planen, damit die normale busy-Sperre seinen ersten Wiederkontakt nicht blockiert. -Ein erwarteter letzter Entscheid der vorherigen Verbindungsgeneration ist beim -Reconnect kein aktueller Healthbeleg. Während eines begrenzten Health-HTTPs -pausieren weitere Kontrollrunden; Heartbeats laufen weiter. Ein tatsächlich neuer -normaler Basesample gehört zur genehmigten Update-Healthstrecke, alte Daten -werden nicht frischgestempelt. Zertifikatsrotation wartet auf das Ende dieses -konkret bekannten Inflightfalls. - -Der konkrete Full-Finalizepfad baut Recordbytes deterministisch aus dem -Originalrelease, altem Record und ursprünglicher SignedHealth. Zwei getrennte -native Intents/Nachlese-CAS sichern Save und Publish. Ein temporärer lokaler -Namespaceguard vergleicht exakt die alte gehaltene Datei/Rootdiridentität mit -dem nicht öffentlich konstruierbaren Recordportbeleg; alle übrigen geschützten -Namen bleiben Pflicht. Floor und aktive Recordmetadaten werden zusammen als -ein neuer Record publiziert, alte/neue Rawrecords zusätzlich create-only -aufbewahrt. Erst danach folgt das ursprüngliche Outcome-CAS; kein Resultunlock -oder allgemeiner Ready-/Startfence entsteht daraus. - -Tatsächlich lokal im isolierten Offlinecontainer ausgeführt: - -- Agent60, Core67, privilegierter Helper68 und Worker5: insgesamt200bestanden, - 0Fehler,0ignoriert,0gefiltert im vollständigen betroffenen Release-Testlauf. -- Gemeinsame all-targets Clippyprüfung mit -D warnings und Formatcheck: PASS. -- Die zwei Record-FS-Fälle verwenden ausschließlich neue eigene Rootdateien - unter privatem Container-/run; keine tatsächlichen Projekt- oder Zieldienste. - -Belege: `devstate/updater-runtime-checkpoint2-69dc0bb5-2e9f-4639-9212-e878b32eadc6/`. -Ein vorheriger breiter Lauf hing in der HTTPS-Reconnectprobe und wurde als eigener -Container beendet (Exit137, kein PASS). Nach Eingrenzung des Altgenerationsfalls -bestand die gezielte tatsächliche mTLS-HTTPSprobe1/1; anschließend bestand der -vollständige200er-Lauf. Zwei reine Clippy-Strukturfehler (Testmodulposition und -verschachteltes if) wurden ohne Prüfungsunterdrückung korrigiert. Das erste -Clippyfehlerlog bleibt im Belegverzeichnis; Hänger/Abbruch, gezielte1er-Probe und -späterer Stilhinweis sind im ursprünglichen Werkzeugprotokoll erhalten. - -Diese lokalen Ergebnisse qualifizieren keinen tatsächlichen Full-/Updater- -Dienstkontext. Der öffentliche Recordbuilder hat hier noch keinen eigenständigen -echt signierten Positivnachweis; die FS-Fälle umgehen seinen authentisierten -Eingang ausdrücklich. Die vollständige Engine/Daemon-/StopFence-/Stagingproducer- -und ursprüngliche Admissionstrecke, qualifizierte passive Kandidatenbeobachtung, -geschlossene Readercensus, unklare Record-I/O-Namespace-Adjudikation und der vor -der ersten Baseline notwendige V2-Rückweg bleiben offen. Applyfähigkeit bleibt -unveröffentlicht; kein Cloud-VM-Apply, kein Produktfertig- oder Produktionsnachweis. - -## Nachtrag2026-11-15: gesperrte Worker-Drivefolge - -Nach dem gepushten gemeinsamen Checkpoint8e93c9e und dem erhaltenden Mainmerge -07d6118 ist die bisher offene Enginefolge als konkrete Workerquelle verbunden. -Dieser historische Stand sperrte den Eintritt explizit mit -`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die folgende lokale Fortschreibung hat -Registry und Readercensus im Quellpfad verbunden; weiterhin wird weder ein -Daemonentrypoint noch eine Job-/Applycapability aktiviert. Die genaue -Queue-/Reply-/Stop-/Lock-/Swap-/Start-/Healthfolge und vorhandene separate -Agent-Singletonsperre stehen in [worker](agent-updater-worker.md). Der neu -geprüfte öffentliche Recordbuilder löst die zuvor dort genannte fehlende -positive authentisierte Eingangsprobe. Keine reale Applyabnahme folgt daraus. - - -## Fortschreibung2026-11-15: Readerregistry und vollständige Task-FD-Prüfung - -Der gemeinsame Quellsatz verbindet Registryprüfung, ursprüngliche Agent- und -Root-Executorsperre sowie TGID-/TID-FD-/maps-Prüfung mit der bestehenden Engine. -Vor SQLiteöffnung verlangt der Ledgerport den nicht frei konstruierbaren -`ClosedReaders`-Beleg und den tatsächlich gehaltenen ursprünglichen Rootguard. -Das ist ein lokaler Quellen-/Vertragspunkt, kein gestarteter Dispatcher und -keine Zusage über zukünftige privilegierte Fremdprozesse. - -Der eingefrorene71-Input-Quellsatz besteht lokal alle10 vorhandenen Workerguards, -locked all-targets Check, Release-Link, Clippy mit `-D warnings` und Formatcheck. -Ein eigener Runner ist ausschließlich für zwei eigene native Prozessfixtures -vorbereitet; er ist noch nicht ausgeführt. Details, frühere fehlgeschlagene -Fixtureprüfung und verbleibende MVP-Gates stehen im -[Readercensusnachweis](agent-updater-reader-census-results.md). - -## Quellenfortschreibung 2026-11-16: Full-Admission und stabiler Linux-Daemon - -Die zuvor fehlende Quellverbindung enthält jetzt einen getrennten festen -`rmm-agent-updater --serve`-Einstieg und eine Systemd-Vorlage. Der Dienst erhält -keine Jobfreigabe-API. Die vorhandene Full-Helperstrecke prüft die vollständig -vorab geladenen Agent-/Helperdateien unabhängig vom Netzwerkagenten und legt -vier exakt gebundene Root-Stages an. Erst danach speichert die bestehende -HelperSync-Transaktion unter derselben Original-Executorsperre Consumption, -Startzeuge, Handoff, Delegation und StopIntent atomar. Die Antwort -`agent_update_handoff_accepted_v1` ist ausdrücklich kein Outcome und enthält -`ready=false` und `terminal=false`. Der Helper antwortet zuerst dem Agenten; -erst anschließend aktiviert er einmal den tatsächlich gebundenen Updater. -Die Cloud-VM wurde dadurch noch nicht aktualisiert. - -Die Quellstrecke erhält auch den aktuellen TLS-Selektor und die tatsächlich -aktive Zertifikatsversion anhand von Dateimetadaten. Sie liest dabei keine -privaten Schlüsselbytes. Ein fester, descriptor-relativ geöffneter -Agent-Cachepfad bleibt auf UID 993 und den bestehenden privaten Agent-Statebaum -beschränkt; die Root-Installationsverzeichnisse behalten ihre eigene strenge -Root-Pfadauflösung. - -Der zusätzliche Full-Aufruf `update_observe_v1` ist ausschließlich lesend. -Er prüft die tatsächliche HelperSync-Lease, Baseline/Release-Trust, Historie, -Floor, feste Dienstgenerationen, Readerregistry und den laufenden Updater. -Ein optionaler Kandidat wird als ursprünglicher ReleaseEnvelope mit eigener -Keyringgeneration entgegengenommen und unabhängig geprüft. Erst danach rendert -Full die genaue Kandidaten-Konfiguration und den Pin für die spätere -WebUI-Anzeige. Katalogmetadaten allein liefern keinen CandidatePreview. Der -Aufruf lädt keine Binärdateien, legt keine Stage an und schreibt keine -Start-/Handoff-/Ready-Zeile. - -Der V2-Rückweg ist im Linux-Worker für den konkret unterscheidbaren Fall eines -nach einmal bestätigt dispatchtem Start gescheiterten neuen Full-Helfers -verbunden. Ein vorher im ersten LedgerReturnIntent reservierter bedingter Stop -beendet ausschließlich die tatsächlich gehaltene neue General-Generation. -Agent/Full ohne erfolgreichen Start erhalten getrennte negative Belege und -keine erfundenen erfolgreichen Stops. Erst nach beendetem Reader, beiden -ursprünglichen Sperren und erneutem vollständigen FD-/maps-Census öffnet der -Updater wieder das Originalledger. Die vier Dateien werden in Gegenrichtung -über getrennte create-once Intents zurückgeführt; Kandidat und Vorgänger bleiben -erhalten. Ein tatsächlich neu gestarteter Vorgänger-Full muss die ursprüngliche -signierte Healthstrecke erneut bestehen. Sein abschließendes Updateergebnis ist -`failed / AGENT_UPDATE_RETURNED_TO_PREDECESSOR`; der ursprüngliche aktive Record -und Floor werden nicht neu publiziert. Verlorene Antworten, unklare Renames, -automatischer Restart und nicht nachgewiesene Dienstzustände bleiben gesperrt. -Andere Startup-/Healthfehlerpfade sind durch diese Quellenfortschreibung noch -nicht als real ausgeführte Wiederherstellung qualifiziert. - -Bei der Verbindung wurde ein konkreter Dienstbeobachtungsfehler korrigiert: -der Systemd-Aufruf fragt sieben Eigenschaften ab, der bisherige Parser verlangte -acht. Der Parser verlangt jetzt genau die tatsächlich angefragten sieben Namen -und verweigert fehlende, zusätzliche und doppelte Eigenschaften. - -Lokal tatsächlich ausgeführt: Helperbibliothek 42/42 bestanden, einschließlich -des neuen typisierten Handoff-Acknowledgement-Gegenfalls. Der erste breite Lauf -hatte sechs APT-Fixturefehler wegen des fehlenden privaten Verzeichnisses -`/tmp/opencode`; mit diesem Fixtureverzeichnis bestanden alle 42. Ein erster -Updater-Linux-Lauf bestand 5/7 und scheiterte bei zwei Dateifixtures am absichtlich -schreibgeschützten Container-`/run`. Diese Fehlversuche sind kein nativer -Zielnachweis. Der weitere Quellencheck und die getrennte reale Linux-first- -Abnahme werden separat ergänzt. Keine Applycapability und kein erfolgreicher -Cloud-Apply werden aus diesen lokalen Ergebnissen abgeleitet. - -Mit privaten Container-Tmpfs für `/tmp`, `/run` und `/var/lib` bestand anschließend -der vollständige betroffene Lauf: Helper 42, Updater-Linux 7, Worker 12, insgesamt -61 bestanden, 0 Fehler, 0 ignoriert. Zuvor scheiterte zusätzlich ein Workerfixture am -schreibgeschützten Container-`/var/lib`; auch diese Ursache wurde durch die -korrekte eigene Fixtureumgebung beseitigt. Der abschließende all-targets-Clippy- -Lauf für Helper und Worker mit `-D warnings` und `git diff --check` bestand. -Diese Tests enthalten ausdrücklich Containerfixtures mit festen privaten -Statepfaden; die vollständigen Testbinaries dürfen deshalb nicht gegen die -bestehenden installierten Statepfade der Cloud-VM gestartet werden. Der reine -Sieben-Eigenschaften-Parsertest benötigt keine Systemd-/Dateieffekte. - -Die zusätzliche ursprüngliche Updater-Zeitgeneration und der tatsächlich -angewandte Pre-Stop-Syncbeleg sind separat in -[Originalzeitgeneration](updater-original-time-generation.md) beschrieben. -Auch diese Quellverbindung ist noch keine reale Applyabnahme. - -Am 16. November wurde die öffentliche deterministische Recordzusammensetzung -in `rmm-domain::agent_update_provisioning::assemble_updated_record` gemeinsam -genutzt. Sie liefert ausschließlich bereits öffentliche Recordmetadaten; -die privaten nativen BuiltRecord-Konstruktoren behalten ihre unabhängigen -Original-/Healthsignatur- und Guardprüfungen. Der Linux-Namespacevertrag -bleibt unverändert. Tatsächliche isolierte Nachprüfung: Agent und Worker -mit allen Targets/Clippy `-D warnings` bestanden; beide bestehenden -Record-Namespaceprüfungen (Originalinode/Archive sowie Ablehnung fremder -Dateiidentitäten) bestanden, 2/2, keine ignoriert. Dafür wurde ausschließlich -der private Container-`/run`-Scratch verwendet, keine VM-Datei verändert. diff --git a/docs/agent-updater-server-console.md b/docs/agent-updater-server-console.md deleted file mode 100644 index e1bff1b..0000000 --- a/docs/agent-updater-server-console.md +++ /dev/null @@ -1,219 +0,0 @@ -# Agent-Selbstupdate: Serverkatalog, Transport und feste WebUI-Pläne - -2026-11-14, isolierter Quellenstand im Updaterbranch. Server und WebUI sind -implementiert und lokal geprüft; **kein Deployment, kein nativer Applylauf und -noch kein aktiver Autoupdater**. Der beauftragte Schnitt verwendet ein eigenes -signiertes Agent-/Helper-Codepaar, keine APT-/MSI-Fixture und kein Wartungsskript. -Domain, lokale Helper-/Handoffruntime und signierter Inflightabgleich werden -getrennt integriert. Die Produktentscheidung und Zielabnahme bleiben beim -Hauptagenten; diese Seite ersetzt weder dessen Review noch die Linux-first-Gates. - -## Planung und unveränderte Genehmigungsgrenze - -HTTP und MCP benutzen dieselbe neue `plan_request`-Auflösung. Für -`action="update_agent"` sind ausschließlich folgende Aktionsparameter erlaubt: - -```json -{ - "release_id": "11111111-1111-4111-8111-111111111111", - "execution_identity": "root", - "timeout_seconds": 600, - "max_output_bytes": 65536 -} -``` - -Dies ist ein synthetisches Schemafragment, kein ausführbarer Auftrag. Feste -Asset-IDs, Fristen, Rolloutlimits und Grund stehen wie bisher daneben. Keine -freien URLs, Dateipfade, Artefaktlisten, Vorgänger, Updater- oder Peerpins vom -Aufrufer. Auch der alte typisierte `PlanInput` erlaubt keine alternative -Einreichung eines selbst zusammengestellten `ResolvedAgentUpdate`. - -Der Server löst den festen Releasekatalog und je Ziel die letzte gespeicherte -`agent_update`-Beobachtung auf. Neben dem bestehenden Baseinventar akzeptiert er -gezielt den eigenen passiven Scope/Source `agent.update` mit Schema1 und exakt -`{"agent_update": AgentUpdateObservation}` als Daten. Der normale authentisierte -Ingest verlangt die angebotene Capability `agent.update/1`; Tenant, Agent, Boot -und Generationen stammen weiterhin ausschließlich aus dem geprüften Envelope. -Die eigene 60s-Quelle behauptet kein neues Windows-Baseinventar und löst keine -angeforderte Liveerhebung aus. Verlangt werden gültige Quelle/Qualität, höchstens fünf -Minuten alte Erhebung/Empfang/Updatebeobachtung, frischer Kontakt, gleicher -aktueller Boot, unveränderte Identitätsgenerationen, bestätigter Agent-/Helpersync -und keine Restore-/Sequence-/Recoverysperre. Die bezeichnete ursprüngliche -signierte Syncentscheidung muss im erhaltenen Servercheckpoint existieren, -bei der Beobachtung gültig gewesen sein und zu Boot, Verbindungsgeneration, -Gerät und beiden aktuellen Journalidentitäten passen. Ein neuerer normaler -Sync macht die historische Entscheidung nicht nachträglich zu einer neuen Lease. - -Genau die passende passive Kandidatenpreview bindet Zielrelease und typisierten -Peerpinübergang. Der Release liegt über dem beobachteten Aktivierungsfloor. -Fehlende, alte oder widersprüchliche Beobachtung ergibt keine Planung und wird -nicht durch eine Liveabfrage oder angenommene Baseline ergänzt. Geräte-mTLS -liefert Herkunft, keine unabhängige Hardware-/OS-Attestierung; der privilegierte -Updater muss sämtliche lokalen Bindungen vor Wirkung erneut selbst prüfen. - -Der gespeicherte Plan enthält sämtliche festen Updatejobs mit exakten -Release-/Envelopehashes, Vorgänger-/InstalledRecordhash, Agent-/Helperdateien, -Updater-/Policy-/Keyringbindung, Konfigurations-/Peerpinübergang und einmaligem -zulässigem Vorgängercode-Rollback. Je Versuch werden exakt die zwei signierten -Artefaktreferenzen abgeleitet. Fehlende, zusätzliche, doppelte oder fremde -Referenzen verweigern Revalidation, Zustellung, Grant und Download. -Die Updaterbindung enthält zusätzlich den festen separaten Health-Publickey -`health_public_key_hex` und dessen `health_key_pin_sha256`. Beide stehen in den -kanonischen Planbytes direkt nach dem Keyringhash, werden vollständig angezeigt -und von der eigenen deny-only-Policy exakt verglichen. Das ersetzt weder den -Jobsignierschlüssel noch erlaubt es einen Fallback auf ihn. Der signierte -Executionpermit bezeichnet ausschließlich bei Updatejobs zusätzlich die -ursprüngliche Plan-ID; ältere Aktionen behalten ihre ursprünglichen Grantbytes. - -Ersteller und Freigeber benötigen aktuell `updates:apply` sowie getrennt -`root:execute` oder `system:execute`. Das erteilt keine Genehmigung. -`operations.submit` bleibt der unveränderte persistente Antrag -`pending_approval`, vor der interaktiven WebUI-Genehmigung ohne Jobs/Outbox/ -JobOffer/Grant. Die vorhandene Autorisierungs- und Auditschicht wird nicht -ersetzt; kein neuer Approve-API-/MCP-/DB-Pfad. Aktualisierte Rechte, Capabilities, -Scope, Releasevertrauen und gespeicherte Vorgänger werden weiter geprüft. - -## Getrenntes Vertrauen und deny-only-Policy - -`RMM_AGENT_UPDATE_KEYRING_FILE` verweist auf eine separat provisionierte, -geschützte Datei mit dem gemeinsamen `UpdateKeyringFile`-Schema1: -Generation und höchstens16 Publickeys, jeweils Plattform, Sequenzbereich und -Widerrufsflag. Der Server prüft Eigentümer wie beim vorhandenen Jobsignierschlüssel, -0600, reguläre einzelne Datei ohne Symlink sowie nicht fremdschreibbaren Elternpfad; -begrenzt eingelesene Originalbytes und gehaltene Dateimetadaten werden verglichen. -Der vollständige Rawhash/Generation muss zur festen Updaterbindung passen. -Keine Schlüssel aus einem Job, Download oder Katalogeintrag werden vertraut. - -Verifikation benutzt den unveränderten bereits nativ qualifizierten reinen -`rmm-updater`-Verifier: feste Ed25519-Domäne, kanonische Manifestbytes, -Signatur, Plattform, Gültigkeit und kompatibles Protokoll/Zustandsschema. -Die serverseitige Kandidatenprüfung ersetzt den lokalen Aktivierungsfloor nicht. - -Die eigene Datei `RMM_AGENT_UPDATE_POLICY_FILE` ist im ersten Entwicklungsprofil -ein ausdrückliches Schema1-Opt-in mit Ablauf und höchstens64 festen Scopes. -Jeder Scope bindet Tenant/Asset/Agent/Generationen, aktuelle Principals, -qualifizierte Helperpolicy/-binary, Updaterbinary/-policy, Keyringgeneration/-hash, -separaten Health-Publickey/-Pin, -erlaubte konkrete Manifest-/Vorgängerrecordhashes und Abnahmenachweis-ID. -Fehlend, falsch, abgelaufen oder Produktion ohne passenden Adapter bleibt deny. -Bestehende General-, Fullskript-, SCM-, MSI- und APT-Policies erteilen dadurch -keine Updateerlaubnis. Kein Codepfad provisioniert diese Dateien oder Mitgliedschaften. - -Zusätzlich sind die abgestimmten tatsächlichen Capabilities erforderlich: -`update_agent`, `agent.update.apply/1`, `rmm.sync.v1`, unabhängiger Root-/SYSTEM- -Helper, `root:update_agent` beziehungsweise `system:update_agent` und konkrete -Helper-/Updatercode-/Updaterpolicyhashes. Quelle oder Build allein öffnet sie nicht. - -## Eigene große Artefakte und passive Metadaten - -Migration0015 legt nur die getrennten Tabellen `agent_update_artifacts` und -`agent_update_releases` an. Beide haben erzwungene Tenant-RLS, zusammengesetzte -Tenant-/Artefakt-/Hash-/Längen-Fremdschlüssel und unveränderliche Inhalte. -Die Anwendungsrolle besitzt nur SELECT/INSERT, keine Tabellen und kein RLS-Bypass. -Alte APT-/MSI-Artefakttabelle, Route, SQLgrenze und Store bleiben bei256KiB. - -| Pfad | Vertrag | -| --- | --- | -| `POST /api/v1/tenants/{tenant}/agent-update-artifacts?artifact_id=…&sha256=…&size_bytes=…` | Interaktive Katalogverwaltung mit CSRF und `catalog:write`; binärer Stream mit exakter Content-Length, höchstens256MiB und180s; kein Job | -| `POST /api/v1/tenants/{tenant}/agent-releases` | Strikter signierter Envelope; Veröffentlichung erst nach vollständiger Prüfung beider bereits importierter Dateien; kein Job | -| `GET /api/v1/tenants/{tenant}/agent-releases` / MCP `updates.list_releases` | Gespeicherte feste Metadaten, berechtigt und paginiert; abgelaufene Metadaten bleiben lesbar und gesondert gekennzeichnet | -| `GET /agent/v1/releases/current?platform=…` | Geräte-mTLS und passende Plattform; tatsächlich beobachtetes höchstes Katalogrelease oder `not_configured`; kein Nachweis weltweiter Aktualität und kein Apply | -| `GET /agent/v1/update-artifacts/{artifact}?job_id=…&attempt_id=…&offset=…&length=…` | Geräte-mTLS, genehmigter fester Job/Versuch, aktuelle Rechte/Policy/Identität und exakte Manifestreferenz; höchstens512KiB je Antwort | - -Upload liest kein vollständiges Binary in einen Vec: feste32KiB-Schreibstücke, -bounded Hash/Längenzählung, create-only privates Staging, Flush vor unveränderlicher -Publikation. Frühes EOF, Zusatzbytes und Hashabweichung verweigern Veröffentlichung. -Die feste180s-Frist wird ausdrücklich vor und nach jedem Streampoll, nach der -Frameverarbeitung sowie vor Veröffentlichung geprüft. Damit können auch sofort -verfügbare oder leere Frames den Ablauf nicht umgehen; das eigene unveröffentlichte -Staging wird beim Abbruch über den vorhandenen Drop entfernt. -Während des Streams wird keine SQLtransaktion gehalten; vor Veröffentlichung -werden interaktive Berechtigung und CSRF erneut geprüft. Unterbrochene eigene -Stagingdateien werden entfernt; Prozess-/Hostcrash kann verwaiste eigene -Stagingdateien hinterlassen, ohne daraus ein veröffentlichtes Objekt zu machen. - -Download benutzt ein gehaltenes reguläres No-follow-Handle und prüft vollständige -Länge/Hash mit32KiB-Puffer, dann den begrenzten Bereich und Dateimetadaten. -Das lädt kein vollständiges großes Objekt in RAM; der erste einfache Adapter -hashprüft das Objekt allerdings pro Chunk erneut. Der Client muss weiterhin vor -Staging/Verwendung unabhängig vollständige Länge, EOF und Releasehash prüfen, -ohne Redirect oder beliebigen Downloadhost. Produktionsobjektspeicher und -weitergehende Durchsatzoptimierung sind kein behaupteter Nachweis dieses Adapters. - -## WebUI und tatsächliche lokale Prüfungen - -Die WebUI bietet eine feste Release-ID und zeigt gespeicherte Releases sowie -alle Update-/Rollbackbindungen vor Genehmigung. Sie prüft ursprüngliche -Planhashbytes, rekonstruiert den gesamten kanonischen Updateplan und Jobhash, -dekodiert den kanonischen Envelope und prüft Manifest-/Envelopehashes und -genau zwei Artefakte je Versuch. Byte-/Ansichtsänderung sperrt die Freigabe. -Signaturprüfung gegen provisionierte Schlüssel bleibt Server/Helperaufgabe; -die Anzeige eines Key-ID-Feldes behauptet keine eigene UI-Vertrauenskette. -Ein getrenntes Katalogformular nimmt den signierten Envelope und genau zwei -Dateiauswahlen entgegen. Der Browser übergibt die Filebodies direkt, ohne im -Anwendungscode ein vollständiges Binary-ArrayBuffer anzulegen. Der Server -prüft die vollständigen Hashes und Längen. Erst zwei bestätigte Importbelege -führen zur getrennten Veröffentlichung der signierten Metadaten. Fehlgeschlagene -Schritte erzeugen keine automatischen Retries oder Installationsjobs; tatsächliche -Teilimportbelege bleiben im Fehlerzustand sichtbar. Sitzungs-/CSRFdaten bleiben -im normalen Browserkontext, kein Tokenexport für einen separaten Approver. - -Tatsächlich lokal ausgeführt, kein RMM-Server oder -Agent auf dem Notebook: - -- Server `cargo check --locked --offline -p rmm-server` bestanden. -- Server `cargo test --locked --offline -p rmm-server --bin rmm-server`: - **43bestanden,0fehlgeschlagen,5bestehende DB-Fälle ausdrücklich ignoriert**. - Einschließlich vollständigem echten Rustcodec-Plan, exakter per-Versuch- - Artefaktmenge, verweigerten freien lokalen Pins und großem Store mit - Trunkierungs-/Korruptions-/Fremdtenant-/Legacygrößengrenzen. -- Server Clippy für alle Targets mit `-D warnings` und gezielte Formatierung - bestanden. Unveränderter Verifier und alte nativen Runner nicht umgeschrieben. -- Web Typecheck, Vitebuild und **54/54Tests** bestanden, davon fünf neue - gezielte Updateprüfungen mit tatsächlichen Rustcodec-Fixtures. Diese enthalten - ausdrücklich synthetische Signaturen und dürfen niemals publiziert/ausgeführt - oder als Kryptografie-/Releasequalifikation ausgegeben werden. - Der zusätzliche Filetransportfall verweigert falsche Länge und widersprüchliche - Importbelege und prüft direkte Filebodyübergabe an die feste gleiche Origin; - dies ist noch kein Browser-/Netzwerk- oder nativer großer Streamnachweis. -- Frischer isolierter PostgreSQL17.6 ohne Netzwerk/Ports: Migrationen1–15 als - Nicht-Superuser-Migrator ausgeführt; Tenant-RLS, fehlender und nach Commit - zurückgesetzter Kontext, Cross-Tenant-FKs, App-UPDATE-/DELETEverweigerung, - unveränderliche Inhalte auch gegenüber dem Migrator und null neue Jobs, - Outbox, Grants/Autorisierungen bestanden. Eigener Testcontainer entfernt. - Fall `postgres-19cdb94c…`, ResultatSHA256 - `bbb649a184e59a645f638d39f2e3182df6aef39353bff0bf43712f03297c99ce`. - Dieser SQLnachweis ersetzt die fünf ausgelassenen anderen DB-Fälle nicht. - -Anfänglicher Web-Typecheck erreichte wegen fehlendem `tsc` noch keine Prüfung; -nach `npm ci --offline --ignore-scripts` liefen die genannten Prüfungen wirklich. -Ein zwischenzeitlicher `--locked`-Lauf verweigerte vor Compile die noch nicht -abgestimmte Workspace-Lockfortschreibung; erst der koordinierte Lockstand wurde -geprüft. Keine Paketversion wurde für diese Ergänzung gezielt hochgezogen. - -Der unabhängige Review des Server-/WebUI-Abschnitts fand keine kritischen Blocker -an Binding, Autorisierung, Genehmigungsgrenze, RLS oder Store. Die dabei benannten -engen Ergänzungen betreffen die ausdrückliche Uploadfrist und die eigene passive -Updaterquelle; Gesamtintegration und Zielabnahme bleiben davon getrennt. -Nach diesen beiden Änderungen wurden Servercheck und Clippy für alle Servertargets -mit unverändertem Lock/offline und `-D warnings` erneut tatsächlich bestanden; -`git diff --check` war sauber. Für diese erste Ergänzung blieb die WebUI -unverändert und wurde nicht erneut gebaut oder getestet. Ein180s-Netzwerklauf -wurde für diese kleine Quellenergänzung nicht -ausgeführt; die vier ausdrücklichen Deadlineprüfungen sind Quellencodebefund, -kein behaupteter nativer Last-/Zeitnachweis. - -Beim folgenden separaten Healthkey-Vertragsnachtrag wurden die drei Codec-Fixtures -erneut direkt aus dem erweiterten Rustbeispiel erzeugt. Die WebUI bekam dafür die -strikte kanonische Feldfolge und verlangt beide Healthbindungen. Tatsächlich -erneut bestanden: Web-Typecheck, Vitebuild, die fünf relevanten Update-Webtests -einschließlich Anzeige beider Healthfelder sowie Server-Clippy aller Targets mit -`-D warnings`, unverändertem Lock und offline und die beiden gezielten -`agent_updates::tests` mit den neu erzeugten Rustcodecbytes. Die übrigen49Webtests wurden nach -diesem begrenzten Nachtrag nicht erneut ausgeführt; der frühere54/54-Lauf bleibt -als früherer Nachweis ausgewiesen. Keine native Health-/Applyprüfung daraus abgeleitet. - -**Noch offen:** Vollständiger aktueller -Linuxruntime-/Handoff-/Health-/Rollbackanschluss, echte signierte Releaseveröffentlichung, -qualifizierter Updaterbootstrap und Linux-first-VM-/WebUI-Applyabnahme; danach -Windows. Produktionsadapter, Dauerbetrieb und Kapazität sind nicht abgenommen. -Alle Zielaktionen und Genehmigungen bleiben ausschließlich beim Hauptagenten. diff --git a/docs/agent-updater-windows-contracts.md b/docs/agent-updater-windows-contracts.md deleted file mode 100644 index 334ecc7..0000000 --- a/docs/agent-updater-windows-contracts.md +++ /dev/null @@ -1,103 +0,0 @@ -# Windows-GNU-Pack für den reinen Updater-Prüfkern - -Stand 2026-11-14: Derselbe unveränderte Prüfkern aus `cc5c935` wurde nach dem -tatsächlichen Cloud-Linux-Ergebnis9/9 für `x86_64-pc-windows-gnu` gebaut. -**Anschließend nativ auf der Windows-Test-VM:9/9 bestanden.** Dies ist weder ein MSVC-Build noch -ein Nachweis für Agentdienst, LocalService/SYSTEM, Zeitvertrauen oder Apply. - -Der neue separate Runner `deploy/agent_updater_windows_contracts.py` bindet -den vollständigen tatsächlichen Linuxproof -`bb98bdbd010d23e2905cdffa37b2ad38639b43c770ed2efafd7fa9ac8a22f9d4`, -dessen Originalmanifest und die vollständigen neun Testnamen. Der bestehende -Linux-Runner `22e7e0a8…` bleibt unverändert; sein ursprüngliches Samecase- -Readback wird durch diese neue Windowsquelle nicht geändert. - -Tatsächlich lokal ausgeführt: - -```text -python3 deploy/agent_updater_windows_contracts.py build-local -``` - -Gepinntes Offline-Dockerimage mit Rust1.99.1 und GNU-Windows-Toolchain: -`sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9`. -Quellmount nur lesbar, eigener Targetordner. Windows-Clippy für alle Targets -mit `-D warnings` und Release-Link der einzigen `release_contract`-Testexe -bestanden; kein neuer Fremddep und keine Kernquelländerung. Die ungestrippte -Originaldatei bleibt neben der gesonderten debuggestrippten Auslieferung erhalten. - -Erster Packfall `build-f15c6c7d-5ff3-421d-b568-2ef0d3c5b649` blieb nach -erfolgreichem Clippy/Link ohne Manifest stehen: Die enge DLL-Prüfung kannte das -von Rust-std importierte `api-ms-win-core-synch-l1-2-0.dll` noch nicht. Nur dieses -beobachtete Windows-API-Set wurde zusätzlich zugelassen. Ein neuer lokaler -Packfall verwendete dieselben unveränderten Kernquellen und gecachten Linkbytes; -alte Reports bleiben erhalten. Keine Windows-Unit wurde dabei ausgeführt. - -Aktueller Packmanifest: -`devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json`, -SHA256 `341e58c254b0848b0553ddf6cd04bb7c322e73752c9a2c87f1d2162991648bf8`. -PE-x64-Auslieferung2537309Bytes, SHA256 -`6c1d3d679c8558c50049c51755784863fc38f57c77c80e6ef005d89f09542396`. -Importe: `KERNEL32.dll`, `USERENV.dll`, `WS2_32.dll`, -`api-ms-win-core-synch-l1-2-0.dll`, `bcryptprimitives.dll`, `msvcrt.dll`, -`ntdll.dll`. Das sind beobachtete Imports, kein bestandener Loadernachweis. - -Python-Syntax, unveränderter vollständiger Linuxproof, sechs Ergebnis- -Verweigerungsfälle, ausschließlich lesendes Samecase-Readback ohne Upload -und fehlendes Native-Opt-in wurden lokal geprüft. Der geschützte Beleg -`local-driver-guards.json` liegt beim Manifest. Kein SSH, keine Zugangsdaten- -abfrage, kein Notebookagent und keine VM-/Dienst-/Policy-/RMM-Jobaktion. -Der Orchestrator prüfte anschließend die vollständige Remotequelle mit dem -vorhandenen lokalen PowerShell-AST-Parser erfolgreich. Der tatsächlich erzeugte -SSH-Prozessaufruf umfasst17874Zeichen und liegt unter der32767Zeichen-Grenze. -Der Verifier-Subagent führte weiterhin keine eigene SSH-/VM-Aktion aus. - -**Nach Sourceprüfung tatsächlich durch den Eltern-Orchestrator auf der -festgelegten Windows-Test-VM ausgeführt:** - -```text -python3 deploy/agent_updater_windows_contracts.py windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native-tests -``` - -Nur dieser explizite Aufruf liest den bestehenden privaten Zugang über -`credentials/server.conf`, `credentials/windows-dev-access.json` und den -bestätigten Windows-Hostkey. Keine Zugangsdaten oder Transportpräfixe in diesem -Beleg. Er erzeugt einen neuen privaten Bootstrap-Scratchfall und überprüft -vor dem einzigen Testlauf tatsächlich alle neun erwarteten Namen. Die Tests -laufen als Bootstrapadministrator mit geleerter Umgebung und begrenzter -Laufzeit/Ausgabe. Ein dauerhaftes Create-once-Intent verhindert Wiederholung. - -Nach Antwortverlust niemals neu starten oder neu hochladen; die ursprüngliche -UUID steht im lokalen `devstate/agent-updater-windows//intent.json`. -Ausschließlich desselben Falls lesend abgleichen: - -```text -python3 deploy/agent_updater_windows_contracts.py readback-windows --manifest /home/kevin/Schreibtisch/Coding/rust-discovery-agent-updater/devstate/agent-updater-windows/build-5a9b7b49-39ba-4d34-b627-b3298886aa18/manifest.json --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --case -``` - -Erst ein vollständiger tatsächlicher9/9-Beleg ohne Skip erzeugt -`windows-gnu-passed.json`. Auch dieser Erfolg qualifiziert nur den reinen -GNU-Prüfkern auf dem Windowsgast, keine installierte -Selbstupdatefunktion oder MSVC-Agentlaufzeit. Normreview, Releasekatalog, -Streaming-/Plan-/WebUI-Bindung und eigenständiger Updater mit erhaltendem -Code-/Pin-Austausch bleiben ausdrücklich offen. - -## Tatsächliche native Windows-GNU-Ergebnisse - -Rootfall `1a6dba2a-0db3-4aa8-8e21-dafcaabf85e3`: Tatsächliche Liste aller neun -gebundenen Testnamen zuerst geprüft, anschließend9/9 ohne Skip bestanden, -Exitcode0, kein Timeout und keine Fehlerausgabe. Die Nativeexe entspricht -exakt der oben genannten Auslieferung und ist an den ursprünglichen tatsächlichen -Linuxproof gebunden. Geschützter Beleg `windows-gnu-passed.json` neben dem -Packmanifest, SHA256 -`fc6ef028f0d71639b940914d2cf66e809ed96f9803b4b0b10ea63c6e08978493`. -Der Beleg wurde gegen Fall, Manifest, Linuxproof, Artefakt und alle neun Namen -zurückgeprüft. - -Das tatsächliche Ergebnis weist ausdrücklich `local_service_proof=false`, -`system_proof=false`, `msvc_runtime_qualified=false`, `rmm_jobs=false` und -`activation_implemented=false` aus. Die Units liefen ausschließlich im eigenen -Bootstrap-Scratchfall; keine Agent-/Helperinstallation oder Policyänderung. -Damit ist derselbe reine Prüfkern **zuerst auf Cloud-Linux, danach auf dem -Windowsgast als GNU-Unitbinary** nativ qualifiziert. Der Autoupdater selbst -bleibt bis zur gesonderten Runtime-/Genehmigungs-/Health-/Rollbackintegration -unimplementiert. diff --git a/docs/agent-updater-worker.md b/docs/agent-updater-worker.md deleted file mode 100644 index da59072..0000000 --- a/docs/agent-updater-worker.md +++ /dev/null @@ -1,210 +0,0 @@ -# Linux-Worker: konkreter Zwischenstand - -2026-11-14, Spezifikation1.21. `crates/updater-worker` ergänzt die eingefrorenen -Linux-OS-Primitiven; es ist noch kein ausgelieferter Updaterdienst und keine -Applycapability. Keine Zielaktion oder Genehmigung durch diesen Quellschnitt. - -## Implementiert - -`NativeClock` verwendet eine tatsächlich lesende `adjtimex`-Abfrage samt -Synchronisations-/Fehlergrenze und vergleicht die laufende Wanduhr mit dem -monotonen ursprünglichen Prozessbezug. IPC-/Serverzeit ist kein Ersatz. - -`Original` prüft den erhaltenen Originalrequest einschließlich Originalsignatur -bei dessen unveränderlichem Verbrauchszeitpunkt. Exakte Rekonstruktion des alten -Startzeugen, Plan-/Job-/Versuchs-/Grant-/Authorizationbindung, Generationen, -Codepaar, Fulltransition und ursprünglicher Boot müssen stimmen. Aktuelle Uhr, -Boot und Gesamtfrist bleiben vor späteren Schritten verpflichtend; der alte -Startzeitpunkt ist ausdrücklich kein erneuertes Startfenster. - -`RetainedSet` hält Dateideskriptoren und Parent-/Dateiidentitäten. Für Schlüssel -und Konfiguration werden zusätzliche Metadatenstempel verglichen, ohne private -Schlüsselbytes zu lesen oder auszugeben; mutable Datenbanken dürfen bei gleicher -Dateiidentität fortschreiten. Die konkrete vollständig erforderliche Dateiliste -muss aus separat geprüfter lokaler Provisionierung kommen. Eine Teilmenge ist -kein vollständiger History-/PKI-Erhaltungsnachweis. - -`FullFiles` liest die konkreten geschützten Rawconfig-/Rawpinbytes sowie die -unabhängig provisionierte öffentliche Jobsignierkeydatei. Der vorhandene reine -Fullrenderer muss exakt den vor WebUI-Genehmigung gebundenen Transitionbeleg -ergeben. Nur dessen exakte Config-/Pinbytes werden create-only gestaged. - -`StableParticipant` verlangt den tatsächlichen eigenen MainPID des festen -Updaterdiensts mit Prozessgeburt, aktuellem Image, Konto und Unitkomposition. -Die ursprüngliche konkrete Helperinstanz wird ebenso gegen die atomare -Delegation geprüft. `/proc`-/Capabilityfehler werden verweigert; kein UID0-, -Prozessname- oder installierter-Dateipfad-Fallback. Getrennte tatsächliche -General-/Full-/Updater-Dienstkontexte sind noch nativ zu qualifizieren. - -`TrustState` lädt ausschließlich geschützte feste Policy-/Keyring-/Healthpin- -und InstalledRecord-Dateien. Originale rohe Hashes bleiben maßgeblich. Die -initiale Baseline benötigt ihre gesonderte Ed25519-Domänensignatur; aktuelle -Schlüsselwiderrufe/-bereiche und Releaseverifikation werden unabhängig geprüft. -Health-/Release-/Jobkeys werden getrennt geprüft. Historische read-only Lader -sind von aktueller Candidate-/Clock-/Boot-/Revocationprüfung getrennt und -erteilen keine Wirkungserlaubnis. `qualify_history` lädt kanonische Rawrecords -am festen geschützten `records/.json`-Pfad, begrenzt auf64Records/2MiB, -und prüft die vollständige Originalledger-/Baseline-/Health-/Outcome-Kette. -Der originale Fullguard muss dies vor Verbrauch/Stopclaims tun; der Updater -wiederholt es unter dem tatsächlich übernommenen Guard vor dem ersten Swap. -Keine Floorableitung aus einem bloß geparsten Record, kein Releaseprivatkey -auf dem Client. Die getrennte TLS-Keyprovisionierung bleibt ein Bootstrapgate. - -`FileWitnesses` bindet die vier tatsächlich vorhandenen Original-/Stageproofs. -Es liest vor jedem einzelnen Schritt unabhängig Original, Stage, erhaltenes -Backup oder neues Ziel nach. Historisch gebundene Hardlinks werden erhalten. - -`OwnedLedger` öffnet ausschließlich die vorhandene `consumption.sqlite` ohne -CREATE, nachdem ein echter Linux-OS-Guard alle installierten Reader gestoppt -bestätigt hat. Derselbe Ledger-/Lockinode, Originalstart, vollständiger -Handoffhead und null weitere offene Verbräuche bleiben Pflicht. Der konkrete -Coreguard verifiziert tatsächliche Prozesse, Dateien und Statezeugnisse vor -append-only Handoff-CAS und nativen Effectintents im selben Ledger. - -`LedgerFence` verwendet die konkreten Core-APIs `claim_native_effect` und -`observe_native_effect`. Pro Datei bleibt genau ein Kernel-ReplaceIntent; -SavePredecessor und PublishReplacement erhalten getrennte dauerhafte native -Intents und Nachlese. Ein fehlgeschlagener/mehrdeutiger Schritt vergiftet den -laufenden Fence; keine Resume-/Retrykonstruktion aus einem Teilintent. - -Hinzugekommen sind eine konkrete streng gebundene Full-Control-Bridge auf dem -bestehenden festen Maintenancesocket und kanonische wiederöffnungsfähige -Witnessbundles. Die Bridge prüft tatsächlichen Fullpeer/PID/Geburt/Image, -Challenge, Originaltupel und monotonen vollständigen Präfix; Request32KiB, -Reply1536KiB sowie gesamte IOfrist sind begrenzt. Ein verlorener mutierender -Reply berechtigt keinen Retry. Header und ursprüngliche Dateistamps bleiben -create-only unter dem Originalgrant geschützt; echte Nachlese bleibt getrennt. - -`prepare_return_and_close` persistiert Returnintent plus genau drei Startclaims -atomar und schließt SQLite vor der wirklichen Guardabgabe. Das nichtklonbare -Rückgabeticket enthält keinen Borrow des alten Guards. Der Startfence prüft -freigegebenen Lock, vollständiges Paar und General/Full/Agent genau einmal; -vor Agentstart wird der neue Full erneut lesend zum Originalversuch befragt. -Native Startresultate werden als tatsächliche gehaltene Prozesse vor/nach der -Fullquittung nachgeprüft. Dieser Anschluss ist noch kein gestarteter Enginepfad. - -## Offen und standardmäßig verweigert - -Vollständige Engine/Daemonhülle und originale aktivierungsgebundene Stageaufnahme, -Stopfence/Drive-Schleife außerhalb des alten synchronen Helpercalls, -drei Stopbeobachtungen vor AllStopped und die vollständige Runtimeverdrahtung -von Guardabgabe/Starts/Full-Observer/Health/Outcome sind noch offen. -Floor-/InstalledRecordpublikation braucht zusätzlich die geschlossenen -originalen nativen Intents nach Health und erhaltende Record-CAS. Die History- -Prüfung ist Quell-/Unitfunktion; ihr tatsächlicher Runtime-/Archivanschluss muss -vor Folgeupdates separat vollständig nachgewiesen werden. - -Der eingefrorene Vorwärtskernel hat noch keinen qualifizierten Rollbackübergang. -`RestorePredecessor` bleibt deshalb auch bei vorab gebundener Recoveryoption -verweigert; Fehler/Unknown erteilen keinen impliziten Rollback oder Neustart. -Das ist eine offene Apply-/Produktanforderung, kein abgeschlossener Updater. - -## Tatsächliche lokale Prüfung - -Offlinecontainer aus bestehendem Image -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. -Der konkrete Ledger-/Native-Fenceanschluss hat -`cargo check --locked --offline -p rmm-updater-worker --all-targets` -tatsächlich bestanden. Der vollständige aktuelle Checkpoint einschließlich -TrustState bestand danach Clippy mit `-D warnings` für alle Crate-Targets. -Ein Box-Typfehler und zwei unnötige `as_ref`-Aufrufe wurden -korrigiert, ohne Typ- oder Lintunterdrückung. - -Der unabhängige Rootreview fand danach einen konkreten historischen -Baselineblocker: `active_release=None` bei `floor=baseline_sequence` -verweigert im unveränderten Frozenverifier jede legitime Baseline. Die tatsächliche -historische Prüfung bindet jetzt die exakte aktive Baseline-Sequenz und deren -Manifesthash; der Floor bleibt unverändert und Kandidaten bleiben aktuell. -Der gezielte reale Ed25519-Gegenbeleg benutzt einen kanonischen separat -baseline-signierten InstalledRecord und echte Release-Signaturen. Die private -Rückmutation auf den alten `None`-Kontext scheiterte erwartungsgemäß genau an der -Baselineprüfung (Exit101); derselbe Release-Test mit Korrektur bestand **1/1**. -Neuer aktueller Kandidat oberhalb des Floors besteht, gleiche/niedrigere Sequenz -mit anderen Bytes, abgelaufenes Angebot und widerrufener Baselinekey werden -verweigert. Release-Test, Clippy `-D warnings` und Formatcheck bestanden aus -derselben privaten Quellkopie. Kein Frozenverifier wurde dafür verändert. -Privater Nachweis: -`devstate/agent-updater-worker/baseline-fix-1fcc8bb2-57fe-4425-b166-f416dc1b4703/`. - -Neuer Übergabecheckpoint nach Bridge/Bundle/Returnticket, historischem -Unknown-only-Split und Historyreviewfixes: private eingefrorene Quellkopie -`devstate/agent-updater-worker/handoff-43ade361-9726-4fb4-8e97-cae19c22c6d0/`. -Release **3/3**, keine Skips/Filter, Clippy `-D warnings` und Formatcheck -tatsächlich bestanden. Fälle: signierter Baseline-/Floor-Gegenbeleg, wirklicher -State-Inode-/Originalstamp-Reopen und vollständig signierte History inklusive -konkreter Tamper-/Rollback-/Fork-/Claim-/Completionfehler bei unveränderten -SQLite-Änderungszählern. Receipt-SHA256: -`30425acbffaa05578fd17ee25a2e3f42976fe4237423e874635c49aa0fcb4990`. -Workerquellsatz: -`793efb917979ca59e95cdf0ff01d75b16c75a79d8392bc557f0864728d558cf1`. -Die erste private Kopie fehlte um die `include_str`-Goldenfixture; der daraus -resultierende Compilerfehler bleibt mit seinen Originallogs erhalten. Nach -Ergänzung exakt derselben Repo-Fixture wurden die genannten Checks ausgeführt. -Private Verzeichnisse700/Dateien600/qualifizierte Exe500 sind explizit gesetzt. - -Keine Engine gestartet, kein systemd-Aufruf, keine echte Zieldatei geändert, -keine VM/SSH-/Job-/WebUI-Aktion und kein nativer Worker-/Applynachweis. -Der native Linux-OS5-Nachweis qualifiziert weiterhin dessen eigene eingefrorene -Primitiven und ersetzt keine Worker-/Dienstkontextabnahme. - -## Anschließender gemeinsamer Runtimeanschluss - -Die historische3er-Qualifikation oben bleibt unverändert. Danach wurden die -feste Recordtransition und der konkrete Full-Namespace-/Fenceadapter verbunden; -der gemeinsame lokale200er-Lauf enthält5Workerfälle. Die2zusätzlichen Root-/run- -FS-Fälle beweisen getrennte echte Recordrenames/Originalinodeerhalt und Abweisung -von namensgleichen Ersatzdateien/Currentkollisionen ohne Resume. Sie qualifizieren -keine echte UI-/Job-/Service-/Rootguardwirkung und umgehen ausdrücklich den -öffentlichen authentisierten BuiltRecordeingang. Aktueller Source-/Nachweisstand -und restliche Engine-/Admission-/Rollback-/Nativegates: -[Runtimefortschreibung](agent-updater-runtime-source.md). - -## Einmalige Queue-/Drivefolge und vorhandene Agent-Singletonsperre - -Am2026-11-15 liegt `worker::engine::Runtime` als noch gesperrter Quellschnitt -vor. Der vorhandene IPC-Activatehandler queuet ausschließlich den originalen -Handoff; die private Drivefolge ist erst nach vollständig geschriebenem Reply -und geschlossener Accepted-Verbindung erreichbar. Eine verlorene Antwort -verwirft die Queue und sperrt dieselbe Runtime. Die erste Fullbridge-Lesung -übernimmt den tatsächlich authentisierten Originalpräfix; vorher sind alle -mutierenden Methoden gesperrt und kein Event wird aus Headerdaten erfunden. - -Die Folge verbindet Originalsignatur-/Policy-/Floor-/Dateibeobachtungen, alle -drei Full-Stopclaims vor irgendeinem Stop, die tatsächlichen Stopbeobachtungen -im Originalledger nach Guardübernahme, AllStopped/Owns, vier getrennte -Save-/Publishpaare, Pair, Return-/Startreservation, tatsächlichen DBclose und -flockdrop, General→Full→Agent und neue Full-Start-/Health-/Recordbestätigung. -Es gibt keinen Resume oder Restore. Ein Fehler bei den Fileübergängen versucht -unter dem noch gehaltenen Originalguard genau einen Unknown-CAS und startet -keinen Dienst neu. Native Dienst-/Fehlerfolgen sind damit noch nicht bewiesen. - -Zusätzlich wird die vorhandene `/var/lib/rmm-agent-remote/agent.lock` aus dem -OriginalRetainedSet gebunden: unveränderter Inode, UID993/GID984/0600/nlink1, -0Bytes und privater Parent. Nach echtem StoppedServices-Beleg nimmt der Worker -diese vorhandene Sperre exklusiv ohne CREATE. Sie bleibt über Root-DB/Swap/ -DBclose/Rootlockreturn gehalten und wird vor der festen Startfolge zurückgegeben. -Der Agent hält schon heute seine ursprüngliche Singletondatei vor beiden -Agent-SQLiteöffnungen; keine ACL, Agentdatei oder Sperrrolle wurde geändert. - -Der ursprüngliche Quellencheckpoint verweigerte den Eintritt explizit mit -`UPDATE_READER_CENSUS_NOT_CONFIGURED`. Die Fortschreibung verbindet jetzt die -Registry sowie tatsächliche Task-/FD-/maps-Census vor den Stops und unter beiden -gehaltenen ursprünglichen Sperren danach. Diese Quellintegration ist lokal -geprüft, jedoch noch nicht als installierter Dienst-/Hostkontext qualifiziert. -Eine bekannte Unitliste allein ersetzt keinen Census. Keine CLI oder -RMM-Admission ruft diese Runtime auf; Applycaps bleiben geschlossen. Offen sind -insbesondere extern qualifizierte kompatible Bootstrapregistry und Hostkontexte, -ursprüngliche Full-Admission, Staging-/Downloadproducer, passiver gültiger -Updatezustand, V2-Rollbackvertrag vor dem ersten Bootstrap, Unsicherheits- -Namespaces und tatsächlicher Linux-Apply. Aktueller Nachweis und enger geplanter -nativer Zweierlauf: [Readercensus](agent-updater-reader-census-results.md). - -Lokaler Nachweis liegt unter -`devstate/updater-engine-source-6a8bb902-4db4-4d93-8843-450ba1dd5622/`. -Der7er-Workerlauf umfasst jetzt auch den **öffentlichen** BuiltRecordbuilder: -Originalsignierter Job und echte vollständig signierte History ergeben exakt -die erwarteten Rawrecordbytes. Ein für einen fremden externen Healthkey gültiger -Journal bleibt unter dem Originaljobkey unzulässig; geänderter Head/prior wird -verweigert. Ein separater echter Container-FS-Fall belegt die Agent-Singleton- -Aliasblockade und Ablehnung eines gleichbyteigen Inodeersatzes. Dies sind lokale -Krypto-/FS-Verträge; sie führen die Queue-/Drive-/Dienstfolge nicht aus. diff --git a/docs/apt-ambient-reboot.md b/docs/apt-ambient-reboot.md deleted file mode 100644 index 0d8f07d..0000000 --- a/docs/apt-ambient-reboot.md +++ /dev/null @@ -1,167 +0,0 @@ -# APT host reboot evidence and the configured historical attempt - -Actual result on 2026-11-13: the Cloud Linux VM's historical configure attempt -`33775478-15b0-46ec-b059-44f500dbb0b6` is now **failed** with -`APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED`. The package effect -completed, but this is a failed acceptance, not an accepted installation. -Normal signed RootSync closed the same attempt; no new job or package command -was used for this classification. The notebook remains development-only and -the server remains `discovery.ease-technologies.de`. - -## Why the earlier result was unknown - -The separately WebUI-approved configure-only job configured fixture `1.0` and -returned APT exit 0 with the expected hook armed. Its private sandbox reported -no reboot marker. The parent observed the host's reboot-required marker, so -the previous provider returned `FIXTURE_UNEXPECTED_REBOOT_REQUIRED` and kept -the attempt unknown. That provider had not measured the host flag before the -effect. A private `/run` observation cannot establish the host's earlier state. -The marker's timestamp does not replace that missing measurement. - -The original failed unpacked attempt -`31ef5e5e-5dbd-4428-a9a1-cbd15de2f5a0`, its partial proof -`dc3bf3870ea77c12f9291bac712c53ae72194eaec980a8646155a7fb5c0dbe21`, -both bootstrap tombstones and the configure attempt marker remain intact. -Neither an install acceptance nor a recovery acceptance was created for 337. - -## New provider contract - -Spec 1.13 permits a fully verified package result with an already pending host -reboot. For future mutating jobs, the parent now seals the host flag and boot ID -before entering the sandbox. Native prechecks schema 2 binds that record's hash. -After package verification the parent requires the same host flag and boot ID; -the child must still report no sandbox reboot marker. Both false/false and -true/true are valid. Either flag transition or a changed boot ID denies acceptance. -The reported `reboot_required` remains truthful, and -`reboot_required_introduced` is false. No reboot is initiated by these jobs. - -Fresh planning exposes `host_reboot_required`. If it is true, the immutable -plan reason displayed for approval includes -“Host reboot already required; flag unchanged; no reboot in this job”. -Browser preparation and approval both verify the reason in the canonical -persisted plan payload. The new runtime uses the separate -`configured-reconcile-runtime/cases/` namespace and refuses to repeat the -historical configure-only operation. - -The historical read-only verifier accepts only the exact saved 337 context, -signed action and old runtime bindings, original partial reference, 13 immutable -evidence files, APT 0/armed hook and original configure-only protocol. It checks -the complete installed snapshot twice, unchanged other packages, payload, -empty audit, idle locks, same boot and stable current host marker. It produces -a new failed classification with `effect_complete=true`, -`postconditions_passed=false` and `reboot_required=true`; it cannot manufacture -the missing before sample or a success record. See -[the helper contract](../tools/apt-transaction/HELPER-CONTRACT.md). - -## Actually executed verification - -All **81 Python tests passed without skips** in the offline, read-only Docker -development image as UID 1000. This included the real APT 2.6.2 protocol and -argument regressions with a fake dpkg collector, which changed neither host nor -copied package status. Targeted coverage includes both equal flag states, -both forbidden transitions, missing before evidence, changed boot, private -marker rejection, acceptance-record binding and strict historical failure -classification. These local tests supplement the native evidence below. - -Python AST, browser JavaScript syntax and `git diff --check` also passed. -The qualified provider SHA256 is -`1dc0237dd8df9c9d22568bb1f6b047ede73bc2a5fca5c7fcedb7f24ab2a58b1e`; -the installed x86-64 helper is -`bbd2cf80a4e67b8a37ba3845c2bbed8b3c84d1eb01c1ac515a34577c8caa8ad0` -and agent is -`f40c7e2646e8122f5320c0909b0172ed8c749c218ec76b7ba3b8b397eb970671`. - -The preserving native runtime upgrade completed. Its SSH response timed out; -an independent readback proved the completed report and all three installed -hashes, so it was not repeated. The probe and report certify runtime readiness, -not package acceptance. Normal RootSync then stored one append-only effect -reconciliation, preserved the original unknown bytes and closed the original -337 grant as failed. The actual Root ledger has **11 consumed, 0 unresolved, -0 faults**; central counts are **20 jobs, 20 outbox entries, 18 permits, -0 unresolved**. The earlier partial proof is unchanged and all forbidden -acceptance records remain absent. - -Protected local witnesses, excluded from Git: - -- `devstate/cloud-apt-recovery/configured-reconcile-runtime.json` -- `devstate/cloud-apt-recovery/configured-maintenance-completed-readback.json` -- `devstate/cloud-apt-recovery/capacity-recovery/configured-closure-3b7e66aba1b1495db1675eaab5117393.json` -- `devstate/cloud-apt-recovery/helper-configured-reconcile.json` -- `devstate/cloud-apt-recovery/agent-configured-reconcile.json` - -At this checkpoint, the new provider's separately approved native `1.0`→`1.1` -upgrade and following no-change jobs remain outstanding. The historical -classification is not their acceptance and does not complete the Linux MVP. - -## Subsequent actual native 1.1 acceptance - -The next separate immutable plan passed its actual simulated dev/test WebUI -approval and native Cloud execution. Before approval0jobs/0outbox/0permits; -afterward exactly1/1/1 and0unresolved. Grant -`6b68c65b-8c0c-4cab-964d-e12a2d7f0626`, Root consumption12, succeeded with -`postconditions_passed=true`, independently verified installed fixture1.1, -payload SHA256`1523e9e982ff804c6d979e1bb2c6f3d7bae35307e8ce458bffc0d12a442b98da` -and native record`a88d6b10bbf6c36eaa8dee87eb1a381f2becc36297db8df2b4189791b9165506`. -The bound host flag was actually true before and after, introductionfalse, -truthful result`reboot_required=true`; no reboot was initiated. No OS/kernel -upgrade or change outside the harmless fixture is claimed. - -Private verified checkpoint: -`devstate/cloud-apt-recovery/configured-reconcile-runtime/cases/apt_native_update/checkpoint.json`. -The two separate normal1.1-noop plans and remaining MVP gates are still open. - -The first separate `ensure_package` plan subsequently ended **failed** with -`STATUS_FINGERPRINT`, grant`b7fbd250-c382-4d2f-950d-ae6001e4c48e`/Root13. -Its actual UI audit and counts1/1/1/0 are retained. It reused exactly the -pre-upgrade baseline and status fingerprint; the native update's verified -post-snapshot was different. The under90-second observation-age check alone -therefore did not establish post-update freshness. The immutable failed plan -is not a passed noop and is never reactivated. The minimal next preparation -must bind a newly stored passive installed1.1 observation to the accepted -post-snapshot; any new attempt needs its own pending0/0/0 and actual WebUI click. -No provider/helper change or replacement of the accepted1.1 record is needed. - -Actual read-only preflight then proved the exact terminal Root13 outcome, -active handoff13 with no launch/hook/prechecks/child result, and retained native12 -acceptance plus original31/337 proofs. Root13/0unresolved/0faults. Protected -report`configured-reconcile-runtime/noop-preflight-d140758efc3e421b91550d3dd52d5d7a.json`. - -The fresh, separately WebUI-approved `ensure_package` then passed on the actual -Cloud VM: pending0/0/0 →1job/1outbox/1permit/0unresolved. Its newly stored passive -planning observation was after the accepted update read and matched the exact -verified installed1.1 post-snapshot. Result succeeded with independently met -postconditions, `changed=false`, `already_desired=true`, -`transaction_executed=false`, and `postcondition_already_met=true`. -The first failed plan is unchanged. Protected successful checkpoint: -`configured-reconcile-runtime/cases/no-change-retry/ensure_package/checkpoint.json`. -The separate `apply_updates` noop remains open. - -Finally the separate `apply_updates` noop passed natively as well, grant -`c267f82b-328f-4d36-8d70-9aa81108646d`/Root15, same exact1.1 post-snapshot and -truthful reboot flag. Both noop results have complete postconditions and -explicitly no transaction. APT test policy was then closed, endpoint removed -and service stopped. This completes bounded fixture M4; the other MVP gates -remain open. Successful apply checkpoint is -`configured-reconcile-runtime/cases/apply_updates/checkpoint.json`. - -The SDK fix is implemented and locally qualified: **29 pure harness guard -tests passed**. A no-change preparation now independently reads the completed, -verified native upgrade, then waits for a passive observation collected after -that read. It requires installed fixture `1.1` and the exact full baseline hash -from the native upgrade's postconditions. The earlier observation's under -90-second age is insufficient. A saved preparation witness records that time -barrier, observation time and baseline/fingerprint. - -The explicit `--new-noop-after-definitive-no-effect` option additionally checks -the old immutable failed plan, its single authoritative grant and a read-only -Root-ledger/context proof that the `STATUS_FINGERPRINT` failure occurred before -launch or hook arming. It creates a separate -`cases/no-change-retry/ensure_package/` directory; the original checkpoint is -retained. The next actual browser flow still creates a new pending plan and -requires its own approval. These commands are **prepared, not executed by this -source qualification**: - -```sh -python3 deploy/cloud_apt_recovery.py accept --case ensure_package --new-noop-after-definitive-no-effect -python3 deploy/cloud_apt_recovery.py finish --case ensure_package --new-noop-after-definitive-no-effect -``` diff --git a/docs/cloud-offline-acceptance.md b/docs/cloud-offline-acceptance.md deleted file mode 100644 index 9ddab12..0000000 --- a/docs/cloud-offline-acceptance.md +++ /dev/null @@ -1,231 +0,0 @@ -# Cloud-Abnahme: Offlinefenster, Ablauf und Genehmigungsentzug - -## Genehmigungsentzug nativ bestanden; alle drei Offlinefälle belegt - -Fall`68148362-e21e-4bd0-9126-12e5a6e03945`: eigener fester tatsächlicher UI-Klick -nach pending0/0/0, dauerhafte Annahme ohne Grant, geprüfte aktive Netzsperre. -Die spätere echte WebUI-Widerrufshandlung war erfolgreich: gleicher Plan/ -Operation, simuliertes Principal/Audit samt interaktiver Sitzung und genau eine -widerrufene Autorisierung. Der Browserrunner scheiterte **nach** diesem Klick -an seinem Warten auf das kurzlebige Ergebnis-`pre`; der Planreload kann den -AdminControl-Ergebnisbereich neu aufbauen. Kein erneuter Klick/Antrag. - -Stattdessen derselbe Fall kontrolliert fortgesetzt: vorhandenes Audit nur -gelesen, Originalplan/Hashes erhalten, derselbe Agent-PID vor/nach frühestem -Start aktiv und Reconnectsequenz3465→3473, eingefrorener Kontakt vor Start, -weiter0Grants/0Verbrauch/Zählerabsent. Normale Netzregelwiederherstellung -**innerhalb** der ursprünglichen Startfrist, frischer Kanal96/Sync ready um -20:10:21UTC vor`start_before`20:11:24UTC. Ergebnis ausdrücklich`cancelled`, -1Job/1Outbox/**0Grants**/0offen, keine Wirkung/keine Rootledgeränderung. -Diese Abnahme benutzt Vorher-/Nachherbelege und echten Auditnachweis; keine -nachträglich erfundenen lückenlosen Zwischenmessungen. - -Private Belege im Fallordner:`ui-revoke.json`, -`revoke-after-browser-error.json`, `observed-revocation-before-restore.json`, -`observed-revocation-native-accepted.json` mit verifiedtrue. -Der Browser prüft künftig die natürliche tatsächliche POST-Antwort derselben -UI-Handlung statt des transienten Ergebnisbereichs. Nur Syntaxprüfung dieses -Runnerfixes, kein zweiter Widerrufsjob als vermeintlicher Erstnachweis. -Alle drei Offlinevarianten sind nun nativ belegt; Crash/Reboot bleiben offen. - -## Wiederholter Nichtstart-Sync nativ korrigiert - -Gezielter Agentfix qualifiziert und auf der Cloud-VM ausgeführt.20 echte -SQLite-/Signatur-Reconciletests ohne Skips, Format und Agent-Alltargets-Clippy -bestanden. Grantfreie accepted/expired/cancelled-Zeilen behalten das Nichtstart- -Label; tatsächlich vorhandene Verbrauchszeilen überschreiben es weiterhin. -requesting/running/unknown und überlebende Grants bleiben gesperrt. Keine -Serverlockerung und keine Änderung von Helperbbd/Provider1dc/M4Runtime3bac. - -Agent702bd7b5… auf vorhandener Identität und unveränderten Journalbytes vor -Neustart installiert. Normaler ausgehender Kanal Generation93 und signierter -Sync wieder bereit, restore_blockedfalse. Derselbe ursprüngliche Ablaufjob -40edcd4b… jetzt korrekt`expired/DEFINITIVE_NONSTART`, Grantnull, revision0, -unlockfalse;26Jobs/26Outbox/23Grants/0offen unverändert. Keine Repair-CLI, -manuelle DB-/Outcomeänderung oder erneute Ablaufwirkung. -Private Belege`devstate/cloud-apt-recovery/nonstart-agent-install.json`, -`agent-nonstart-sync.json` und`nonstart-sync-native.json`. -UI-Entzug, Crash und Reboot bleiben offen. - -## Nach Ablauf gefundene Sync-Klassifikationslücke - -Vor dem nächsten Fall stoppte der Bereitschaftsguard; Fall09fc228c-e339-409a- -af1c-afe1a9fa9aaa hat **keinen** Plan/Antrag/Job erzeugt. Gespeicherter signierter -Sync zeigt genau den vorherigen Ablaufjob40edcd4b-99c5-43e7-8562-ccdda86c4031 -als`GRANT_OR_EFFECT_UNRESOLVED`. Tatsächlich zentral und lokal expired/revision0, -Grantleer, keine Resultbehauptung; zentral`start_reserved=false`,0Permits und -0Startaudits, beide Consumptionledgers ohne diesen Versuch. Alle15Rootwirkungen -geschlossen/faultfrei, Journalintegrität und Kerneluhr geprüft, kein Platzmangel. - -Ursache: Nach der ersten signierten Nichtstart-Expiry bezeichnete der Agent -denselben grantlosen terminalen Nichtstart beim nächsten Snapshot als -`uncertain`; nur`accepted` bekam das Label`unconsumed`. Der Server verweigert -dieses widersprüchliche Bild korrekt. Eine reine Serverlockerung genügt zudem -nicht, weil auch der Agent terminale beweislose Ergebnisse bei`uncertain` -verweigert. Notwendige Korrektur bleibt auf die richtige Agentklassifikation -des belegten Nichtstarts begrenzt; vorhandene Verbrauchszeilen haben weiterhin -Vorrang, requesting/running/unknown bleiben gesperrt. Noch nicht als native -Korrektur abgenommen; keine Datenbank-/Freigabe-/Unlockabkürzung. -Private tatsächliche Readbacks`09fc.../sync-{server,vm}.json` und -`expired-attempt-{server,vm}.json`; zentrale Historie26/26/23/0 unverändert. - -## Eigenständiger Ablauf bei aktivem Offlineagent bestanden - -Fall`5869480b-d06c-450c-8163-838bf2dda6bc` tatsächlich bestanden: eigener fester -WebUI-Antrag0/0/0, angenommen und ohne Grant offline über`not_before` **und** -`start_before` gehalten. Derselbe Agentprozess blieb aktiv, Reconnectsequenz -stieg, Serverkontakt blieb eingefroren. Erst nach Ablauf wiederverbunden; -Ergebnis ausdrücklich`expired`,1Job/1Outbox/**0Grants**,0offen. Keine native -Consumption und kein Effektzähler. Eigene Transportregel wieder entfernt, -positive TCPkontrolle/normaler signierter Wiederkontakt belegt, Rootledger -unverändert. Verifizierter abschließender nummerierter Checkpoint im Fallordner. -Genehmigungsentzug und Prozessabbruch bleiben eigenständige nächste Abnahmen. - -## Aktiver Offlinefall mit Start nach gültigem Wiederkontakt bestanden - -Tatsächlicher Cloudfall`8d2d0d7c-f844-48b6-bb8d-b9d00c229c5b` bestanden. -Vollständiger positiver Vorher-/Nachher-TCP-Kontrollpfad derselben Cgroup/UID993/ -GID984, positive Außenkontrolle und zwei echte innere Denials. Danach eigener -fester WebUI-Plan: vor Klick0Jobs/0Outbox/0Grants. Dauerhaft angenommen, vor -Start wieder aktiv offline; auch über`not_before` blieb derselbe Agentprozess -aktiv, dauerhafte Reconnectsequenz stieg, null Grants/Consumption/Wirkung, -kein neuer Serverkontakt. Vorfristiger normaler Wiederkontakt lieferte einen -frischen gesunden signierten Sync **vor** genau einer Startreservierung. -Ergebnis succeeded,1Job/1Outbox/1Grant/0offen, nativeConsumption1 und Zähler1. -Vorhandene Rootledger-/Outcomehashes unverändert, keine neue Rootwirkung. - -Innerhalb der ursprünglichen Plan-/Startfrist derselbe MCP-Submit mit demselben -Plan und Idempotenzschlüssel tatsächlich wiederholt: dieselbe Operation, -unverändert1/1/1. Eigene private Receipt und vollständiger verifizierter -Checkpoint`029-native_dev_test_accepted.json` im Fallordner gespeichert. -**Noch offen:** eigene Ablauf-/UI-Entzugsfälle, Crash und übriger MVP-Abschluss. - -## Erster tatsächlicher Preflight, noch kein Job - -Fall`d9663783-9c8c-441a-808e-768bd72bd69a` brach bereits vor Planung/Antrag ab. -Die private Phase000 enthält nur den gesunden Ausgangszustand; kein Job wurde -zur Offlineabnahme angelegt. Tatsächliche operative Metadaten zeigten später -Agent-Autorestarts unter der Netzregel, unveränderte Agent-DB-Eigentümer993:984 -und keine WAL/SHM-Dateien. Ein SQLite-Eigentümerproblem ist damit **nicht als -Ursache nachgewiesen**. Der normale Startpfad mit aktivem einmaligem -Online-Signierschlüsselbootstrap wird vor Fortsetzung geprüft/finalisiert. - -Eigener420s-Rollback entfernte die Testregel; anschließend tatsächlicher -WSS-Kanal Generation86, signierter Sync bereit, `restore_blocked=false`, -Heartbeat19:22:22UTC. Zentrale weiterhin24Jobs/24Outbox/22Grants/0offen. -Private tatsächliche Belege im oben genannten Fallordner: -`preflight-complete-diagnostic.json`, `preflight-exit-metadata.json` und -`restored-central-state.json`. Fehlgeschlagene Probe ist kein bestandener -aktiver Offlinejob; die drei Abnahmefälle bleiben offen. - -Der Probeadapter wurde zusätzlich so korrigiert, dass auch inaktive Dienste -und fehlgeschlagene Unterprozesse ausschließlich begrenzte Zustands-/Owner-/ -Phasen-/Errnometadaten zurückliefern. Keine Rohstderr-/Credentialausgabe. -Feste numerische Probe-GID wird durch die geprüfte tatsächliche Agentgruppe -ersetzt; eigene neue SQLite-Sidecars werden defensiv korrekt zugeordnet und -Verbindungen ausdrücklich geschlossen. Diese Sourcekorrekturen sind noch -kein erfolgreicher vollständiger Offline-Nachweis. - -## Einmaligen Onlinebootstrap tatsächlich abgeschlossen - -Vorprüfung bestätigte tatsächlich`RMM_JOB_SIGNING_KEY_BOOTSTRAP=1` in der -ursprünglichen EnvironmentFile. `main.rs` führte dadurch den Netzwerkabruf -vor der Reconnect-Schleife erneut aus; unter der Sperre konnte der Agent nicht -dauerhaft offline starten. Bereits vorhandene nichtleere öffentliche -Agentbinding-, Agentcache- und Roothelper-Schlüssel sowie Generalidentity/-Pin -stimmten exakt überein, KeyID4338aabe… unverändert. - -Nur Bootstrapkonfiguration finalisiert: eigener80-Dropin mit abschließendem -`UnsetEnvironment=RMM_JOB_SIGNING_KEY_BOOTSTRAP`. Ein bloßes`Environment=0` -würde gegen die ursprüngliche EnvironmentFile verlieren. Ursprüngliche Datei, -Bindings/Caches, Identität, drei Journale, Artefakte und Generalpins bis zum -normalen Neustart in Bytes/Inodes erhalten. Keine Schlüsselrotation, kein -Enrollment, keine Paketwirkung/Jobfreigabe oder neues Releaseartefakt. -Private tatsächliche Reports`devstate/cloud-offline/bootstrap-trust-{preflight,finalized,reconnected}.json`; -versionierter VM-Report unter`cloud-provisioned-trust-bb67cdda-7920-468b-a560-a4d81eb5894c`. -Der native Offlinejobnachweis folgt weiterhin gesondert. - -Stand: Adapter implementiert und lokal auf Python-/Node-Syntax sowie identische -Skriptbytes zwischen Orchestrator und Browser geprüft. **Noch kein nativer -VM-Nachweis aus diesem Adapter.** Die folgenden Befehle sind geplant, nicht -ausgeführt. Alle Ergebnisse entstehen als private, fortlaufende JSON-Belege in -`devstate/cloud-offline//`. - -Der Adapter verwendet ausschließlich die bestehende Cloud-Linux-VM und den -festgelegten Cloudserver. Das Notebook betreibt keinen Agenten oder Server. -Er setzt einen gesunden signierten Reconnect, keine offenen Wirkungen und den -geprüften aktuellen Agentenhash aus `devstate/remote-vm.json` voraus. - -```sh -python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case offline_wait -python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case expired_offline -python3 deploy/cloud_offline_acceptance.py --execute-dev-test-ui --case revoked_before_start -``` - -Jeder Aufruf erzeugt einen eigenen unveränderlichen Plan mit genau einem -zukünftigen `agent_service`-Skriptjob. MCP erstellt Plan und persistenten Antrag; -vor der Genehmigung müssen Jobs, Outbox und Startgrants jeweils null sein. -`deploy/browser/cloud_offline_acceptance.cjs` prüft alle Planbytes und betätigt -den echten WebUI-Genehmigungsknopf mit dem sichtbar simulierten Testprincipal. -Der dritte Fall verwendet zusätzlich das vorhandene WebUI-Control -„Planberechtigung widerrufen“ mit Bestätigungskennung. Keine Freigabe oder -Widerruf wird über einen direkten API-/DB-Aufruf ersetzt. - -Ein Agentstopp allein gilt nicht als Offline-Nachweis. Der Adapter prüft vor -dem ersten Job die tatsächliche systemd-BPF-Funktion: Nur für -`rmm-agent-remote.service` wird die feste Serveradresse `88.99.80.202/32` -gesperrt. Ein separater Bootstrap-Prozess verschiebt ausschließlich seine -eigene PID in die tatsächliche Cgroup dieses Dienstes, wechselt zur festen -Agent-UID993 und primären GID der benannten Gruppe `rmm-agent` -und versucht nur einen TCP-Verbindungsaufbau zu Port443. Vor jedem neuen Plan -muss dieselbe Unit mit tatsächlicher Agent-UID/GID zunächst erfolgreich -verbinden, unter exakt wirksamer Sperre zweimal begrenzt scheitern und nach -Entfernen der Regel wieder erfolgreich verbinden. Während der Sperre muss -eine Kontrolle außerhalb der Agent-Cgroup erfolgreich sein; der Agent bleibt -aktiv, mit unveränderter PID/Restartzahl und unverändertem Rootledger. -`EACCES`/`EPERM` oder zwei Timeouts zählen nur zusammen mit diesen Kontrollen. -Ein isolierter Timeout genügt nicht. Das spätere Jobfenster prüft dieselbe -Regel erneut mit Außenkontrolle und zwei inneren Proben; Wiederherstellung -verlangt erneut eine erfolgreiche innere Verbindung. Die Proben -lesen keine Agentenidentität oder Zugangsdaten und senden keine Anwendungsdaten. -Die TLS-Prüfungen des echten Agenten bleiben erhalten. - -Tatsächlich beobachtet wurde bei aktivem Agent ohne Neustarts unter der -Paketregel ein TCP-Timeout ohne Errno. Die frühere Forderung ausschließlich -nach`EACCES`/`EPERM` war für diesen nativen Pfad falsch; daraus wird keine -erfolgreiche Offlineabnahme abgeleitet. Systemd255 beschreibt -`IPAddressDeny` als Ein-/Ausgangs-Paketfilter und verspricht keinen bestimmten -Connect-Errno. Quelle: [systemd255 resource-control](https://www.freedesktop.org/software/systemd/man/255/systemd.resource-control.html). - -Nach der dauerhaften Jobannahme werden vor der Sperre erneut null Grants, -Consumption-Einträge und Wirkungen geprüft. Während des Offlinefensters muss -der Agent aktiv bleiben, seine Reconnect-Versuche dauerhaft zählen und auch -über `not_before` hinaus ohne Grant oder Effekt bleiben. SSH und Helper sind -von der Netzsperre unabhängig. Die bereits vorhandenen Root-Consumption- und -Start-/Outcome-Belege müssen dieselben Hashes behalten. -Der kurze operative Stopp zum Einrichten der Regel zählt nicht zum Nachweis; -der Agent muss bereits vor `not_before` wieder aktiv und tatsächlich gesperrt sein. - -- `offline_wait`: Netz vor Ablauf wiederherstellen; ein neuer gesunder - signierter Sync muss vor genau einer Startreservierung liegen. Erwartet sind - ein Grant, ein Consumption-Eintrag und der gespeicherte Effektzähler `1`. - Danach denselben ursprünglichen Submit mit demselben Plan und Schlüssel - noch innerhalb der ursprünglichen Frist beobachten: dieselbe Operation, - unverändert1Job/1Outbox/1Grant. Die eigene private Idempotenzreceipt bindet - diese Beobachtung an den späteren rein lesenden MCP-Referenzbericht. -- `expired_offline`: Sperre bis hinter die feste Startfrist halten; - anschließend `expired`, null Grants und keine Wirkung nachweisen. -- `revoked_before_start`: Genehmigung während der Sperre tatsächlich in der - WebUI entziehen; nach dem Reconnect `cancelled`, null Grants und keine - Wirkung einschließlich interaktivem Widerrufsaudit nachweisen. - -Ein vorab eingerichteter Timer entfernt nach 420 Sekunden ausschließlich die -eigenen unveränderten Drop-in-Bytes und stellt den normalen Agententransport -wieder her. Diese Frist liegt hinter der festen Jobfrist. Ein fehlgeschlagener -Aufruf wird nicht automatisch wiederholt; seine Belege und Jobs bleiben zur -Auswertung erhalten. Das Skript besitzt keinen Journal-, Identitäts- oder -Consumption-Reset. -Lesende Zustandsabfragen und das Entfernen exakt dieser eigenen Netzregel -bleiben auch bei einem späteren `unknown` oder Fault möglich. Nur eine neue -Sperrinstallation verlangt einen vollständig geklärten Ausgangszustand; -Transportcleanup verändert keine Job-, Journal- oder Genehmigungsgrenze. diff --git a/docs/delivery-acceptance.md b/docs/delivery-acceptance.md deleted file mode 100644 index fa0a108..0000000 --- a/docs/delivery-acceptance.md +++ /dev/null @@ -1,90 +0,0 @@ -# Native Zustellungsabnahme - -Stand: 2026-11-13. Ausschließlich Ubuntu-Cloud-VM als Client gegen -`discovery.ease-technologies.de`; Notebook ausschließlich Entwicklung. -Dies sind ausdrücklich **simulierte dev/test-WebUI-Genehmigungen**, keine -Produktionsfreigaben. Der vorherige APT-Unknown wurde vor diesem Test separat -gebunden abgeglichen; dessen Versuch und Nachweise wurden nicht verändert. - -## Doppelte Zustellung: tatsächlich bestanden - -Fall-ID `4be60da7-fffe-4a49-b42e-ed0c70bdf8b7`, Transport **WSS**. -Die vier dauerhaften Auditbelege entstanden am 2026-11-13 zwischen -16:47:39.730194 und 16:47:40.172768 UTC. - -- Zentral und im erhaltenen VM-Journal bestanden vor Beginn keine offenen - Versuche. MCP erzeugte einen festen Plan und persistenten Antrag; vor der - Genehmigung tatsächlich **0 Jobs / 0 Outbox / 0 Grants**. -- Der Browser prüfte den sichtbaren Principal `simulated-testprincipal-a`, - sämtliche festen Plan-/Skriptbytes und das Ziel. Erst Checkbox und tatsächlicher - WebUI-Genehmigungsklick erzeugten die Ausführung. Audit: - `approval_origin=dev_test_browser_simulation`, `testsimulation=true`. -- Der eng gebundene Adapter sendete denselben bereits autorisierten JobOffer - mit identischen Bytes und derselben Nachrichten-ID zweimal. Dauerhaft vorhanden: - `claim`, `emitted`, `accepted_1`, `accepted_2`. Die zwei Annahmebestätigungen - stammen vom tatsächlichen Client und besitzen unterschiedliche Nachrichten-IDs. -- Ergebnis `succeeded`, Exit 0, geprüfte Postcondition und exakte Ausgabe - `RMM_DELIVERY_COUNT=1`. Ein Job / ein Outboxeintrag / ein Grant; genau ein - lokaler Versuch und ein zu dessen Grant passender dauerhafter Verbrauch. -- Anschließend Adapter deaktiviert. Eine unabhängige, nur lesende Prüfung - bestätigte in **beiden tatsächlich laufenden Serverrollen** den Flagwert - `false` und das Fehlen von `RMM_DEV_DELIVERY_FAULT_FILE`. -- Ein **separater** fester Lesejob erhielt erneut zunächst 0/0/0 und eine eigene - tatsächliche WebUI-Genehmigung. Er las den erhaltenen Zähler und bestätigte - weiterhin exakt 1; eigener Nachweis 1/1/1, `succeeded`, Exit 0. Dieser Lesejob - ist weder eine zweite Wirkung des Testversuchs noch eine SSH-Liveerhebung. - -Geschützter, nicht eingecheckter Gesamtbeleg: -`devstate/cloud-delivery/4be60da7-fffe-4a49-b42e-ed0c70bdf8b7/checkpoint.json`. -Er enthält die unveränderten Pläne, beide Pending-/Genehmigungsbelege, native -Journal-/Verbrauchsmetadaten, Audit-Slots und unabhängigen Zählernachweis. -Konfigurationsstände einschließlich bestehender `.env` blieben zusätzlich -versioniert und ausschließlich root-privat auf dem Server; keine Secrets im Git. - -## Verlorenes Ergebnis-ACK: tatsächlich bestanden - -Fall-ID `66ffd3ef-d4a9-4d98-a786-2c570b9d5d30`, Transport **WSS**. -Nach dem tatsächlichen WebUI-Klick wurde das erfolgreich abgeschlossene Ergebnis -am 2026-11-13 um **16:53:56.337151 UTC** dauerhaft gespeichert. Erst danach -unterdrückte der Adapter genau dessen direkte Ergebnisbestätigung (`claim`). -Um **16:54:01.148460 UTC** ging die natürliche Wiederholung des tatsächlichen -Agenten ein (`replay`): **dieselbe ursprüngliche Nachrichten-ID und derselbe -normalisierte Envelopehash**, keine synthetische neue Nachricht oder Versuch. -Der nächste normale ACK wurde zugestellt; im erhaltenen nativen Journal ist -die ursprüngliche Nachricht nicht mehr unbestätigt vorhanden. - -Auch hier wurden vor **beiden** tatsächlichen WebUI-Genehmigungen 0/0/0 sowie -jeweils der sichtbar simulierte Principal und der unveränderte Plan geprüft. -Der Wirkungsjob endete mit `succeeded`, Exit 0 und Ausgabe -`RMM_DELIVERY_COUNT=1`: ein Job / ein Outboxeintrag / ein Grant, genau ein -lokaler Versuch und ein zu dessen Grant passender Verbrauch. Keine offenen -Versuche. Nach Deaktivierung bestätigte der separat genehmigte Lesejob mit -eigenem 1/1/1-Nachweis den gespeicherten Zähler weiterhin exakt 1. - -Die tatsächlich laufenden API- und Gatewaycontainer wurden unabhängig lesend -geprüft: jeweils `RMM_DEV_DELIVERY_FAULTS=false`, FILE fehlt. Geschützter -Gesamtbeleg: -`devstate/cloud-delivery/66ffd3ef-d4a9-4d98-a786-2c570b9d5d30/checkpoint.json`. -Root-/APT-Versuche, Geräteidentität, erhaltene Journale und Tombstones wurden -nicht geändert. Ein paralleler ARM64-Quellbuild war beim Abschluss noch nicht -fertig; während dieser Abnahme erfolgte kein Wechsel auf dessen Serverimage. - -## Implementiert und lokal geprüft - -`dev_delivery_faults.rs` und WSS-/HTTPS-Hooks sind standardmäßig deaktiviert; -Aktivierung erfordert dev/test-Profil, private Konfiguration, exakte -Tenant-/Agent-/Job-/Attempt-/Plan-/Payloadbindung und höchstens 15 Minuten. -Nur normal genehmigte `agent_service`-Skripte sind zulässig. Ausschließlich -begrenzte append-only Audit-Slots; keine Jobs-/Outbox-/Grant-/Freigabeänderung. -Produktionsaktivierung und mehrdeutige Konfiguration verweigern den Start. - -Tatsächlich lokal bestanden: fünf gezielte Rust-Guardtests und Server-Clippy -für alle Targets mit `-D warnings`; Python-/Node-Syntaxprüfung des Cloudrunners; -exakte Python-/Browser-Skriptgleichheit, Shell-Parsing ohne Ausführung und -Negativprüfungen für veränderte Replay-ID bzw. identische Annahme-IDs. - -## Grenzen und verbleibende Gates - -Die beiden WSS-Nachweise sind kein HTTPS-Fehler-, Prozessabbruch- oder -Produktionsnachweis und schließen das gesamte Linux-MVP nicht ab. -Weitere verpflichtende MVP-Gates bleiben in [mvp-gates.md](mvp-gates.md). diff --git a/docs/development.md b/docs/development.md index 1d89487..d679e9d 100644 --- a/docs/development.md +++ b/docs/development.md @@ -1,118 +1,69 @@ -# Bauen und Bereitstellen in der Entwicklungsumgebung +# Entwickeln, bauen und ausliefern -Der [Lieferplan](mvp-completion-plan.md) nennt den nächsten Schritt. Für eine Entwicklungskorrektur reicht der direkte Weg zum betroffenen Dienst. Der Agent-Updater ist selbst ein Produktfeature und wird über den Releasekanal geprüft, wenn genau diese Funktion zur Abnahme steht. - -## Buildziel wählen - -Die Befehle werden im Repository ausgeführt. Der [Buildrunner](../tools/build.py) verwendet den gewählten Git-Commit, die gepinnte Rust-Toolchain und die vorhandenen Docker-Builder. `--plan` zeigt Revision, Zielbinaries und Kommando an. `--ref` akzeptiert einen Commit oder Branch und verwendet standardmäßig `HEAD`. Bei absichtlich geänderten Quellen einen eigenen abgegrenzten Git-Stand wählen, damit fremder WIP im Arbeitsbaum bleiben kann. Der Cargo-Cache wird je Ziel wiederverwendet. Fehlen dem gepinnten Builder Pakete aus dem gewählten Lockfile, lädt der Runner sie einmalig mit `cargo fetch --locked` in den zielbezogenen Cache. Kompilierung und Buildskripte laufen weiterhin ohne Netzwerk. +Der Buildrunner verpackt die Quellen eines eingecheckten Git-Stands und baut mit den gepinnten Docker-Buildern. Die folgenden Befehle laufen vom Wurzelverzeichnis des Repositorys. `REVISION` durch den zu liefernden Commit ersetzen. Vor dem ersten Frontendbuild `npm --prefix web ci` ausführen. Für den Rust-Build werden Python 3, Git, Docker, tar, rsync und die zum Ziel passenden lokalen Builder-Images benötigt. [Buildrunner](../tools/build.py) | Ziel | Befehl | Ergebnis | | --- | --- | --- | -| Linux-Client x86-64 | `python3 tools/build.py linux-x64` | Agent, privilegierter Helper und stabiler Updater | -| Offizieller Windows-Client x86-64 | `python3 tools/build.py windows-gnu-x64` | Windows-GNU-Agent, SYSTEM-Helper und stabiler Windows-Updater. | -| Server ARM64 vom Notebook | `python3 tools/build.py server-arm64 --ssh` | Überträgt den Runner und ausgewählte Quellen des Git-Commits per geprüftem SSH. Baut Server und Zeitbroker im separaten Bereich `~/rmm-dev-build/server-arm64/` auf dem nativen ARM64-Host. Ausgabe enthält Remote-Pfad und Hashes. | -| Server ARM64 direkt auf einem passenden Linux-Buildhost | `python3 tools/build.py server-arm64` | Serverbinary für API/Gateway und Zeitbroker. Der lokale Modus erwartet Git-Checkout, gepinnten ARM64-Builder, Docker, Python 3, git, tar und rsync. | -| WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Vite-Bundle in `web/dist/`. Im frischen Checkout zuerst `npm --prefix web ci` ausführen. | -| Windows-Binaries nativ mit MSVC | Vorhandenen [MSVC-Runner und Voraussetzungen](../deploy/windows/msvc/README.md) verwenden. | Geplant, nicht ausgeführt. Eigener Preflight und Build auf passendem Windows-Builder. Optionales zusätzliches Buildziel. | +| Linux-Client x86-64 | `python3 tools/build.py linux-x64 --ref REVISION` | `rmm-agent`, `rmm-privileged-helper`, `rmm-agent-updater` | +| Offizieller Windows-Client x64 | `python3 tools/build.py windows-gnu-x64 --ref REVISION` | `rmm-agent-windows.exe`, `rmm-helper-windows.exe`, `rmm-updater-windows.exe` für GNU | +| Server auf dem dedizierten ARM64-Host | `python3 tools/build.py server-arm64 --ssh --ref REVISION` | Server und Linux-Zeitbroker im Remote-Buildbereich | +| WebUI | `npm --prefix web run build` | TypeScript-Prüfung und Bundle in `web/dist/` | -Der lokale Runner gibt den **konkreten Artefaktordner** aus. Unter `devstate/build//artifacts///` liegen die Binaries und `manifest.json` mit Quellrevision, Zielarchitektur, Builder und SHA-256. Ausgelieferte Binärdateien immer am Hash identifizieren: Zwei Builds aus demselben Commit können unterschiedliche Bytes haben. Ein Build erstellt noch keinen signierten Produktrelease. +`--plan` zeigt den Rust-Build einschließlich Quellenrevision und Ziel an. Der Runner verwendet je Ziel einen gemeinsamen Cargo-Cache, lädt bei Bedarf die gesperrten Abhängigkeiten und kompiliert offline. Er meldet den konkreten Ausgabeordner. Lokal liegt er unter `devstate/build//artifacts///`, beim SSH-Build unter `~/rmm-dev-build/server-arm64/artifacts/` auf dem Server. Die Buildquittung `manifest.json` bindet Ziel, Git-Revision, Builder und Binärhashes. -## Server und WebUI aus einem geprüften Git-Stand aktivieren +## Entwicklungsserver und WebUI aktualisieren -`python3 tools/build.py server-arm64 --ssh --ref REVISION` erzeugt die Binärdatei auf dem Server. Anschließend baut `python3 tools/dev_deploy_server.py --ref REVISION` die passende WebUI, übernimmt die vorhandene Compose-Konfiguration und aktiviert API und Gateway. Der Runner vergleicht die tatsächlich angewendeten SQLx-Prüfsummen mit Git und liest die laufenden Binärhashes und die über TLS ausgelieferte Startseite zurück. Mit `--overlay server.releases.compose.yaml` überträgt und aktiviert der Runner die entsprechende Datei aus derselben Git-Revision. [Deploymentrunner](../tools/dev_deploy_server.py) +Für eine Serveränderung zuerst das ARM64-Ziel mit `--ssh` bauen. Der folgende Befehl aktiviert dieselbe Git-Revision vom Entwicklungs-PC aus. -Bei einer reinen WebUI-Änderung genügt `python3 tools/dev_deploy_server.py --web-only --ref REVISION`. Für ein schon gebautes Bundle aus dem Arbeitsbaum genügt `python3 tools/dev_deploy_server.py --web-only --web-dist web/dist`. Beide Wege stellen zuerst die Assets und zuletzt die Startseite per SSH bereit. Der Runner vergleicht die per TLS ausgelieferte Startseite mit den übergebenen Bytes. Die Ausgabe enthält den SHA-256 der Startseite und die ID des laufenden API-Containers. +```sh +python3 tools/dev_deploy_server.py --ref REVISION +``` -## Vorhandene Dateien direkt bereitstellen +Für eine reine WebUI-Änderung genügt `python3 tools/dev_deploy_server.py --web-only --ref REVISION`. Ein bereits gebautes Bundle lässt sich mit `python3 tools/dev_deploy_server.py --web-only --web-dist web/dist` übertragen. Der Deploymentrunner liefert die neuen Assets vor dem Index aus und liest den Index über TLS zurück. [Serveraufbau](server-deployment.md) · [Deploymentrunner](../tools/dev_deploy_server.py) -[dev_stage.py](../tools/dev_stage.py) verwendet die vorhandenen gepinnten SSH-Zugänge für `server`, `linux` und `windows`. Der Befehl nimmt beliebig viele benannte Entwicklungsartefakte entgegen, darunter fertige Binaries oder bereits gebaute Webassets. Unter `rmm-dev-stage//` im Profil des SSH-Benutzers verifiziert er die Datei und verwendet vorhandene identische Bytes wieder. Für das Prüfen der Zielpfade genügt `--plan`. [Zugangsprofile und Hostpins](operations-access.md) - -Beispiel für ein bereits gebautes Linux-Paar, **geplant, nicht ausgeführt**. `ARTIFACT_DIR` auf den vom Build ausgegebenen Ordner setzen: +Vorhandene Entwicklungsartefakte lassen sich per SSH direkt bereitstellen. Dieses Beispiel überträgt das gebaute Agent-/Helperpaar auf den Gast `linux`. ```sh -python3 tools/dev_stage.py --plan linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper" python3 tools/dev_stage.py linux "$ARTIFACT_DIR/rmm-agent" "$ARTIFACT_DIR/rmm-privileged-helper" ``` -## Aktivierung der bereitgestellten Entwicklungsversion +`ARTIFACT_DIR` ist der gemeldete Buildordner. Als Ziel stehen `server`, `linux` und `windows` zur Auswahl. Der Runner überprüft den Hash und legt die Datei unter `rmm-dev-stage//` im Zielkonto ab. Die Aktivierung ist ein eigener Schritt. Bei einer direkten Aktivierung die installierte Geräteidentität, Zertifikate, Journale und Dateirechte erhalten. Gehören Agent und Helper zu einem signierten Paket, ihre Bindungen zusammen berücksichtigen. Nach dem Wechsel Version, frischen authentisierten Kontakt und bei geänderter Ausführung einen genehmigten Testauftrag prüfen. Für eine Installer- oder Updaterabnahme den regulären Produktweg verwenden. [Stagingwerkzeug](../tools/dev_stage.py) · [Betriebszugänge](operations-access.md) -Nach dem Transfer die laufende Version und ihre Rückmeldung prüfen. Für den Server übernimmt das der Deploymentrunner. Die beiden Entwicklungsgeräte haben eigene Verfahren für den Wechsel einer laufenden Binärdatei. +## Signierte Agentversion veröffentlichen -- **Server.** Den oben angegebenen Deploymentrunner verwenden. Er übernimmt die aktive Compose-Dateikette aus den Containerlabels, bestehende Volumes und Policy-Mounts. [Deploymentaufbau](server-deployment.md) -- **Linux.** Beim Austausch der betroffenen Dienste ihre tatsächlich installierten Artefakte und Rechte feststellen, Ersatz vollständig bereitstellen und Konfiguration, Identität und Journal erhalten. Den Prozesshash, einen neuen Heartbeat und bei geänderter Jobruntime einen regulären Sync zurücklesen. Die früheren [Linux-Wechsel](../deploy/cloud_shared_core_upgrade_v2.py) enthalten wiederverwendbare Prüfungen und setzen konkrete Altfälle voraus. -- **Windows.** Agent und Helper bei einem Paarwechsel koordiniert stoppen, Binärdateien und die an sie gebundenen Metadaten aus derselben Version einsetzen, ACLs und Geräteidentität erhalten und geordnet starten. Prozesshashes und Gerätepräsenz getrennt abfragen. [Vorhandener Paarwechsel](../deploy/windows/Install-DevelopmentPairSuccessor.ps1) · [Zugang und lesende Diensteprüfung](operations-access.md) +Der signierte Release enthält die Plattform, Release-ID, fortlaufende Sequenz, Version, Kompatibilitäts- und Gültigkeitsdaten sowie Hash und Länge des Agent-/Helperpaars. Dieser Datensatz wird aus geprüften Buildartefakten erzeugt. Der Server liefert die signierten Daten und die passenden Binärdateien aus dem Katalog des Kunden. Die automatische Prüfung und Aktivierung erfolgt auf dem Gerät. Der stabile Updater selbst wird bei der Aufnahme über einen eigenen hinterlegten Hash gebunden. -Der alte `deploy/dev.py up` richtet eine lokale Compose-Umgebung ein. Der Produktserver liegt auf dem dedizierten Internetserver. Fallbezogene Builder wie `server_build_221.py` sind über ihre damaligen Belege auffindbar. +1. Das gewünschte Clientziel bauen. Den konkreten Buildordner mit seiner `manifest.json` verwenden. +2. Das folgende Beispiel für den offiziellen Windows-GNU-Kanal mit den tatsächlichen Werten aufrufen. `NEXT_SEQUENCE` ist eine höhere Sequenz für diesen Kanal. Der Runner überträgt die Artefakte, prüft die Buildquittung und signiert auf dem Signierhost. `--prepare-only` bereitet den Release ohne Veröffentlichung im Kundenkatalog vor. +3. Zum Veröffentlichen mit denselben Werten erneut aufrufen und `--prepare-only` weglassen. Der Entwicklungsrunner veröffentlicht über den internen Entwicklungszugang des berechtigten Kunden. Für andere berechtigte Kunden unterstützt `python3 tools/agent_release.py publish --help` den regulären API-Import mit lokalem Benutzer und TOTP. +4. Den Eintrag im Katalog des Zielkunden prüfen. Für die Abnahme des Selbstupdates einen regulären Abruf des Geräts, die Aktivierung und eine neue Meldung derselben Geräteidentität mit der neuen Version beobachten. -## Tatsächlich geprüft am 17. November 2026 - -- `linux-x64` und `windows-gnu-x64` auf dem Entwicklungs-PC aus `a576c10` gebaut, fünf Binaries und beide Manifeste per SHA-256 geprüft. Wiederholte Cargo-Builds aus dem Cache lagen jeweils unter einer Sekunde. Auf dem Windows-Gast liefen bei der Inventur die Hashes seines früheren Installationsbuilds aus demselben Commit. -- `python3 tools/build.py server-arm64 --ssh` auf dem konfigurierten ARM64-Server tatsächlich ausgeführt. Server und Zeitbroker als ELF64/AArch64 nachgelesen, Manifest und Hashes bestätigt. Cargo benötigte beim ersten Lauf 7 min 6 s, beim zweiten 0,52 s. Beide Läufe lieferten identische Bytes. API, Gateway und Datenbank liefen währenddessen weiter. -- WebUI mit den lokal vorhandenen Abhängigkeiten typgeprüft und in ein isoliertes Ausgabeverzeichnis gebaut. Ergebnis: `index.html`, CSS- und JavaScript-Bundle. -- Auf Server, Cloud-Linux und Windows jeweils `python3 tools/dev_stage.py ZIEL rust-toolchain.toml` zweimal ausgeführt. Der erste Aufruf übertrug die Datei und prüfte den Zielhash, der zweite bestätigte die vorhandenen Bytes. Der Test veränderte nur den Stagingbereich. Es wurde kein Dienst aktiviert, Gerät neu aufgenommen oder Produktrelease veröffentlicht. [Build- und Betriebsbelege](evidence/product-audit-20261117.json) - -Die früheren Entwicklungsprotokolle einschließlich der alten Notebook-/Reverse-Tunnel-Topologie sind im Git-Stand `a576c10:docs/development.md` erhalten. - -## Entwicklungspakete im isolierten Entwicklungsprofil veröffentlichen - -Der Buildordner enthält das in der Buildquittung gebundene Agent-/Helperpaar und den stabilen Bootstrap-Updater. Ein Linux-Build benötigt `rmm-agent`, `rmm-privileged-helper` und `rmm-agent-updater`. Auf Windows heißen die Dateien `rmm-agent-windows.exe`, `rmm-helper-windows.exe` und `rmm-updater-windows.exe`. Der GNU-Build enthält den stabilen Updater. Der Katalog führt Linux GNU, Windows MSVC und Windows GNU als getrennte Ziele. Für offizielle Windows-Pakete den eigenen Signierschlüssel verwenden. - -```bash -python3 tools/dev_agent_release.py \ - --artifacts "$buildordner" --build-receipt "$buildordner/manifest.json" \ - --sequence 1 --version 0.1.0-mvp.1 +```sh +python3 tools/dev_agent_release.py --official-windows \ + --artifacts "$ARTIFACT_DIR" --build-receipt "$ARTIFACT_DIR/manifest.json" \ + --tenant "$TENANT_ID" --sequence "$NEXT_SEQUENCE" --version "$VERSION" \ + --minimum-updater-version 2 --prepare-only ``` -Der Befehl prüft die Buildquittung und überträgt die drei Binärdateien über den gepinnten SSH-Zugang. Auf dem Server signiert ein separater Ed25519-Schlüssel je Plattform das exakte Agent-/Helperpaar. Der Aufruf lädt die Dateien über die authentisierte Management-API und veröffentlicht zuletzt den Envelope. Ein erneuter Aufruf mit derselben Sequenz und denselben Bytes verwendet die gespeicherte Signatur. Für eine geänderte Version die Sequenz erhöhen. Native MSVC-Builds verwenden ihre `result.json` als `--build-receipt`. +Für Linux gilt derselbe Ablauf mit dem Linux-Buildordner und ohne `--official-windows`. Die Mindestversion entsprechend der vom Paket benötigten Updaterfähigkeit setzen. Der offizielle Windows-Kanal nutzt einen eigenen Signierschlüssel. Private Signierschlüssel verbleiben auf dem Signierhost. -Beim ersten Serveraufbau den Befehl zunächst mit `--prepare-only` ausführen. Damit entstehen die Schlüssel, die öffentliche Konfiguration und der Objektspeicher unter `/opt/rust-discovery/devstate/mvp-releases`. Das Compose-Overlay `deploy/server.releases.compose.yaml` bindet nur Konfiguration und Objekte an die Rollen. Der private Schlüssel bleibt auf dem Server. Anschließend API und Gateway mit diesem Overlay aktivieren und den Veröffentlichungsbefehl ohne `--prepare-only` erneut ausführen. Der bei der Einrichtung gespeicherte SHA-256 ist der Ausgangswert für die unten beschriebene kontrollierte Rotation. +Für die Erstaufnahme in neuen Kundenkatalogen kann der Betreiber einen veröffentlichten Release als Starter auswählen. Die Quelle wird anhand ihrer Kunden-, Plattform- und Release-ID geprüft. Bereits befüllte Kataloge werden je Kunde gepflegt. [Starter veröffentlichen](../tools/dev_customer_starters.py) -## Neue Geräte und Selbstupdate +```sh +python3 tools/dev_customer_starters.py --tenant "$TENANT_ID" \ + --platform x86_64-pc-windows-gnu --official-windows --release "$RELEASE_ID" +``` -Im Releasekatalog der WebUI unter **Neues Gerät aufnehmen** einen Einmalcode erzeugen. Die WebUI zeigt die Installationsaufrufe für die veröffentlichten Plattformen. Den Code auf dem neuen Gerät im Prompt eingeben. Nach 15 Minuten oder beim erfolgreichen Enrollment verliert er seine Gültigkeit. Der öffentliche Bootstrap-Origin wird mit `RMM_BOOTSTRAP_ORIGIN` festgelegt. Die Geräteadresse stammt aus der geschützten plattformspezifischen Bootstrapkonfiguration. +Ein neuer stabiler Updater benötigt eine eigene Rotation des Bootstrap-Hashes. `--rotate-worker-only --rotate-bootstrap-from SHA256` bindet die Umstellung im Zielkunden an den bisherigen Hash. Für den gezielten lokalen Austausch des stabilen Windows-Updaters im Entwicklungsbetrieb prüft der PowerShell-Operator beide Hashes, die Geräteidentität und die installierten Releasepaare. [Releasewerkzeuge](../tools/agent_release.py) · [Windows-Updater austauschen](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1) -Im aktuellen Windows-Entwicklungsmandanten den angebotenen Aufruf mit `-Platform x86_64-pc-windows-gnu` aus der WebUI übernehmen. Windows verwendet den LocalService-Agenten und den separaten Dienst `RmmDiscoveryReleasePull` für die periodische Prüfung. +## Ergebnis prüfen -Auf Linux startet `rmm-discovery-agent.service` als Systemkonto `rmm-discovery` mit eigenem Zustand in `/var/lib/rmm-discovery`. `rmm-discovery-update.timer` prüft nach dem Booten und anschließend alle fünf Minuten den Releasebestand. Die aktive Generation und ein bei fehlgeschlagener Aktivierung gespeicherter Fehler liegen unter `/opt/rust-discovery-client`. Der Lauf berücksichtigt belegte Jobs, verifiziert den signierten Inhalt, schaltet die Generation um und prüft die neue Geräteverbindung. Das Systemjournal von `rmm-discovery-update.service` enthält die Fehlermeldung. Der Linux-Produktinstaller startet den unprivilegierten Agenten. Für Root-Skripte aktiviert ein lokaler Administrator einmalig den an dieses Gerät gebundenen Helferdienst. Dazu den aus der WebUI geladenen Installer mit `sudo sh linux.sh https://discovery.ease-technologies.de:8443 --enable-admin-scripts` ausführen. Bei einem abweichenden Bootstrap-Origin die von der WebUI angezeigte HTTPS-Adresse einsetzen. Der Schalter funktioniert auch nach der Aufnahme mit der vorhandenen Geräteidentität. Ohne diesen Schalter bleibt ein bisheriges Dienstkonto-Gerät beim Dienstkonto. Die WebUI-Genehmigung des konkreten Skripts und die Berechtigungen auf dem Server gelten bei jedem Auftrag. +Die folgenden Rust-Tests laufen lokal mit Testidentitäten. Die Transporttests starten einen TLS-Server auf Loopback. -Der Helferdienst `rmm-discovery-managed-script-helper.service` verwendet den Helper aus demselben signierten Release wie der Agent. Der Installer übernimmt einen bereits ausdrücklich eingerichteten, dauerhaft aktivierten Skripthelfer nur mit übereinstimmender Gerätebindung und Skriptrichtlinie. Für diese Migration den aktuellen HTTPS-Installer auf dem eingeschriebenen Gerät erneut ausführen. Die nächste periodische Aktualisierung schaltet Agent, Helper und die zugehörigen Prüfdaten gemeinsam um. Bei fehlgeschlagener Aktivierung prüft der Updater die Rückkehr des vorherigen Paares. Eine bestehende lokale Deaktivierung, Maskierung oder abweichende Richtlinie bleibt wirksam. +| Was geprüft wird | Lokaler Befehl | Testbeschreibung | +| --- | --- | --- | +| Bindung eines Startrechts an Gerät, Skript und Versuch, Schutz vor doppelter Ausführung | `cargo test --locked -p rmm-agent-core --test contracts` | [Skriptaufträge](../tests/agent_jobs/README.md) | +| Wiederanmeldung des Agents, Journal- und Helperabgleich | `cargo test --locked -p rmm-agent-core --test reconcile --test helper_reconcile` | [Agentenabgleich](../tests/agent_sync/README.md) | +| HTTPS-Gerätekanal und Erneuerung des Clientzertifikats | `cargo test --locked -p rmm-agent --test https_channel --test certificate_rotation` | [Transport](../tests/agent_transport/README.md) | -Ein geänderter stabiler Bootstrap-Updater wird ausdrücklich je Mandant rotiert. Dazu beim Veröffentlichen des geprüften neuen Builds `--rotate-bootstrap-from ` ergänzen. Für den Windows-GNU-Worker mit Skript-/Updatesperre verlangt der signierte Release zusätzlich `--minimum-updater-version 2`. Der Befehl lädt den neuen Worker zunächst über die Katalog-API hoch, vergleicht das gespeicherte Objekt und den bisherigen Mandantenpin und schaltet anschließend auf den neuen Hash um. Bereits ausgestellte Installer können den vorher erhaltenen Hash noch 15 Minuten lang abrufen. Weitere Releases desselben Workerstands verwenden nur `--minimum-updater-version 2`. Bestehende Geräte mit älterer stabiler Prüferdatei verwerfen ein Release, dessen signierte Mindestversion ihre eigene Prüferfähigkeit übersteigt. - -## Historischer manueller Linux-Helperwechsel - -Für Systeme vor der Migration auf den aktuellen HTTPS-Installer gilt das frühere Verfahren. Auf der Entwicklungs-VM verwies die Unit `rmm-discovery-managed-script-helper.service` auf den absoluten Pfad der bisherigen signierten Releaseversion. Für den gemeinsamen Versionswechsel vor der Katalogveröffentlichung den aktiven Release aus `/opt/rust-discovery-client/current` erfassen, `rmm-discovery-update.timer` mit systemd stoppen und den Abschluss eines laufenden Update-Dienstes abwarten. Das neue Paar veröffentlichen, den regulären `rmm-discovery-update.service` einmal starten und seine erfolgreich aktivierte Release-ID prüfen. - -Vom Entwicklungsrechner den [Helperwechsel](../tools/dev_linux_helper_rollover.py) zuerst mit `check` und dann mit `switch` aufrufen. Beide Aufrufe erwarten `--tenant UUID --asset UUID --agent UUID --previous ALTE_RELEASE_UUID --current NEUE_RELEASE_UUID`. Der Befehl prüft beide signierten Paare, den vorhandenen Systemdienst, die lokale Gerätebindung und genau einen passenden bestehenden Serverscope. Unter der lokalen Auftrags- und Releasesperre aktualisiert er Helperprofil, Agentpin und Unit-Ziel. Ein neuer authentisierter Kontakt muss beide erwarteten Helperhashes und einen bereiten Abgleich melden. Erst dann ersetzt der Operator im vorhandenen Serverscope die beiden Hashwerte. Principals, erlaubte Aktionen, übrige Geräte und Kunden bleiben erhalten. - -Nach erfolgreichem Rücklesen den Update-Timer wieder starten. Ein unterbrochener `switch` ist mit denselben Kennungen fortsetzbar. `rollback` stellt unter denselben Prüfungen den vorherigen Helper und dessen Pins wieder her und belässt den Agenten in der angegebenen aktuellen Releaseversion. Bei ausstehendem Abgleich bleibt der bestehende Serverscope wirksam. Der stabile Verifier unter `/opt/rust-discovery-client/updater` wird separat anhand seines Bootstrap-Pins ausgetauscht. - -## Stabilen Windows-Updater im Entwicklungsbetrieb ersetzen - -Für den gezielten Austausch des stabilen Workers zuerst die fertige Datei mit `tools/dev_stage.py windows DATEI` übertragen. [Replace-DevelopmentReleaseUpdater.ps1](../deploy/windows/Replace-DevelopmentReleaseUpdater.ps1) erwartet `-Candidate`, die beiden exakten Hashes über `-ExpectedPreviousSha256` und `-ExpectedCandidateSha256`, `-AgentId` und die zu prüfenden `-VerifyReleaseIds`. In einer administrativen Windows-PowerShell ausführen. Der Befehl verlangt einen laufenden Agenten und gestoppten Updater, prüft die signierten Releasepaare nativ, ersetzt den Worker atomar mit Sicherung und startet den Updatedienst mit SCM-Wiederanlauf. Bei standardmäßig Restricted geltender Skriptrichtlinie für die Entwicklungs-PowerShell `Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned` verwenden. - -Dieser Weg wurde am 17. November für den Worker `de75510b…` ausgeführt. Der anschließende reguläre Abruf aktivierte Windows `0.1.3` auf derselben Geräteidentität. [Nativer Beleg](evidence/windows-https-release-20261117.json) - -Für die separate Veröffentlichung eines korrigierten stabilen Workers ohne neues Agentpaket verwendet der Entwicklungsrunner `--rotate-worker-only --rotate-bootstrap-from SHA256` zusammen mit `--artifacts` und `--build-receipt`. Die Quittung muss die passende Plattform und den übertragenen Worker binden. Der Aufruf prüft den gespeicherten Worker und rotiert nur den Bootstrap-Pin des gewählten Mandanten. [Veröffentlichungs- und Rotationsnachweis](evidence/agent-release-worker-rotation-20261117.json) - -## Windows-Skripte als Administrator einrichten - -Der HTTPS-Installer nimmt das Gerät mit dem Dienstkonto LocalService auf. Für die örtliche Einrichtung des SYSTEM-Helpers in einer administrativen PowerShell den Installer mit `-EnableAdministratorScripts` aufrufen. Bei einem bereits aufgenommenen Gerät genügen der bisherige HTTPS-Ursprung und dieser Schalter. Ein kompatibler stabiler Updater, die aktuelle Gerätebindung und das exakt signierte Agent-/Helperpaar sind erforderlich. Die WebUI bietet beim Aufnehmen die passenden Befehle an. - -Für den zentralen Betreiber ist `RMM_MANAGED_SCRIPT_POLICY_FILE` die geschützte Konfiguration. Eine Gerätefreigabe bindet Kunde, Asset, Agent, Enrollmentgeneration, Zuordnung, Ausführungskonto, berechtigte Personen sowie die Hashes von Helper und lokaler Richtlinie. Auf Windows kann `allowed_script_sha256` den Umfang auf genaue UTF-8-Skriptinhalte mit leerer Argumentliste begrenzen. Eine leere Liste sperrt alle Skripte für diesen Eintrag. Jede tatsächliche Ausführung benötigt weiterhin den in der WebUI genehmigten, unveränderlichen Plan. - -Bei einer für künftige Releases vorgesehenen Bindung kann der Betreiber im selben Dokument unter `release_anchors` die `agent_id`, `release_id`, `agent_sha256`, `helper_sha256` und die kanonischen, bereits zugelassenen öffentlichen Richtlinienbytes als `policy_json` hinterlegen. Deren SHA-256 muss dem unabhängig am Gerät geprüften und in der zentralen Gerätefreigabe eingetragenen Richtlinienhash entsprechen. Der Server prüft beim Versionswechsel das signierte Paar und berechnet den erwarteten neuen Richtlinienhash. Nur Releaseverzeichnis und zugehörige Binärhashes werden für diesen Vergleich ersetzt. Die WebUI unterscheidet einen nicht gemeldeten Helper, eine nicht bestätigte Releasebindung und eine fehlende zentrale Berechtigung. - -Der frühere [Entwicklungsablauf für das befristete Windows-Updatefenster](windows-update-dev-window.md) dokumentiert die vorherige Installationsgeneration. Bestehende Fenster werden vor einer Umstellung regulär geschlossen. - -## Öffentliche Verwaltung - -`tools/dev_public_access.py` provisioniert den lokalen Passwort-/TOTP-Zugang, startet die zusätzliche API intern und aktiviert den vorhandenen öffentlichen TLS-Ingress. Die tatsächlichen Befehle und die privaten Dateipfade stehen im [Betriebsablauf](public-access.md). Der normale Deploymentrunner aktualisiert anschließend auch den öffentlichen API-Dienst. - - -## Offizielle Windows-Veröffentlichung - -1. `python3 tools/build.py windows-gnu-x64 --ref REVISION` erzeugt das Agent-/Helperpaar, den stabilen Updater und die Buildquittung. -2. `python3 tools/dev_agent_release.py --official-windows --artifacts ORDNER --build-receipt ORDNER/manifest.json --sequence NUMMER --version VERSION --minimum-updater-version 2 --prepare-only` bindet die Binärhashes an den separaten Schlüssel auf dem Signierhost. Die Sequenz muss größer als die letzte im Zielkatalog sein. Schlüssel und Konfiguration liegen in den getrennten Slots `windows-gnu-official`. Nur die öffentlichen Prüfmaterialien werden in die Serverprozesse eingebunden. -3. Auf dem Entwicklungsserver denselben Aufruf ohne `--prepare-only` für Development A verwenden. Für weitere Kunden die signierten Artefakte über die reguläre Katalog-API mit der Berechtigung des Zielkunden veröffentlichen. `tools/agent_release.py publish --help` beschreibt den Login mit lokalem Konto und TOTP. Bei einer Workerrotation den bisherigen Hash angeben. -4. `python3 tools/dev_customer_starters.py --official-windows --tenant UUID --platform x86_64-pc-windows-gnu --release RELEASE_UUID` veröffentlicht den gewählten Starter für neue Kunden. Befüllte Kataloge benötigen ihren eigenen Import. Bestehende Entwicklungsinstallationen besitzen einen anderen lokalen Schlüsselring. Die erstmalige Umstellung erfolgt über eine geprüfte Neuaufnahme oder eine separat autorisierte lokale Vertrauensmigration. +Der [MVP-Stand](mvp-completion-plan.md) enthält die überprüften Ergebnisse der Testgeräte. Lokale Frontendtests, Binärbuild, übertragene Datei, gestarteter Dienst und erfolgreicher Auftrag sind verschiedene Beobachtungen. Bei einem Neustart die Boot-ID vor und nach dem Auftrag, den authentisierten Kontakt und den erfolgreichen Folgeauftrag derselben Installation festhalten. [Frontendtests](../web/README.md) diff --git a/docs/evidence/mcp-scoped-script-requests-20261118.json b/docs/evidence/mcp-scoped-script-requests-20261118.json index 025060e..77c4ff1 100644 --- a/docs/evidence/mcp-scoped-script-requests-20261118.json +++ b/docs/evidence/mcp-scoped-script-requests-20261118.json @@ -1,5 +1,5 @@ { - "observed_at": "2026-11-18T15:59:16Z", + "observed_at": "2026-11-18T16:13:35Z", "server_revision": "c4e064773bc3abfb21ad8343621fa77e4953eeca", "server_sha256": "3d66f74b61333a5f767b9240e65fde2de0bd7d670c3db0a18047594407ce6ec4", "tenant_id": "11111111-1111-4111-8111-111111111111", @@ -100,7 +100,7 @@ }, "windows": { "hostname": "discwindowstest", - "scenario": "awaiting_ping_approval", + "scenario": "succeeded", "asset_id": "fab8b229-4eea-4af8-9362-a3aea4a8f709", "agent_id": "239ffa87-642f-40cd-9cbf-d48557dc0193", "agent_version": "0.1.16", @@ -170,8 +170,16 @@ "plan_id": "27590df4-57b5-432e-8c27-c96f51f2a66d", "operation_id": "cbf31de2-29e1-4442-abad-6e808d9b5320", "start_before": "2026-11-18T17:57:37Z", - "approval_state": "pending_approval", - "execution_identity": "agent_service" + "approval_state": "approved", + "execution_identity": "agent_service", + "approved_at": "2026-11-18T16:05:30.779945+00:00", + "testsimulation": false, + "job_id": "c4155fe7-e42b-4614-bfe1-3fc90b60b6d8", + "attempt_id": "68fb18c7-7dfc-48be-a2df-c70b11d314f0", + "state": "succeeded", + "exit_code": 0, + "execution_sid": "S-1-5-19", + "stdout": "google.com 142.251.20.139 Versuch 1: Success (17 ms)\r\ngoogle.com 142.251.20.139 Versuch 2: Success (17 ms)\r\nAntworten: 2/2" }, "boot_after": { "boot_started_utc": "2026-11-18T15:56:40.5000000Z", diff --git a/docs/handover-history-through-20261116.md b/docs/handover-history-through-20261116.md deleted file mode 100644 index 2ecc71c..0000000 --- a/docs/handover-history-through-20261116.md +++ /dev/null @@ -1,1298 +0,0 @@ -# Historische Übergabechronik bis zum 16. November 2026 - -Archiviert am17.November2026. Die folgenden Angaben sind datierte historische -Belege, keine aktuellen Start-/Recoveryanweisungen. Aktueller Einstieg: -[handover.md](handover.md), Zugänge: [operations-access.md](operations-access.md). -Der frühere Dateiinhalt bleibt nachfolgend vollständig erhalten. - ---- - -## Aktuelle S0–S2-Übergabe16.November22:45UTC - -Aktueller Auftrag ausschließlich S0–S2, kein MSI/Reboot/Updater. -S0 und221-Abschluss sind abgeschlossen und gepusht. Neues Paar437a/744d, -Profil9, lokale Skriptpolicya65/Q8b709 und normale Synchronisation nativ belegt. -Neuer MCP-/WebUI-Job7d756c34-3506-4545-8ecd-0e94b9fe7569 ist **nicht erfolgreich**: -OriginalUnknown in beiden Ledgern, kein Resultabschluss, Kontrollköpfe aligned357. -Grant89226940-dcf5-4647-8707-9fea48940027 niemals wiederholen, neue Ausnahme -nicht genehmigt. Originale/Identität/Journale erhalten. Zentrale Policy abgelaufen. -Quelle verschluckte konkrete Fehlerursache; zusätzlich Ausführungskontextlücke -im eingefrorenen Runtimequellstand. Enger Vorwärtspatch nur lokal vorbereitet/ -in Review, keine Installation. Alle Details und native Belege: -[aktuelle Ergebnisse](windows-system-s0-s2-results.md). -Nachfolgende Übergaben sind historische Stände. - -# Übergabe — aktueller MVP-Abschlussplan und historische Einzelbelege - -**Fortsetzung 16. November, 20:13 UTC:** S0-Quellencheckpoint und gezielter -Windows-Paarbuild bestanden. Fall221 nativ einmalig mit Exit0 angewandt, -separate Nachprüfung Exit0: OriginalUnknown erhalten, abgeleitetfailed3, -physischesEvent1/aktiveQueue0. Beide Dienste weiterhinStopped; zentraler -Originaljob wartet noch auf normalen SignedSync. **S2 wird fortgesetzt**: -neuesPaar/Profil, frischeBereitschaft und neuer MCP-/WebUI-SYSTEM-Auftrag. -[Aktuelle S0–S2-Ergebnisse](windows-system-s0-s2-results.md). -Die nachfolgende Auditaufnahme ist damit historisch, kein neuer Blocker221. - -**Maßgeblicher Stand 16. November 2026, 18:11 Uhr MEZ:** -[Status und konkrete Agentaufträge](mvp-completion-plan.md). -Der User hat die Implementierung für eine Bestandsaufnahme und einen -schrittweisen Abschlussplan unterbrochen. In diesem Audit wurden nur Quellen, -gespeicherte Belege und Betriebsmetadaten gelesen; keine neuen Builds, Tests, -Zieländerungen, UI-Genehmigungen oder Jobs gestartet. Unteragents sind gestoppt, -es läuft kein ihnen zugeordnetes Abschlusswerkzeug weiter. - -- Der erweiterte MVP ist **offen**. Linux M0–M5 ist historisch abgenommen, - aktuell verhindert das fast volle 1-GiB-Helperjournal einen frischen Sync. - Agent/General/Full laufen; Updater unprovisioniert/inaktiv, APT-Helper inaktiv. -- Allgemeine Windows-PowerShell-Skripte unter LocalService sind tatsächlich - bestanden. **SYSTEM nicht bestanden:** Job `94047873…` bleibt unknown/Revision 2. - Agent/Helper seit 15:45 UTC gestoppt; Originalimages `d630…`/`0502…` installiert. - Dauerhafter eingeschränkter Entwicklungs-SSH und Reverse-Tunneltask laufen. -- Fall 221 ist ausdrücklich genehmigt, aber noch nicht erfolgreich angewendet. - Zwei native Anwendungsversuche scheiterten vor Commit; Originalzustand danach - unabhängig unverändert bestätigt. Letzter Placeholderfix nur auf Cloud-Linux - vertragsgeprüft; SDK `66c1…` lokal gebaut, **noch nicht auf Windows übertragen**. - Kein abschließend aktuelles Runtimepaar gebaut/installiert; aktive Receiptdatei - fehlt, alte Quittungen sind abgelaufen und erhalten. -- Server-API/Gateway laufen mit Image `f0f3b791…`/Migration 21; Verwaltung Loopback, - PostgreSQL intern. Aktuelle globale Zahlen: 35 Jobs/30 Grants/35 Outbox. -- Weitere native Windows-W-Abnahmen, MSVC/Installer/Reboot und tatsächlicher - Agent-Selbstupdate beider Plattformen fehlen. Kein OIDC-Ausbau nötig. - -**Nächster Implementierungsauftrag:** S0–S2 des Abschlussplans, ausschließlich -historienerhaltender 221-Abschluss, korrigiertes Paar und **neuer** MCP-/WebUI- -SYSTEM-Auftrag. Andere Wirkungen erst nach diesem Erfolg. Der aktuelle Plan enthält -die genaue Quellen-/Artefaktübergabe; kein neuer User-Konsolenschritt vorbereitet. -[Frische rein lesende Beobachtungen](evidence/mvp-status-audit-20261116.json). - -Die folgenden Abschnitte sind eine **historische Chronik**. Angaben wie -„beide Dienste laufen“, frühere Images/Migrationen oder „MVP abgeschlossen“ -gelten ausschließlich für ihren damaligen Schritt, nicht für den aktuellen -Betriebszustand. Die spätere ausdrückliche 221-Freigabe ist gültig. - -**16. November: erste SYSTEM-Skriptabnahme versucht, NICHT bestanden.** -MCP-Antrag ce1b969b… und echte sichtbar simulierte WebUI-Genehmigung bestanden; -vorher 0/0/0, danach genau ein Job, eine Auslieferung und ein Grant. -Originaljob94047873…/Grant97e705b8… bleibt Unknown. Nativer Readonlyzeuge bestätigt -beiderseits einen Verbrauch, Start und Outcome, SYSTEM_SCRIPT_EFFECT_UNRESOLVED, -leere Ausgabe und Exitnull; kein Retry oder Historyreset. -Ursache konkret belegt: system_script öffnet STATE_ROOT nur mit ShareRead, -während Helper1304 denselben Ordner dauerhaft schreibfähig hält. Native -Leseprobe: Error32; ShareRead|Write positiv. Enger Fix open_read_shared -vorbereitet, noch nicht installiert. Kontrollspalt221 mit Agent0442c732… und -Helper193b951b… erhalten; Policy seit16:15:01MEZ abgelaufen. Die frühere -205-Ausnahme deckt diesen neuen Unknownfall nicht ab. -[Originalversuch und Grenzen](windows-system-script-first-attempt.md) · -[Gesonderter Abschlussvorschlag](windows-system-script-nonstart-221-proposal.md). -Weitere MVP-/Linuxarbeit wegen aktuellem Userfokus angehalten; keine Neustarts. - -**16. November, 14:54UTC: SYSTEM-Skriptvoraussetzungen nativ positiv.** -Die eng gebundene NoEffect-Fortsetzung installierte um14:31UTC vier öffentliche -Dateien erhaltend und stellte den Helper aufAutomatic. Unabhängiger Hash-/ACL- -Readback positiv; beide Dienste seit14:39UTC einmalig gestartet. Tatsächliche -Agentprobe bestätigt authentischen SYSTEM-Helper, eigene qualifizierte Uhr und -alle fünf SYS-Skriptfähigkeiten; regulärer SignedSync215 ready/helper_ready, -alle offenen Zähler0. Noch kein SYSTEM-Job/MCP-Plan/UI-Freigabe und keine zentrale -SYSTEM-Scopeaktivierung. GNU-Entwicklungsbuild; MSVC und die zwei ausdrücklich -genehmigten Gastneustarts noch nicht ausgeführt. -[Exakte Ergebnisse](windows-system-first-job-plan.md). - -**16. November, allgemeiner Windows-Skriptbetrieb tatsächlich bestanden.** -Neues Agent-/Helperpaar d6302aa0/0502d6c8 und Zeitprofil7 erhalten Identität, -Schlüssel und Originaljournale. Beide Dienste laufen, Agent aktiv mit -RemoteSigned ausschließlich pro genehmigtem Jobprozess. Ein neuer MCP-Plan -wurde mit 0/0/0 vor Genehmigung über die echte sichtbar simulierte WebUI -bestätigt. Job `5f1ffef4-2bb6-4c7e-a3a0-fb619144b4f8` succeeded/Exit0, -exakte allgemeine Wartungsausgabe, BOM-/Unicodeprobe252 und LocalServiceSID19. -Zentral genau1Job/Outbox/Grant, korrekterSimulationsaudit; unabhängiger nativer -Readonlyzeuge bestätigt einmaligen Verbrauch/Start/Outcome und ursprüngliche -Permit-Signatur. [Exakte Ergebnisse](windows-general-script-acceptance.md). -SYSTEM-/SCM-/MSI-/Zertifikat-/Reboot-/Selbstupdateabnahmen sind weiterhin offen; -die folgende frühere Stoppaussage gilt nur bis zum dokumentierten Paarwechsel. - - -**16. November, 12:30 UTC: autorisierter Kontrollabschluss 205 bestanden.** -Der Betreiber hat genau diesen zusätzlichen historienerhaltenden Fall -zugelassen (Spezifikation 1.28). Nativer Originalzeuge, tatsächliche sichtbar -simulierte WebUI-Bestätigung, einmalige signierte native Anwendung mit Exit 0 -und separate rein lesende Nachprüfung mit Exit 0 sind nachgewiesen. -Helper und Agent referenzieren jetzt die erhaltene zweite Entscheidung -`2af359c5-5b5c-4992-b445-1c00e271a288`; Capturecheckpoint 201 bleibt erhalten. -Zwei alte Jobs, ein alter Verbrauch/Grant, null Helperwirkungen/SYSTEM-Intents. -Keine Bereitschaft, Entsperrung oder Jobgenehmigung wurde erteilt. -**Beide Windows-RMM-Dienste bleiben gestoppt**, bis das gezielt korrigierte -Paar und sein neues Zeitprofil bereitstehen. Danach frischer regulärer -unabhängiger SignedSync und ein neuer MCP-/WebUI-Skriptauftrag; keine -Verlängerung alter Pläne. [Tatsächliche Ergebnisse](windows-sync-alignment-205-native-witness.md). - -Der Server betreibt jetzt API und Gateway mit Image `a7fc4243fee4…`, -Migration 20 und neuer WebUI. Zusätzliche Deployment-Overlays und exakte -CAS-/Containerbelege stehen in [der Implementierungsdokumentation](windows-sync-alignment-205-implementation.md). -Die Verwaltungsports bleiben ausschließlich Loopback. -Alle 18 vorgesehenen kompatiblen Updater-Vertragsprüfungen sind jetzt auf der -echten Cloud-Linux-VM bestanden; das ist noch kein vollständiges Selbstupdate. -[Native Resultate](updater-compatible-linux-contracts.md). -Der dauerhaft beauftragte Windows-Entwicklungstransport hat um 12:39:57 UTC -automatisch übernommen: SYSTEM-SSH-Prozess, aktiver Task, Konto ohne -Ablaufdatum und neue strikt gepinnte SSH-Verbindung ohne Multiplexing belegt. -[Zugangsstatus](windows-development-access.md). - - -**16. November, tatsächlicher Abschluss des Echo-Testscopes bestanden:** -Neuer Windowsagent `9651b2e518b3`, unveränderter SYSTEM-Helper, erhaltene -Geräteidentität/Journale und Zeitprofilrevision 5. Beide Rollen lieferten nach -dem Start eigene signierte Zeitbelege. Der administrative Abschluss wurde -sichtbar simuliert in der tatsächlichen WebUI bestätigt und die signierte -Quittung nativ mit Exit 0 angewandt; unabhängige Nachlese positiv. -Ursprünglicher Scope und einmaliger Jobverbrauch bleiben erhalten. Dieser -Schritt erzeugte keine neuen Jobs oder Jobgenehmigungen; neue allgemeine -Aufträge benötigen weiterhin regulären SignedSync und eigene WebUI-Pläne. -Auf dem Server jetzt API-Image `c4c869114a60` und Migration 19, neues zusätzliches -Compose-Overlay `devstate/windows-mvp-7560235e1adc/mvp-images.compose.yaml` -zuletzt einbeziehen. [Nachweise und genaue Grenzen](windows-mvp-completion.md). - -**Fortsetzung 16. November 2026:** Der Betreiber beauftragt die vollständige -Windows-MVP-Fortsetzung mit paralleler Arbeit. Der vorhandene eingeschränkte -SSH-Entwicklungstransport wurde über die bereitgestellte Gastkonsole ohne -weiteren Userhandgriff erneuert und nativ geprüft; Agent/Helper und passive -Konfiguration unverändert. Allgemeine Skript-/SYSTEM-, Lifecycle- und -Updaterarbeiten laufen getrennt. [Aktuelle Ergebnisse](windows-mvp-completion.md). - -**Erster Windows-PowerShell-Auftrag bestanden, 16. November 2026.** -Die WebUI und MCP bleiben ausschließlich auf Server-Loopback erreichbar und -werden über SSH bedient. Ein OIDC-Anbieter ist für den MVP nicht erforderlich. -Der reguläre MCP-Antrag, die sichtbar simulierte WebUI-Plangenehmigung und -die tatsächliche PowerShell-Ausführung auf der bestehenden Windows-VM sind -nachgewiesen. Job `645ad11b-9ecd-4efe-8f92-8ad2fb6ed5cf` endete -`succeeded` mit Exit 0, exakt `Zeitprofil-Test`, leerem stderr, -LocalService-SID19 und RemoteSigned ausschließlich für den Jobprozess. -Es gab genau einen Verbrauch und einen Startgrant. Der Grant wurde am -15. November um 23:17:47 UTC ausgestellt, vor der festen Startfrist 23:18 UTC. - -Der native Capabilityfehler wurde korrigiert. Aktueller Agenthash -`742257bfb86ff3ccb5b7c04371471afbdf3c26c5d5cf73ea7bf6d0a51586e80f`, -Zeitprofilrevision 4, unveränderter Helper. Die Dienste sind seit -23:19:06 UTC wieder passiv, die ursprüngliche Konfiguration ist hergestellt. -Identität und Originaljournale sind erhalten. Der zusätzliche Testscope ist -weiterhin an genau diesen einen Auftrag gebunden. Die Abnahme erweitert sich -nicht automatisch auf allgemeine Windows-/SYSTEM-Wartung oder Agentupdates. - -Auf dem Projektserver läuft API-Image `d5fd32ff157c` mit Migration 18. -Für spätere Compose-Aufrufe zum Basis- und Timebroker-Overlay die beiden -privaten Release-Overlays in `devstate/human-review-e19a9c80d438/package` -und `devstate/echo-probe-1b8acf06ea84/package` (je -`review-images.compose.yaml`, neuestes zuletzt) hinzunehmen. -[Exakte IDs, Grenzen und Nachweise](windows-profile-acceptance.md) - -**15. November 2026.** Der permanente Server betreibt das Zeit-Gateway. -Die Windows-VM hat mit ihrer Geräteidentität die Signatur geprüft. Ein fremder -Mandant und eine alte Verbindung wurden abgewiesen. Die Cloud-Linux-VM und -der Windowsgast melden sich selbständig und sind über MCP abrufbar. -[Gateway](server-time-gateway-deploy.md) · [Windows-Protokolltest](windows-time-route-operator.md) - -Am 15. November liefen auf dem Windowsgast nach dem einmaligen Dienstwechsel -der neue Agent unter LocalService und der neue Helper unter SYSTEM. Die -separate Nachprüfung bestätigte beide Prozessstarts, das Gerätezertifikat, -die Geräteidentität und die bisherigen Journalstrukturen. Der erste Online-Kontakt -nach dem Wechsel gelang. Danach wies PostgreSQL den passiven Updatestatus -`agent.update` zurück. Der letzte reguläre Kontakt vor der Störung lag um -16:17:32 Uhr MEZ. Für die Korrektur wurden auf dem permanenten Server die -gefilterte Basisinventarabfrage und Migration 16 aus dem zum laufenden -ARM64-Image passenden Builder offline gebaut. Docker meldete Exit 0 für -Image `6a76343bf65c` (Buildfall `5ad7c74c-67a1-40b8-8960-d3ba016565af`). -Die Migration lief anschließend erfolgreich. Die API arbeitet mit diesem -Image. MCP bestätigte zwei neue Windows-Heartbeats um **16:39:46 und -16:40:17 Uhr MEZ**, jeweils mit derselben Geräte- und Zertifikatsidentität wie -vor dem Dienstwechsel. Die Cloud-Linux-VM meldete sich weiterhin als online. -[Dienstwechsel und Telemetrienachweis](windows-signed-clock-upgrade-plan.md) - -Die Erstinstallation des Windows-Zeitprofils ist auf der VM belegt. Der Server empfing zunächst um -17:05:36 Uhr MEZ den Fehlercode `0x80070020` beim Verschieben in das -Zielverzeichnis. Der Helper hält dort einen Verzeichnishandle, der diesen -Schreibzugriff sperrt. Im korrigierten Quellstand erlauben die Handles für -das öffentliche Verzeichnis diesen Zugriff. Löschsperre, DACL- und -Dateiidentitätsprüfungen bleiben aktiv. Agent und Helper wurden damit für -Windows x86-64 gebaut; dieser Build ist noch nicht auf der VM installiert -oder dort abgenommen. Beim anschließenden Versuch um 20:24 Uhr MEZ konnte der Gast -die neue Zieldatei öffnen. Der Sicherheitsdeskriptor entsprach beim Lesen -nicht exakt dem erwarteten Wert. Der Controller stoppte vor dem Schreiben -der Profilbytes. Die anschließende Konsolenlesung bestätigte 0 Byte. -Eigentümer, Gruppe, DACL-Schutz und alle sechs expliziten Zugriffsregeln -stimmten überein. Nur das DACL-Steuerbit für automatische Vererbung (`AI`) -fehlte im gelesenen Deskriptor. Um 20:40 Uhr MEZ gelang der Abschluss. -Der Gast las die 1177 Profilbytes mit dem erwarteten SHA-256 und derselben -Dateikennung zurück, die er vor dem Schreiben festgehalten hatte. -Um 20:41 Uhr MEZ bestätigte der Projektserver die ersten zwei getrennten -signierten Zeitvergleiche des laufenden Agenten und SYSTEM-Helpers. -Die Windows-Skript- und Paketabnahmen stehen aus. -[Zeitbelege beider Dienste](windows-passive-time-closeout.md) -[VM-Fehlerbeleg und Buildprüfung](windows-time-profile-config.md) - -Die passive Zertifikatserneuerung ist implementiert. Fünf Wiederanlauf- und -Fehlerfälle mit Testidentitäten bestanden auch auf Windows. Das Anlegen, -Schützen und Wiederöffnen einer separaten Testschlüsseldatei bestand auf -der Windows-VM unter dem Entwicklungskonto. Die Erneuerung durch den -installierten LocalService-Dienst steht aus. -[Zertifikatserneuerung](windows-certificate-renewal.md) - -Der Linux-Agent kann einen signierten Releasekatalog über mTLS prüfen und das -Ergebnis im Inventar melden. Sechs gezielte Tests bestanden auf der Cloud-VM. -Der Katalogcheck ist im Quellstand integriert. Die laufende Installation hat -noch kein Agent-Selbstupdate durchgeführt. [Updatekatalog und offene Schritte](agent-updater-passive-catalog.md) - -## Frühere Zwischenschritte - -**Broker-UDS und echte Signaturen bestanden:** Host und Standard-PIDnamespace- -ContainerUID10001 mit getrennten Challenges tatsächlich Ed25519-verifiziert; -ContainerpeerPID0 und RootUID0-Deny belegt. Separater Originalread und identische -Corezeugen. [Ergebnisse](server-time-broker-signature-acceptance.md). -HTTPSdeployment und Windowsrollen-/Jobnachweise bleiben offen. - -**Zeitbroker tatsächlich einmal gestartet:** Effektivhärtung, gehaltener -Prozess und Root:10001-Socket bestanden; separate Nachlese und identische -SQL-Corezeugen belegt. [Ergebnisse](server-time-broker-start-acceptance.md). -Noch keine Signatur-/HTTP-/Windowsjobabnahme. - -**Historischer vorangehender Stand — Zeitbroker installiert, noch nicht gestartet:** eigenes Root500-ARM64- -Binary5d8d und Demand-Unit4792 samt Socketgruppe10001 create-only eingerichtet; -alle Schritte mit separatem Read. [Belege](server-time-broker-bootstrap.md). -Noch kein Reload/Enable/Start, keine Signatur oder Windowsjobfreigabe. - -**Separater Server-Zeitschlüssel provisioniert:** eigener Hostseed bleibt -ausschließlich Root600; öffentlicher Pinc31d31d2 und separater Read belegt. -[Ergebnisse](server-time-broker-bootstrap.md). Noch kein Brokerstart, -Zeitsignieren oder Windows-/Jobgate. - -**Tatsächliche Serverquellqualität bestanden:** neue c9-Probe Exit0, -Kernel0/Fehler50.834ms/Syncalter43.596s, identische Erhaltungszeugen und -separater Read. [Originalbelege](server-time-source-new-generation-probe.md). -Kein Signer/Broker/HTTP-/Windowsjobgate daraus automatisch aktiviert; -geschützter separater Signerbootstrap folgt. - -**Zwei reale Schritte bestanden:** freigegebener einmaliger Chronyrestart -und Pin395f mit separatem Read/Erhaltung ([Belege](server-time-source-chrony-generation-bootstrap.md)); -aktives Windows-Zeitprofil nativ Cloud-Linux8/18,10gefiltert, separater Read -([Belege](windows-trusted-os-clock-source.md)). Noch kein echter Server- -Qualitätssample, Signer/Broker oder Windows-Jobgate. - -**Chrony-Generationsplan konkret und lesend geprüft:** d5d56b38, tatsächlicher -Preflightb7c05714 bestanden (Normal/Stratum3,0.123ms Offset); ursprüngliche -Runtime/Config/Pin erhalten. [Plan und Belege](server-time-source-chrony-generation-bootstrap.md). -Einmaliger Zeitdienstrestart samt öffentlichem Pin-CAS weiterhin NICHT -ausgeführt; ausdrückliche Userfreigabe wegen möglichem normalen Start-Sync nötig. - -**Passiver Windows-Upgradecontroller nativ quellengeprüft:** korrigierter -77fb-Generator, AST/C#compile-only und14reineAktionsfixtures auf Windows -bestanden; geschlossene Wirkungssperre, RMM-/Serverzeugen erhalten. -[Belege](windows-signed-clock-upgrade-plan.md). Kein Paarupgrade oder Zeitpin, -neuer1.23-Profilcode und native Wirkung bleiben offen. - -**Userentscheidung1.23 angenommen:** aktives `trusted_os_active_guest`-Profil -für die identifizierte Windows-KVM-Test-VM ausdrücklich zur Umsetzung erlaubt. -[Vertrag/Betriebsgrenzen](windows-kvm-clock-contract-proposal.md); geschützter -Opt-in, signierter Serververgleich und WebUI bleiben. Implementierung und -neue native Abnahme folgen, keine Kalibrierungszahl/Clockfreigabe erfunden. - -**Zeit-Gatewayimage nativ ARM64 gebaut:** eigener Falld11a6fb7, Dockerbuild0, -Image422c2c28, separater Plattform-/Originalread bestanden. -[Nachweise](server-time-gateway-build.md). Laufende Runtime bleibt6f8383f7; -keine Migration/Bereitstellung oder Zeit-/Jobfreigabe. - -**Abstrakter Chrony-Transport verworfen:** sechs Kernel-Guards nativ bestanden, -separater realer Trackingrequest blieb aber unbeantwortet; Chronys -C-String-Antwortadressierung ist inkompatibel. Produktionsprovider bleibt -3fd9-Named, keine ARM-/Quality-/Jobfreigabe. -[Belege und Grenzen](server-time-source-abstract-client.md). - -**Chrony-Peergegencheck eingegrenzt:** aktive Policy bytegleich belegt; -ursprüngliche Queryauslegung wegen libapparmor-Pfadkürzung korrigiert. -Named-Connect bleibt EACCES, eigener abstrakter Unix-Connect im gleichen -Profil bestanden, noch ohne Datagramm/Sourcequalität. -[Reale Befunde und Grenzen](server-time-peer-diagnosis.md). - -**Konservative Zeitfrische nativ Linux bestanden:** acht Guards im Originalfall -4072ed8d,8PASS/0Filter, separater Read mit erhaltenen Runtimezeugen. -[Belege und neue gebaute Windowskandidaten](time-attestation-freshness-results.md). -[Konkrete fehlende Plattformqualifikation](windows-signed-clock-calibration-assessment.md) -bleibt offen; keine Kalibrierungszahl oder Windowswirkung erfunden. - -**Reale Peer-Zeitqualitätsprobe fehlgeschlagen:** neuer Fallteilf37040c5, -Exit1/kein Sample; separater Read bestätigt unveränderte Runtime-/Chronyzeugen. -[Ergebnis](server-time-source-probe-peer-acceptance.md). Namespace bleibt -konfiguriert und Enforce; Broker-/Windowsclock-/Jobgates weiter geschlossen. - -**Namespacebootstrap auf dem permanenten Server bestanden:** exakte Such-ACL -und enger Chrony-Localoverride eingerichtet, tatsächlicher Parser-Replace0 und -separater Read belegt; Enforce, Chronyprozess, Boot und RMM-Runtime erhalten. -[Ergebnis](server-time-source-peer-namespace-bootstrap.md). Noch keine reale -Sourcequalität, Schlüssel oder Clock-/Jobfreigabe. - -**Signierte Windows-Runtimequelle Linux-first geprüft:** Original75a4ee16, -vollständige27-/31-Listen, exakt4Guards bestanden/112andere gefiltert; -separater Originalread vollständig, bekannte Runtimezeugen erhalten. -Eigene Agent-/Helper-Timeworker und strikt frische Upper-Leases im Quellcode, -[Belege und offene Pfade](windows-signed-clock-runtime.md). Keine native -Windows-Runtimequalifikation, Zeitpins oder Jobfreigabe durch diesen Schritt. - - -**Windows-Rohcapture einschließlich Cleanup abgeschlossen:** beide Rollen -nativ mit128Samples/gebundenemKernelExit0 bestanden, beide eigenen gestoppten -Messdienste getrennt gelöscht und Abwesenheit nachgelesen. Abschlussread -eff75fee, bekannte RMM-/Serverzeugen erhalten. [Ergebnis](windows-raw-capture-completion.md). -Noch keine Calibration/Zeitversorgung oder Windows-RMM-Jobabnahme. - - -**Auch SYSTEM-Rohclock nativ Windows bestanden:** genau ein Start, -128 Samples, tatsächlicher SYSTEMtoken und gebundener Kernel-/SCM-Exit0; -separater Originalread verifiziert nun beide Rollen. [Messwerte](windows-raw-capture-completion.md). -Bekannte RMM-/Serverzeugen erhalten. Keine Calibration oder Clockfreigabe. - - -**Öffentlicher Chrony-Pin auf Server provisioniert:** create-only, -Owner/Modi und Singlelink samt separatem Read belegt. [Belege](server-time-source-pin-bootstrap.md). -Kein Signer, Schlüssel, Brokerstart, Qualitätsprobe oder RMM-Jobgate. - - -**LocalService-Rohclock tatsächlich auf Windows bestanden:** genau ein -Start,128 Samples, gebundener Prozess und beobachteter Kernel-/SCM-Exit0; -separater Originalread vollständig. Receipt10dd411b/read43017933. -[Messwerte und Grenzen](windows-raw-capture-completion.md). SYSTEM noch offen, -keine Calibration, Clockautorität oder RMM-Jobfreigabe. - - -**Windows-Messfixture tatsächlich vollständig:** separater Completionbeleg -abaa549d und nativer Originalread048e995f, sämtliche bekannten RMM-/Serverzeugen -erhalten. Beide eigenen SCM-Dienste gestoppt; noch keine Rollenmessung, -Kalibrierung oder Clockfreigabe. [Nachweise](windows-raw-capture-completion.md). - - -**Zeitprovider und Broker auf tatsächlichem ARM64-Server gebaut:** -Originalfall5b358997, Preflight/Staging und CargoRelease0, zwei tatsächliche -AArch64-Artefakte sowie separater Originalread belegt; RMM-Containermetadaten -und Boot erhalten. [Ergebnisse inklusive vorheriger101-Fälle](server-time-source-bootstrap.md). -Noch keine Qualitätsprobe, Pins, Schlüssel, Broker-/Gatewaybetrieb oder Windowsjobfreigabe. - - -**Provider-Socketfix Linux-first bestanden:** Originalfall8ee39b4f, native -Cloud-Linux4/4 ohne Skip/Filter, separater Originalread vollständig; bekannte -Runtimezeugen erhalten.0755 akzeptiert, Gruppen-/Fremdwrite verweigert, -Ancestry/Socket-/Daemon-/Credentialbindung erhalten. [Ergebnis](server-time-source.md). -Keine Chronyrechte geändert und noch keine echte Serverqualitätsprobe. - - -**Windows-Messfixture eng repariert:** Originalfallefd17b43, separate -SYSTEM-Erstellung mit C#-internem NULL erfolgreich, beide eigenen Messdienste -verifiziert gestoppt; separater Readback und sämtliche RMM-/Serverzeugen erhalten. -Originalsetup bleibt fehlgeschlagen, keine Rollenstarts/Calibration/Clockfreigabe. -[Reparatur und Grenzen](windows-raw-capture-system-repair.md). - - -**Finaler Windows-Kontextfence Linux-first bestanden:** Originalfall1e179c84, -volle15er-Liste, nur geänderten Fencetest1PASS/14filtered ausgeführt; separater -Readback vollständig, bekannte Runtimezeugen erhalten. Recheck und erkannter -Konstruktor-Fork/Rollback invalidieren prozessweit. [Belege](windows-signed-clock-evidence.md). -Keine Windows-Kernel-/Zeitbereitschaft oder Jobfreigabe. - - -**Kurzlebige Zeitevidenz Linux-first bestanden:** Originalfall44514778, -sechs native Cloud-Linux-Vertragsprüfungen ohne Skip/Filter, separater Readback -vollständig und bekannte Runtimezeugen erhalten. [Ergebnis](signed-time-contract-results.md). -Keine Windows-Kernel-/Serverproviderqualifikation oder Jobgateaktivierung. - - -**Native Zeitbootstrapversuche2026-11-15:** Windowsoriginalfall efd17b43 -baseline und AST/C# compile-only bestanden; Setup bei zweiter Messdienstanlage -gescheitert. Eigener LocalService gestoppt, SYSTEM fehlt; Originalread samt -RMM-/Servererhaltung vollständig. Keine Rollenstarts/Calibration. Serverfall -d3be954b scheitert an unzutreffender MainPID==chronyd-Annahme; Shellwrapper -und zwei chronyd-Prozesse tatsächlich lesend belegt. Kein Stage/Build/Probe, -Pin oder Runtimewechsel. Einzelheiten: [Windowsoperator](windows-signed-clock-capture-operator.md) -und [Serveroperator](server-time-source-bootstrap.md). Originale bleiben erhalten, -kein ungeprüfter Retry. Windows-MVP weiterhin offen. - - -**Rohcapturequellen Linux-first bestanden, noch keine Windowsuhr:** dcef489d, -volle15er-Liste, neue5Guards bestanden/10andere gefiltert, separater Rückabruf -vollständig. [Belege](windows-signed-clock-capture.md). Broker3lokaleGuards, -ServerrouteCheck/Clippy und unabhängige Quellenreviews bestanden. Noch kein -echter Broker-/Chrony-/mTLS-/Windows-Zeitaustausch oder Jobgate. Der -Host→Container-PID0-Integrationsfehler ist sourcekorrigiert, reale -UID-/Namespacesprobe offen. [Brokergrenzen](server-time-broker.md). - - -**Linux-Providerunits nativ bestanden:** fe3f5082,4/4/keineSkips/Filter, -separater Rückabruf vollständig; bekannte Runtimezeugen erhalten. Nur eigene -Socket-/Parser-/Zeitbracketfixtures, keine tatsächliche Chrony-/Kernelquery. -[Details](server-time-source.md#tatsächlich-nativ-vier-provider-vertragsunits-auf-cloud-linux). -Echter Serverprovider, Broker-/HTTPbetrieb und Windowszeitbereitschaft offen. - - -**Windows-Zeitguards Linux-first bestanden:** Originalfall6ea36dec, -volle13er-Liste geprüft, ausschließlich neue3Tests bestanden/10andere bewusst -gefiltert; separater Readback vollständig, bekannte Runtimezeugen erhalten. -Geschütztes Verifiermodul6b66612b unabhängig geprüft und lokal Windowsgelinkt; -[Nachweise und Grenzen](windows-signed-clock-source.md). -Keine Windowszeit-/Jobbereitschaft; Rohcapturequalifikation folgt separat. - - -**Aktueller Zeitcodec-Endpunkt nativ geprüft:** Die Audiencekorrektur auf -/agent/v1/time-attestation hat einen eigenen Linuxfall a22de8d2 mit4/4 und -separatem vollständigem Readback; Originalfall2b282376 unverändert. -[Belege](signed-time-contract-results.md#nachfolgender-quellenstand-tatsächlicher-agent-endpunkt). -Linux-Providerquelle lokal4/4 plus unabhängiger Review bestanden; noch kein -nativer Chrony-/Kernelprovider. Ein getrennter lesender Serverkernelbefund -meldet state0/flags0/maxerror55.773ms; keine gemeinsame Qualitätsabnahme oder -Clockgateöffnung. [Grenzen](server-time-source.md). - - -**Signierter Zeitvergleich, erster tatsächlicher Linuxbeleg:** Gemeinsamer -Codec/Verifier nach Nonce-Replayfix im Originalfall2b282376 nativ4/4 bestanden, -separater Readback abgeschlossen, bekannte Runtimezeugen erhalten. -[Ergebnisse und klare Integrationsgrenzen](signed-time-contract-results.md). -Keine Server-/Windows-Zeitqualifikation oder Jobgateöffnung; Audiencepfad vor -Transportintegration noch an bestehenden /agent/v1-Vertrag angleichen. - - -**Userentscheidung1.22:** Signierter unabhängiger Windows-Zeitvergleich mit -festgelegtem Server ausdrücklich zur Umsetzung erlaubt; Agent und SYSTEM -prüfen separat, fehlende Qualität sperrt. Normativ Kapitel0/Projektentscheidungen, -[angenommener ADR](windows-clock-attestation-proposal.md). Keine Uhrstellung, -kein impliziter manueller Resync und noch kein Clockgatewechsel. - - -**Neuer nativer Linux-Sechsernachweis:** Quellenstand328e440/Main7d328ee, -Originalfall349ffb0b, Cloud-VM UID0:6/6 ohne Skip/Filter; separater Readback -abgeschlossen. Ein vorheriger lokaler Rechtefehler stoppte vor SSH und wurde -unter Erhalt von Inodes/Bytes behoben. Details samt Belegshashes: -[Linux-Updaterport](agent-updater-linux-native-results.md#neuer-sechsernachweis-nach-gebundenem-stage-reopen). -Keine Apply-/Rollback-/Windowsqualifikation; Full weiter Autostart disabled. - - -**Quellencheckpoint1.21, noch kein Runtimewechsel:** Der zusammengehörige -Updaterstand `1e89c45` ist geprüft und nach Gitea gepusht, anschließend in Main -zusammengeführt. Neue Plan-/Healthschlüsselbindung, atomarer Handoff samt -nativen Effect-CAS, Serverkatalog/Streaming/WebUI, separat signierte -Baseline-/Policycodecs und erste konkrete Worker-Fence-/Truststrecke sind im -Quellcode. Quelle allein eröffnet keine Capability. Tatsächlich lokal: -Core64/64, Domain23/23, Server45/45; fünf bestehende DB-Harnessprüfungen explizit -ignored. Gemeinsames Targetcheck, Clippy mit verweigerten Warnungen und -Formatcheck bestanden. Worker1/1 mit echter Baselinesignatur und gezieltem -historischem Floor-Gegenfehler; Kandidat weiter strikt aktuell/über Floor. -Receipt `bdcfb1b319398899cbadd1101255f4dc25108455d665a197ddcbe993080c1870`. - -Die bis dahin gemeldeten beiden Reviewfehler sind geschlossen: historische -Baselineprüfung verlangt die exakte aktive Manifestbindung; Record-Publish -muss dasselbe beobachtete Save-Hashpaar benutzen. Die sieben OSportdateien -stimmen bytegleich mit dem tatsächlich nativ geprüften Fünfersnapshot überein; -fünf Domaininputs wurden danach erweitert. Der gesamte neue Quellencheckpoint -hat deshalb **noch keinen neuen vollständigen Linux-/Windows-VM-Nachweis**. -Aktuelle laufende Cloudimages/Indizes bleiben die separat dokumentierten alten -Runtimegenerationen. Konkrete Fullbridge-/Ownerguards, vollständige Engine, -Baselinebootstrap, Updated-Recordhistory, Rollbackvertrag und tatsächlicher -WebUI-genehmigter Apply bleiben offen. Kein aktiver Selbstupdater. - - -**Aktueller Nachtrag2026-11-14:** Linux-Skriptkonsole ist nativ bestanden; -Windows und der vollständige Agent-Selbstupdater sind noch nicht abgeschlossen. -Nach dem Acht-Handoffkern bestand auch der Linux-OS-Port nativ5/5 mit separatem -Readback, ohne RMM-Job, Dateitausch oder Dienststeuerung -([Ergebnis](agent-updater-linux-native-results.md), Giteac35c440). -Der private aktuelle Linuxruntimeindex wurde im eigenen lokalen CAS-Fall99048876 -nach Erhaltungsnachweis fortgeschrieben (SHA256 -`4b98189f68b1671ed64b9ed0ab808fc53f43b2a819f5044d7e81796d8a5bb25a`). -Er ist Herkunftsindex, kein signierter Release-/InstalledRecord und keine frische -Zielbeobachtung. Darin ausdrücklich: Fullhelper aktiv, **Autostart disabled**; -keine Bootbereitschaft behaupten. Der Server-Herkunftsindex ist anschließend lokal exklusiv unter -`devstate/cloud-server-current-runtime.json` angelegt und nachgelesen -(SHA256 `671913a8e97bcf137b08fee5f5700541a42856f98744289b562e33df9ae56d98`). -Er bindet Originalmanifest43d4af86 und akzeptierten Postdeploybeleg5df21b55 -aus Fall14dcc27d: Image6f8383f7/Migration14 und exakte Webdateien. -Kein neuer Zielaufruf, keine aktuellen Job-/Policywerte aus alten Deploydaten -übernommen. Historische Indizes unverändert; kein signierter Releasebeleg. - -Windows: Privilegaktivierung allein beseitigte RPC5 nicht; der getrennte -Impersonate3-Vergleich erreichte danach eine echte Statusquery mit RPC0/Stage80. -Dies qualifiziert weder Dienstidentität noch Zeitbereitschaft. Die erste -QOS5-SID-/Service-Descriptorprobe scheiterte vor der Query mit87/Stage30 -([Befund](windows-clock-identity-result.md)). Produktclock/Windowsjobs bleiben -geschlossen. Der lesende native W32Time-Status meldete Leap3/Stratum0; zwei -separate NTPantworten sind kein Synchronisierungsbeleg. Manueller Resync bleibt -bis zur konkret angefragten Userantwort unausgeführt. Die nachfolgende -Descriptorprobe ist einschließlich separater Cleanupauflösung dokumentiert: -[Originalfehler und Erhaltung](windows-clock-descriptor-result.md), -[statische Runtimeursache](windows-clock-rpc-qos5-analysis.md). Ein signierter -Serverzeitvergleich ist inzwischen [ausdrücklich angenommen](windows-clock-attestation-proposal.md); -Implementierung und Qualifikation stehen noch aus. - - -**Fortschreibung2026-11-14 nach tatsächlicher Skriptabnahme:** Die vollständige -MCP→WebUI→Rootskriptstrecke ist auf der Cloud-Linux-VM bestanden. V2-Fall -ced97b4d, ursprüngliche Plan-/Skriptbytes in der WebUI verglichen, -SIMULIERT-Freigabeklick, genau ein erfolgreicher UID0-Lauf; stdout28/stderr27 -Byte auch tatsächlich über die WebUI heruntergeladen und verglichen. -MCP-Ergebnis identisch, zwei authentisierte Fremdmandantenabfragen verweigert. -Root19/0, ServerLinux31Jobs/31Outbox/27Grants/0ungeklärt; Windows weiter0/0/0/0. -Beide temporären Rootscopes geschlossen, Originalpolicycf15cbb6 lesend -bestätigt. Details und Grenzen: [Linux-Skriptresultat](script-console-linux-full-results.md), -Gitea76440e1. Vollständiger dreiteiliger passiver Nachbeleg ebenfalls bestanden, -Giteaefd310b. Automation hat explizit root:execute erhalten, keine -Genehmigungsrechte. Noch offen bleiben Windowsclock/PowerShell/SYSTEM, -Selbstupdater-Runtime und native Applynachweise. Die oben ergänzten privaten -Linux-/Server-Herkunftsindizes lösen den früher offenen Indexabgleich, keine -neue Runtimequalifikation. Ältere Angaben darunter sind historische -Zwischenstände. Kein vollständiger Windows-/Updaterabschluss. - -**Windowsclock-Nachtrag:** SPNEGO liefert tatsächlich einen nicht-NULL leeren -Principalnamen. Erst die eigene ursprüngliche Nichtleerprüfung stoppte vor RPC; -der neue getrennte Empty-Case5e0e8ce9 führte genau eine Query aus und meldete -weiter RPC5/Stage90 ohne Status. SeSystemtimePrivilege ist im Diagnoseprozess -vorhanden, aber deaktiviert; das beweist noch keine alleinige Fehlerursache. -Readback, Cleanup und sechs unveränderte native RMM-Bereiche bestätigt; Windows -weiter0/0/0/0. Der parallele Linuxjob erklärt explizit31/31/27 statt30/30/26. -[Tatsächlicher Beleg98f4edf](windows-clock-spnego-empty-trace.md). -Der nächste isolierte Prozessprivilegvergleich ist noch kein Zielnachweis. - -**Updater-Kernnachtrag:** Acht feste Handoff-/Fullrenderer-/Healthverträge aus -a2efb79 sind danach tatsächlich auf Cloud-Linux als UID65534 bestanden, -kein Skip/Filter; separates lesendes Readback und bekannte Dienst-/Kontroll-/ -Stateidentität erhalten. [Ergebnis und Grenzen](agent-updater-handoff-linux-results.md). -Keine Applyruntime oder Windowsqualifikation daraus ableiten. - -**Vorheriger Betriebsstand der Skriptkonsole2026-11-14:** Cloudserver und WebUI -sind im separaten Fall14dcc27d tatsächlich erhaltend bereitgestellt (ARM64-Image -6f8383f7, Migration14; alte Geschichte/Identitäten unverändert). Die drei neuen -Linux-Dienste Agent0a7ad6ee sowie General/Full79442727 laufen nach einmaligen -Starts und separatem Readback, gleicher Boot; APT bleibtdisabled. Ursprüngliche -Installer-/Startprobeberichte bleiben fehlgeschlagen und erhalten. Quellen und -Nachweise jeweils nach Gitea gepusht: [Bereitstellung](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/cfd32ea/docs/script-console-bootstrap-results.md). -Aktuelle Skriptunits danach auch nativ Windows36+7 bestanden, keine Skips; -[Beleg5b2f07b](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/5b2f07b/docs/script-console-windows-link.md). -Ein erster lesender Linux-Historien-/SignedSyncnachweis ist bestanden; der -vollständige dreiteilige passive Nachbeleg wird noch vervollständigt. Neue WebUI -privat mit geprüftem TLS und Sandbox sichtbar als SIMULIERT angemeldet, kein -neuer Job/Approval. Windowsclock weiterfalse, Updater weiterhin nur Prüfkern. -Die alten privaten Runtimeindizes nicht als Pins der neuen Linux-Generation -verwenden; deren Fortschreibung folgt erst dem vollständigen Nachbeleg. - -**Fortschreibung2026-11-14:** Die parallele Weiterarbeit an Skriptkonsole, -Windowslaufzeit und Agent-Selbstupdater ist ausdrücklich beauftragt. -Der Windowszugang wurde tatsächlich wiederhergestellt und vollständig erhaltend -geprüft. Pipe-v2-Paarupgrade14fb ist inzwischen nativ bestanden; aktuelle -Agent-/Helpergenerationf10c78dd/5f8c62fa läuft, Pipepeerprobe positiv, -Clock/Jobs/Wirkungen bleiben gesperrt. Linux10→Windows42-Runtimeunits bestanden; -erster Harnessfehler bleibt dokumentiert. Microsoft-MIDL-Codegen nativ -abgeschlossen, noch keine positive Clockabnahme. Quellen-/Prüfstände und offene -Integrationsschritte: [paralleler MVP-Stand](parallel-mvp-status.md). -Die älteren gegenteiligen Zwischenstände unten sind historische Belege. - -**M0–M5 sind im vereinbarten begrenzten dev/test-Umfang vollständig -nachgewiesen.** Linuxabschluss unter Spezifikation1.15; aktueller Gesamtvertrag -ist1.18. Umfang und Grenzen der Linuxabnahme stehen in -[mvp-gates.md](mvp-gates.md) und [mvp-final-audit.md](mvp-final-audit.md). -Die frühere Entwicklungspause wurde durch den ausdrücklichen -Fortsetzungsauftrag aufgehoben. Ältere offene oder pausierte Zustände unten -sind historische Belege. - -- Der Linuxclient läuft ausschließlich auf der permanenten Ubuntu-24.04- - x86-64-Cloud-VM gegen `discovery.ease-technologies.de`. Das Notebook hat - keine RMM-Dienste oder RMM-Container und dient nur der Entwicklung. - Windows ist ein eigener passiv geprüfter Gast; sein Ausbau ist ausdrücklich - beauftragt und ändert die abgeschlossene Linux-Abnahme nicht. -- Nativ bestanden: Paketfixture 1.0→1.1 und beide eigenen Noops, drei aktive - Offlinefälle, Doppelzustellung, ACK-Verlust, Agentcrash, Rootdienst und - begrenzte Logs, TLS-Lifecycle/Fallback sowie genau ein genehmigter Reboot. - Alte Fehlversuche bleiben fehlgeschlagen; fehlende Messwerte fehlen weiter. -- Der ursprüngliche Rebootjob 8ffd / Grant 25a wurde durch normalen - signierten Sync geschlossen: neuer Boot, Originalinventar innerhalb 180 s, - zusätzliche frische Verifikation. Keine zweite Wirkung und kein Reset. -- Reale Fehler wurden offen behoben: automatische Helper-Startwiederholung - nach 5 s; endliches Journalbudget von 1 GiB pro Datei ohne Kompaktierung; - eng versionierte Korrektur der strikten APT-Installationsmetadaten. - Alte Ledger-, Acceptance-, History-, Schlüssel- und DB-Inodebelege erhalten. -- Aktuelle Artefakte: Agent `9e9f3230…`, Helper `d6fbfc25…`, Provider - `1dc0237d…`, General-Unit `104a7d6f…`, Servercandidate `7be1f330…`. - Historische M4-Paketabnahmen bleiben an Runtime `3bac…` gebunden. - Aktuelle APT-Runtime `6545c784…` ist separat nur kopierend als - `readiness_only` qualifiziert, keine neue Paket-Acceptance. - Historische Runner-/Runtime-JSONs nicht als aktuelle Artefaktpins verwenden - und ursprüngliche Berichte nicht überschreiben. -- Letzter Zustand: 30 Jobs / 30 Outbox / 26 Grants / 0 ungeklärt; - Root 18 verbraucht / 0 offen / 0 Faults. Agent tatsächlich UID 993/GID 984; - Agent und General aktiv/enabled. APT und beide Legacydienste inaktiv/disabled, - APT-Endpunkt entfernt, General `allow_reboot=false`, zentrale Rootscope - geschlossen. Testhooks aus, Probeoverride entfernt, Rollbacktimer inaktiv. - API/Gateway laufen mit dem qualifizierten Image als UID 10001, Ports nur - `127.0.0.1:18443/18444`; PostgreSQL healthy ohne publizierten Port. -- Geschützte Endbelege: `devstate/cloud-mcp-reference-final.json` enthält - sieben bestehende erfolgreiche Operationen und die originale - Idempotenzreceipt. `devstate/cloud-mvp-final-closeout.json` ist verifiziert - und bindet die unveränderten Rohbeobachtungen per Hash. Weitere Belege unter - `devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/`. - -Alle Genehmigungen sind tatsächliche WebUI-Interaktionen mit sichtbar -simulierter dev/test-Identität, kein menschlicher Produktionsfreigabenachweis. -Produktions-IdP, CI-Runner, Mehrgeräte- und Langzeitbetrieb sind nicht -abgenommen. Die folgende Windowsfortsetzung ist ausdrücklich beauftragt; -weitere Themen stehen im [Backlog](post-mvp.md). -Zugänge und private Rohbelege bleiben gitignoriert. - -## Aktuelle Windowsfortsetzung - -Neue isolierte Quellenstände (jeweils nach Gitea gepusht, **keine neue -Windows-Runtime oder Cloudserverbereitstellung daraus ableiten**): - -- `codex/windows-msi-integration`/`ae82b27`: Spec1.19, striktes MSI-Manifest, - Tenantkatalog/Migration0014, exakte automatische Artefakt-/Rezeptmengen und - separate SYSTEM-Paketerlaubnis; unabhängig geprüft. Lokal118Rust/PG1 und - UI42/Typecheck/Build bestanden. Echte synthetische Rust-Planbytes1.0/1.1 - prüfen die UI; der zuerst gespiegelte None-/Null-Fehler ist korrigiert. - Anschließend **Cloud-Linux101 nativ bestanden**, Fall `d015f861…`, Manifest - `2d96a07b…`, Proof `09fa24e3…`. Danach **Windows79 nativ bestanden**, Fall `1b1aeff3…`, - Proof `666ed196…`, gleicher Manifest-/Linuxproofbezug. - Cache-/Helper-/Runtimeintegration im separaten `codex/windows-msi-runtime` - /`287a784` implementiert/unabhängig geprüft: deny-onlyCancel, geschützter - Cache, Originalbudget und Erhaltung unklarer Installerhandles. Lokal10 plus - WindowsClippy/Link bestanden; nativeCloud-Linux10 ebenfalls bestanden (050c33bd…, - 620255bc…/679ac094…), Windows35+7 noch erwartet. Keine Paketwirkung oder Capability veröffentlicht. -- `codex/windows-clock-diagnostic`/`ae9b271`: Trace nativ im Fall `2996df8c…` - bestätigte1783 als aufgefangene RPC-/NDR-Ausnahme vor normalem Stubreturn, - nicht eigenen Strukturguard (`572d70e1…`). Neuer lokal geprüfter WIDL- - Pointerkandidat `91889303…` erzeugt ref→unique statt ref→ref. Die komplette - Microsoft-IDL zeigt mit WIDL7 denselben rekursiven Attributfehler; kein - manueller Stubbytepatch. Kandidat danach **nativ ebenfalls fehlgeschlagen**, Fall `79896ca7…`: weiter - Named-Pipe1783/Stage90 ohne Status, ALPC1753; isolierter Dienst entfernt, - Erhaltung/geschlossene Zähler bestätigt (`fceb92c2…`). Clockfalse. Nativer - Microsoft-MIDL-Codegen ohne Installation mit festen zwei SDK-Tools vorbereitet - und lokal geprüft; noch nicht auf Windows ausgeführt. -- `codex/windows-pipe-drain`/`fc2d01d`: eigener V2-Endpunkt und begrenzter - Transport-Drain-ACK implementiert/lokal geprüft. Neuer Pack `59623db2…`, - Manifest `b2f77713…`, **23+7Windowsunits nativ bestanden**, Fall - `db25cd4a…`; keine RMM-Jobs, Produktdateien oder Dienste geändert. - Paarupgrader e4665766… separat geprüft: alle drei Befunde behoben. Fall14fb… - nach erstem180sStagingtimeout nur nach echter Abwesenheitsprüfung in seiner - unerreichten ersten Phase fortgesetzt, Baseline57b79e9c… gewonnen. **Kein - Enter/Stop/Swap/Start**; unveränderte aktuelle Generation890/e6, HelperStopped. - -Manueller Windows-Konsolenneustart nach konkreter Zeitabstimmung vom Benutzer -als abgeschlossen bestätigt und nativ nur lesend nachgewiesen: Boot -2026-11-14T12:26:50.5000000Z, Fall `d888645b…`, Bericht `ab4a99b7…`. -Agent89004ad3 läuft als LocalService/Auto mit neuem PID3172; Helpere6aacbdd -und W32Time waren entsprechend ihrer unveränderten Manual-Startart gestoppt. -Danach W32Time gezielt mit bestehender Userfreigabe im separaten bootgebundenen -Fall203ce31a… einmal gestartet und identisch lesend bestätigt (badcc320…); -Helper weiterhinStopped, keine Startart-/NTP-/ACLänderung oder RMM-Jobs. -WU-Neustartmarkerfalse, CBS-Neustartmarker weiterhintrue. Kein Remote-Reboot, -keine Startartänderung, kein Installer; MSVC bleibt deshalb gesperrt. Die alten -PIDs8108/2620 unten sind historische Wartungsbelege, keine aktuelle Baseline. -Windows79-Vertragstests anschließend nativ nach dem Linux101-Beleg bestanden. -Der bisherige Dev-Reversetunnel lief2026-11-14T12:55:31UTC ab. Zwei neue -Readonly-Bootstrapfehler verhinderten rechtzeitige Erneuerung, dritter lokaler -Fristguard ohne Zielaufruf; keinerlei Renewal-Enter oder Worker. Danach eigener -Server-only-CAS im Fall4b6506a7…: gleicher restriktiver Key und gleiches SSH- -Profil, neue Frist2026-11-15T13:05:58UTC. Windows-Konsolenphase ist per -asynchroner Benutzeranweisung angefragt, noch nicht bestätigt oder nativ -nachgewiesen; noch kein neuer Windowszugriff oder lokaler Accessmetadatenwechsel. -Öffentliches Recoverypaket7bf4… zuerst separat publiziert, dann wegen unbelegter -Accountzeit-Rundung gezielt zurückgezogen. Neuer eigener Präzisionsfall5c96d3d8… -leitet genau einen Sollwert aus Originalcfg-UTC ab (kein VM-Messwert, keine -Toleranz), gleiche bereits ausgeführte Serverfreigabe. Neuer öffentlicher -ZIPdbcd5ca8… bis14:17:54UTC tatsächlich publiziert/extern mit normaler TLS-Prüfung -verifiziert; eigener neuer Close-Timer aktiv für14:17:54UTC, alter Downloadtimer -tatsächlich inactive/disabled. Letzter lesender Servernachbeleg: kein Windows- -Reverselistener. Aktuelle Benutzeranweisung ersetzt alte Rückfrage; Details: -[Korrektur](windows-recovery-precision-download.md). - -Gemeinsame passive Komponentenwartung nach dokumentiertem ersten APIfehler -abgeschlossen, Originalfall `6d2df065…` und separate Recovery `595dd1da…`. -ActualAgent `89004ad3…` LocalService/Auto PID8108; Helper `e6aacbdd…` -SYSTEM/Manual PID2620; Policy `007adf5f…`, Pin `126670bc…`. Alle vier Dateien -mit expliziten Nativebackups und Datei-ID-/ACL-/Frozenprüfungen ersetzt, -danach beide eigenen Dienste jeweils einmal gestartet. Zwei frische WSS- -Heartbeats, konkretes Inventar-ACK, Tenantverweigerung und Erhaltung bestanden. -Runtime-/Komponentenindex per CAS veröffentlicht; Ursprung/Fehler/Backups erhalten. -Abschluss `ac00411f…`, Recoveryacceptance `5ad5925c…`. Keine Jobs/Bindings, -Clockfalse, Wirkungen/Rebootfalse, Intentablage weiter0B. Die ursprünglichen -Stoppedabschnitte unten sind jetzt historische Zwischenstände. - -Positive Pipeabnahme weiterhin **fehlgeschlagen**: tatsächlicher neuer Agent -8108 meldet `client_read_reply`/`HELPER_PIPE_IO`/Win32233; privater Helper- -Diagnosebeleg fehlt. Das grenzt den Clientpfad ein, beweist aber keine konkrete -Serverursache. [Wartung/Recovery](windows-system-delegation-upgrade.md). - -Clockkandidat nach W32Time-Start tatsächlich nativ ausgeführt, Fall `e1f3edbb…`: -LocalService bestätigt, beide ALPC-Proben1753, kein Endpunkteintrag; beide -Negativkontrollen ebenfalls1753, kein Identitätsnachweis. Named-Pipe-Diagnose1783 -ohne Status, Ursache noch unbewiesen. Originalbericht separat identisch gelesen, -eigener temporärer Dienst entfernt, Zentralstände/Flags erhalten. Clockabnahme -**nicht bestanden**, Gatefalse und keine Jobs. Microsoft spezifiziert für -MS-W32T Named Pipes, keinen zugesicherten ALPC-Endpunkt. [Native Details](windows-clock-readiness.md). - -Vorhandenes W32Time ausdrücklich autorisiert einmal gestartet, nativer Fall -`c3552c3f…`: Running und unveränderte RMM-PIDs5140/6240, Konfiguration, -PKI-Metadaten und Dienstdefinition bestätigt. Getrennter Readback identisch, -Zentralstände0/0/0/0 und30/30/26/0 sowie geschlossene Flags erhalten. Kein -Uhrqualifikations- oder Rebootbeleg; `ADAPTER_QUALIFIED=false`. [Startnachweis](windows-time-service-start.md). - -Separater M3-Branch `codex/windows-eventlog`, Commit `eb38b4b`: fester -Application-/Fixtureprovider, begrenzter authentisierter Worker und sichtbarer -hashgebundener Plan implementiert und unabhängig geprüft. Lokal238Rust, -isolierterPG-Fall und38Webtests/Build/Clippy bestanden; anschließend nativ -Cloud-Linux24→Windows23 ohne Skips, Manifest `ed1371e9…`, Fälle `6f9bdfb7…` -und `ccb258a7…`. Quellen und beide Abnahmeschritte jeweils gepusht. Dies sind -Vertragsunits, keine tatsächliche LocalService-Eventlog-Abfrage oder Jobwirkung. -Keine Capability aktiviert, keine Runtime ersetzt. [Quellen und genaue Grenzen](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/branch/codex/windows-eventlog/docs/windows-eventlog-source.md). - -Separater Profilbranch `codex/windows-powershell-profile`, Commit `207b91f`: -RemoteSigned als optionales festes Aktions-/Variantenfeld implementiert, alte -Bytes erhalten, UI-Planansichten streng gebunden. Lokal Rust-/Server-/35Web- -Prüfungen bestanden; danach nativ Cloud-Linux23 ohne Skips, Fall `f463acc9…`, -Manifest `26247a3a…`. Anschließend nativ Windows22 ohne Skips bestanden, -Fall `9abd3e0d…`, Proof `47cee8c9…`, an denselben Linuxbeleg gebunden. Keine -Profilcapability veröffentlicht und kein PowerShelljob gestartet. Der -Hauptcheckout bleibt für die Komponentenwartung unverändert. Quellen/Nachweise: -[Profilbranch](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/branch/codex/windows-powershell-profile). -Ein separat tatsächlich bestätigter Schemars-Nullable-Metadatenunterschied -betrifft keine Berechtigung; sein enger Attributfix wird im isolierten folgenden -M3-Schnitt mitgeführt. Der ursprüngliche Nativebeleg wird nicht umgeschrieben. - -Neue Userentscheidungen1.18: RemoteSigned nur für den einzelnen zuvor in der -WebUI genehmigten PowerShell5.1-Jobprozess, vor Genehmigung sichtbar und fest -gebunden; bestehendes W32Time gezielt starten ohne Startart-/NTP-/ACLänderung; -manueller VM-Konsolenneustart erst nach konkreter Zeitabstimmung. Keine Remote- -oder RMM-Rebootfreigabe. Profilquelle und Vertragsunits im oben genannten -isolierten Branch vorhanden; tatsächlicher genehmigter Job weiterhin offen. -[Begrenzter Vertrag](windows-powershell-policy.md). - -Gemeinsamer Upgradefall `6d2df065…` bisher vor dem Server-Beforecheckpoint -abgebrochen, kein Enter-/Stop-/Swap-/Startintent. Bestehender RMM-Agent meldet -weiter Heartbeats; Reverse-Tunnellistener vorhanden, aber TCP-Weiterleitung -lieferte zunächst kein SSH-Banner. Ein eng begrenzter Devtransport-Reset im -Fall `eed7dad0…` beendete genau den separat identifizierten Tunnel-Sessionchild -über sein gepinntes Prozesshandle; kein SSH-Master-/UID-Reset. Der bestehende -Windowsloop stellte den Listener neu her; Anmeldung mit unverändert gepinntem -Windows-Hostschlüssel und lesender Nachbeleg bestanden. Agent5140 und Helper6240 -laufen unverändert, W32Time weiterhin gestoppt. Ursache der ursprünglichen -Bannerblockade unbewiesen; keine neue Schlüssel-/Port-/Expiryfreigabe und kein -VM-Neustart. Kein Upgradefortschritt daraus ableiten. -Konkrete Zeitabstimmung für den bereits zugesagten manuellen Konsolenneustart -wurde angefragt; bis zur Antwort keine Ziel-Neustartaktion und keine Annahme -eines erfolgten Neustarts. Aktuelle Artefakte weiterhin2bee/921c. - -Vollständiger neuer Nur-Lese-Helperwitness auf der Windows-VM bestanden, -Fall `f4879e01…`, EXE `d0b2d033…`: tatsächliches SQLite-VFS-Dateihandle, -Integrität, drei Basistabellen0/0/1 und zwei leere Intent-Leaves geprüft; -vier Synctabellen fehlen ausdrücklich. Exit0, keine privaten Zeilen/Schlüssel -ausgegeben, zentrale Zähler/Flags unverändert. Separater dauerhafter -Resultreadback identisch. Nur Bootstrap-Administrator-Nachweis, kein -SYSTEM-/LocalService-Pipe- oder Jobnachweis. [Native Readerabnahme](windows-system-state-witness.md). - -Neuer SYSTEM-Delegationsadapter unabhängig quellgeprüft und als gemeinsamer -Build `80655271…`/Manifest `71914e2a…` mit70Quellen gebunden. Nativ Windows -23Lib+7Bin ohne Skips bestanden, Fall `5f95361a…`; RawMirror-Unknown und -wiederholter Terminal-Startup idempotent korrigiert. Statische private Pipe- -Diagnose und dokumentierte OVERLAPPED-Bytezählung korrigiert, ursprüngliche -Nativeursache weiter unbewiesen. SSH-Timeout vor erstem Unitstart nur nach -Readonly-Hash-/Abwesenheitsbeleg als erste noch nicht erreichte Phase fortgesetzt. -Neue Artefakte89004ad3/e6aacbdd **noch nicht installiert**; tatsächliche -Agent-/Helper-Runtime2bee/921c unverändert. [Genauer Quellen-/Native-Stand](windows-system-delegation-source.md). - -Eigene Intentablage auf dem Windowsgast einmal vorbereitet und separat nur -lesend verifiziert, Fall `f322a4d2…`: geschütztes Verzeichnis und genau zwei -Admin-owned0B-Leaves mit Actor-RW/Synchronize ohne Delete/Owner/DACLrechte. -Agent5140/Helper6240 und ursprüngliche Metadaten/Policies erhalten, zentrale -Zähler unverändert. Keine SQLiteinitialisierung, keine PERSIST-/Hotjournal- -oder Agenttoken-Funktionsabnahme. [Tatsächlicher Vorbereitungsbeleg](windows-intent-store-preparation.md). - -Direkter produktiver Prozess-Peerproof im neuen Fall `d792c4c6…` bestanden: -eigener SYSTEM-Parent3992 prüfte unverändert Agent5140 mit tatsächlicher -Startzeit `134390970107200328`, SCM-/Token-/Image-/Dateibindung,20ms. Kein -Pipeaufruf, Child, Token-Duplikat oder ACLwechsel. Originale Prozesse, -Metadaten und Zähler erhalten, eigener Dienst entfernt. Ursprünglicher -SSH-Timeout bleibt dokumentiert; vor expliziter Fortsetzung der ersten noch -nicht erreichten Startphase wurden fehlender Startmarker und fehlender eigener -Dienst nur lesend nachgewiesen. Produktive Agentprobe bleibt fehlgeschlagen, -keine positive Pipeabnahme. [Kontrollbericht](windows-helper-peer-controls.md). - -Korrigierter Parentdiagnosefall `00703dab…`, Manifest `869a999c…`/EXE `35dea018…`: -tatsächlicher SYSTEM-Parent8256, atomar zugeordneter Child7360 mit Agenttoken, -Exit0, Originalagent5140 erhalten. Alle fünf Helper-SDK-Vorprüfungen unter SID19/ -Agent-Service-SID bestanden; Probe ohne Antwort/`HELPER_PIPE_IO`18ms bei bewusst -fremdem PID/Image. Diagnostisch, kein tatsächlicher Agent-Pipe-Erfolg und keine -konkrete serverseitige Ablehnungsursache behauptet. Eigene Dienste entfernt, -Metadaten/Policies/Zähler erhalten. Alter Parentfall bleibt fehlgeschlagen. -[Kontrollbericht](windows-helper-peer-controls.md). - -Enger Domain-/WebUI-SCM-Schnitt implementiert: explizites `system:execute`, -feste Fixturezustände und sichtbare Bindung aus gespeicherten Planbytes. -15 Domain-/26 Webtests, Clippy/Typecheck/Build lokal bestanden; anschließend -15 Domainunits nativ zuerst Cloud-Linux (`0dd12ed9…`, Binary `635a6dd6…`) -und danach Windows (`60e404a2…`, `bdadedef…`), keine Skips. Der Windowsbeleg -bindet den Linuxbeleg; nur Bootstrap-Units, keine Service-/Jobabnahme. -Nach SSH-Störung vor Upload/Unitstart wurde die noch nicht erreichte erste -Unitphase erst nach Readonly-Abwesenheitsprüfung im selben Fall fortgesetzt. -Kein Deployment oder Capabilitysetup. Vorbereiteter -Runtimepfad bleibt wegen Reviewbefund zu Vor-Delegation-Consumption gesperrt; -dessen Korrektur darf den unabhängigen Helperabgleich nicht aufweichen. -Spezifikation1.17 und [Abandonvertrag](windows-system-abandon.md) beschreiben -den zusätzlichen engen deny-only Nichtstart. Dessen gemeinsamer Kern ist jetzt -implementiert: lokal80 und nativ Cloud-Linux80 Prüfungen bestanden, Fall -`9d08e552…`, gemeinsamer Build `de37ee99…`; danach nativ Windows58 ohne -Skips bestanden (`4a260f42…`), Windowsbeleg bindet Linuxbeleg. Nur Bootstrap- -Units; keine Runtimeinstallation und keine SYSTEM-Jobabnahme. -Windowsadapter weiter im unabhängigen Review, keine Runtime-/Jobqualifikation. -[SYSTEM-Vertrag und Nachweise](windows-system-policy.md). - -Helper-Peer-Kontrollfall `603c2f9d…`: native Windows5-Speicherproben der -ACL-Konstruktoren, geschützte Vorbereitung und rohe Administrator-/fremde -LocalService-Kontrolle bestanden (Pipeöffnen jeweils verweigert5, tatsächliche -getrennte Rollen, kein SDK-Selbstcheck). Eigener LocalService-Kontrolldienst -PID9064 nach Stopped entfernt, nicht der bestehende Agent. -Originale Agent-/Helperprozesse5140/6240 und Windows0/0/0/0/Linux30/30/26/0 -erhalten. Parentphase tatsächlich unvollständig: Controller9060 verweigerte -wegen `CONTROL_ORIGINAL_AGENT_BIRTH` vor Token-Duplikation/Childstart. -Readonlynachbeleg zeigt CIM-Präzisionsverlust von8×100ns beim Originalagenten -gegenüber dem exakten `Process.StartTime`-/GetProcessTimes-Wert. Korrektur über -exakte Quelle geplant, keine Toleranz und kein Wiederholen des alten Versuchs. -Positive Agentverbindung und Child-/SDK-Diagnose bleiben offen. -Vorheriger Fall `4a60d264…` scheiterte vor Dienststart an einer exakt nativ -reproduzierten Null-Collection aus leerem PowerShell-IF-Zweig; weder -allgemeiner Konstruktorfehler noch nachträglicher Erfolg behauptet. -[Kontrollbericht](windows-helper-peer-controls.md). - -Zentrale getrennte SYSTEM-Policy implementiert, lokal und anschließend13 reine -Policyguards nativ auf Cloud-Linux bestanden, Fall `13b11ce4…`, Binary `ca1df8b2…`. -Rootrecht ist kein SYSTEM-Recht, exakte Geräte-/Helperpins und enge Fixture-SCM- -Grenze; unsichere Policyvorfahren werden verweigert. Kein Deployment, neue Rechte, -Policyaktivierung oder Windowsjob. Domain/WebUI/Runtime-SCM-Route noch separat -offen. [Vertrag und Nachweis](windows-system-policy.md). - -MSVC-Werkzeugbootstrap im neuen Fall `b208282f…` vor Downloads/Installation -gestoppt: Die VM meldete bereits CBS- und Windows-Update-Neustartbedarf. -Beide Marker separat nur lesend bestätigt; kein Marker entfernt, kein Installer -oder Reboot gestartet. Der Benutzer wurde um Abstimmung eines späteren eigenen -Konsolenneustarts gebeten. Agent5140/Helper6240 laufen weiter, W32Time bleibt -gestoppt. MSVC/Signierung/Installer weiterhin offen; siehe -[MSVC-Bericht](../deploy/windows/msvc/README.md). - -MSI-Fixturebau auf dem Windowsgast tatsächlich bestanden, Fall `48291dbe…`: -20480Byte, Artefakt `2204dc82…`, unabhängiger Tabellen-/CAB-/Hashreadback und -lokale Rust-Rezeptvalidierung. Zwei alte COM-Fehlerfälle bleiben fehlgeschlagen; -Ursache des Typfehlers war ein ETS-Wrapper im Argumentarray. Keine Installation -oder RMM-Jobwirkung. Einzelheiten und noch offene Integration/Upgrade-/EXE-Abnahmen: -[MSI-Bericht](windows-msi-fixture.md). - -Eigener SYSTEM-Helper inzwischen nativ installiert und einmal gestartet, -Fall `59c2fd6f…`, Helper `921cf182…`, LocalSystem/Manual, PID6240. -`allowed_services=[]`, `enable_effects=false`, `allow_reboot=false`; -eigenes geschütztes Ledger und Lock vorhanden. Der echte unveränderte -LocalService-Agent PID5140 meldet jedoch `HELPER_NOT_AVAILABLE`; die positive -Peerprüfung ist ausdrücklich fehlgeschlagen. Diagnose ohne RMM-Wirkung läuft, -keine Readiness/Systemfähigkeit daraus ableiten. Ältere Aussagen „noch nicht -installiert“ unten sind historische Zwischenstände. - -Neuester Windowsruntimeindex: Agent `2beed7fa…`, tatsächlicher LocalService -PID5140, Featurefall `cea4d30f…`, davor neue native21+6-Unitqualifikation -`23b0e0aa…`. Gleiche Identität, sechs Konfigurationsfelder, Telemetrie-DB und -Schlüsselmetadaten erhalten; WSS/Heartbeat/ACK/Tenantprobe bestanden. Timeout -im ersten Nur-Lese-Readback ausschließlich durch Lesen desselben Falls geklärt, -kein zweiter Start. Optionaler Helperclient kompiliert/aktiv vorhanden, kein -Signingbinding beim Netzwerkagenten, Jobs/Uhr geschlossen, keine SYSTEM-Caps -oder Execute-Route. Pipe-/Helpernachweis folgt separat. Die unten genannten -`f64e8115…`- und älteren Stände bleiben historische Abnahmen. - -Aktueller Linux-Dienststand nach Shared-Core-Fortsetzung: Agent `c9c09de0…`, -Helper `51c3142a…`, Provider/Units/Policies unverändert. Eigener Fall `a2423612…` -hat beide Binärdateien erhaltend installiert; ein getrennter Nur-Lese-Nachbeleg -bestätigt UID993/GID984, Root18/0, historische DB-/PKI-/Outcomeerhaltung und -normalen signierten Sync114. Zentral30/30/26/0, MCP online/fremder Tenant -verweigert; keine neuen Jobs oder Reboots. Originale Fehlerberichte bleiben -erhalten (zu strenger Hardlinkcheck, falscher letzter Gruppenvergleich und -zunächst nicht berücksichtigte signierte Cache-Referenzerneuerung). -`devstate/cloud-shared-core-current-runtime.json` bindet die tatsächlichen -Zusatzbelege. Historischer Abschluss und alte Paketabnahmen bleiben unverändert; -APT ist weiter geschlossen und für die neuen Hashes nicht erneut qualifiziert. - -Neuester passiver Windowsstand: Agent `f64e8115…`, eigener erhaltender Fall -`c4f9b280-e83d-4b8e-a1c2-1cd103f73eda`, tatsächlicher LocalService/Auto/WSS, -gleiche Identität/Schlüsselmetadaten/ACLs und ursprüngliche Telemetrie-DB. -Neue Hardware-/begrenzte Softwarebeobachtungen, zwei frische Heartbeats und -konkretes Inventar-ACK nachgewiesen. Davor native Default-Unitqualifikation -`3dbfe686-6e91-41e9-a5bc-078f7a4e3e6a`:12+6 tatsächlich bestanden. -Jobs bleiben deaktiviert, Clockadapter fest unqualifiziert, kein Signingbinding, -Verbrauchsledger oder Jobsverzeichnis angelegt. W32Time gestoppt und unverändert; -dessen Start und eine mögliche nur prozessbezogene RemoteSigned-Option wurden -konkret beim Benutzer angefragt, noch nicht genehmigt. SYSTEM-Helperquelle nur -featureisoliert vorbereitet, noch nicht installiert/nativ als Dienst abgenommen. -Nach tatsächlichem Codecfehler wurde die Probevariante strikt korrigiert; -eigener Fall `38b0fe75-f6a5-4ad3-ab2d-7f3acf7e9cbd` bestand alle21 nativen -Unitfixtures, kein tatsächlicher SYSTEM-/Pipepeer-Nachweis. -Details und Grenzen im [Implementierungsstand](implementation-status.md) und -[Clockbericht](windows-clock-readiness.md). Notebook weiterhin nur Entwicklung. - -**Fortsetzung 2026-11-14:** Gemeinsamer `rmm-agent-core` und Linuxadapter -implementiert. Eigene Core-Unittests zuerst auf Cloud-Linux (25) und danach auf -Windows (24) nativ ohne Skip bestanden; Fall -`4bc4db12-2990-4e93-bb86-8fbd94b691fb`. Geschützte Manifest-/Quell-/Artefaktbindung -in `devstate/shared-core/acceptance//`. Keine Dienst-/Serverersetzung oder -Jobwirkung durch diese Tests. Native Dienstintegration, vertrauenswürdige Uhr -und erste tatsächliche WebUI-genehmigte PowerShell-Strecke bleiben offen. -Server/Domain/WebUI unterstützen lokal geprüft feste Plattformvarianten; -Clouddeployment steht noch aus. Vollständiger Restumfang: -[Windows-Gates](windows-gates.md), [Umsetzungsplan](windows-remaining-implementation.md). - -Danach gemeinsamer Helper-Sync mit explizit getrennten Root-/Systembindungen -portiert: im eigenen Fall `5704073c-a135-431c-aa84-fedc68a3de0b` zuerst -69 Linux- und danach 47 Windows-Fixturen nativ bestanden, ohne RMM-Wirkung oder -Dienstersetzung. Windows-SYSTEM-Helper/Named-Pipe-Integration bleibt separat offen. - -Aktueller Cloudserver seit dieser Fortsetzung: Candidate -`9058f6a3-0832-400f-ba93-b3fb94faaba0`, Sourcecommit `31278be`. -Neue Plattformverträge/UI bereitgestellt, keine neuen Jobs; Linux 30/30/26/0 -und Windows 0/0/0/0 erhalten. Rollen UID10001/Loopback, PostgreSQL healthy, -Rootpolicy und deaktivierte Faults erhalten. Passiver Windowsclient hat nach -Hello ein Legacy-Readyflag, weiterhin keinen signierten Sync-/Executornachweis. -Windows-PowerShell-Plan ohne Fähigkeiten tatsächlich verweigert. - -Gemeinsamer Persistenzfix anschließend nativ qualifiziert: atomarer Start, -Outcome-CAS vor Result und Startup-Recovery nur aus vollständig gebundenen -Originalbelegen. Fall `08a9be72-dd7c-46b7-a2c6-7d17424533c2`, zuerst Linux76, -danach Windows54, keine Skips oder RMM-Wirkung. Fehlender Outcome bleibt Unknown; -keine abgeschwächte signierte Freigabe. Die noch laufenden Dienste sind dadurch -nicht automatisch als aktualisiert nachgewiesen. - -Der bestehende Windows-11-LocalService bleibt passiv: gleiche Geräteidentität, -Telemetriehistorie und Schlüssel; keine Jobs, Outbox oder Startgrants. Native -WSS-/Inventar-/Tenantnachweise und sieben Rusttests liegen vor. Explizites HTTPS -ist unter dem tatsächlichen LocalService mit zwei frischen Heartbeats und -konkretem Inventar-ACK geprüft. Anschließend wurde die ursprüngliche -WSS-Konfiguration samt ACLs wiederhergestellt und erneut nativ beobachtet. - -Auch automatischer WSS→HTTPS-Fallback ist nativ bestanden: genau zwei -zielgebundene mTLS-WSS503-Auditreceipts, danach frische HTTPS-Heartbeats und ACK. -Windows blieb bei 0 Jobs/Outbox/Grants/ungeklärten Wirkungen; der Linuxstand -30/30/26/0 blieb unverändert. Rootpolicy blieb erhalten, beide zentralen -Transporthooks sind aus; die ursprünglichen WSS-Bytes/ACLs wurden restauriert. -Geschützter Fall: `devstate/windows-client/auto-transport/2ff2e1aa-0037-4831-9bc2-31218bf1461c/`. - -Anschließend wurde die vorhandene VM separat dauerhaft auf `transport=auto` -umgestellt; WSS bleibt bevorzugter Kanal. Zwei frische WSS-Heartbeats und -konkretes ACK sind unter LocalService (`S-1-5-19`) nativ beobachtet. Agentbinary, -CA/Zertifikat/Schlüssel, Identität, ACLs und Telemetriehistorie sind erhalten; -Serverflags, Rootpolicy und Faultkonfiguration blieben unverändert. -Windows bleibt 0/0/0/0, Linux bleibt 30/30/26/0. Der geschützte -`devstate/windows-client/auto-default/422562e8-18eb-4865-977d-ab2af65f510b/result.json` -ist verifiziert und wird vom -separaten aktuellen Transportbeleg per Hash gebunden. Die Installerquelle hat -nun ebenfalls Default `auto`; daraus folgt kein neuer Fresh-Install-, MSVC- -oder Signiernachweis. - -Native TLS-Negativproben sind separat als Bootstrapadministrator bestanden: -falsche CA und falscher Name liefern konkrete Rustls-Zertifikatsfehler, -abgelaufene Clientzertifikate den Serveralert `CertificateExpired`; gültige, -unregistrierte Kontrollen davor/danach passieren TLS und erhalten HTTP401. -Private Fixturekeys entstanden auf der VM und wurden nicht exportiert. -Permanente Identität und Dienst blieben unverändert. Dies qualifiziert keinen -LocalService-Negativlauf und noch keine Rotation oder Widerrufsbehandlung. -Der erste Fehlerklassifikationslauf bleibt fehlgeschlagen erhalten; der -gezielte Retest verwendete dieselben öffentlichen Zertifikate und denselben -VM-Schlüssel mit korrigierter typisierter Fehlerkette. Timeoutbelege bleiben -separat erhalten und gelten nicht als Zertifikatsablehnung. -Geschützter Fall: `devstate/windows-client/tls-negative/7b190a5c-c928-4348-bd0d-c9698dad5417/`. - -Nächste Grenze ist weiterhin **vor jedem Windowsjob**: qualifizierte -vertrauenswürdige Uhr, gemeinsamer signierter Sync-/Checkpoint-/Grantverbrauch, -erhaltende Jobjournalmigration und plattformgebundene Interpreterverträge in -Domain, Server und WebUI. Keine Ausführungscapability aus Transporterfolg -ableiten, kein erstmaliges PowerShell-Hello als Bootstrap ausführen. Exakte -Voraussetzungen und offene Nachweise: [Windows-Gates](windows-gates.md), -[Jobgrenze](windows-job-boundary.md), [Clientvertrag](../deploy/windows/CLIENT.md). -Windows-Reboot, Rotation/Widerruf der permanenten Identität, SYSTEM-Helper und -Installationsaktionen haben hier keine Freigabe. - -## Historische Entwicklungsstände bis zum Abschluss - - -**Aktuellster nativer Stand:** Agent702bd7b5 korrigiert wiederholten Nichtstart- -Sync nach abgelaufenem grantlosen Auftrag. Erhaltend installiert; normaler -Generation93-Sync ready/restore_blockedfalse, gleicher Ablaufjob korrekt -expired/DEFINITIVE_NONSTART, kein Grant/Unlock. Zentrale26/26/23/0, Root15closed. -Keine Server-/Helper-/Provideränderung, M4Runtime3bac bleibt gültig. Aktiver -Offline-Warte- und Ablauffall sowie MCP-Vorbericht bestanden; Generalautostart -nachgewiesen aktiviert, öffentlicher Pinbootstrapfinalisiert. Noch UI-Entzug, -Crash und letzter einzelner Reboot plus Endaudit. Ältere Sperrstände historisch. - -**Neuester abgeschlossener Stand:** M4-APT im begrenzten Fixtureumfang bestanden: -echtes1.0→1.1-Upgrade plus eigene ensure_package-/apply_updates-Noops, feste -WebUI-Grenze jeweils0/0/0→1/1/1/0. Tatsächliche Paketnachbedingungen, true→true -Hostflag/kein neuer Rebootbedarf, keine zusätzliche Noop-Pakettransaktion. -AltefailedVersuche unverändert. Runtimef40c/bbd2/1dc/3bac bleibt qualifiziert. -APT-Policygeschlossen/Endpunktentfernt/Helperinactive; Agent/Generalaktiv. -Server73aab983 enthält konservative Rebootfrist, nativdeployt/Historieerhalten. -Nächste Arbeit: Offline3, Crash, MCP-Endbericht, einzelner Reboot zuletzt, -danach Endaudit. Nicht vollständig MVP-abgenommen. - -**Neuester tatsächlicher Stand2026-11-13:** Configure337 jetzt durch gebundenen -Readonly-Nachweis und normalen signierten RootSync geschlossen: failed -`APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED`, vollständige Wirkung, -keine nachträgliche erfolgreiche Acceptance. Hostflagtrue/historischvorhernull. -Root11/0offen/0Faults, zentral20/20/18/0. Native erhaltende Runtimef40c/bbd2/1dc -und copied-Sandboxprobe bestanden; APTinactive/Endpunktentfernt/Policygeschlossen. -SSH40s-Timeout verlor nur Antwort, unabhängiger erhaltener Endbericht und -Dateihashes bestätigten abgeschlossene Installation; keine Wiederholung. -Nächster Schritt eigener UI-Upgradeplan1.0→1.1, danach Noops und übrige Gates. -Details oben in implementation-status.md; ältere Unknownzustände unten historisch. - -**Aktuelle Fortsetzung2026-11-13:** Automatischer WSS→HTTPS-Fallback auf der -permanenten Cloud-VM bestanden; Hook wieder deaktiviert, WSS operativ -wiederhergestellt, keine neuen Jobs. Danach eigener Configureplan tatsächlich -einmal ausgeführt, APT0/dpkg installed1.0, aber Abnahme wegen globalem -Neustartmarker verweigert: Grant33775478-15b0-46ec-b059-44f500dbb0b6 unknown, -Rootverbrauch11. Fehlender Host-Vorherwert bleibt fehlend; keine rückwirkende -Acceptance. Rootpolicy deny-only geschlossen, kein Retry/Markerreset/Reboot. -Gebundener Readonly-Abgleich wird implementiert. Spec1.13 präzisiert getrennte -Host-/Sandboxbeobachtung und konservative zentrale Rebootfrist. Tatsächlicher -MCP-Lesebericht eines bestehenden Dienstplans bestanden, Idempotenz noch nicht -angehängt. Offline/Crash/APT1.1/Noops/finaler Reboot und Endaudit weiter offen. -Ältere Zustände unten bleiben historische Snapshots. - -**Neuester aktiver Stand2026-11-13:** Scope-Replayfix und TLS-Lifecycle einschließlich -nativ abgelaufener Clientcerts bestanden. UI-Schema4 geprüft/publiziert; -Configure-only-Plan tatsächlich genehmigt, aber ohneOffer/Grant expired an -64MiB-Helperjournalgrenze. Isoliert SQLFull reproduziert, bounded256MiB-Default -auf Cloud-VM mit allen Historien/Identitäten/DBinodes erhalten installiert. -Agent2ce885cf/Helper332eae00/Provider5ff260f7, normaler signierterSync bereit, -Root10/0offen/0faults, Zentrale19/19/17/0, Rootpolicygeschlossen/APTinactive. -Neuer eigener UI-Configureplan im Namensraum `capacity-recovery` erforderlich; -Paketwirkung noch NICHT ausgeführt. Details oben in implementation-status.md; -MVP weiterhin offen, kein Produktionsfreigabenachweis. Ältere Zwischenstände -bleiben historisch und werden nicht als aktuelle Runtimepins verwendet. - -**Neuester Stand 2026-11-13, Arbeit ausdrücklich fortgesetzt:** Signierte -Kontrollkettenreparatur auf tatsächlicher Cloud-VM bestanden. Anschließender -Readonly-APT-Nachweis plus normaler RootSync schloss ursprüngliche Teilwirkung -als `failed / APT_PARTIAL_UNCONFIGURED_VERIFIED`; Fixture1.0 nur unpacked, -Nachbedingungen false, keine Paket-Acceptance. Ledger9/0offen/faultfrei, -Zentrale13/13/12/0. Agent988c62fd/Generalhelper5ad30cdf/Provideredd1950d aktiv; -APT-Helper inactive/Endpunkt entfernt, Rootpolicy geschlossen. Identität, -Journale, Ledger und alte Marker erhalten. Neue Configure-only-UI-Wiederherstellung, -Upgrade/Noops und weitereMVP-Gates offen. Ältere Unknown-/Pauseabschnitte unten -sind historische Snapshots. Tatsächliche Details: `implementation-status.md`, -aktuelle Prioritäten: `mvp-gates.md`. - -**Aktueller Arbeitsstand 2026-11-13:** Windows-Passivstrecke auf tatsächlichem -Gast bestanden: LocalService, Enrollment/mTLS/WSS, gespeichertes Inventar, -zwei Heartbeats, Tenant-B-Verweigerung und sieben native Tests. Native SQLite- -Probe Integrität ok, gleiche Identität, 0 ausstehende Inventarereignisse. Migration -0013 nativ auf endgültigem Server angewendet, RLS/FKs/alte Beobachtungen erhalten. -Windows ohne Jobexecutor, unsignierter Entwicklungsbuild, übrige Grenzen in -`deploy/windows/CLIENT.md` und `docs/platform-support.md`. - -APT bleibt **unknown**: gespeicherter Lauf Hook armed/APT 0, Fixture1.0 nur -unpacked, kein Configure/Acceptance. Ledger 9 / 1 unresolved, Zentrale 13/13/12/1, -Originalmarker/History + eigener Retrymarker erhalten. Rootpolicy geschlossen, -keine weiteren Paketjobs/Reparaturen/Resets. Configure-Korrektur ausschließlich -lokal nachgewiesen (67 Python-Tests, echtes APT2.6.2 mit simulierendem dpkg), -**nicht auf Cloud installiert**. Cloudprovider weiterhin 465ac5ed…, neue Source -3977c2c0…; Pins nicht vermischen. Signierter prüfender Abgleich und begrenzter -neuer UI-Wiederherstellungsplan erforderlich. Servermigration bewahrte die -exakten Unknown-Nachweise/Zähler vor/nach Neustart. Details oben in -`implementation-status.md`. Nachweise/Quellen nach jedem Schritt gepusht; -private Daten gitignoriert. Ältere Abschnitte sind historische Snapshots. - -**Aktueller Folgestand 2026-11-13:** APT-100-Ursache durch separat WebUI-genehmigte -Cloud-Diagnosen belegt: `--no-download` lieferte im echten v3-Hook `**ERROR**` -statt Archivpfad. Lokale Dateiacquisition korrigiert; wirkliche IPv4-/IPv6-Sperre -zusätzlich geprüft. Neuer Provider/Helper auf Cloud-VM installiert, echter -Readiness-Probe bestanden. Acht bekannte Rootversuche, keine offene Wirkung, -ursprünglicher Fehlversuchsmarker/`active/` erhalten, kein Paketretry. Root- -Diagnosepolicy geschlossen, APT-Helper gestoppt, Linux-Agent online/sync-ready. -Paketabnahme benötigt weiterhin sichere Behandlung des gespeicherten Fehlversuchs. - -Windows auf Userwunsch jetzt parallel erlaubt (Spezifikation 1.8). SSH-Zugang -zur Windows-11-Pro-VM (Build 26300, x64) mit echtem Administratortoken nativ -bestätigt. SYSTEM-Tunnel-Task/sshd Running, Windows-SSH nur Loopback; Cloud- -Reverse-Port nicht extern erreichbar. Kein RMM-Windows-Client/Notebook-Agent. -Bootstrap/Repair öffentlich gültiges HTTPS8443, befristet bis 2026-11-14 -12:55:31 UTC, automatisches Schließen des Downloadports vorbereitet/geprüft. -Nach jedem Abnahmeschritt Quellen/Dokumentation nach Gitea gepusht; private -Daten weiterhin ignoriert. Details: [implementation-status.md](implementation-status.md) -und [Windowszugang](../deploy/windows/README.md). Die folgenden Pausentexte und -älteren Zwischenstände sind historisch, keine aktuelle Entwicklungsstopanweisung. - -**Historische Übergabe. Wiederaufnahme am 2026-11-13 ausdrücklich beauftragt.** -Die lokale Servertopologie wurde inzwischen durch den dedizierten Internetserver -ersetzt; aktueller Zustand und Zugänge: [server-deployment.md](server-deployment.md). -Der unten genannte Skript-/SHA-Konflikt ist korrigiert. Alte Nachweise bleiben -historisch; neue getrennte Testidentitäten sind keine Wiederherstellung der alten -Serverhistorie. Aktueller Prüfstand: [implementation-status.md](implementation-status.md). - -**Neuester Cloud-Stand 2026-11-13:** Root-Testdienst eingerichtet/gestartet/gestoppt, -jeweils tatsächlich separat WebUI-genehmigt und auf VM bestanden. Erste APT- -Acceptance `failed / HOOK_NOT_HANDED_OFF`, APT 100 vor Hookübergabe, Paketbestand -unverändert. Kein Wiederholungsversuch; Create-once-Marker und Ledger erhalten. -Root-Testpolicy geschlossen, APT-Helper gestoppt/deaktiviert; Cloud-Agent aktiv, -Notebook ohne Client. Cloud-Controlpfad-Maskierungsfix nur im Quellcode/lokal -geprüft, neue VM-Readiness und sichere Weiterführung des gespeicherten Fehlversuchs -offen. Details und Belege in [server-deployment.md](server-deployment.md#root--apt-abnahmelauf-2026-11-13). - -**Auf Userwunsch pausiert. Linux-MVP M0–M5 ausdrücklich NICHT vollständig -abgenommen; keine Produktionsfreigabe.** Dieser Durchgang sichert Dokumentation -und prüft veröffentlichbare Quellen. Keine Entwicklung, Builds, Tests, -Deployments oder RMM-Jobs fortsetzen. Commit/Push ist ein separater Schritt des -Orchestrators nach Sicherheitsprüfung; hier weder Staging noch Commit/Push. - -## Einstieg und verbindliche Grenzen - -- Repository: ; - SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git`. - Remote vor Veröffentlichung erneut prüfen; keine erfolgreiche CI behaupten. -- Zuerst vollständige Spezifikation 1.5, `AGENTS.md`, - `docs/project-decisions.md` und `docs/development.md` lesen. Windows erst nach - Linux-MVP-Abnahme; PVE/PBS/Cluster/Backups nachgelagert. **RustDesk AUS**, - keine Installation/Provisionierung/Desktopabnahme oder eigene Desktop-Engine. -- Jeder Job beginnt als persistenter Antrag `pending_approval`. Vor Genehmigung - **0 Jobs/Outbox/Startgrants**, keine JobOffers/Wirkung. Nur interaktive WebUI - genehmigt den unveränderlichen Plan; MCP/KI dürfen nicht selbst genehmigen, - keine direkte API-/DB-Freigabe. Policies begrenzen/verweigern nur. -- Dev/test-Browserbedienung ausschließlich sichtbar **SIMULIERT**, Audit mit - `approval_origin=dev_test_browser_simulation`, `testsimulation=true`, - Testprincipal und Planbezug. Kein menschlicher Produktionsfreigabenachweis. - Neue Versuche/neue Wirkung brauchen neuen genehmigten Plan; unklare Wirkung - bleibt `unknown`, nicht blind wiederholen. - -## Plattform und sicherer finaler Pausenzustand - -Server lokal in Docker auf dem PC, TLS nur `127.0.0.1:18443`, PostgreSQL intern -ohne publizierten Port. PC-initiiertes SSH im Devmodus: `-N -T`, strikte -Hostkeyprüfung, `ExitOnForwardFailure=yes`, Keepalive 30/3 und -`-R 127.0.0.1:18443:127.0.0.1:18443`. VM-Agent ausgehend über Loopback; -TLS Ende-zu-Ende mit vertrauenswürdiger Dev-CA und SAN/SNI `rmm-dev.internal`. -Connect-Override darf nur TCP ändern, niemals Namens-/Zertifikatsprüfung. -Netzwerkagent unprivilegiert als `rmm-agent` (UID 993, Gruppe 984), Roothelper -separat; kein Root-Netzwerkagent. - -**Finales VM-Worker-Verdikt, in `docs/implementation-status.md` protokolliert:** - -- Agent und beide Helper (`rmm-agent.service`, `rmm-helper-dev-test.service`, - `rmm-apt-helper.service`) **inactive**; kein Reversetunnel/VM-18443-Listener. -- Rootledger **0 consumed / 0 unknown**, kein laufender Installer-/Paket-/Rebootjob. - Einziger VM-Joberfolg bleibt der frühere Hello-World-Lauf; keine neuen Jobs, - Anträge oder Genehmigungen im letzten Upgrade-/Pauselauf. -- Lokaler Docker-Server und PostgreSQL laufen bewusst weiter, Portbindung wie - oben. Kein pauschales „alles gestoppt“. Letzter zuvor gemeldeter Serverstart - 20:49:18 UTC ist kein hier erneut erhobener Startzeitnachweis. -- Aktuelle Bookworm-Releaseartefakte für Agent/Helper gebaut und konkrete - VM-Loaderprüfung bestanden (glibc 2.34/OpenSSL 3). Runtimeupgrade bewahrte - Identität und Journal-Dateibytes/SQLite-Schema/Rows. Alte Artefakte/Backups bleiben. -- Bekannte Fixturearchive administrativ versiegelt, **keine Paketinstallation**. - Tatsächliche dedizierte APT-Probe **FEHLGESCHLAGEN**: - `APT_CONTROLLER_PROFILE_REQUIRED`, Start-Exit 1. Keine Native-Readiness, - Native-Acceptance oder Paketwirkung; Helper danach kontrolliert gestoppt. - Unit-Härtung wurde nicht zur Umgehung gelockert. - -## Funktionen und Nachweise — Ebenen nicht vermischen - -| Bereich | Lokal / Entwickler-PC | Tatsächliche Linux-VM | -|---|---|---| -| TLS/Enrollment/Inventar | Lokale Integrationsnachweise vorhanden | Passives Inventar und Heartbeats früher belegt | -| MCP → UI → Grant → Agent | Gemeinsame Plan-/Antragsstrecke implementiert | Früherer Hello World unter unprivilegiertem systemd-Agent: genau 1 Grant, 1 Wirkung; Journal/Ergebnis belegt | -| Roothelper | Neue Root-/APT-/Sync-Schnittstellen implementiert | Readiness des **alten** Profils belegt; neues Runtime installiert, APT-Probe fehlgeschlagen, keine vollständige Rootaktionsabnahme | -| Paket/Update/Dienst/Reboot | Adapter und Sicherheitsprüfungen vorhanden | Aktuelle UI-genehmigte native Wirkungskette weiterhin offen | -| OIDC/WebUI | OIDC-Adapter implementiert, externe IdP-Konfiguration `not_configured`; Dev-UI-Testactor simuliert | Kein produktiver IdP-/MVP-Abnahmenachweis | -| Replay/ACK-Verlust | Lokale Regressionspfade vorhanden | Native Fault-Injection für duplicate_offer/lost_result_ack **unsupported**, nicht grün | - -Letzte getrennte, von den jeweiligen Sourceownern dokumentierte Prüfstände, -**in dieser Übergabe nicht erneut ausgeführt und nicht zu einer Summe addieren**: - -- Client: **115 Rust-Alltargets-, 56 Python-APT-, 2 Installer-Guardtests**; - Clippy/Format, Debug/Release grün (`deploy/linux/runtime-README.md`). Dies ist - der letzte vollständig validierte Client-Quellstand, nicht „alles aktuell grün“. - PC-Artefakte sind nicht mit dem separaten Bookworm-/VM-Loaderbeleg gleichzusetzen. -- UI: zuletzt **23 Unit- und 5 TLS-Browsertests** gemeldet; OIDC **13 + 1 PG** - sowie **35 integrierte Assertions**. Backend **150 Assertions**, Transport - **38**, Rootlog **15** als bestehende getrennte Snapshotnachweise. Verträge und - Prüfkontext: `web/README.md`, `crates/server/OIDC.md`, `tests/oidc/README.md`, - `proto/BACKEND_CONTRACT.md`. Keine neue Ausführung/CI-Verifikation in der Pause. -- Backend zuletzt mit Rootlogs-Image/Migrationen 1–12 gemeldet; Runtime-/VM-Probe - ist ein separater Nachweis und macht offene Funktionstests nicht erfolgreich. - -## Bekannter ungeprüfter Snapshotfehler — NICHT jetzt korrigieren - -Die letzte Änderung der `SERVICE_SETUP`-Skriptbytes in -`deploy/vm_mvp_adapters.py` für den vorerzeugten leeren Unit-Inode wurde **nicht -erneut getestet**. Alte SHA-Pins stehen noch in -`tests/browser/mvp-actions.spec.ts` (service_setup-Prüfung) und -`tests/vm_mvp_guards.py` (Setup-Hashassertion). Bei Wiederaufnahme zuerst Bytes, -Browser-Pin und Guard-Pin konsistent anpassen und gezielt prüfen. Frühere -**28 Guards** sind **kein finaler Nachweis** dieser Änderung. Absichtlich keine -Reparatur im angeforderten Pause-/Snapshotdurchgang. - -## Wiederaufnahme — erst nach neuem Auftrag, nichts davon hier ausgeführt - -1. Erhaltenen Zustand und feste Geräte-/Job-/Versuchsbindung kontrollieren. - Den tatsächlichen Controllerprofilfehler gegen `verify_controller_profile()` - **zuerst diagnostizieren**, vor weiteren Mutationen/Proben. Keine Härtung, - Capability-, Peer-, Pin-, Sync- oder Genehmigungsgrenze blind abschwächen. - Den oben dokumentierten Skript-/SHA-Konflikt vor Suiteausführung beheben. -2. Bookworm-Artefakt/Deploymentmanifest, tatsächliche Unit-/Public-Pins, - getrennte Helperledger und dedizierte RPC-/APT-Readiness prüfen. Build und - Loadercheck liegen vor, Native-APT-Probe dagegen nicht bestanden. -3. Frischen Peer-/Sync-/passiven Planungsnachweis und aktuelle Baseline erheben; - anschließend einzeln UI-genehmigte Rootdienst-/Paket-/Updatefälle. Fixture - nach Upgrade auf **1.1**, fresh baseline und gewünschte Noop-Nachbedingungen - konsistent halten; keine heimliche Entfernung/Downgrade/Reset von Paketstate. -4. HTTPS-Transport, Rotation, Reconnect, Ablauf/Cancel, Reboot zuletzt mit eigener - Recovery und neuer Boot-ID sowie tatsächliche Wirkung/Nachprüfung abnehmen. - Duplicate-/lost-ACK-Nativefaultadapter fehlen weiterhin; nicht durch zweiten - Job als vermeintliche Redelivery ersetzen. Vor jedem Job erneut 0/0/0-Gate. -5. Linux-MVP erst nach vollständigen realen Feature-/Fehlernachweisen abnehmen. - Bestehende Identität/Journale/Backups niemals löschen oder neu enrollen, um - Tests grün zu machen. Create-only Bootstrapphasen nicht blind wiederholen. - -## Quellnavigation, Befehle und geschützte Evidenz - -- Agentbetrieb/Config: `deploy/linux/runtime-README.md`, `deploy/linux/README.md`; - APT: `deploy/linux/apt-helper-README.md`, - `tools/apt-transaction/HELPER-CONTRACT.md`; Backend/Rootlogpolicy: - `proto/BACKEND_CONTRACT.md` (`RMM_ROOT_LOG_UNITS` und zugehörige Grenzen, - Rootlogs standardmäßig verweigert); Login: `crates/server/OIDC.md`. -- Bestehende Kernbefehle in `README.md`: `python3 deploy/dev.py init|up|status`, - CA-verifizierter `/healthz`-Check und `python3 deploy/dev.py down` ohne - Datenlöschung. **Hier nur nachgelesen, nicht ausgeführt.** `init` überschreibt - keinen vorhandenen Zustand; `up` baut/startet und ist keine Pauseaktion. - Die älteren Funktionsaussagen in README/unteren Statusabschnitten sind - historische Slices; aktueller finaler Pauseabschnitt hat für diesen Snapshot Vorrang. -- Geschützt/gitignored: `devstate/vm-jobs/result.json` (Hello World), - `devstate/vm-root/` (historische Rootreadiness), - `devstate/vm-final/68741ab0b1c84e15bf3fc442bd812558/` - (`build.json`, `install.json`, `probe-diagnostic.json`; kein erfolgreicher probe.json). - VM-seitig: `/var/lib/rmm-bootstrap-history/68741ab0b1c84e15bf3fc442bd812558/` - und `/etc/rmm/runtime-v2-probe-report.json`. Nur Pfade, keine privaten Inhalte. -- Zugangsdaten/Rohlogs/Schlüssel bleiben unter `credentials/`, `.env`, - `secrets/`, `devstate/` bzw. geschütztem VM-State. Nie in Git/Chat/Jobausgaben; - 0700-Verzeichnisse/0600-Secretdateien, Daten strikt parsen, kein source/eval. - Keine VM-Adressen, Passwörter, privaten Agentkeys oder Tokens veröffentlichen. -- Vor Staging ausschließlich nichtignorierte Quellpfade aus - `git ls-files --cached --others --exclude-standard` prüfen; echte PEM-Blöcke, - Credentialliterale, private Laufzeitdateien/Adressen und Browsertraces melden - **nur als Anzahl, Pfad, Regel**, niemals Matchzeilen. Build-/Browsercaches nicht - veröffentlichen. `.env.example` mit Platzhaltern und generierte Testfixtures - sind nicht automatisch echte Zugangsdaten. Keine Userdateien verschieben/löschen. - -### Sicherheitsprüfung dieses Übergabedurchgangs - -Nichtignorierte Sourcepfade: **194**, alle 194 auf echte vollständige private -PEM-Blöcke, auffällige Credentialliterale/Providertokens, nichtbeispielhafte -IPv4-Adressen und private Laufzeit-/Binärdateinamen geprüft. **Keine bestätigten -Leakfindings.** Ein Literal-Kandidat in `crates/oidc-auth/src/tests.rs` wurde als -ungenutzter synthetischer Access-Token der lokalen Mock-Providerantwort geprüft -und verworfen; Schlüssel der Tests werden zur Laufzeit generiert. Keine -Credentialdateien für diese Prüfung gelesen, kein Secretvergleich erforderlich. -Das ist eine heuristische Sourceprüfung, keine Garantie über unbekannte Secrets. - -Ignore-Ausschluss ausdrücklich bestätigt für `crates/oidc-auth/target/`, -`devstate/`, `credentials/linux-vm.conf`, `web/node_modules/`, lokale -Testresults/Playwrightreports. Root-Ignore ergänzt um verschachtelte `target/` -und präzise private Browsertrace-/Reportpfade. Keine Source-/Testverzeichnisse -pauschal ausgeschlossen. Vor tatsächlichem Staging erneut prüfen, da parallele -Änderungen diesen Snapshot verändern können. diff --git a/docs/handover.md b/docs/handover.md index 3812410..4371963 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -1,37 +1,23 @@ -# Übergabe am 17. November 2026 +# Übergabe an die nächste Entwicklungssitzung -**Der nächste Auftrag steht im [Umsetzungsplan](mvp-completion-plan.md).** Er enthält den letzten Betriebsbefund je Nutzeranforderung und die Reihenfolge für die nächste Lieferung. [Entwicklungsbefehle](development.md) und [Zugänge](operations-access.md) beschreiben den Arbeitsweg. +`main` enthält den abgenommenen Stand. Zum Einstieg den [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) lesen und die vom neuen Auftrag betroffene Funktion in der [Abnahme](mvp-completion-plan.md) nachschlagen. Die JSON-Dateien in `docs/evidence/` sind datierte Beobachtungen. -**Lieferstand am 18. November 2026 nach der Skriptumstellung.** Server und WebUI laufen auf Revision `5889964`, Schema 39. Linux `0.1.0-mvp.6` und Windows GNU `0.1.15` stehen in beiden Entwicklungskunden und als Starter für neue Kunden bereit. Neue Geräteaktionen aus WebUI und MCP sind Skripte. In der öffentlichen Geräteansicht werden Dienstkonto und tatsächlich gemeldeter Administrator-Kontext angezeigt. Die Installation eines dauerhaften Helpers erfolgt einmalig durch einen Administrator. Die öffentliche Anmeldung verwendet Passwort und TOTP, MCP kunden- und rechtegebundene Bearer-Tokens. [Zugang](public-access.md) +## Wo eine Änderung beginnt -**Abnahme.** Beide VMs haben über einen genehmigten Bibliotheksauftrag einmal tatsächlich neu gebootet. Beide meldeten sich mit derselben Kopplung und neuer Boot-ID zurück und lieferten je einen Folgeauftrag mit Exitcode 0. Dienstkonto sowie Root bzw. SYSTEM sind über getrennte Skriptergebnisse belegt. Die Windows-Vorlage V2 prüft den tatsächlichen Exitcode des Betriebssystems. Ab `0.1.15` stellt der Client die für `shutdown.exe` erforderliche Variable `COMPUTERNAME` bereit. Die beiden Windows-Vorversuche, die keinen Neustart bewirkten, stehen ebenfalls im Nachweis. [VM- und WebUI-Abnahme](evidence/script-channel-vm-acceptance-20261118.json) +| Thema | Einstieg in die Implementierung | +| --- | --- | +| Gerätebestand und Kunden | [Geräteabfrage und Lebenszyklus](../crates/server/src/device_list.sql), [Kundenrechte](../crates/server/src/customers.rs), [Geräteansicht](../web/src/devices.tsx) | +| Bibliothek und Auftragsplanung | [Skriptversionen](../crates/server/src/script_library.rs), [Planung und Auswertung](../crates/server/src/jobs.rs), [Auftragsassistent](../web/src/order-composer.tsx) | +| Genehmigung und Zustellung | [Genehmigungseingang](../crates/server/src/approvals.rs), [Entscheidung und Freigabe](../crates/server/src/jobs.rs), [Gerätegateway](../crates/server/src/job_gateway.rs), [Abgleich im Agenten](../crates/agent-core/src/reconcile.rs) | +| MCP und Administrator-Skripte | [Werkzeuge](../crates/server/src/mcp.rs), [Tokenrechte](../crates/server/src/mcp_tokens.rs), [Helper und zentrale Geräteregel](../crates/server/src/managed_scripts.rs) | +| Geräteaufnahme und Releasewechsel | [HTTPS-Installer und Lebenszyklus](../crates/server/src/bootstrap), [Releasekatalog](../crates/server/src/agent_updates.rs), [Signaturprüfung](../crates/updater/src/manifest.rs) | +| Native Laufzeiten | [Linux-Agent](../crates/agent/src/main.rs), [Linux-Inventar und Skripte](../crates/agent-linux/src), [Windows-Agent](../crates/agent-windows/src/runtime.rs), [Agentprotokoll](../proto/BACKEND_CONTRACT.md) | -Vor der Neuaufnahme mit dem offiziellen GNU-Kanal lief die Windows-Test-VM mit `0.1.9`. Nach dem Geräteabgleich und dem Neustart des Gateways lieferte der einmal genehmigte PowerShell-Auftrag „Geräteabgleich geprüft“ mit Exitcode 0. Auf Linux lief unter `0.1.0-mvp.4` auch die Bibliotheksrevision „Linux-Kernelversion“ erfolgreich. Beide Ergebnisse wurden zum Zeitpunkt dieser Abnahme in der öffentlichen WebUI geprüft. Die Rechtekorrekturen und SQLite 3.54.1 sind bereitgestellt. Der aktuelle Windows-Kanal ist GNU. Development A, Development B und der Starter für neue Kunden führen `0.1.11`. Der HTTPS-Installer wählt GNU. Die neu aufgenommene Test-VM wechselte selbstständig von `0.1.10` auf `0.1.11`. [Veröffentlichung](evidence/windows-gnu-official-release-20261118.json) [Abnahme und laufende Komponenten](evidence/windows-release-blockers-20261118.json) +## Einen vorhandenen Auftrag nachvollziehen -**Native Abnahme und Bereinigung.** Der neue Agent meldete nach dem Selbstupdate auf `0.1.11` denselben Kopplungsbezug. Der im Entwicklungsprofil interaktiv genehmigte [PowerShell-Auftrag](https://discovery.ease-technologies.de:8443/#auftraege/ansehen/11111111-1111-4111-8111-111111111111/c40aa3cc-47bf-45b7-87a6-9772b77473f2) zeigte „GNU-Selbstupdate geprüft“ und Exitcode 0 in der öffentlichen WebUI. Dieselbe Oberfläche widerrief und löschte die frühere Kopplung. Der Direktabruf der alten Installation ergab HTTP 404. Die neue Installation war weiterhin online. Die abgesprochene Sicherung liegt als geschützte WIM-Datei im Gast. [VM- und WebUI-Nachweis](evidence/windows-gnu-official-vm-20261118.json) +1. Kunde und Installation identifizieren. Die `asset_id` bezeichnet das Gerät und die `agent_id` die konkrete Kopplung. Nach Neuaufnahme kann derselbe Hostname eine andere Installation bezeichnen. +2. Die `plan_id` öffnet die feste Vorschau zur Entscheidung. Unter der `operation_id` steht der eingereichte Auftrag samt Genehmigungsstatus. Bei `pending_approval` sind null ausführbare Jobs zu erwarten. +3. Nach der Genehmigung mit `jobs.get` und der `job_id` den Zustand, die Ausgabe und den Exitcode des einzelnen Ziels lesen. Die `attempt_id` verbindet das Ergebnis mit dem ursprünglichen Versuch. Für einen bereits laufenden oder ungeklärten Versuch dieselbe Kennung weiterverfolgen. +4. Bei plattformspezifischen Fragen die jeweilige Betriebsanleitung nutzen. Sie benennt Dienste, Helper und Anzeichen einer erfolgreichen Wiederanmeldung. [Linux](../deploy/linux/README.md) · [Windows](../deploy/windows/README.md) -Die Skriptbibliothek lässt sich nach Name und Plattform filtern. Die Kopfzeile zeigt den Kunden auch beim Seitenwechsel und übernimmt in einer Detailansicht den zugehörigen Kunden. Gerätebestand und Genehmigungseingang kennzeichnen ihre eigenen kundenübergreifenden Filter. Die öffentliche Sichtprüfung um 09:28 Uhr MEZ umfasste Development A und B sowie Desktop und Mobil. [Nachweis](evidence/webui-script-catalog-context-20261118.json) - -Aufträge lassen sich über den gesamten Kundenbestand nach Name oder Anlass, Gerät, Status und Erstellungszeitraum filtern. Ein Ergebnislink im Gerätedetail öffnet den zugehörigen Job direkt im Auftrag. Der Genehmigungsverlauf zeigt Person und Zeitpunkt aus der aufgezeichneten Entscheidung. Die öffentliche Abnahme fand einen Treffer von einer späteren Seite, vier Treffer bei kombiniertem Filter und dieselbe Entscheidung in Liste und Detail. [Nachweis](evidence/webui-order-history-20261118.json) - -Skripte werden in der Bibliothek veröffentlicht. Aufträge binden die gewählte Version oder ein einmaliges Skript an konkrete Geräte. Genehmigungen bündelt offene Anträge aus WebUI und MCP. Der native Linux-Versuch und zwei Ablehnungen sind samt Audit und öffentlicher Sichtprüfung im [Abnahmeprotokoll](evidence/webui-auftragsablauf-20261117.json) dokumentiert. - -Die öffentliche WebUI zeigt die gespeicherte Ausgabe bei einem einzelnen Gerät direkt im Auftrag. Um 23:22 MEZ zeigte der vorhandene Lauf „Linux-Kernelversion“, Version 2, in Desktop- und Mobilbreite das Skript `uname -s`, die Ausgabe `Linux` und Exitcode `0`. Im Chromium-Test sind unterschiedliche Skriptvarianten pro Gerät, die Sperre bei einer fremden Planbindung und das Öffnen der Ergebnisse je Gerät geprüft. - -Die erste Lieferung aus dem WebUI-Review ist öffentlich bereitgestellt. Der Ausführungsstatus wurde für Development A und B getrennt über HTTPS gelesen. Der Assistent meldete auf beiden Testgeräten die fehlende Neustartfähigkeit. Das historische Windows-Gerät blieb lesbar, die Entwicklungsformulare waren mit der öffentlichen Anmeldung ausgeblendet. Agent-Releases haben eine Tabelle, die Installationsschritte stehen vor der Codeausgabe und widerrufene MCP-Tokens erscheinen im Verlauf. [Nachweis](evidence/webui-review-20261117.json) - -Der Bestand enthält die Linux- und die Windows-Test-VM für Development A. Fünf frühere Installationen liegen in der Historie. Im Kundenverzeichnis kann der Betreiber Kunden anlegen und umbenennen. MCP-Tokens haben eine feste Kundenauswahl oder ausdrücklich alle aktuellen und künftigen Kunden. Einzel-, Mehrkunden- und globaler Zugriff sowie Widerruf sind am öffentlichen Server geprüft. Die Aufnahme für Development B lieferte beide signierten Pakete und die passenden Updater. [Abnahme mit nativen Hardwaredaten](evidence/customer-fleet-20261117.json) - -Der Windows-Testgast betreibt den signierten Release `0.1.6` mit CPU-Modell im Inventar. Mit der vorherigen Version `0.1.5` wurde die Wiederherstellung der Zeitfreigabe geprüft. Nach Uhrkorrektur und Gatewaywechsel erlangte derselbe Agentprozess seine Zeitfreigabe mit einem neuen signierten Abgleich zurück. Die feste Bootkennung stammt aus dem Kernel-Startprotokoll. [Nativer Nachweis](evidence/windows-gateway-clock-recovery-20261117.json) - -Die CP850-Darstellung des gespeicherten PowerShell-Ergebnisses wurde in der privaten und öffentlichen WebUI geprüft, einschließlich Umschaltung, Polling und bytegleichem Download. [Umlautnachweis](evidence/powershell-output-encoding-20261117.json) - -Die beiden zuletzt offenen Punkte sind erledigt. Die Windows-Test-VM hat KB890830 v5.147 über die gespeicherte Updatevorlage installiert. Ein vorbestehender Neustartbedarf wurde vorher durch einen autorisierten administrativen SSH-Neustart behoben. Der ursprüngliche Installationsversuch wurde genau einmal ausgeführt und nach signiertem Abgleich als erfolgreich bestätigt. Windows-Ereignis 19 und beide nativen Journale bestätigen die Installation. Ein weiterer Neustart war nicht erforderlich. Agent und Updater laufen nach geschlossenem Wartungsfenster wieder, Sync ist bereit und SYSTEM-Rechte sind entzogen. [Installation](evidence/windows-update-installation-20261117.json) - -Der frühe Abbruch wurde mit einem tatsächlich beendeten Controller und unabhängigem Wiederanlauf geprüft. Auch ein leerer Helperkopf ohne jemals angewendete Entscheidung wird nun gebunden archiviert und zurückgebaut. Die Windows-Zeitsynchronisation ist aktiviert. [Wiederanlauf](evidence/windows-update-early-abort-20261117.json) - -Die ausdrücklich zur Löschung benannte Entwicklungsanfrage ist entfernt. Beide registrierten Testgeräte laufen über HTTPS-Polling. Den Bereinigungs- und Journalnachweis sowie die aktiven Buildrevisionen im [Lieferplan](mvp-completion-plan.md) verwenden. Die [frühere Bestandsaufnahme](evidence/product-audit-20261117.json) zeigt den Zustand vor der Bereinigung. - -Bei der Bestandsaufnahme auf `main` bei `a576c10` waren **22 versionierte Dateien geändert und 39 unversioniert**. Darunter sind Windows-Updater, MSVC, Reboot und Linux-Journaldiagnose. Vor jedem Bau den vorgesehenen Quellstand auswählen. Der Arbeitsbaum enthält Implementierungen und Belege, die ein Checkout dieses Commits allein nicht enthält. - -Für die ursprüngliche Chronik siehe [Archiv bis 16. November](handover-history-through-20261116.md). Die Übergabe vom Morgen und der frühere S0–S7-Plan sind im Git-Stand `a576c10` unter `docs/handover.md` und `docs/mvp-completion-plan.md` abrufbar. Die datierten [Windows-Fallnachweise](windows-system-s0-s2-results.md) dokumentieren die damaligen Eingriffe. +Builds, Veröffentlichung und die Bereitstellung auf dem dedizierten Server sind unter [Entwicklung](development.md) beschrieben. Zugang zu den beiden nativen Testgeräten und die geschützten lokalen Profile stehen unter [Betriebszugänge](operations-access.md). diff --git a/docs/implementation-status.md b/docs/implementation-status.md deleted file mode 100644 index 5b8a59f..0000000 --- a/docs/implementation-status.md +++ /dev/null @@ -1,2732 +0,0 @@ -# Tatsächlicher Implementierungsstand - -Der [Lieferplan](mvp-completion-plan.md) nennt den aktuellen Produktstand. Die [Bestandsaufnahme](evidence/product-audit-20261117.json) und die folgenden Einträge sind zeitgebundene Entwicklungsprotokolle. - -**Frühe Linux-S3-Diagnosesitzung, 17. November 2026:** Lesende Tabellenmessung plus explizite, -create-only Kopienprüfung implementiert; acht lokale Guards bestanden. Echter -`SQLITE_FULL` und gemessener Seitenbedarf ausschließlich an einer kleinen -synthetischen Kopie, vollständiger Byte-Rollback und unveränderte Quelle belegt. -SSH und Docker dieser Sitzung lokal mit `Operation not permitted` blockiert; -keine neue Cloudmessung, Runtimeänderung oder S3-Abnahme. -[Genauer Stand und Fortsetzung](linux-journal-capacity-diagnosis.md). - -**Historischer Gesamtstand vom 16. November 2026:** -Allgemeine Windows-PowerShell bestanden; SYSTEM unbekannt/gestoppt, -Linux aktuell journalblockiert, echte Agent-Selbstupdates offen. -Die folgenden datierten Einträge beschreiben einzelne historische Quellstände; -sie ersetzen weder den aktuellen Betriebsnachweis noch die Gesamt-Abnahme. - -## Agent-Update-Telemetrie: Migration0016 tatsächlich angewendet — 2026-11-15 - -Der permanente Server akzeptiert nun zusätzlich den festen passiven Scope -`agent.update`. Regulärer SQLx-Runner aus dem vorhandenen ARM64-Kandidaten6a7634, -Exit0 und separate Read-only-Nachprüfung von Version16/Checksum/VALIDATED-Check -bestanden. Ursprüngliche Zeilen, RLS/FKs/PK/ACL und Corezeugen erhalten; keine -laufenden Dienste durch diesen Schnitt ersetzt. Erste drei regulär angenommene -Updatebeobachtungen belegt. API-Basisfilterung ist getrennt. Vorherfingerprints -und ausdrücklich erst nachher angelegter privater pg_dump sind dokumentiert; -kein vorgetäuschter Vorherbackup-/Restoretest. [Beleg](agent-update-observation-scope.md). - -## Passiver Windows-Zeitabschluss vorbereitet — 2026-11-15 - -Ein kleiner rein lesender Collector für die beiden historischen Rollenbelege -aus cc82124 ist ausführbar vorbereitet. Er bindet öffentliche Dienstprozesse, -Boot, aktuelle Servergeneration, Rollen-/Hashtrennung und enge Datenalter; -keine Dienste, IPC, Zeitrequests oder Diagnoseprogramme werden ausgelöst. -Lokale Syntax-/Scopeguards und sechs Bindingfixtures bestanden. Der konkrete -lokale .NET-/Chrono-Fraktionsparserfehler ist mit exakter Nanosekundenrechnung -und +1ns-Grenzfall korrigiert. **Kein VM-Aufruf, -keine native Collector-/Rollenabnahme** vor Roots V2-Profil-/Readbacksignal. -[Umfang und genaue Grenzen](windows-passive-time-closeout.md). - -## Passiver Windows-Zertifikatspfad — Quellenstand 2026-11-15 - -Eigener RotationStore mit geschützten CreateNew-Keydateien und atomarer -öffentlicher CSR-/Zertifikats-/Versionswahl im bestehenden SQLite-Journal. -Pending wird vor dem Transport-Hello wiederaufgenommen; kein Schlüssel im -Telemetrie-WAL, kein automatisches Reenrollment oder Legacyfallback nach Wechsel. -Automatische Erneuerung ausschließlich bei `enable_jobs=false`; keine neue -Job-/Helperfähigkeit. [Vertrag und Abnahmegrenzen](windows-certificate-renewal.md). - -Lokal Linux23/23Libtests ohne Filter, GNU-Windows-Alltargetscheck mit -`system-helper`, Clippy beider Targets mit `-D warnings` und Workspacefmt -bestanden. Anschließend dieselben fünf portablen Rotationsfälle tatsächlich auf -Cloud-Linux als UID65534 bestanden (5PASS/18andere gefiltert); Ergebnisquittung -`7e6cab5915ec00a9b1392c1f15ddb13fe9ac6dd3b8e007b82e1dc914cb0507e1`. -Kein installierter Dienst oder Gerätezertifikat verändert; echte -Windows-Renewal-/LocalService-Dateiabnahme bleibt offen. - -Ein erster Windowslauf blieb bei4/5 fehlgeschlagen: Testfixture las die rohen -SQLite-Dateien vor Schließen ihres eigenen WAL-/SHM-Locks (Win32-Fehler33). -Nach ausschließlich diesem Testfix erneut tatsächlich Linux5/18gefiltert, -danach Windows11-AMD64-Entwicklungsbenutzer5/44gefiltert bestanden; jeweils -keine Skips/Fehler. Neue Quittungen `1736a19a75d49eca91062e4e7adb28732f254279b64003474efcd6201ffa08ac` -und `64e960c2eb0b755b376028d923c6fdebbc11d5f96534103452f865ccf51a4fc0`. -Nur portable Logik mit synthetischen KeyFiles, keine echte TLS-Rotation oder -LocalService-Keydateiabnahme. Originalfehler und genaue Grenzen bleiben im -verlinkten Bericht erhalten. - -Zusätzlich tatsächlich nativ Windows bestanden: eine ausdrücklich ausgewählte -Keydatei-Unit im bestehenden Lib-Testbinary (ein PASS/49andere gefiltert, -Exit0/0ignored). Geschütztes CreateNew/Flush/Reopen, öffentlicher Keyhash, -Nichtüberschreiben, breite DACL an leerer Fixture, gehaltenes Verzeichnis und -Hardlinkablehnung geprüft. Eigener Falle0590d96, Rohread-SHA -`68dd458a24c2455049b7799f57e30f1e858e323fa82c578e3b962f58282b5e49`. -Nach einem lokalen JSON-Formatfehler wurde nur das ursprüngliche beständige -Ergebnis nachgelesen, kein zweiter Start. Eigener temporärer Testkey entfernt; -keine Dienste/Accounts/Tokenübernahme oder permanente Dateien betroffen. -Produktcode unverändert; dieser Administratorlauf ersetzt keinen LocalService- -Nachweis und keine echte Renewalabnahme. Im Defaultlauf bleibt die gesonderte -Administratorfixture bewusst `ignored`. - -## Windowsfortsetzung: Nichtstart-Kern nativ qualifiziert — 2026-11-14 - -Der zusätzliche enge deny-only Nichtstart-Kern ist implementiert und mit -demselben Manifest zuerst auf Cloud-Linux80, danach Windows58 Prüfungen ohne -Skips nativ qualifiziert. Bestehende Unknowns/fehlende Starts bleiben ungeklärt; -neue Nichtstartbelege entstehen atomar und öffnen keine Starterlaubnis. -Windowsadapter weiter im unabhängigen Review, keine Installation oder -SYSTEM-Jobabnahme. [Vertrag und tatsächliche Nachweise](windows-system-abandon.md). - -Der tatsächliche Agent5140 bestand separat unter einem eigenen SYSTEM- -Diagnosedienst seine direkte produktive Prozess-/Token-/Imageprüfung. Keine -Pipe benutzt, keine DACL geändert. Die positive produktive Agent-Pipeverbindung -bleibt offen. [Abnahmegrenzen und Belege](windows-helper-peer-controls.md). - -## Windowsfortsetzung: zentrale Policy nativ geprüft, MSI gebaut — 2026-11-14 - -Spezifikation1.16 präzisiert SYSTEM als eigene Identität mit eigenem Recht, -standardmäßig verweigernder Geräte-/Helperhashpolicy und unveränderter WebUI- -Grenze. Vier neue enge Policyguards und neun bestehende Root-/Logguards lokal -und anschließend auf der tatsächlichen Cloud-Linux-VM bestanden, Fall -`13b11ce4…`, Binary `ca1df8b2…`; keine DB-/Daemon-/Jobwirkung und noch kein -Cloudserverdeployment. Unsichere beschreibbare Policyvorfahren werden ebenfalls -verweigert. Domain-/UI-/Runtime-SCM-Integration und native Windowsjobs bleiben -offen. [Details](windows-system-policy.md). - -MSI1.0.0 auf Windows nativ erstellt und unabhängig wieder gelesen; Fall -`48291dbe…`,20480Byte, `2204dc82…`, CAB-/Tabellen-/Downloadhash und lokale -Rust-Rezeptvalidierung bestanden. Zwei alte Fehlerfälle bleiben fehlgeschlagen; -ETS-Wrapper im COM-Argumentarray war die belegte Typfehlerursache. Keine -Produktinstallation/Upgrade/Noop oder Serverkatalogintegration ausgeführt. -[MSI-Bericht](windows-msi-fixture.md). - -SYSTEM-Helper `921cf182…` im Fall `59c2fd6f…` nativ installiert und einmal -gestartet (LocalSystem/Manual/PID6240, leere Aktionsliste und Effects/Reboot aus). -Tatsächlicher Agent PID5140 meldet weiterhin `HELPER_NOT_AVAILABLE`; positive -Peerprüfung fehlgeschlagen. Neue interne Negativ-/Diagnosekontrollen noch ohne -erfolgreichen nativen Lauf: Vorbereitung scheiterte im ACL-Konstruktor vor jedem -Kontrolldienststart, Fall `4a60d264…`, Belege bleiben erhalten. MSVC-Prepare -`b208282f…` stoppte bereits vor Downloads/Installation an vorhandenem CBS-/WU- -Neustartbedarf. Kein Reboot angefordert, Marker/OS unverändert. Windowsjobs, -TrustedClock und SYSTEM-Capabilities bleiben gesperrt; Windows ist nicht fertig. - -## Optionaler Windows-Helperclient nativ qualifiziert und ausgerollt — 2026-11-14 - -Neuer57-Quellen-Featurebuild und eigene native Qualifikation -`23b0e0aa-d5c5-433b-a025-53293d86c1a0` bestanden:21 Library- und6 Binarytests, -keine Skips. Danach erhaltender Dienstwechsel `cea4d30f…` auf Agent `2beed7fa…`: -tatsächlich LocalService PID5140, Auto/WSS, zwei frische Heartbeats und konkretes -Inventar-ACK. Gleiche Geräte-/Zertifikats-/Konfigurations-/ACL- und DB-Identität, -Schlüsselmetadaten erhalten. Windows0/0/0/0 und Linux30/30/26/0, Fremdtenant -verweigert. Nach einem Timeout des ersten Nur-Lese-Readbacks wurde ausschließlich -derselbe Fall gelesen; weder Installation noch Dienststart wiederholt. - -Der Client bindet einen optionalen geschützten festen Pin ohne Änderung der -sechs bisherigen Konfigurationsfelder. Probe, Snapshot und Original-Apply -verwenden getrennte Taskzustände und eine einzige begrenzte Blocking-Lane; -die Session wartet nicht auf laufende Pipearbeit. Unabhängiger Quellreview, -Default-/Feature-Clippy und sieben fokussierte Bootstrap-/Runnerguards bestanden. -Die Frist für Frame-I/O ist keine harte Frist sämtlicher synchroner Windows- -API-Aufrufe. Das neue Flag `system_helper_client_feature=true` beweist den -ausgerollten Client, noch keine Pipe-/SYSTEM-/Signed-Sync-Abnahme. - -Jobs und Uhr bleiben geschlossen; keine Execute-Route oder SYSTEM-Capability. -Native Provider für Eventlog und MSI1.0 sind separat quellimplementiert und -in eigenen Harnesses lokal geprüft, noch unverdrahtet und ohne UI-Ausführung. -Die erste echte MSI-Erzeugung scheiterte im Authoring, ohne Produktinstallation; -Fehlerursache wird unter erhaltenen Fällen eingegrenzt. Native MSVC-Tools fehlen -auf der VM; der Builder und eine ABI-/SEH-Probe sind vorbereitet, kein nativer -MSVC- oder signierter Installernachweis. Einzelheiten: -[Feature-Dienstwechsel](windows-feature-runtime-upgrade.md), -[Helperbootstrap](windows-system-helper-bootstrap.md). - -## Gemeinsamer Kern im tatsächlichen Linux-Dienstbetrieb nachgewiesen — 2026-11-14 - -Agent `c9c09de0…` und Generalhelper `51c3142a…` laufen jetzt auf der Cloud- -Linux-VM mit dem zuvor nativ qualifizierten gemeinsamen Kern. Tatsächlicher -Agent weiterhin UID993/GID984, beide Dienste aktiv, gleiche Geräteidentität, -Bootkennung, DB-Inodes, PKI und ursprüngliche18 geschlossenen Root-Verbräuche. -Die alten Binärdateien sind versioniert erhalten. Neuer normaler signierter -Sync Generation114: derselbe Entscheid in Agent/Helper/Server, ready/helper_ready, -kein Restoreblock/Fault. MCP liest das gespeicherte Gerät online; fremder Tenant -verweigert. Zentral weiterhin30 Jobs/30 Outbox/26 Grants/0 ungeklärt, Rootscope -geschlossen, keine neue Genehmigung oder RMM-Wirkung. - -Die erste Installationsprüfung `2f8de8b9…` brach vor Binärtausch an zwei gültigen -APT-Hardlink-Abnahmedateien ab. Beide alten Dienste wurden unter derselben -erhaltenen Intention einmalig wieder gestartet, ohne Dateien/Verbräuche zu -ändern. Ein eigener zweiter Fall `a2423612…` bewahrte anschließend alle Daten -vor dem Tausch und startete beide neuen Dienste; nur sein letzter Check -verwechselte primäre Benutzergruppe und festgelegte Dienstgruppe. Der originale -Fehlerbericht bleibt `completed=false`; keine Wiederholung des Installers. - -Ein separater tatsächlicher Nur-Lese-Nachbeleg bestätigt die korrekte Dienst- -identität und alle erhaltenen Originale.28 lokale Outcome-Caches erneuern im -normalen Sync ihre Entscheidungsreferenz; auch das wurde zunächst als -Byteabweichung gemeldet. Danach ausschließlich diese Referenzerneuerung streng -nachgewiesen: ursprünglicher vollständiger Zeilenhash aus unveränderten Job-/ -Versuchs-/Outcome-Bytes rekonstruiert, alte/neue Ed25519-Entscheide unabhängig -verifiziert, ursprüngliche Anträge/Responses und Plan-/Grant-/Outcomebindungen -belegt. Alle übrigen historischen Zeilen unverändert. Kein pauschales Ausnehmen -von Outcomes, kein Reset oder nachträgliches Umschreiben des Fehlerberichts. - -Geschützte Fälle unter `devstate/shared-core/runtime-upgrade{,-v2}/`; separater -aktueller Beleg `devstate/cloud-shared-core-current-runtime.json`. Historischer -MVP-Abschluss bleibt unverändert. APT bleibt inaktiv, Endpunkt entfernt und -General `allow_reboot=false`. Die früheren APT-Paketabnahmen gelten weiter für -ihre ursprünglichen Artefakte; neue Agent-/Helperhashes ergeben ausdrücklich -keine neue APT-Readiness-/Paketqualifikation. Runner und Erhaltungspins: -[Shared-Core-Dienstwechsel](../deploy/shared-core-upgrade.md). - -## Gebundenes Unknown-Folgeergebnis wird dauerhaft bestätigt — lokal geprüft - -Ein nachträgliches authentisiertes JobResult mit höherer Revision darf jetzt -`unknown` bleiben, wenn der signierte Sync den Server bereits auf Unknown -gesetzt hat. Dieselben Tenant-/Agent-/Job-/Versuchs-/Grantprüfungen gelten -unverändert. Die konkrete Receipt/ACK kann das Ergebnisjournal leeren; Status, -Startreservierung und ursprünglicher Grant bleiben gesperrt. Kein neuer Versuch, -Unlock oder irreführender `job_reconciled`-Audit für unverändertes Unknown. - -Tatsächlich ausgeführt: ein gezielter isolierter PostgreSQL-Integrationstest -mit allen Migrationen und RLS als Anwendungsrolle, ohne veröffentlichte Ports, -sowie Server-Clippy über alle Targets mit `-D warnings`: bestanden. Gleiche -Nachricht idempotent bestätigt; falsche/fehlende Grants, fremder Tenant/Agent, -anderer Versuch und widersprüchliche Revision verweigert. Eigene Testdatenbank, -kein Produktionsplan oder RMM-Job genehmigt. Clouddeployment und tatsächlicher -Reconnect dieses Pfads sind separat noch offen. - -## Windows-Laufzeit erhaltend als LocalService aktualisiert — 2026-11-14 - -Zusätzlicher Helper-Quelllauf: zunächst20/21 native Fixtures bestanden; Serde -akzeptierte bei einer intern getaggten Unit-Variante unerwartete Probe-Felder. -Die Variante ist jetzt eine strikt leere Struktur, unverändertes Wireformat -`{"operation":"probe"}`. Der ursprüngliche Negativtest bleibt erhalten. -Neuer Fall `38b0fe75-f6a5-4ad3-ab2d-7f3acf7e9cbd` bestand tatsächlich alle21 -Fixtures einschließlich neun Helperfälle, ohne Skip, als Bootstrapadministrator. -Das qualifiziert Codec-/Guardfixturen, keinen laufenden SYSTEM-Dienst oder -tatsächliche Pipepeers. Die Helperquelle wurde zusätzlich unabhängig auf -Grantintervall, echte SCM-Prozessidentität, Dependencies/Groups, Recoveryaktionen -und Deadline geprüft. Recovery-Command/Reboot/Restart bleiben verweigert; -überschrittene SCM-Laufzeit nach möglicher Wirkung bleibt Unknown. Eine synchrone -SCM-API kann trotzdem blockieren; keine harte Effektabbruchgarantie behauptet. - -Die Default-Laufzeit integriert jetzt den gemeinsamen Jobkern, additive -Telemetrie-/Jobtabellen und monotone Sequenzmigration. Der PowerShell-5.1- -Executor ist implementiert: unveränderte genehmigte Skriptbytes, einzelne -Argumente, begrenzte Rohbytes, atomare Windows-Jobobject-Zuordnung und explizite -Handlevererbung. Maschinenrichtlinien werden nicht verändert; die Ausführungs- -richtlinie wird derzeit geerbt. Timeout/Abbruch kann eine Wirkung hinterlassen -und wird deshalb nicht als erfolgreicher oder sicher wiederholbarer Lauf gewertet. -Dies ist noch kein tatsächlicher Windows-RMM-Jobnachweis. - -Native Qualifikation `3dbfe686-6e91-41e9-a5bc-078f7a4e3e6a`: alle12 Library- -und6 Binarytests ohne Skip bestanden, als Bootstrapadministrator. Ein früherer -Fall bestand bereits12 Tests, verlor danach beim Übertragen der großen zweiten -Testdatei die Antwort und bleibt unvollständig. Neue, vor Hashbildung von -Debuginformationen befreite Testkopien wurden beide erneut tatsächlich geprüft; -Originalartefakte und frühere Berichte blieben erhalten. Cross-Clippy mit -`-D warnings`, Releasebuild und Quellenbindung bestanden. - -Anschließend eigener erhaltender Dienstwechsel -`c4f9b280-e83d-4b8e-a1c2-1cd103f73eda`: Agent `f64e8115…` läuft tatsächlich -als LocalService SID19, automatisch, mit unverändertem `transport=auto` und -bevorzugtem WSS. Geräteidentität, Zertifikat, private Schlüsselmetadaten, -Konfiguration/ACLs und ursprüngliche Telemetrie-DB-Dateiidentität erhalten; -Integrität `ok`, Sequenz steigt, zwei frische Heartbeats und konkretes Inventar- -ACK nachgewiesen. Neue CPU-/Speicher- und begrenzte64-/32-Bit-HKLM-Software- -beobachtungen wurden unabhängig auf dem Server gelesen; explizit Teilinventar, -kein `Win32_Product`, kein vollständiger Patchstatus. Fremder Tenant verweigert. - -Windows bleibt0 Jobs/Outbox/Grants/ungeklärte Wirkungen, Linux30/30/26/0. -Kein Binding, Verbrauchsledger oder Jobsverzeichnis angelegt; keine neue -Ausführungscapability. `enable_jobs=false` und `ADAPTER_QUALIFIED=false` bleiben -geschlossen. Der implementierte Zeitadapter und seine tatsächlichen negativen -Zwischenstände stehen in [Windows-Zeitstatus](windows-clock-readiness.md). -W32Time blieb gestoppt; dessen Start und eine etwaige prozessbezogene -PowerShell-Richtlinie warten auf die jeweils konkrete Benutzerentscheidung. -Die SYSTEM-Helperquelle ist featureisoliert; daraus folgt keine native Helper-, -Pipe- oder Systemaktionsabnahme. Geschützte Belege: -`devstate/windows-client/runtime-upgrade//`. - -## Dauerhafte Outcomes und atomarer Start nativ geprüft — 2026-11-14 - -Beim Portieren wurde eine bestehende Verfügbarkeitslücke gefunden: Ein Crash -zwischen dauerhaftem JobResult und Ledgerabschluss konnte den Verbrauch ohne -lokalen Outcome gesperrt lassen. Jetzt werden Verbrauch und Startzeuge atomar -gespeichert; der gebundene Outcome wird ohne Unlock vor der Result-Transaktion -persistiert. Erst danach darf der Verbrauch abgeschlossen werden. Startup -rekonstruiert ausschließlich vollständig historisch verifizierte Original- -Outcomes; ohne solchen Beleg bleibt `unknown` gesperrt. Konflikte überschreiben -keine vorhandenen Ergebnisse, und Server-/Sync-Unlockprüfungen bleiben streng. - -Lokal 181 betroffene Tests sowie Linux-/Windows-Clippy bestanden. Im eigenen -Fall `08a9be72-dd7c-46b7-a2c6-7d17424533c2` danach zuerst 76 Linux- und -anschließend 54 Windows-Fixturen nativ ohne Skip bestanden. Geprüft wurden -beide Crashfenster, ein noch nicht journalisierter Grant, später gespeicherter -Outcome nach Unknown sowie verweigerte Manipulationen und atomarer Rollback. -Eigene Testdaten, kein tatsächlicher Jobabbruch oder neuer RMM-Job. -Private Profile/Artefakte: `devstate/{shared-core,windows-core}/durable-outcome-v1/`; -Rohbelege unter `devstate/shared-core/acceptance//`. Native Dienstintegration -und Windows-Ausführung bleiben separat offen. - -## Windows-Plattformverträge auf endgültigem Server bereitgestellt — 2026-11-14 - -Servercandidate `9058f6a3-0832-400f-ba93-b3fb94faaba0` wurde ausschließlich aus -dem unveränderlichen Gitstand `31278be` gebaut; laufendes Image blieb bis zum -ausdrücklichen Deploy unverändert. Build und Deployment mit erhaltenem Datenbank- -und PKI-Bestand bestanden. Die gebaute WebUI enthält Windows- und feste gemischte -Skriptvarianten sowie exakte JSON-stdout-Nachbedingungen. - -Tatsächlich nachgeprüft: API/Gateway verwenden dasselbe qualifizierte Image als -UID 10001, nur Loopbackports 18443/18444; PostgreSQL healthy ohne veröffentlichten -Port. Rootpolicy, Compose und Faultdateihash unverändert, alle Testhooks aus. -Der Transportfault-Flag wechselte bei der Neuerstellung von explizit `false` -zu abwesend; beide Zustände sind deaktiviert. Die erste zu strikte -Gleichheitsprüfung dieser Flagdarstellung wurde getrennt durch diesen -tatsächlichen Nachbeleg ergänzt; keine erfolgreiche Bytegleichheit behauptet. -Windows blieb bei 0 Jobs/Outbox/Grants/ungeklärten Wirkungen; Linux bei -30/30/26/0. Linux ist wieder mit signiertem Checkpoint bereit, Windows weiter -passiv verbunden; fremder Tenantzugriff verweigert. - -Eine tatsächliche MCP-Plananfrage für PowerShell an den noch passiven Windows- -Client wurde mit `UNSUPPORTED_CAPABILITY` verweigert, ohne Submit/Genehmigung. -Das beobachtete Legacy-DB-Flag `sync_ready=true` auf diesem Client ist ausdrücklich -kein Windows-Sync-/Jobnachweis. Geschützte Rohbelege: -`devstate/server-upgrades/9058f6a3-0832-400f-ba93-b3fb94faaba0.*.json`. - -## Gemeinsamer Helper-Sync nativ geprüft — 2026-11-14 - -Der bisherige Linux-Helper-Sync ist jetzt ebenfalls Teil von `rmm-agent-core`. -Linux behält seine tatsächlichen Datei-/Lock-/Boot-/Clockadapter und den -OpenSSL-Verifier. Der gemeinsame Kern erhält explizite `Root`-/`System`- -Konfiguration; Windows wird niemals durch ein falsches `root`-Label dargestellt. -Historische Snapshot-/LocalAttempt-/SignedResponse-Codecs bleiben bytegleich. - -Lokal bestanden: 174 betroffene Tests, Linux-/Windows-Clippy und Formatprüfung. -Im getrennten nativen Fall `5704073c-a135-431c-aa84-fedc68a3de0b` zuerst -69 Linuxfälle einschließlich 21 tatsächlicher Linux-Datei-/Lockadapter-Fixturen, -danach 47 portable Windowsfälle ohne Skip bestanden. Quell-/Artefaktbindungen -liegen separat unter `devstate/{shared-core,windows-core}/helper-sync-v1/`; -Rohbelege unter `devstate/shared-core/acceptance//`. Frühere Belege bleiben -unverändert. Keine Dienste ersetzt, keine RMM-Jobs, Systemaktionen oder neue -Grants. Dies ist kein nativer Windows-SYSTEM-/Named-Pipe-Nachweis. - -## Gemeinsamer Jobkern nativ auf Linux und Windows geprüft — 2026-11-14 - -Der neue `rmm-agent-core` enthält die gemeinsame signierte Sync-/Checkpoint- -Maschine, Permit-/Request-/Outcome-Codecs, Verbrauchsledger und portable -Jobpersistenz. Linux verwendet diese Implementierung über dünne Adapter; -seine bisherige OpenSSL-Verifikation bleibt erhalten. Windows verwendet Dalek, -ohne OpenSSL-Abhängigkeit. Die bisherigen Linux-Codecbytes bleiben unverändert. - -Tatsächlich bestanden: 151 betroffene lokale Rusttests und Clippy; danach im -eigenen Fall `4bc4db12-2990-4e93-bb86-8fbd94b691fb` zuerst 25 native -Core-Unittests auf der Cloud-Linux-VM, anschließend 24 auf der Windows-VM, -jeweils ohne Skip. Quell-/Artefakthashes und vollständige Ausgabe bleiben in -geschützten Manifesten und `devstate/shared-core/acceptance//` erhalten. -Die unterschiedlichen Zahlen entstehen durch den zusätzlichen Unix-OpenSSL- -Paritytest. Diese Programme verwenden ausschließlich eigene SQLite-Fixturen, -Testsignaturen und simulierte Clock/Channel-Objekte. Kein RMM-Job, Dienstwechsel, -Enrollment oder Netzwerkpfad wurde damit ausgeführt. Ein nativer Sync des -laufenden Dienstes mit dem extrahierten Kern bleibt separat nachzuweisen. - -Server/Domain/WebUI sind additiv für feste Windows-/Linux-Skriptvarianten und -Windows-Basisinventur vorbereitet. Gemeinsame Plattform-/Capabilityprüfung bei -Planung, erneuter Prüfung, Grant und Zustellung; vor Genehmigung unverändert -0 Jobs/Outbox/Grants. Exakte stdout-Nachbedingungen lassen sich als JSON-String -einschließlich CRLF eingeben. Lokal bestanden: 14 Domainfälle einschließlich -Linux-Goldenbytes, Variantenprüfung, isolierter PostgreSQL-Test mit Migrationen -und Tenant-/Capability-Verweigerungen, Clippy sowie 29 Webtests/Typecheck. -Dies ist noch kein Clouddeployment oder Windows-Ausführungsnachweis. - -Windows-Dienst, Identität und bisherige passive Capabilities blieben bei diesem -Schritt unverändert. Clock-, Executor-, Helper-, Paket- und übrige native -Windows-Abnahmen laufen weiter; die Plattform meldet dafür keinen Erfolg. - -## Windows: dauerhaftes Auto auf bestehender VM nativ bestanden — 2026-11-13 - -Separater Fall `422562e8-18eb-4865-977d-ab2af65f510b` verifiziert und abgeschlossen. -Der vorhandene Dienst läuft dauerhaft mit `transport=auto`, bevorzugt WSS und -bestätigt zwei frische WSS-Heartbeats sowie konkretes Inventar-ACK. Tatsächlicher -LocalService, Binary, Identität, CA/Zertifikat/Schlüssel, ACLs und Telemetriehistorie -blieben erhalten. Originalkonfiguration ist versioniert. Beide Server-Testhooks -sind aus; Serverkonfiguration und Rootpolicy blieben unverändert. Windows -weiterhin 0 Jobs/Outbox/Grants/ungeklärte Wirkungen, Linux weiterhin 30/30/26/0. - -Geschütztes `auto-default//result.json` ist durch den separaten aktuellen -Transportbeleg per Hash gebunden. Der Installerdefault lautet ebenfalls `auto`; -keine frische Installation, MSVC- oder Signierabnahme daraus ableiten. Fünf -gezielte lokale Schutztests und PowerShell-Parserprüfungen bestanden. Keine -Windows-Jobs, Genehmigungen, Reboots oder Erweiterung der Ausführungsrechte. -Der erste Windows-Job bleibt bis zur qualifizierten Uhr und dem gemeinsamen -signierten Jobkern offen; siehe [Windows-Gates](windows-gates.md). - -## Windows: automatischer WSS→HTTPS-Fallback nativ bestanden — 2026-11-13 - -Fall2ff2e1aa-0037-4831-9bc2-31218bf1461c verifiziert. Bestehender LocalService- -Agent inauto: zwei aktuelle WSS-Heartbeats, danach genau zwei tatsächliche -authentisierte503 mit festen Slots/Peer-/Konfigurations-/Fallbindungen. -Automatische HTTPS-Auswahl mit zwei frischen Heartbeats und konkretem Inventar- -ACK; Identitäten/Dateien/ACLs erhalten, Sequenz monoton und TenantB verweigert. -WindowScounts0/0/0/0, Linux30/30/26/0 und Rootpolicy vor/nach unverändert. -Beide Server-Testhooksfalse/Dateipfadeabwesend; ursprüngliche WSS-Konfiguration -und ACLs exakt restauriert, wieder frische WSS-Heartbeats/ACK0. Kein automatischer -Switchback behauptet. Sechs lokale Guards ergänzen den nativen Nachweis. -Details:[Windows-Client](../deploy/windows/CLIENT.md). Windows-Jobs weiterhin -ausdrücklich nicht angeboten; erste PowerShell-Strecke benötigt die dokumentierten -[Core-/Uhr-/Planvoraussetzungen](windows-job-boundary.md). - -## Windows-TLS-Negativabnahme vollständig bestanden — 2026-11-13 - -Derselbe erhaltene Fall7b190a5c-c928-4348-bd0d-c9698dad5417 mit unveränderten -öffentlichen Fixtures und neuer qualifizierter Probe33eb5650…: gültige Kontrolle -vor/nachHTTP401; falsche CA TLS_UNKNOWN_ISSUER, falscher Name -TLS_SERVER_NAME_MISMATCH, abgelaufener Client TLS_PEER_CERTIFICATE_EXPIRED, -jeweils ohne HTTP. Alle fünf echten Windowsprozesse bestanden. Native Admin- -TLS-Proben ausdrücklich von separatem LocalService-HTTPS getrennt; keine -Rotation/Widerruf/Jobfähigkeit behauptet. Dienst/PID/Identität/Schlüsselmetadaten -unverändert, keine Registrierung/Jobs/Clockänderung/privaten Transfers. - -Get_ref-Klassifikationsfix gezielt lokal geprüft und GNU-Release/Clippy -qualifiziert. Erster unbekannter Fehler und ein vor TLS unterbrochener Witness- -Retest bleiben erhalten. Kurzer zeitlich begrenzter Metadatenaufruf erlaubte -Fortsetzung ohne Neusignierung/CSR. Verifiziertes Ergebnis in typed-retest- -6dd51cc0-deb5-4020-afee-58dbb716cdbb/result.json unter dem ursprünglichen -privaten TLS-Fall. Details:[Windows-Client](../deploy/windows/CLIENT.md). -Automatischer Fallback und weitere Windows-Gates bleiben eigenständig offen. - -## Windows-TLS: gültige Kontrolle bestanden, Negativklassifikation korrigiert - -Native getrennte Admin-TLS-Fixture7b190a5c-c928-4348-bd0d-c9698dad5417 erzeugte -ihren Schlüssel ausschließlich auf Windows. Nur öffentliche CSR zum Server, -öffentliche CA/Clientzertifikate zurück. Gültige unregistrierte Kontrolle -erreichte HTTP401. Falsche CA endete ohne HTTP, aber als -UNCLASSIFIED_TRANSPORT_ERROR; deshalb ausdrücklich keine erfolgreiche -TLS-Negativabnahme. Readonly-Folgenachweis bestätigt unveränderten permanenten -Dienst/PID/Identität und private Keydateimetadaten, keine Registrierung/Jobs. - -Exakte gelockte Bibliotheksquellen erklären die verlorene Typidentität: zwei -verschachtelte io::Error um den tatsächlichen Rustlsfehler. Prüfer folgt jetzt -get_ref vor source, ohne String-/Timeout-/Resetheuristik. Gezielter Test dieser -Kette samt verweigerten Timeout-/Reset-/Stringfällen, GNU-Releasebuild, Clippy -und Python-/PowerShell-Parserprüfungen bestanden. Originale EXE/Qualifikation/ -Quellbytes privat erhalten; neue Probe33eb5650… bereit. Wiederaufnahme desselben -Falls liest die erhaltenen öffentlichen Fixtures und erstellt separate -Retestbelege, keine neue CSR/Signierung/Identität. Native Wiederprüfung noch offen. -Windows-Jobfähigkeiten bleiben gesperrt. - -## Windows: explizites HTTPS nativ bestanden — 2026-11-13 - -Bestehender Windows-11-Gast, LocalService und unveränderte Geräteidentität. -Fall3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458 verifiziert: tatsächliches HTTPS, zwei -frische Heartbeats, konkreter Inventar-ACK, monotone Sequenz und erhaltene -Schlüssel-/Programm-/CA-/Identitätsdateien samt ACLs. Originale WSS-Konfiguration -byte- und ACL-genau restauriert, wieder zwei frische WSS-Heartbeats. TenantB -weiter verweigert, davor/danach0Jobs/Outbox/Grants/offene Versuche. Keine -WebUI-Genehmigung benötigt oder ersetzt, weil ausschließlich eigene passive -Transportwartung und gespeicherte Daten geprüft wurden. Sieben lokale Guards/ -drei PS-Parserprüfungen ergänzen den nativen Nachweis; keine neue Binärdatei. -Details:[Windows-Client](../deploy/windows/CLIENT.md), [Windows-Gates](windows-gates.md). -Für erste PowerShell-Jobs fehlen noch portierter Sicherheitskern, nachgewiesene -vertrauenswürdige Uhr, dauerhaftes Jobjournal und plattformgebundene Plan-/ -Interpreterprüfung; kein Ausführungscapability behauptet. - -## Linux-MVP M0–M5 abgeschlossen — Endabgleich vom 2026-11-13 - -Alle vereinbarten begrenzten Linux-dev/test-Gates sind nachgewiesen. -Der tatsächliche Readonly-Endsnapshot ist verifiziert: **30 Jobs / 30 Outbox / -26 Grants / 0 ungeklärt; Root 18 verbraucht / 0 offen / 0 Faults**. -Alle historischen Verbrauchszeilen und drei DB-Inodes sind erhalten. -Agent und Helper haben dieselbe signierte Syncentscheidung angewandt und -sind bereit. Aktuelle Artefakte: Agent `9e9f3230…`, Helper `d6fbfc25…`, -Provider `1dc0237d…`. Der Agent läuft tatsächlich als UID 993/GID 984; -Agent und General sind aktiv/enabled, APT und Legacydienste inaktiv/disabled. - -Die ursprünglichen General-Policy-/Pinbytes mit `allow_reboot=false` sind -wiederhergestellt, die zentrale Rootscope geschlossen. Probeoverride entfernt, -Rollbacktimer inaktiv. Das tatsächliche Serverimage entspricht dem qualifizierten -Candidate `7be1f330…`: API/Gateway als UID 10001, Ports nur an -`127.0.0.1:18443/18444`; PostgreSQL healthy ohne publizierten Port. -Testhooks sind aus, ihre Dateipfade abwesend. Auf dem Notebook sind alle fünf -RMM-Units not-found/inaktiv; es laufen keine RMM-Container. - -`devstate/cloud-mvp-final-closeout.json` bindet die unveränderten tatsächlichen -Rohbeobachtungen per SHA. Der erste lokale Finalwriter verweigerte versehentliches -Überschreiben des create-only-Rohreports. Anschließend wurden ausschließlich -dieselben gespeicherten Beobachtungen validiert und ein separater Completionreport -erstellt; keine Messwerte überschrieben und keine Wirkung wiederholt. - -Alle Genehmigungen verwenden tatsächliche WebUI-Interaktionen im ausdrücklich -simulierten dev/test-Profil. Das ist keine Produktionsfreigabe. Aktueller -Umfang, Einzelgates und spätere Aufgaben: [Abnahmegates](mvp-gates.md), -[Audit](mvp-final-audit.md), [Backlog](post-mvp.md). -Die folgenden Abschnitte dokumentieren die tatsächlichen früheren Teilschritte -und Zwischenstände; ihre damaligen offenen Aufgaben sind inzwischen geschlossen. - -## MCP-Endreferenz tatsächlich bestanden — 2026-11-13 - -Neuer rein lesender Berichtdevstate/cloud-mcp-reference-final.jsonverifiedtrue: -genauein ausdrücklich ausgewähltes realesLinuxziel/berechtigterKunde, frisches -gespeichertes Inventar und korrekte Zustandszähler/Aggregate. Sieben bestehende -erfolgreiche OperationenHello/refresh_inventory/Dienstsetup/start/stop/ -offline_wait und ursprünglicher abgeschlossenerReboot, jeweils ursprüngliche -Plan-/Ziel-/Versuchsbindung und tatsächlichesUI-Nullgate/Simulationsaudit. -OriginaleSubmit-Idempotenzreceipt ausOfflinefall währenddessenbeobachtet -angebunden; keine neueFreigabe/Plan/Jobs/Liveinventur/Wirkung durchBericht. -M0–M5-Funktionsnachweise damit vollständig; endgültiger Betriebs-/Source-/ -Dokumentationssnapshot wird noch geprüft, daher noch keinGesamtabschluss. - -## APT-Messungsrequalifikation nach Originalabschluss bestanden - -Separater enger Resume nach nachgewiesenem Bootstrapfehler nativ bestanden: -ungültige siebenfeldrige Metadatendatei versioniert, exakt ursprüngliche -vierFeldbytes/SHA5566bc26… kopiert. Bereits richtige APT-Konfiguration/-pin -unverändert; kein Provider-/Binarywechsel, kein erneutes Requalifikationssetup. -Aktuelle Runtime6545c78462a23be67b283e22e084fa889e094973e91fea9f4abd207e4d515f63 -mitAgent9e9f/Helperd6fb/Provider1dc gemessen. Echtes systemdExecStartPre mit -kopierter dpkg-Datenbank und nativer Sandbox-/Lock-/Rechteprüfung bestanden; -readiness_onlytrue/native_acceptancefalse. AlteAcceptances und alleRoot18-/ -DBinodes-/Identitäts-/Historybelege unverändert; keine neuePaketwirkung/Jobs/ -Grants/Reboot. APTdanachinaktiv/Endpunktabwesend/Scopegeschlossen, General+Agent -wieder gestartet. Privater post-reboot-apt-recovery.jsoncompletedtrue; -ursprünglicher failedpost-reboot-apt-readiness.json bleibt unverändert. -Historische Paketabnahme bleibt an Originalruntime3bac gebunden, wird nicht -auf6545 umgeschrieben. Noch MCP-Endbericht und DoD-Endsnapshot erforderlich. - -## APT-Runtimemessung sicher verweigert; Bootstrap-Metadatenfehler - -Der neue post-reboot-Requalifikationslauf stoppte nach versionierter -Konfigurations-/Pinmessung beim APT-ExecStartPre, bevor die Pythonprobe anlief. -Kein Paketjob, Grant, Markerreset oder neue Wirkung. Privater ursprünglicher -post-reboot-apt-readiness.jsoncompletedfalse/stagerepinned_preserved erhalten. -Tatsächliche reine Schemaprüfung bestätigt sieben aktuelle Metadatenfelder, -aber InstallMetadata verweigert unbekannte Felder und erlaubt exakt vier. -Bootstrap ergänzte irrtümlichhelper_sha256/runtime_sha256/apt_config_sha256; -diese gehören in Runtime-/Policybelege, nicht in InstallMetadata. Originale -vier Werte im versionierten Backup nachweislich unverändert, Schema4Felder. -Aktuelle DateiSHAf55a784e…, Original5566bc26…. Agent/General/APT kontrolliert -inactive; Root18geschlossen bleibt erhalten. Enge versionierte Metadaten- -korrektur und Fortsetzung derselben Readinessprobe werden vorbereitet, -keine Wiederholung des Requalifikationsbootstrap/keine erneute Paketabnahme. -MVP bleibt bis Abschluss dieser und der MCP-/DoD-Prüfungen offen. - -## General-Startretry nativ nachgewiesen — 2026-11-13 - -Einzige dauerhafte UnitänderungRestart=on-failure/RestartSec=5, keinBinary-/ -Policy-/Privilegienwechsel. Kontrollierter früher Konfigurationsfehler erzeugte -Exit1 und automatischeWiederholungNRestarts1; nach exakterOverrideentfernung -automatische stabileRecoveryNRestarts2 ohne zweitenStartbefehl. AlleRoot18-/ -DBinodes/-bytes, Schlüssel und Policies erhalten, keinRMMjob/OSreboot. -Native private startup-retry-result.jsoncompleted/automatic_recovery/ -state_preservedtrue. Quelledeploy/linux/rmm-helper-cloud.service entspricht -nativerUnitSHA104a7d6f. Rebootrechte weiterfalse/zentralgeschlossen, Agentwiederaktiv. -Noch APT-Runtime-Messungsrequalifikation, MCP-Endbericht und DoD-Endsnapshot. - -## Einziger Reboot vollständig nativ abgeglichen und Rechte geschlossen - -Original8ffd/25a jetztSucceeded/revision3. Rechtzeitiger Originalinventarbeleg -20:28:40.877951UTC innerhalb180s ab zentral20:26:12.430245UTC, zusätzlicher -frischer Sameboot-Beleg21:11:02.272955UTC; genau ein fest gebundenes -Postcondition-Audit. Generation103 normaler signierterSync vonAgent+Helper -angewandt/ready, Root18/0offen/0Faults, keine anderen offenen Agentversuche, -alle17altenVerbrauchszeilen und drei DBinodes erhalten. result.jsonverifiedtrue. -Danach zentraleRootscopegeschlossen und exakte ursprüngliche Generalpolicy/-pin -mitallow_rebootfalse restauriert, closed.jsonverifiedtrue. Keine zweite Wirkung. -[Originalnachweise](reboot-acceptance.md). Noch enger Startupretry-Nachweis, -kopierende APT-Runtimequalifikation nach Storageartefaktwechsel, MCP-Endbericht -und vollständiger DoD-/Dokumentationsabgleich; MVP noch nicht abgeschlossen. - -## Journalursache nativ bestätigt und erhaltend korrigiert — 2026-11-13 - -Tatsächliche RootDBkopie am256MiB-Limit mitSQLITE_FULL13 reproduziert; derselbe -512KiB-Insert unter endlichen1GiB gelang. Beide Rollbacks erhalten Schema/Zeilen, -Originalbytes/-inode unverändert. Spec1.15/sharedRustfix mit126Tests/Format/ -Clippy und BookwormReleasebuild qualifiziert, Agent9e9f3230/Helperd6fbfc25 nativ -versioniert installiert. Alle18Rootverbräuche, drei DBinodes, sämtliche History/ -Identitäts-/Paket-/Policynachweise erhalten. General läuft, Agent für folgenden -normalen Sync zunächst gestoppt; Originalrebootweiterunknown, keine weitere -Wirkung. APT-Endpunkt bleibt aus; historische3bac-Abnahmen bleiben exakt gültig, -aktueller Helperhash verlangt separate kopierende Runtime-Requalifikation vor -weiteren APTjobs. [Journalnachweise](journal-capacity.md). - -## Original-Reboot erfolgt; Abschluss noch gesperrt — 2026-11-13 - -Der feste WebUI-genehmigte Job `8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa` -verbrauchte genau Grant `25a4bf3f-772c-487d-825d-73bcbbc418fd`. Tatsächlicher -neuer Boot und mTLS-Inventare nach etwa88/148Sekunden liegen innerhalb der -unveränderten180Sekunden ab zentraler Reservierung20:26:12.430245UTC. -General startete zunächst mit `CLOCK_UNTRUSTED` nicht; die bestehende Unit -`Restart=no` konnte nicht selbst wieder anlaufen. Nach nachgewiesen vertrauter -Kerneluhr wurde ausschließlich derselbe Helper gestartet. Keine zweite -Rebootwirkung, keine Journal-/Grant-/Identitätsrücksetzung. - -Servercandidate `7be1f330-4bbd-4801-b72a-c35ce7ac479e` nativ ARM64 gebaut und -erhaltend deployt. Spec1.14 präzisiert spätere Erstverifikation: unveränderlicher -rechtzeitiger Originalbeleg **und** separater frischer Sameboot-Inventarbeleg -unter aktuellem authentisierten Kanal. Drei isolierte echte PostgreSQL-Tests, -Format und Clippy bestanden. Alle30Jobs/30Outbox/26Grants, Root18 und alten -DBinodes/-Verbrauchszeilen beim Deployment erhalten; UI unverändert. Dies ist -noch keine vollständige Rebootabnahme: Abschluss weiterhin unknown. - -Danach kein neuer SyncRequest, obwohl Heartbeats/Inventare fortliefen. -Rootjournal tatsächlich268414976Bytes nahe256MiB-Grenze; Meta blieb1378, -Agent meldet nur generischen Syncabhängigkeitsfehler. Sourcepfad schreibt -Helpercapture vor Agentrequest. Agent exakt an denselben Originalversuch -gebunden administrativ gestoppt, Helper aktiv/Rootfaultfrei. Kapazitätsursache -wird an eigener DBkopie geprüft; keine Historylöschung oder Wiederholung. -Erneuter `finish`-Leseversuch endete ohne Erfolgsnachweis. Noch offen sind -Abschluss desselben signierten Rebootabgleichs, Startretrykorrektur, MCP-Endbericht -und Endaudit. Details:[reboot-acceptance.md](reboot-acceptance.md). - -## Kontrollierter Agentabbruch nativ vollständig abgeglichen — 2026-11-13 - -Eigener Cloudfall644c06eb-24b0-41b0-9a90-f60ea1fe38a9 bestanden. Tatsächlicher -WebUI-Nullgate/Klick, Root16/Grant a3cbc544-0582-4d64-8237-017a82d7cddf; -nach einmaligem Countereffekt nur AgentMainPID gezielt beendet. Unabhängiger -Helper blieb aktiv, neuer Agent meldete tatsächlichen lokalen und zentralen -Unknown/revision2/AGENT_PROCESS_INTERRUPTED. Kein neuer Versuch/Grant für -diesen Job. OriginalHelper abschließend succeeded; normaler signierter Sync -schloss exakt den Originalverbrauch. Eigener separat UI-genehmigter Lesejob -bestätigteCounter1, beide1/1/1/0, Policygeschlossen. Keine Paket-/Journal-/ -Identitätsänderung. Details:[agent-crash-acceptance.md](agent-crash-acceptance.md). -MVP noch offen: autorisierter einzelner letzter Reboot, Endaudit/Dokumentation. - -## Alle drei aktiven Offlinevarianten nativ belegt — 2026-11-13 - -Zusätzlich zu gültigem Wiederkontakt und Ablauf tatsächlicher UI-Planwiderruf -im eigenen Fall68148362-e21e-4bd0-9126-12e5a6e03945 bestanden. Bereits erfolgter -einmaliger UI-Klick samt interaktivem Simulationsaudit nach Browser-Auswertungs- -fehler rein lesend bestätigt, nicht wiederholt. Derselbe aktive Offlineagent -ohneGrant/Wirkung überfrühestenStart; Normalreconnect96/ready innerhalb -gültigerStartfrist, Ergebnis cancelled/1Job/1Outbox/0Grants/0offen. Rootledger -unverändert, keine Ablaufmaskierung des Entzugs. Tatsächliche Grenzen und -Fortsetzungsbelege:[cloud-offline-acceptance.md](cloud-offline-acceptance.md). -Agent702, Helperbbd/Provider1dc/M4Runtime3bac unverändert. Noch Prozessabbruch, -letzter eigener Rebootplan und Endaudit; kein vollständiges MVP behauptet. - -## Nichtstart beim Folgesync nativ stabil erhalten — 2026-11-13 - -Minimaler Agentfix für grantfreie expired/cancelled-Nichtstarts,20 echte -SQLite-/Signatur-Reconciletests/0Skips, Format und Alltargets-Clippy bestanden. -Vorhandene Verbrauchszeilen haben Vorrang; unklare Wirkungen bleiben gesperrt. -Neuer Bookworm-Agent702bd7b5293a38b3d910d9b38401a155dd5bccb88d43fa3af807d2094c70caa3 -erhaltend auf Cloud-VM installiert. Gewöhnlicher frischer Kanal Generation93 -übernahm die vorhandenen letzten gültigen/pending Anker ohne Reparatur/Reset. -Signierter Sync wieder ready, restore_blockedfalse; ursprünglicher Ablaufjob -korrekt expired/DEFINITIVE_NONSTART mitnullGrant/revision0/unlockfalse. -Zentrale26/26/23/0 unverändert; keine erneute Wirkung, kein neuer Plan. Helper, -Provider und native1.1-Acceptanceruntime3bac unverändert. Nächste Arbeit eigener -UI-Entzugsfall, Crash, Reboot zuletzt und Endaudit. - -## Nichtstart nach Ablauf beim Folgesync falsch klassifiziert — 2026-11-13 - -Vor UI-Entzugsplan blockiert korrekter Readinessguard, noch kein neuer Antrag. -Tatsächlicher gespeicherter Sync und beide Ledgers bestätigen für den -abgelaufenen vorherigen Versuch0Grant/0Startreservierung/0Startaudit/0Verbrauch, -expired/revision0. Agent kennzeichnet den grantlosen terminalen Zustand jedoch -beim Folgesnapshot als uncertain und verursacht dadurch die Verweigerung -`ATTEMPT_RECONCILIATION_REQUIRED`. Keine ungeklärte tatsächliche Wirkung, -beide Journale faultfrei, Root15geschlossen, Zentrale26/26/23/0. Keine -Umgehung/DBreparatur; minimale Agentklassifikation wird gezielt korrigiert, -Helper/Provider/M4Runtime bleiben unverändert. Vollständiger M2/MVP-Abschluss -weiter offen. Details:[Offlineabnahme](cloud-offline-acceptance.md). - -## Aktiver Offline-Ablauf ohne nachträgliche Wirkung bestanden — 2026-11-13 - -Eigener Fall5869480b-d06c-450c-8163-838bf2dda6bc mit echtem WebUI-Nullgate und -Genehmigung bestanden. Aktiver Agent blieb über beide festen Startgrenzen -offline, persistierte Reconnectversuche, erhielt keinen Grant und bewirkte -nichts. Nach fristüberschreitendem Wiederkontakt ehrlich expired/1/1/0/0, -nativeConsumptionleer/Zählerabsent/Rootledgerhistoriegleich. Transport vollständig -wiederhergestellt. Noch UI-Genehmigungsentzug, Crash, Reboot und Endaudit offen. - -## MCP-Referenzvorbericht tatsächlich vollständig gelesen — 2026-11-13 - -Rein lesender MCP-Lauf auf endgültigem Server bestanden: berechtigter Kunde, -gespeicherte Geräteliste/Datenalter, ausdrücklich gewählte reale Linuxzielmenge -genau ein Gerät, sechs ursprüngliche erfolgreiche Operationen Hello/Liveinventur/ -Dienstsetup/start/stop/offline_wait mit festen ursprünglichen Plänen und0/0/0- -Audits. Jobanzahlen/Zustandsaggregate passen jeweils exakt. Tatsächlich -beobachtete ursprüngliche Submit-Idempotenzreceipt angebunden; Bericht -`verified=true`, `idempotency_status=observed`. Kein neuer Antrag/Job oder -Freigabeaufruf. Privater Beleg`devstate/cloud-mcp-reference-prereboot.json`. -Kein Mehrgeräte-/Mischplattformnachweis. Rebootreferenz wird nach dessen eigener -letzter nativer Abnahme ergänzt; Offlinefrist/Entzug und Crash noch offen. - -## Aktiver Offline-Startschutz samt frischem Wiederkontakt bestanden — 2026-11-13 - -Fall8d2d0d7c-f844-48b6-bb8d-b9d00c229c5b auf derselben Cloud-VM bestanden. -Echte Netzgegenproben und eigener WebUI-Klick0/0/0; Agent blieb mit steigender -persistenter Reconnectsequenz aktiv offline über den frühesten Start, weiterhin -null Grants/Consumption/Wirkung und gefrorener Serverkontakt. Nach normaler -Netzwiederherstellung innerhalb Frist frischer signierter Sync vor genau einem -Grant und genau einer Wirkung/Zähler1, Ergebnis succeeded/1/1/1/0. Rootledger- -Historie unverändert. Tatsächlicher derselbe MCP-Submit innerhalb der alten -Frist blieb idempotent/dieselbe Operation/keine weiteren Ausführungsartefakte. -Details/Belege:[cloud-offline-acceptance.md](cloud-offline-acceptance.md). -MVP weiter offen: Ablauf/Entzug, Crash, MCP-Endbericht und Reboot zuletzt. - -## Begrenzte M4-APT-Abnahme vollständig bestanden — 2026-11-13 - -Zusätzlich zum echten1.0→1.1-Upgrade beide eigenen WebUI-genehmigten Noops nativ -bestanden: ensure_package Grantb8f95463-383d-47c7-a127-25ac3ce64510/Root14 im -getrennten Retryordner, apply_updates Grantc267f82b-328f-4d36-8d70-9aa81108646d/ -Root15. Jeweils0/0/0 vor Klick und1/1/1/0 danach; Nachbedingungen true, -beobachtete1.1/Nutzdatei und vollständiger Postsnapshot korrekt, -`changed=false`, `already_desired=true`, `transaction_executed=false`, -`postcondition_already_met=true`. Wahrheitsgemäß reboot_requiredtrue, keine -weitere Pakettransaktion oder Reboot. Erster fehlgeschlagener Noop und alle -alten Unknown-/Reconcilebelege unverändert erhalten. Native1.1-Acceptance -gehört weiterhin exakt zu Provider1dc/Helperbbd/Runtime3bac. - -APT-Testpolicy danach tatsächlich geschlossen, Agentendpunkt entfernt, -APT-Dienst gestoppt; normale Agent-/Generalstrecke bleibt aktiv. Tatsächlicher -Abschlussreadback Root15/0offen/0Faults, zentral24Jobs/24Outbox/22Grants/0offen, -beide Journale integritätsgeprüft/faultfrei. Der Umfang -ist ausschließlich das harmlose gepinnte Testrezept, keine OS-/Kernelupdate- -oder allgemeine Repositoryfreigabe. Private aktuelle Belege unter -`devstate/cloud-apt-recovery/configured-reconcile-runtime/` einschließlich -`cases/{apt_native_update,apply_updates}/checkpoint.json`, -`cases/no-change-retry/ensure_package/checkpoint.json`, Policy-/Endpointclose. -**MVP weiter offen:** aktive Offline/Ablauf/UI-Entzug, Agentabbruch mit -gebundenem Abschluss, vollständiger MCP-Referenzbericht und zuletzt Reboot. - -## Frischer eigener ensure_package-Noop nativ bestanden — 2026-11-13 - -Nach tatsächlichem rein lesendem Nachweis des wirkungslosen STATUS_FINGERPRINT- -Fehlversuchs neuer fester Plan in eigenem`cases/no-change-retry/ensure_package`. -Originalplan unverändert. Frische passive1.1-Planung nach verifiziertem -Upgradeabschluss und exakt dessen Postsnapshot gebunden; tatsächlicher -simulierter WebUI-Klick0/0/0→1/1/1/0. Ergebnis succeeded/Nachbedingungen true, -`changed=false`, `already_desired=true`, `transaction_executed=false`, -`postcondition_already_met=true`. Keine weitere Pakettransaktion, Runtime und -native1.1-Acceptance unverändert. Separater apply_updates-Noop noch offen. - -## Erste1.1-Noop-Vorbereitung ehrlich abgewiesen — 2026-11-13 - -Separater tatsächlicher UI-`ensure_package`-Plan wurde vor Paketwirkung mit -`failed/STATUS_FINGERPRINT` geschlossen, Grantb7fbd250-c382-4d2f-950d-ae6001e4c48e, -Root13, eigenes0/0/0→1/1/1/0 und simuliertes Genehmigungsaudit erhalten. -Er benutzte exakt die passive Baseline und den Fingerprint VOR dem erfolgreichen -Upgrade, nicht dessen verifizierten1.1-Postsnapshot. Alter<90Sekunden genügte -hier nicht. Kein bestandener Noop; alter Versuch bleibt unverändert. Ein neuer -fester Plan muss frische passive1.1-Daten nach Updateabschluss binden. Provider, -Helper und native1.1-Acceptance werden dafür nicht verändert. MVP weiterhin offen. - -## Native APT1.0→1.1-Acceptance bestanden — 2026-11-13 - -Eigener fester WebUI-Plan auf der qualifizierten Runtimef40c/bbd2/1dc tatsächlich -genehmigt und auf der Cloud-VM ausgeführt: vor Genehmigung0/0/0, danach genau -1Job/1Outbox/1Grant und0offen. Grant6b68c65b-8c0c-4cab-964d-e12a2d7f0626, -Rootverbrauch12. Ergebnis succeeded, Nachbedingungen true; vollständiger -Paketbestand und Nutzdatei1.1 unabhängig geprüft, runtimegebundene native -Acceptancedatei erzeugt. Hostflag tatsächlich vorher/nachhertrue, -`reboot_required_introduced=false`, Ergebnis wahrheitsgemäß`reboot_required=true`. -Kein Reboot, kein OS-/Kernelupdate. Details und Recordhashes: -[apt-ambient-reboot.md](apt-ambient-reboot.md). -**MVP weiter offen:** beide getrennten1.1-Noops sowie Offline/Crash/MCP/Reboot. - -## Configurewirkung nativ gebunden abgeglichen, Abnahme ehrlich failed — 2026-11-13 - -Identitäts-/journalbewahrende Installation von Agent`f40c7e26…`, Helper`bbd2cf80…` -und Provider`1dc0237d…` auf der tatsächlichen Cloud-VM bestanden. Vorheriger -Readonly-Preflight prüfte exakt den offenen337-Versuch und ursprünglichen31- -Partial-Proof. Erhaltene DBbytes/Inodes, alle elf Grants, Active-/History-/Archive, -Marker und Generalpolicy vor dem Neustart nachgewiesen; neue kopierte native -dpkg-Sandboxprobe86e320fd-c06e-40d3-92c7-da4e7870cd74 bestanden. Keine Paketwirkung -durch Wartung oder Probe. APT-Endpunkt entfernt/inactive, Agent/General aktiv. - -SSH-Clienttimeout40Sekunden verlor die Installationsantwort. Kein zweiter Lauf: -gespeicherter Endbericht166630b0-bc96-4090-977a-574d35c8669d war bereits -`qualified_runtime_started/completed=true`. Unabhängige erneute Ablesung der -drei tatsächlichen Datei-SHAs und Dienstzustände bestätigte den Abschluss; -erst danach lokale Deploymentmetadaten einmalig finalisiert. - -Der neue Helper prüfte ausschließlich den ursprünglich signierten337-Auftrag, -gebundene alte Hook-/APT0-/Schema1-/Recoverymarker und die vollständige aktuelle -Paketbaseline zweimal unabhängig. Vollständig installed1.0, richtige Nutzdatei, -keine fremden Paketänderungen und gleicher Boot nachgewiesen. Originalunknown -und24-Feld-Proof append-only in eigener`apt_effect_reconciliations` erhalten. -Klassifizierung **failed/APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED**, -`effect_complete=true`, `postconditions_passed=false`, `reboot_required=true`, -historischer Host-Vorherwert ausdrücklich null. Keine rückwirkende Acceptance. - -Anschließender **gewöhnlicher signierter RootSync** schloss genau denselben -Verbrauch. Rein lesender Abschlussbericht bestand: Root11/0offen/0Faults, -Zentrale20Jobs/20Outbox/18Grants/0offen, result-/outcomebytes gleich, ursprünglicher -31/dc3-Proof erhalten, keine install-/recovery-Acceptancedateien erzeugt. -Private Belege`devstate/cloud-apt-recovery/configured-maintenance-*.json`, -`configured-reconcile-runtime.json` und`capacity-recovery/configured-closure-*.json`. - -Gezielt lokal qualifiziert:81Python-Tests ohne Skips einschließlich echtem -isoliertem APT-Protokoll,41Helperlibtests,3Inventarprüfungen,1Startupguard, -28VM-Adapterguards, Agent-/Helper-Alltargets-Clippy und Bookwormrelease. -Neue Fixturewirkungen erfassen Hostflag vor/nach der Wirkung außerhalb des -privaten`/run`; keine Flagänderung/kein eigenmächtiger Reboot erlaubt. -**MVP weiter offen:** native1.0→1.1-Acceptance, beide1.1-Noops, aktive Offlinefälle, -Prozessabbruch, abschließender MCP-Bericht und letzter eigener Rebootplan. - -## Automatischer Cloud-Fallback bestanden; neuer APT-Abgleich offen — 2026-11-13 - -Passiver Automatikfall `697b19ba-e7ff-4ebf-8a45-f5a0b0514fea` auf der bestehenden -Cloud-VM: zwei authentisierte WSS503, danach tatsächlicher HTTPS-Heartbeat und -signierter Sync. Hook auf beiden Serverrollen deaktiviert, anschließend normaler -WSS-Kanal durch kontrollierten Agentneustart wiederhergestellt. Identität und -Zähler19Jobs/19Outbox/17Grants/0offen unverändert. Ursprünglicher Runnerfehler -und ergänzende Verifikation desselben Falls bleiben erhalten; keine neue -Faultausführung. [Tatsächliche Details](transport-acceptance.md). - -Anschließender eigener Configure-only-Plan erhielt einen Grant und führte APT -einmal aus: gespeicherter Hook armed, Exit0, privates Sandboxflag false und -dpkg-Statuswechsel bis installed1.0. Hostflag `/run/reboot-required` war bei -Nachprüfung vorhanden; Provider verwarf pauschal mit -`FIXTURE_UNEXPECTED_REBOOT_REQUIRED`. Die damaligen Prechecks enthalten keinen -Host-Vorherwert. Deshalb bleibt Grant33775478-15b0-46ec-b059-44f500dbb0b6 ehrlich -unknown; keine rückwirkende erfolgreiche Acceptance. Rootpolicy am18:45:29UTC -deny-only geschlossen, keine neue Wirkung/Freigabe. Nächster Schritt ist ein -rein lesender, originalgebundener Abgleich und gewöhnlicher signierter RootSync. -Keine Wiederholung, kein Löschen des Neustartmarkers oder der Historie. -Private Originalbelege unter`devstate/cloud-apt-recovery/capacity-recovery/` -und`configure-attempt-{stored,witnesses}.json`. MVP weiterhin offen. - -## Journal-Kapazität nativ korrigiert, vollständige Historie erhalten — 2026-11-13 - -Der tatsächlich per simulierter WebUI genehmigte Configure-only-Plan wurde -zunächst nicht zugestellt und **expired** mit **0 Grants**, keinem lokalen -Versuch/Verbrauch und keiner Paketwirkung. Vorherige UI-Schema4-Erweiterung -mit elf gezielten Safetytests, Typecheck und Produktionsbuild bestanden; -Indexpublication verglich den unabhängig vor dem Build gesicherten alten -Indexhash. Browser prüfte tatsächlich feste Schema4-/Planbytes und 0/0/0 vor -Genehmigung. Dieser Lauf ist ausdrücklich keine Paketabnahme und bleibt erhalten. - -Ursache des geschlossenen Sync-Gates: Helperledger **67.076.096Bytes /16.376 -Seiten à4096Bytes** bei festem Connectionlimit16.384Seiten. Datenträger noch -rund21GB frei, Kerneluhr vertrauenswürdig, kein Executorlockinhaber. Nur erlaubte -gespeicherte Fehlercodezählungen der drei Projektdienste als operative -Bootstrapfehlermetadaten gelesen, keine Kundenlogs oder Paketdiagnose ausgeführt. -Isolierte tatsächliche VM-Kopie reproduzierte mit512KiB-Testschreiben -**SQLITE_FULL13** unter altem Limit und Erfolg unter neuem endlichem Limit. -Beide Transaktionen vollständig zurückgerollt; Kopieinhalte und Originalbytes, -Größe/Inode unverändert, keine ursprüngliche SQL- oder Paketmutation. - -Minimaler Default auf **256MiB pro Datei** angepasst;4096-Byte-Seiten explizit -geprüft. Kein unbegrenzter Modus oder Kompaktierungs-/Resetpfad. Helper meldet -echtes DiskFull ohne Rohsql als `JOURNAL_STORAGE_CAPACITY_BLOCKED`. -**Vier gezielte Kapazitäts-/Rollback-/Fehlerklassifizierungs-/Sequenztests**, -Agent-/Helper-Alltargets-Clippy und Releasebuilds bestanden. Neuer Agent enthält -außerdem die lokal geprüfte Startup-Unknown-Korrektur; eigentliche native -Abbruchabnahme weiterhin offen und unter `agent-crash-acceptance.md` getrennt. - -Native identitäts-/journalbewahrende Installation von Agent`2ce885cf…` und -Helper`332eae00…` bestanden, Provider`5ff260f7…` unverändert. Unabhängige Pins, -neue helpergebundene Runtime und kopierte dpkg-Sandboxprobe aktualisiert; -alle alten Reports versioniert. Vor normalem Neustart Agent-/Ledgerbytes und -Inodes, alle zehn abgeschlossenen Rootverbräuche, ursprünglicher Partial-Proof, -Marker/Active-/History-/Archive und Generalpolicy gleich. Danach gewöhnlicher -signierter Sync tatsächlich **bereit**, Helper **10 consumed /0offen /0faults**, -Zentrale **19 Jobs /19Outbox /17Grants /0offen**. Rootpolicy geschlossen, -APT-Endpunkt absent/Helperinactive; keine neue Paketwirkung durch Wartung/Probe. - -Details: [journal-capacity.md](journal-capacity.md). Private Belege -`devstate/cloud-apt-recovery/journal-capacity-copy-6e882a74-507a-4af0-8baf-8f9005e4ac08.json`, -`journal-capacity-runtime.json`, `journal-capacity-native-ready.json` und -ursprüngliches `cases/apt_configure_recovery/checkpoint-capacity-terminal.json`. -**MVP weiterhin offen:** neuer fester UI-Plan im getrennten Kapazitätsruntime- -Namensraum; ursprüngliche Genehmigung/abgelaufener Versuch werden nicht ersetzt. -Danach native Upgrade-/Noop- und übrige Offline-/Abbruch-/Fallback-/Rebootgates. - -## Abgelaufenes Clientzertifikat nativ auf TLS-Ebene verweigert — 2026-11-13 - -Isoliertes Schlüsselpaar ausschließlich auf der Cloud-VM, CSR öffentlich; -vorhandene CA ausschließlich auf dem endgültigen Server verwendet, Schlüssel -nicht exportiert. Abgelaufene und gültige Testleafs mit gleichem Issuer, -Subject, öffentlichem Schlüssel und Clientconstraints, isoliertem CA-Fixtureindex -und ohne Enrollment/Geräteregistrierung. Keine Uhränderung oder TLS-Abkürzung. - -Tatsächliche Cloud-Verbindungen als UID993: gültige Kontrolle vor/nachher -jeweils HTTP401 nach erfolgreicher normaler CA-/Namensprüfung; abgelaufenes -Leaf **SSLV3_ALERT_CERTIFICATE_EXPIRED**, keine HTTP-Antwort. Beide positiven -Kontrollen sahen denselben echten Serverzertifikatfingerprint. Testidentität -vor/nachher **0 Registrierungen / 0 Jobs / 0 Outbox / 0 Grants**. Permanente -Geräteidentität/Zertifikatsselektor in Hash und Inode unverändert, bestehende -CA unverändert. Tatsächliches Development-Gateway zusätzlich ausschließlich -über die beiden festen Profil-/Authflags lesend geprüft; kein Produktionslauf. - -Vollständiger tatsächlicher Nachweis und Grenzen: -[tls-expiry-acceptance.md](tls-expiry-acceptance.md). **MVP weiterhin offen**: -APT-Konfiguration noch nicht ausgeführt; Queueschritt blockierte vor Start an -Helperjournal-Kapazität. Offline-/Abbruch-/Fallback-/Rebootnachweise folgen. - -## Ursprünglicher Recovery-Inventar-Replay nativ angenommen — 2026-11-13 - -Nach aktiviertem neuen Runtime-Endpunkt erzeugte der Agent korrekt die separate -Recovery-Beobachtung. Der bisherige Inventarvalidator erlaubte in Scopezeichen -nur Kleinbuchstaben, Punkt und Unterstrich; `linux.apt.recovery-planning` -wurde deshalb abgewiesen. Der erhaltene dauerhafte Inventar-Replay steht vor -RootSync und blockierte so den Kanal trotz gesunder, untätiger Helper. Noch -kein Configure-Plan/Antrag/Job erzeugt; zehn Rootverbräuche abgeschlossen, -beide Journale faultfrei. Operative Prozess-/Kernel-Wartezustände ausschließlich -der drei Projektdienste geprüft, keine Kundeninventur oder fremden Logs erhoben. - -Minimal korrigiert: **ausschließlich** dieser exakt definierte Linuxscope -zusätzlich erlaubt. Andere Bindestrichnamen, Suffixe und Windowskontexte bleiben -verweigert. **13 Domaintests,2 gezielte Servertests**, Format und Domain-/Server- -Clippy bestanden. Keine neue allgemeine Scopefreigabe oder Payloadumschreibung. - -Tatsächlich neuer ARM64-Build und bewusstes Deployment bestanden. Danach nahm -der endgültige Server **die ursprüngliche** Inventarnachricht an: gleiche -Message-ID/Snapshot-ID, gleicher normalisierter Envelopehash und dieselbe -Erhebungszeit. Nativer ACK entfernte nur deren unbestätigten Outboxeintrag; -anschließender gewöhnlicher signierter Sync bereit, Verbindungsgeneration73. -Kein Reset, neues Enrollment, ausgetauschter Messzeitpunkt oder Ersatzpayload. -Private Belege `devstate/cloud-apt-recovery/inventory-replay-{before,after}.json`. - -Zudem konkretes Build-/Runtime-Risiko begrenzt: Serverbuilds erhalten jetzt -einen eindeutigen Kandidatentag samt aufgezeichnetem Imagedigest. Erst ein -explizites geprüftes Deployment bewegt den Runtimetag. Nativ geprüft: gesamter -abgeschlossener Build `96063e93-c71f-4cc7-b7e1-8622e26bed9b` ließ den Runtimetag -unverändert; danach bewusste Übernahme desselben aufgezeichneten Digests. -Ein weiterer Kandidatenbuild verändert die laufende Runtime nicht. - -**MVP weiterhin offen:** Wiederherstellungswirkung noch nicht ausgeführt. -Als Nächstes neuer fester Configure-only-Plan, danach separate Upgrade-/Noops -und restliche Offline-/Abbruch-/Transport-/Rebootgates. - -## Neue Configure-only-Runtime nativ qualifiziert; Paketwirkung noch offen — 2026-11-13 - -Configure-only-Vertrag implementiert und lokal geprüft: Schema4 mit exaktem -Originalgrant/-versuch/Partial-Proof, Schema2 `configure_only`, ausschließlich -Fixture1.0 konfigurieren. Eigene Recoverymarker/-Records, keine Freshinstall- -Acceptance und kein Überschreiben alter Marker. Frische eigene authentisierte -Recovery-Planung; normale Paketplanung/Closure bleibt strikt. Native neue -Paketwirkung durch diesen Abschnitt **noch nicht ausgeführt**. - -Tatsächlich lokal **75 Python-Tests ohne Skips** im isolierten schreibgeschützten -UID1000-Container, einschließlich echtem APT2.6.2-Protokoll und kontrolliertem -Fake-dpkg ohne Paketwirkung: ausschließlich `=`/CONFIGURE und exaktes -`--configure rmm-mvp-test:all`, kein Unpack/Remove/Pending; reale/kopierte -Statusdateien unverändert. Qualifikation Rust: **12 Domain,37 Helper-Library, -3 Helperbinary,21 RootSync,24 Agentbinary,18 Agent-Reconcile-Tests**; -Format/Clippy `-D warnings` und Releasebuilds bestanden. Betroffene bestehenden -Cloudadapterguards: **28 bestanden**, Python-/Node-Syntax geprüft. - -Neuer ARM64-Serverbuild und bewusstes Deployment auf endgültigem Server -bestanden, keine neuen Jobs/Freigaben. Auf Cloud-VM anschließend qualifizierte -Artefakte versioniert installiert: Agent `44ae9115…`, Helper `ab7bbc87…`, Provider -`5ff260f7…`; tatsächliche Loaderchecks bestanden. Native Sandboxprobe an exakt -kopierter vorhandener dpkg-Datenbank mit Teilzustand bestanden, echte neue -Configure-/No-Pending-Konfiguration und Runtimepins geprüft. Alle zehn bekannten -abgeschlossenen Rootgrants, beide Marker, ursprünglicher Partial-Proof und -Active-/History-/Archivebytes erhalten. Agent-/Ledgerbytes und Inodes vor -Normalneustart nachweislich gleich, Generalpolicy unverändert. Danach normale -Agent-/Generalhelperaktivität; APT-Endpunkt bleibt absent/Helper **inactive**. -Keine neue Pakettransaktion oder Acceptance durch Wartung/Probe. - -Die erste Vorprüfung stoppte korrekt vor Austausch an einem Orchestrator- -Codecfehler: gespeicherter Request hatte sortierte JSON-Objektschlüssel, -Originalhash verwendet die Rust-Strukturreihenfolge. Exakten fünfteiligen -Requestcodec wiederhergestellt; danach ausdrücklicher mutationsfreier -`--preflight-only` mit identischen Zeugen bestanden, erst dann versionierter -Upgrade-/Probelauf. Keine Lockerung der Originalhash-/Signaturprüfung und kein -Wiederholen eines teilweise mutierten Installationslaufs. - -Geschützte Nachweise `devstate/cloud-apt-recovery/configure-runtime.json`, -`runtime-upgrade-*.json` und VM-seitige versionierte Bootstrap-Historie. -**MVP weiterhin offen:** jetzt neuer fester tatsächlich UI-genehmigter -Configure-only-Plan, danach separater Upgrade-/Noopnachweis und restliche Gates. - -## Nativer Verlust einer Ergebnisbestätigung bestanden — 2026-11-13 - -Beim eng gebundenen WSS-Fall nach tatsächlicher simulierter UI-Genehmigung -zuerst Ergebnis dauerhaft gespeichert, dann genau dessen ACK ausgelassen. -Der echte Agent wiederholte nach knapp5Sekunden dieselbe ursprüngliche -Resultnachricht: gleiche ID und normalisierter Hash. Gewöhnlicher nächster ACK -beendete den Replay, ursprüngliches Ereignis im nativen Journal nicht mehr -unbestätigt. Ein Grant, ein Versuch/Verbrauch, eine Wirkung; eigener separat -UI-genehmigter Lesejob bestätigte tatsächlichen Zähler1. Beide Pendinggates -0/0/0 und Auditbindungen geprüft, keine offenen Versuche. - -Beide laufenden Serverrollen anschließend unabhängig mit deaktiviertem -Faultflag und ohne FILE geprüft. ARM64-Parallelbuild bis Testabschluss unfertig, -kein unbeabsichtigter Imagewechsel. Vollständiger Beleg und Grenzen: -[delivery-acceptance.md](delivery-acceptance.md). Entdecktes veränderliches -Buildtag-Risiko in [post-mvp.md](post-mvp.md); Runtimewechsel bis dahin strikt -koordiniert. **MVP weiterhin offen**: Prozessabbruch-/Offline-/APT-/Rebootgates -werden als Nächstes bearbeitet, keine vorgezogenen Zusatzfeatures. - -## Begrenzte Root-Logs und gleiche UI/HTTP/MCP-Lesesicht bestanden — 2026-11-13 - -Neuer fester Cloud-Plan für `query_logs`, ausschließlich -`rmm-mvp-test.service`, genau 300 Sekunden aus dem bereits genehmigten früheren -Testdienstlauf, höchstens50Zeilen/65536Bytes. Kein Dienststart nur zur Erzeugung -von Testlogs. Kurzlebige Rootpolicy erlaubte ausschließlich diese eine -Logquelle: keine Rootskripte, Dienständerungen, APT oder Reboots. Unabhängiger -Generalhelper-Readinessbeleg ohne Wiederaktivierung des APT-Endpunkts. - -Vor dem tatsächlichen simulierten WebUI-Klick 0/0/0, danach genau1/1/1, -Nachbedingungen bestanden. Tatsächlich **vier JSON-Journalzeilen**, Quelle -`/usr/bin/journalctl`, Unit exaktgebunden, Erhebungszeit -`2026-11-13T16:50:04.641161226Z`. Qualität valid, Abdeckung bewusst **partial**, -`JOURNAL_ACCESS_COVERAGE_AND_CURSOR_UNVERIFIED`; kein behaupteter vollständiger -Journalzugriff oder persistenter Cursor. Keine Rohlogs in Git/Chat. - -Danach denselben gespeicherten Job per tatsächlichem UI-Klick geöffnet und -seine natürliche HTTP-Antwort beobachtet: vollständiger Job-/Ergebnis-DTO -exaktgleich zu MCP `jobs.get`. MCP `logs.query` mit `live=false` lieferte genau -denselben Job und dasselbe Ergebnis samt ursprünglichen Quellen-/Zeitwerten. -MandantB auf A-Logkontext tatsächlich verweigert. Kein neuer Diagnosejob für -Lesekonsistenz, keine direkte API-Genehmigung. Testlogpolicy abschließend -kontrolliert geschlossen; APT-Endpunkt weiterhin inactive. - -Geschützte Nachweise `devstate/cloud-root/cases/query_logs/` und -`devstate/cloud-logs/{policy-open,policy-closed,mcp-read,read-evidence}.json`. -Python-/Node-Syntaxprüfung und tatsächliche Browser-Vorbereitung, Genehmigung -sowie Lesesicht bestanden. **MVP weiterhin offen**: weitere Fehler-/Offline-/ -APT-/Rebootgates bleiben bestehen. - -## WSS-Doppelzustellung nativ bestanden — 2026-11-13 - -Tatsächlich denselben WebUI-genehmigten Offer mit identischen Bytes/ID doppelt -über WSS zugestellt; zwei unterschiedliche echte Client-Annahmebestätigungen -und vier unveränderliche Audit-Slots. Ein Versuch, ein Grant/Verbrauch, eine -Wirkung; Exit0, Postcondition und stdout `RMM_DELIVERY_COUNT=1`. Nach Deaktivierung -des Adapters bestätigte ein separater fester, erneut tatsächlich UI-genehmigter -Lesejob den erhaltenen Zähler exakt1. Beide Anträge vor Klick0/0/0, danach je -1/1/1, sichtbare simulierte Principal-/Auditbindung geprüft. Beide laufenden -Serverrollen anschließend tatsächlich Adapterflagfalse/FILEfehlt. - -Quellen und vollständiger tatsächlicher Nachweis samt Grenzen: -[delivery-acceptance.md](delivery-acceptance.md). **MVP weiterhin offen**: -ACK-Verlust/Abbruch, APT-Recovery/Upgrade/Noops, begrenzte Logs und weitere -Gates noch nicht durch diesen Zustellungsnachweis abgenommen. - -## Gebundener nativer APT-Teilwirkungsabgleich bestanden — 2026-11-13 - -Nach der signierten Kontrollreparatur die qualifizierten Artefakte -identitäts-/journalbewahrend installiert: Agent `988c62fd…` mit bestätigtem -Sync-Anker, Readonlyhelper `5ad30cdf…`, Provider `edd1950d…`. Echter VM- -Loadercheck bestanden, alter Agent/Helper/Provider/Metadaten versioniert gesichert. -Originalmarker, Retrymarker, Archive, Active-/History-Kontexte, beide Journale, -Ledgerdateiinode, ursprüngliche Unknownbytes und General-Policy unverändert -vor dem Start geprüft. APT-Endpunkt aus Agentkonfiguration entfernt und -APT-Helper bleibt **inactive**; nur Generalhelper und unprivilegierter Agent aktiv. - -Der unabhängige Helper prüfte tatsächlich den vollständigen gebundenen -Paketbestand samt Originalauftrag/Hook/APT0/Archiv/Payload und beiden Markern. -Genau ein append-only Teilwirkungsbeleg mit erhaltenen alten Unknownbytes; -Proof SHA256 `dc3bf3870ea77c12f9291bac712c53ae72194eaec980a8646155a7fb5c0dbe21`. -Anschließender normaler signierter RootSync übernahm das höhere dauerhafte -Ergebnis für **denselben ursprünglichen Versuch** und schloss nur dessen -Verbrauch. Kein Bootstrap-Unlock und kein neues Job-/Paketkommando. - -Tatsächlicher Ausgang **failed / APT_PARTIAL_UNCONFIGURED_VERIFIED**, -`partial_effect=true`, `postconditions_passed=false`, Fixture **1.0 / install ok -unpacked**. Das ist keine Installations-/Paket-Acceptance. Helperledger jetzt -**9 consumed / 0 unresolved / 0 faults**, zentrale Zähler unverändert -**13 Jobs / 13 Outbox / 12 Grants**, jetzt **0 unresolved**. Normale signierte -Bereitschaft wieder möglich; Rootpolicy weiterhin geschlossen. Originale -Testmarker/History bleiben erhalten, keine blind wiederholte Wirkung. - -Der Remote-Upgradeablauf bestand vollständig. Anschließend verweigerte der -lokale Create-only-JSON-Schreiber das Überschreiben des alten Deploymentrecords; -das betraf nur lokale Metadaten. Remotebericht und tatsächlicher neuer -Agenthash erneut geprüft, alter Record separat gesichert und neuer Record -atomar veröffentlicht. Kein zweiter Upgrade-/Abgleichlauf. Private Belege: -`devstate/cloud-apt-recovery/install-2702f94c-2a40-47b3-91cc-80fb85fe5931.json`, -`readonly-result-first.json`, `readonly-central-result.json`. - -**MVP-Prüfung: weiterhin offen.** Gate0 ist geschlossen. Gate1 benötigt einen -neuen explizit WebUI-genehmigten Configure-only-Wiederherstellungsplan und danach -separate native Upgrade-/Noopnachweise. Parallel ausschließlich notwendige -M2/M3-Fehler-/Logstrecken; keine Featureausweitung nach Windows/PVE/M7. - -## Signierte Kontrollkettenreparatur auf Cloud-VM bestanden — 2026-11-13 - -Der qualifizierte Root-Bootstrap prüfte native gespeicherte Agent-/Helper- -Historien und fertigte begrenzte Zeugen an; alle drei SQLite-Dateien blieben -bei dieser Vorbereitung bytegleich. Agent und beide Helper kontrolliert gestoppt, -keine Paketmanagerwirkung unterbrochen. Der neue ARM64-Serverbuild und das -Deployment bestanden; exakte ursprüngliche APT-Evidenz und Zähler vor/nach -Serverwechsel gleich. DB/PKI/Geräteidentität nicht ersetzt. - -Server-CLI `repair-unsent-sync-request` prüfte ursprüngliche signierte Ablehnung, -noch vorhandenen gültigen Serverhead, fehlenden ungesendeten Vorgänger, -Geräte-/Boot-/Generationsbindung und geschlossene Rootpolicy. Bestehende -wirkungslose Ablehnung monoton zum gemeinsamen Kontrollhead übernommen; -separate kurzlebige Signatur `rmm.sync.unsent-request-repair` ausgestellt. -Kein neuer HTTP-Endpunkt, keine interaktive Freigabe vorgetäuscht. - -Native unabhängige Verifier akzeptierten ausschließlich die exakten Zeugen. -Danach tatsächlich **0 Agentfaults / 0 Helperfaults**, jeweils **eine dauerhaft -archivierte Reparaturquittung**, beide Integritätsprüfungen ok. Verbrauchsledger -weiter **9 / 1 unresolved**, Zentrale weiter **13 Jobs / 13 Outbox / 12 Grants / -1 unresolved**. Keine Ready-Lease, Jobs, Grants, Outcomeänderung oder neue -Paketwirkung. Alle drei Dienste bleiben bis zum nachfolgenden qualifizierten -Agent-/Readonlyhelperwechsel gestoppt. APT weiterhin unknown; die -Kontrollreparatur ist ausdrücklich keine Paketabnahme oder Wiederholungsfreigabe. - -Lokale Prüfungen dieser Quittungsstrecke: **1 CLI-Historienmutationstest, -34 Helper-Library- und 21 RootSync-Tests**; Server **3 gezielte Prüfungen mit -frischem isoliertem PostgreSQL**, einschließlicher verweigerter manipuliert/ -veraltet/falsch gebundener Zeugen und unveränderter Null-Jobartefakte. -Format/Clippy `-D warnings` und Releasebuild bestanden. Außerdem fünf gezielte -Guards für eng begrenzte Entwicklungs-Wirefaults geprüft; deren native -Duplicate-/Lost-ACK-Abnahme steht weiterhin aus. - -Ein erster lokaler Quittungsaufruf stoppte am normalen 1-MiB-DTO-Limit für die -vollständigen historischen Zeugen, noch vor Serverzugriff. Separater begrenzter -Private-Dateileser ergänzt (Owner, 0600, keine Symlinks/Hardlinks, maximal45MiB); -identische ursprüngliche Zeugen anschließend erfolgreich verwendet. Geschützt: -`devstate/checkpoint-chain-repair/2c5c3f06-a10e-40de-a02c-3c8009bc034f/` und -`devstate/server-upgrades/2f6144c6-fcd5-49cb-9634-0d6e0b898165*`. - -**MVP-Prüfung: weiterhin offen.** Nächster Schritt ist der ausschließlich -lesende, an den ursprünglichen APT-Auftrag gebundene Teilwirkungsnachweis und -seine Übernahme über den normalen signierten Sync, erst danach ein neuer -WebUI-Wiederherstellungsplan. Weitere Gates: `mvp-gates.md`. - -## Nicht persistierter Sync-Request als MVP-Blocker eingegrenzt — 2026-11-13 - -Vorprüfung des geplanten Readonly-APT-Helperupgrades stoppte **vor jeder -Datei-/Dienständerung**: Agent und Sharedhelper tragen -`CHECKPOINT_CHAIN_MISMATCH`. Installierte Helper-/Providerhashes unverändert, -alle drei Dienste aktiv, keine Upgrade-Backups/Installation angelegt. Gespeicherte -Checkpointmetadaten ausschließlich gelesen, keine Fault-, Ledger- oder -Identitätsrücksetzung. Rootpolicy weiter geschlossen, APT weiterhin unknown. - -Gespeicherte Kette zeigt: Ein lokal dauerhaft vorbereiteter Request wurde -serverseitig nicht committed. Der folgende Request referenziert diesen -unsicheren Vorgänger, lässt aber den tatsächlich bekannten letzten signierten -Anker weg. Der Server findet den Vorgänger nicht, behandelt dies als Kettenfehler -und überschreibt zusätzlich den präziseren Grund mit Chain-Mismatch. Beide -lokalen Journale haben die signierte Ablehnung bereits gespeichert; der Server -hält noch den älteren gültigen Head. Dies ist ein Fehler im aktuellen -MVP-Wiederverbindungspfad, keine nachgelagerte Erweiterung. - -Prävention implementiert: Agent behält bestätigten Anker **und** unsicheren -Vorgänger; Server benutzt einen tatsächlich gespeicherten Vorgänger, sonst nur -den expliziten noch passenden bestätigten Anker. Exakter Vergleich mit dem -autoritativen Serverhead bleibt Pflicht. Fehlender/veralteter Anker wird -weiter verweigert; Fehlergrund bleibt präzise. **18 Agent-Reconcile- und -2 Server-Sync-Tests**, Format und Clippy mit `-D warnings` bestanden. -Diese Prävention ist noch nicht auf Cloud ausgeliefert und löscht keine Sperre. - -Zusätzlich gebundener Readonly-APT-Verifier implementiert: vollständige Baseline -plus ausschließlich Fixture1.0 `unpacked`, original signierter Auftrag, -Kontext/Hook/APT0 und beide unveränderten Marker. Immutable alte Unknownbytes -und neuer Prüfbeleg werden angehängt; nur bestehender signierter RootSync darf -danach den einzelnen Verbrauch schließen. **70 Python-Tests** sowie -**31 Helper-Library / 3 Binary / 20 RootSync-Tests**, Format/Clippy/Releasebuild -bestanden. **Noch keine native Verifierabnahme**, weil die Kettensperre vorher -korrekt blockierte. Kein Paket-/Configure-/Retryaufruf ausgeführt. - -Nächster zwingender Schritt ist eine getrennt signierte, exakt an diese -gespeicherten Zeugen gebundene Kontrollquittung: vorhandene wirkungslose -Ablehnung als gemeinsamen Head ausrichten, alte Sperre und alle Zeugen dauerhaft -archivieren, weder Outcome/Grant noch Bereit-Lease ändern. Danach gewöhnlicher -Sync und erst dann der gebundene APT-Abgleich. Keine manuelle SQL-Faultlöschung. -Private Metadaten: `devstate/cloud-apt-recovery/sync-chain-{vm,server}.json`. - -**MVP-Prüfung: weiterhin offen; Kettenreparatur hat Vorrang vor Paket-Recovery.** - -## Linux-TLS-Lebenszyklus nativ geprüft; MVP bleibt offen — 2026-11-13 - -Auf derselben erlaubten Cloud-Linux-VM eine **separate ausschließlich passive -Testidentität** unter dem bereits maskierten Agent-Statepfad verwendet. Kein -Jobbinding/Roothelper, Capabilities ausschließlich `linux.base/1`, `heartbeat/1`; -kein Ersatz der dauerhaften Geräteidentität und kein Entkommen aus deren -offener APT-Wirkung. Eigenes unprivilegiertes Testsystemd-Service, zeitlich -begrenzt und nach Prüfung gestoppt; Identität/Journale für Nachvollziehbarkeit -erhalten und abschließend tatsächlich per WebUI widerrufen. - -Tatsächlich ausgeführt (`deploy/cloud_lifecycle_acceptance.py`): nativer Agent -verweigert vor Enrollment sowohl falschen TLS-Namen als auch nicht vertraute -CA, keine Geräteidentität angelegt, einmaliger Enrollmentnachweis danach -serverseitig noch unbenutzt. Positive Kontrolle mit korrektem Namen/CA enrollte -denselben Testlauf erfolgreich. Bestehender Development-Rotationstrigger -verwendet, keine Systemuhr-/Grant-/TLS-Prüfung verändert. Neuer privater Schlüssel -nur auf der VM; neue Zertifikatsversion, gleiche Agent-/Asset-/Enrollment-IDs -und tatsächlicher neuer mTLS-Peerfingerprint serverseitig bestätigt. Trigger -danach entfernt, Tokenkopie gelöscht, gleiche Identität normal wiederverbunden. - -Anschließend tatsächlicher UI-Widerruf mit sichtbar simuliertem Principal, -Bestätigungskennung und explizitem Klick; Audit mit -`dev_test_browser_simulation`/`testsimulation=true`. Kanal geschlossen und -Wiederverbindungsversuche beobachtet; nach Widerruf keine neue Authentisierung -oder Kontaktauffrischung. Testgerät **0 Jobs / 0 Outbox / 0 Grants / 0 offene -Versuche**. Native Testservice anschließend gestoppt. Der erste Freigabebrowser -stoppte vor dem Widerruf an einem nicht vorhandenen DTO-`tenant_id`; korrigiert -auf tatsächlich ausgewählten UI-Mandanten plus feste Asset-/Agentbindung. -Keine API-/DB-Widerrufsabkürzung, keine Jobgenehmigung durch diese Lifecycleaktion. - -Gesamte gespeicherte APT-Unknown-Evidenz der dauerhaften Identität vor/nachher -exakt gleich; weiterhin **13/13/12/1**, Rootpolicy geschlossen. Geschützte -Nachweise `devstate/cloud-lifecycle//`. Die reine TLS-Lifecycleprüfung -ersetzt keine Genehmigungsentzug-/Startfristprobe mit tatsächlichem Job. - -**MVP-Prüfung nach diesem Teilerfolg: nicht vollständig.** Als Nächstes der -gebundene APT-Abgleich, dann begrenzte Wiederherstellung/Paketabnahme und die -weiteren [MVP-Gates](mvp-gates.md). Spätere Entdeckungen sind unter -[post-mvp.md](post-mvp.md) erfasst; keine Windows-/PVE-/Produktionsausweitung. - -## Windows-Passivstrecke auf tatsächlichem Gast abgenommen — 2026-11-13 - -Additive Migration 0013 nach erneutem tatsächlichem ARM64-Serverbuild und -erfolgreichem Migratorlauf auf endgültigem Cloudserver angewendet. Sie erlaubt -ausschließlich `linux.base` und `windows.base`, keine beliebigen Quelllabels. -Die ursprüngliche Windows-Inventarnachricht wurde aus dem dauerhaften Journal -erneut zugestellt und gespeichert: ursprüngliche Erhebungszeit erhalten, -Empfangszeit separat; Quelle `windows.base`, native Windowsdaten und Inodes -`null`. Kein Neuerheben als vermeintlicher Replaybeleg, kein Identitätsreset. - -Tatsächlich bestätigt: SCM-Dienst **LocalService / Prozessowner S-1-5-19**, -Enrollment und ausgehendes mTLS/WSS zum endgültigen Server, gespeichertes -Inventar, zwei verschiedene frische Heartbeats und `online`. Mandant B sah -weder über A-Kontext noch eigene Mandantensicht das fremde Asset. Windows- -Gerät **0 Jobs / 0 Outbox / 0 Grants / 0 offene Versuche**; dies ist passive -Standardtelemetrie und keine Jobfreigabe. Zusätzliche native Readonly- -SQLite-Prüfung: Integrität ok, gleiche Geräteidentität, **0 ausstehende -Inventarereignisse** nach konkretem ACK. - -**Sieben native Windows-Rusttests bestanden**: drei Transport-/Namensguards, -drei Bibliothekstests mit echtem Win32-Inventar, unabhängigen stabilen CIM- -Bootabfragen, Journal-Reopen/Sequenz/Prozesssperre/ACK/Identitätsbindung sowie -ein ACL-Integrationstest. Dieser prüft korrekte ACLs und verweigert breite/ -NULL-DACLs, falschen Pfadtyp und Reparse-Points ausschließlich auf neuen -nichtgeheimen Tempfixtures. Windows-target Alltargets-Clippy mit `-D warnings` -bestanden. Eigener Buildcontainer entfernt. - -Frischer isolierter PostgreSQL-Test aller Migrationen 1–13 bestand: bestehende -Linuxzeile bytegleich, Windows erlaubt, beliebiger Scope verweigert, Tenant-/ -Missing-context-RLS und zusammengesetzter Geräte-FK erhalten, Null-Jobgate. -Serverwechsel prüfte **vor/nachher exakt unveränderte** vorhandene APT-Kontexte, -Marker, Loghashes, Ledger-Outcomes und zentrale Zähler **13/13/12/1**. Derselbe -Linux-Versuch bleibt unknown, Rootpolicy geschlossen; keine Freigabe/Entsperrung -durch Migration oder Serverneustart. - -**Grenzen:** unsignierter Windows-Entwicklungsbuild, kein Jobexecutor/Helper, -native Windows-HTTPS-/Rotation-/Installer-/Paketabnahme offen. Registry liefert -auf dem unabhängig als Windows 11 bestätigten Gast den Legacy-Produktnamen -„Windows 10 Pro“; dieser Rohwert wird sichtbar erhalten, keine erfundene -Marketingnormalisierung. Detailquellen und Abnahmekontext: -`deploy/windows/CLIENT.md`; [Plattformmatrix](platform-support.md). -Private Belege unter `devstate/windows-client/` und -`devstate/server-upgrades/*.unknown-preserved.json`. - -## APT-Unpack-only-Ursache lokal korrigiert, Cloud weiter gesperrt — 2026-11-13 - -Feste APT-Konfiguration ergänzt um -`dpkg::selection::remove::approved=false`. Damit bleibt die explizite -Konfiguration des im Plan gebundenen Pakets erhalten. `ConfigurePending=false` -und `TriggersPending=false` bleiben bestehen; Hook verlangt alle drei Werte -eindeutig, fehlende/abweichende Werte führen zum Veto. Kein allgemeines -`--configure --pending`, keine Fremdpaketkonfiguration oder stiller Reparaturpfad. - -**67 Python-Tests bestanden**, einschließlich echtem APT-Argumentvergleich im -isolierten readonly/offline-Container als UID 1000. Dort **APT 2.6.2**, nicht die -Cloudversion 2.7.14: Original nur `--unpack` des exakten Fixturearchivs; Korrektur -zusätzlich ausschließlich `--configure rmm-mvp-test:all`. Unabhängiger -dpkg-Wrapper delegiert nur einzeln erlaubte Readonly-Queries, simuliert sämtliche -Wirkungsaufrufe und zeichnet argv auf. Keine Pending-/Trigger-/Remove-/Purge- -oder Fremdpaketaufrufe; echte und kopierte Statusdatei bytegleich. Test ist -ausdrücklich opt-in `RMM_APT_ARGUMENT_REGRESSION=1`. Erster Containerlauf hatte -eine veraltete Unit eingebunden und scheiterte korrekt am Clock-Pin; mit -aktueller readonly-Unit alle Tests bestanden, kein Guard abgeschwächt. - -Sourceprovider `3977c2c0ad68823a372cf8e66d050642ff8e15162260d5809b7e46e58999f455`, -Sourceconfig `18ba7b2fe65ff557a86acdf87a0cc0f004d56202a104e0fb0d416c998d413b95`. -**Nicht auf Cloud installiert, kein neuer Helper-/Agentbuild und keine native -Cloudabnahme dieser Konfiguration.** VM weiterhin Provider `465ac5ed…`, alter -Runtimepin unverändert. APT-Versuch weiterhin unknown/teilweise ausgeführt, -kein Paketretry oder Configure-Reparaturaufruf. Vor weiterer Wirkung sind ein -signierter, rein prüfender Abgleich der gespeicherten Teilwirkung und ein neuer -fest gebundener UI-Plan für eine begrenzte Wiederherstellung erforderlich. -Bestehende Unknown-/Restore-/Rootfences bleiben aktiv. - -## Neuer APT-Versuch: Hook/APT bestanden, Nachprüfung unknown — 2026-11-13 - -**Kein Paketerfolg und keine Linux-MVP-Abnahme.** Neuer fest gebundener -Schema-3-Versuch tatsächlich durch die dev/test-WebUI vorbereitet; separater -Freigabebrowser verglich zuerst irrtümlich auch das veränderliche -Antragsmetadatum `approval_state`. Er stoppte vor dem Klick; mehrfach gespeicherte -0/0/0 belegen keine Wirkung. Vergleich korrigiert: `null` vor Submit und -`pending_approval` danach ausdrücklich prüfen, **alle übrigen Felder und exakten -Plan-/Jobbytes unverändert vergleichen**. Derselbe bestehende Antrag wurde -anschließend einmal tatsächlich per UI genehmigt, kein weiterer Plan/Versuch. - -Vorher 0/0/0, danach **1/1/1**. Audit -`approval_origin=dev_test_browser_simulation`, `testsimulation=true`, -`simulated-testprincipal-a`, gebundener Planhash. Der neue Helper verifizierte -den ursprünglichen Fehler und signierten Auftrag, verschob den alten `active/` -in unveränderte Historie und schrieb einen eigenen Create-once-Retrymarker. -Ursprünglicher Marker weiterhin -`ec84aa4df8065f0b54b282bd273a6f342f07a6d47312289608389d05c7fb6053`. - -Native Sandbox-/Lock-/Syscallprüfungen bestanden, Hook tatsächlich armed, -**APT Exit 0**, kein Rebootflag. Gebundene unabhängige Nachprüfung verweigerte -jedoch `DPKG_INCONSISTENT`; Rootledger behält **unknown**, Zentrale zeigt -`unknown / SYNC_EFFECT_UNRESOLVED`. Gespeicherte dpkg-Logs belegen ausschließlich -`half-installed -> unpacked` für Fixture 1.0, keinen Configure-Aufruf. Kein -nativer Acceptancebeleg oder gestagter Ersatzbeleg. Vorhandene Logs nur gelesen, -keine neue Live-Paketdiagnose über SSH und kein Shell-APT/dpkg-Reparaturaufruf. - -Die konfigurierte Sperre `DPkg::ConfigurePending=false` trifft auf APTs -standardmäßiges `dpkg::selection::remove::approved=true`: dieser Pfad entfernt -explizite Configure-Aktionen und ergänzt sonst ConfigurePending. Das erklärt -den beobachteten Unpack-only-Lauf; Primärquelle: -[APT 2.7.14 dpkgpm.cc](https://github.com/Debian/apt/blob/2.7.14/apt-pkg/deb/dpkgpm.cc#L1626-L1657). -Eine begrenzte Korrektur muss explizites Configure des genehmigten Pakets -erhalten, **kein** allgemeines `--configure --pending` erlauben. Neue lokale -Regression und sichere gebundene Wiederherstellung des teilweise ausgeführten -Versuchs sind offen; kein blindes Retry/Upgrade/Noop gegen diesen Zustand. - -Zähler Linux **13 Jobs / 13 Outbox / 12 Grants, 1 unresolved**; Sharedledger -**9 consumed / 1 unresolved**, alle ursprünglichen Tombstones erhalten. -Neue Root-Testpolicy geschlossen, Helper bleiben zur unbekannten Wirkung und -zum signierten Abgleich erhalten. Geschützt: -`devstate/cloud-apt-retry/apt_install_retry/{checkpoint,stored-evidence,stored-log-evidence}.json`. - -## Windows: native Probe und erster Dienstkontakt — 2026-11-13 - -Neuer passiver Windows-Client mit gemeinsamem Domain-/Protobuf-/TLS-/WSS-/HTTPS- -Vertrag. GNU-x64-Crossbuild Debug/Release und Windows-target Clippy bestanden; -native Probe wirklich auf Windows 11 Pro 10.0.26300 x64 bestanden: Win32-Hostname, -Systemvolume, CIM-Bootkennung, keine erfundenen Inodes. Artefakt -`31e360e50b177b4d5729d24e436d4f25aeed7b1a7bd35f2a129841ba1abffd37`. -Anschließend tatsächlicher SCM-Dienst als **LocalService (S-1-5-19)** gestartet, -Geräteschlüssel ausschließlich im Gast erzeugt, Enrollmenttoken entfernt; -mTLS-Hello und frischer Heartbeat serverseitig online bestätigt. - -**Inventar noch nicht gespeichert:** native Integration deckte den alten -SQL-Check `source_id='linux.base'` auf. Additive Migration erforderlich; die -bestehende Windowsidentität und durable Inventarnachricht bleiben erhalten. -Native Windows-Testprogramme bislang nicht erfolgreich abgeschlossen. Kein -Jobexecutor/Helper, keine Jobcapability oder Genehmigungsabkürzung; erster Build -unsigniert. Notebook-Host weiterhin ausschließlich Entwicklung. Detailvertrag -und ausgeführte/geplante Befehle: `deploy/windows/CLIENT.md`. - -## Cloudserver und Linux-Agent aktualisiert, ohne neue Jobs — 2026-11-13 - -Versionierter Cloudserver-Sourceupload/ARM64-Releasebuild tatsächlich erfolgreich, -Migrationen erfolgreich und API/Gateway auf neues Image gewechselt. PostgreSQL, -PKI und Gerätehistorie erhalten. Neue Inventarvalidierung unterscheidet explizit -`linux.base` und `windows.base` samt gemeldeter Capability; Windows erfindet -keine Inodes. API übernimmt die gespeicherte Quelle statt jedes Gerät als Linux -zu beschriften. Windows-Plattformvalidator nativ-unabhängig lokal geprüft; -echter Windows-Clientnachweis folgt separat. - -WebUI akzeptiert jetzt die vollständige signierte Schema-3-Retryreferenz nur -im eigenen dev/test-Abnahmeplan; fehlende/zusätzliche Felder, ungültige UUIDs, -Null-IDs/Hashplatzhalter und Retry im Normaljob werden verweigert. Bestehende -Updateeingabe an den Backendvertrag angeglichen: feste Paketnamen, Versionen -aus vollständigem signiertem Manifest. Fremde/fehlende Auswahl bleibt verboten. -**25 WebUI-Tests**, Typecheck und Vitebuild bestanden; gebautes UI tatsächlich -auf Cloudserver veröffentlicht, alte Assets/Index versioniert erhalten. - -Linux-Agent mit neuem Manifestparser gebaut: **55 Tests**, Clippy/Format/Release -bestanden, ELF x86-64 maximal glibc 2.34. Tatsächlicher nativer Loadercheck und -identitätsbewahrendes Upgrade auf Cloud-VM bestanden; alle State-/Journalbytes -vor neuem Start identisch. SHA -`8e79f881b7cd6e11d3bf0c1ce31d4c3f3afed354eeae72b4d188d376d8dff747`. -Danach serverseitig **online, sync_ready=true, restore_blocked=false** beobachtet. -Weiter **12/12/11, 0 unresolved**, keine neue Wirkung. **8 Cloud- / 28 MVP-Guards** -bestanden. APT-Endpunkt anschließend mit unabhängigem Nonce-/Peer-/Sharedledger- -Readinesscheck wieder aktiviert; neue zweistündige Policy begrenzt ausschließlich -dieses Gerät, festen APT-Provider und simulierten UI-Principal. Keine Rootskript-, -Dienst- oder Rebootrechte und keine Jobgenehmigung durch die Policy. - -Neue Paketabnahmen **noch nicht ausgeführt**. Geschützte Belege: -`devstate/server-upgrades/`, `devstate/cloud-apt-retry/agent-upgraded.json`, -`after-server-agent-upgrade.json`, `policy.json`. Frühere Abschnitte beschreiben -jeweils ihren damaligen abgeschlossenen Schritt. - -## Signierte APT-Wiederaufnahme: neue Runtime nativ bereit — 2026-11-13 - -Für den explizit beauftragten neuen Abnahmeschritt ist ein eigener sicherer -Wiederaufnahmevertrag implementiert (Spezifikation 1.9). Schema 3 trägt eine -typisierte Referenz auf ursprünglichen Grant/Versuch und unveränderten -Bootstrapmarker. Schema 2 bleibt unverändert serialisierbar. Vor Grantverbrauch -und Staging prüft der Helper im **gleichen** Ledger den eindeutigen alten Fehler, -gespeicherten ursprünglichen Ed25519-Auftrag, Ziel/Generationen, neue feste -Job-/Versuchs-/Genehmigungs-/Planbindung und identische vollständige Transaktion. -Python prüft historische Baseline, Kontext, Launch und APT-100-Ergebnis ohne -Hook nochmals. Alter Marker bleibt erhalten; genau ein eigener Retrymarker -wird exklusiv geschrieben. Unknown, vorhandener Hook/Acceptance, geänderte -Baseline oder Wiederverwendung sperren. Keine Marker-/Ledger-/Identitätslöschung. - -Tatsächlich ausgeführt: **65 Python-APT-Tests**, **12 Domain / 28 Helper-Library / -3 Helper-Binary / 20 Sync-Tests**, Clippy mit `-D warnings`, Formatprüfung und -Releasebuild bestanden. Die Rustprüfung lief in isoliertem Buildcontainer mit -passendem vorherigem Workspace-/Locksnapshot, da Windows-Abhängigkeiten parallel -ergänzt wurden; kein vollständiger Workspace-/Servernachweis dieses Snapshots. - -`python3 deploy/cloud_apt_sandbox_upgrade.py --native-retry` auf der echten -Cloud-Linux-VM erfolgreich: versionierte Backups, unveränderte beide -Agentidentitäten/Journale, Sharedledger-Inode/Bytes, Archive/Baselines/History, -gesamter alter `active/` und originaler Marker nachgewiesen. Echter neuer -Readonly-Sandboxprobe unter unverändertem APT-Profil bestanden; zehn stabile -Daemonprüfungen. **Keine Pakettransaktion und keine neue native Acceptance.** - -- Helper: `91ffd13a4a0a6713bf6d1aa07ccc72e1bea737ce5533fbec87b40a9f274cf35c`. -- Provider: `465ac5ed61185dd72f4600c49e0da5b9da16f75aa3686f7c278f8667a6564945`. -- Runtime: `711d81290ab3262cab409eb00e2d35ac0ef430de45bbbbe8b988973e47a632f6`. -- Stack: `a89219bb230dff1412da78174cddc493972ae5972143f371d08191a49331110d`. - -APT nach Probe wieder gestoppt, allgemeiner Helper und Cloud-Agent gestartet. -Acht bekannte abgeschlossene Rootversuche; kein neuer Job. Rootpolicy weiter -geschlossen. Signierte neue Fixtureinstallation, Upgrade und normale -Ensure-/Update-Noops **geplant, noch nicht ausgeführt**. Serverbuild mit neuen -APT-/Windows-Verträgen separat gestartet, noch kein bestätigtes Deployment. -Windows-Client wird parallel implementiert; native Clientabnahme noch offen. -Geschützt: `devstate/cloud-apt-followup/sandbox-*.json`, Build-/VM-Backups. - -## Providerkorrektur und erneute native Readiness bestanden — 2026-11-13 - -Korrektur in `tools/apt-transaction/apt_transaction.py`: feste lokale -Dateiacquisition zulassen, `--no-download` entfernt. Keine globale Quelle, -kein URLparameter, keine Abschwächung von Manifest-/Byte-/Pfad-/Hash-/Zeit- -oder Genehmigungsgates. `**ERROR**` bleibt Veto. Statt auf ein CLI-Flag zu -vertrauen prüfen Worker, Hook und Readonly-Probe jetzt wirklich, dass sowohl -IPv4- als auch IPv6-Socketerzeugung vom Kernel verweigert wird. Erlaubter Socket -oder unklarer Ressourcenfehler führt zum Veto. AF_UNIX-only/PrivateNetwork und -private Net-/PID-/Mountnamespaces bleiben unverändert. - -Neues Release gebaut und auf tatsächlicher Cloud-VM kontrolliert installiert: -`python3 deploy/cloud_apt_sandbox_upgrade.py --local-file-fix`. Upgrade vergleicht -jetzt die **exakte Menge der acht bekannten abgeschlossenen Grant-IDs**, statt -lediglich einen Zähler zu prüfen. Alte Provider-/Helperbytes, Runtime und -unabhängiger Pin gegen vorherige geprüfte Installation gebunden. Beide -Agentjournale, Rootledger-Inode/Bytes vor Start, kompletter alter `active/`, -Archive/Baselines/History und ursprünglicher Versuchsmarker erhalten. - -Tatsächlicher neuer Readiness-Probe unter unverändertem dediziertem APT- -Serviceprofil bestanden, einschließlich neuer IP-Denial-Prüfung und maskierter -Cloud-Identitätspfade. Zehn stabile Starts ohne Restart; keine Pakettransaktion, -kein neuer Acceptancebeleg. Aktuelle Messwerte: - -- Helper `e824de1cff4a1f2a2f176fd1f5d4a48df7ac3c50ef9a10974a858e92f21e3ca6`. -- Provider `00fef95f73edb781f0cfb92c8f4b6c3b3ef11cd4cfd063df30952507333b7059`. -- APT-Config `1d00a6d01c4ba0ae72e5e7fb85e170f2358cccd534ef060f2e8368268dae6941`. -- Runtime `27917dc46bb746607b1789e9cb2ba42241ab699b5569752de7d9a6ab0993c249`. -- Stackpin `152469399b06e2e834c81c38273d7e0cfd9ac2bd5b7f8991a0774a0cf758e8b1`. - -Abschließend Diagnosepolicy ausdrücklich geschlossen; APT-Daemon inaktiv, -allgemeiner Helper/Linux-Agent aktiv, signierter Sync ready, Restoreblock false. -Rootledger **8 consumed / 0 unresolved / 0 faults**, Integrität ok; Fixture -nicht installiert. Zentrale **12/12/11**, keine ungeklärten Jobs. Windows -sshd/Tunnel-Task tatsächlich Running, Listener ausschließlich `127.0.0.1`; -Cloud-Reverseport extern nicht erreichbar geprüft. Geschützte Abschlussbelege: -`devstate/cloud-apt-followup/final-*.json`, `sandbox-*.json` und -`devstate/windows-bootstrap/windows-final-state.json`. - -**62 Python-APT-Tests**, **8 Cloud-Guards**, **4 Download-Guards**, **28 MVP-Guards**, -**3 Bootstrap-Guards** bestanden. Ein erster Mock-Kernel-Test modellierte die neue -AF-Sperre noch nicht und schlug korrekt fehl; Mock um tatsächliche Socket-Denials -ergänzt, separate Positiv-/Negativtests für beide Familien und EMFILE bestanden. -Helper all-targets mit neu eingebettetem Provider: **25 Library / 3 Binary / -20 Sync** bestanden; Builds ausschließlich auf Entwicklungsrechner im isolierten -Container. Native Probe separat auf Cloud-VM, keine Vermischung der Nachweise. - -**Weiter offen:** eigentliche Fixtureinstallation/Upgrade/EnsurePackage/ -ApplyUpdates. Create-once-Marker des alten fehlgeschlagenen Versuchs bleibt; -kontrollierte signierte Wiederaufnahme ist Voraussetzung eines neuen festen -WebUI-genehmigten Paketversuchs, keine Marker-/Ledger-/Identitätslöschung. -Kein Linux-MVP-/Produktionsabschluss, kein RMM-Windows-Client behauptet. - -## Ursache von APT Exit 100 durch echten Hookvergleich belegt — 2026-11-13 - -Zwei separat tatsächlich WebUI-genehmigte Hookdiagnosen auf der Cloud-VM: -beide mit kopierter dpkg-Datenbank, zwingend nichtzero endendem Collector und -unabhängigem Wrapper, der jeden mutierenden dpkg-Aufruf verweigert. Jeweils -`pending_approval` 0/0/0, danach 1/1/1 mit gebundenem Simulationsaudit. - -- Ursprüngliche `--no-download`-Argumente: APT-v3-Installationszeile `**ERROR**`, - Providerprüfung `ACTION_PATH_OR_REMOVAL` verweigert. Config/Protokoll korrekt. -- Vergleich mit erlaubter **lokaler Dateiacquisition**: tatsächlicher absoluter - SHA-gepinnter Archivpfad, Protokoll-/Config-/Aktionsvalidierung bestanden. - IPv4-/IPv6-Socketerzeugung im tatsächlichen Helper zusätzlich explizit - verweigert geprüft; Quellen bleiben leer, Hook endet immer nichtzero, kein - mutierender dpkg-Aufruf angefragt. APT 100 ist hier der absichtliche Collector- - Abbruch und **kein** Paketfehler/Acceptance. - -Damit ist die Ursache der ursprünglichen verweigerten Übergabe eingegrenzt: -`--no-download` verhindert hier die notwendige Auflösung der bereits vorhandenen -lokalen `.deb` in einen absoluten Installationspfad. Dry-Run und Download-only -lieferten zuvor 0, erkannten aber den ungültigen späteren Hookeintrag nicht. -`**ERROR**` bleibt strikt verboten. Korrektur muss lokale Dateiacquisition -erlauben und die tatsächliche Netzwerksperre, Manifest-/Hash-/Pfad-/Planbindung -erhalten. Noch keine neue native Paket-Acceptance, kein alter Versuch wiederholt. - -Alle vier Diagnosejobs abgeschlossen, Originalstatus/`active/`/Marker bytegleich, -Fixture nicht installiert. Gesamtsnapshot **10 succeeded / 1 failed / 1 cancelled; -12 Jobs / 12 Outbox / 11 Startgrants**, acht bekannte abgeschlossene Rootversuche. -Einzelbelege unter `devstate/cloud-apt-followup/diagnosis-{hook,local-hook}/`. - -## Windows-SSH-Entwicklungszugang nativ bestätigt — 2026-11-13 - -User führte Bootstrap tatsächlich auf Windows 11 aus. OpenSSH-Service zuerst -1067, Vordergrundserver dagegen funktionsfähig. Separates Reparaturskript -erhielt Konto/Host-/Tunnelschlüssel, sicherte ACLs und setzte Verzeichnis-, -Config- und Hostkeyrechte auf SYSTEM/Administratoren. Danach vom User aus der -VM-Konsole `sshd=Running` und unveränderter ED25519-Fingerprint bestätigt. -Initialbootstrap-Quelle entsprechend korrigiert; ursprüngliches veröffentlichtes -Paket bleibt für Nachvollziehbarkeit erhalten, Reparatur separat veröffentlicht. - -Tunnelschlüssel ausschließlich auf der VM erzeugt. Public Key danach unter dem -eingeschränkten Cloudkonto registriert. Ein zunächst ungültiges `permitopen="none"` -im `authorized_keys`-Eintrag verhinderte Anmeldung; entfernt und öffentliche -Verzeichnisrechte explizit gesetzt. **`PermitOpen none` bleibt im sshd-Matchprofil**, -weiter nur Remote-Forward auf `127.0.0.1:22240`, keine Sessions/Shell und keine -Agentweiterleitung. Windows-Hostkey gegen bestätigte VM-Konsole gepinnt. - -Anschließend realer SSH-Zugriff vom Notebook über Cloud-Loopback/Reverse-Tunnel -mit vorhandenem Notebook-Key erfolgreich: **Windows 11 Pro, Build 26300, -64 Bit, Administratortoken true**. Hintergrundtask auf Windows stellt Tunnel -her. Private Schlüssel unverändert auf ihren Ursprungsmaschinen. Dies ist -**Bootstrap-/SSH-Nachweis, noch kein RMM-Windows-Client/Jobnachweis**. Notebook -weiter ausschließlich Entwicklung; Cloud-Linux-Agent unverändert. Geschützte -Konfiguration unter `credentials/windows-dev-access.json`, Belege unter -`devstate/windows-bootstrap/`. Zugang bis 2026-11-14 12:55:31 UTC befristet. - -## Echter APT-v3-Hook als Diagnose erreicht — 2026-11-13 - -Weiterer separat WebUI-genehmigter Diagnosejob, vor Genehmigung 0/0/0, -danach 1/1/1. Kopierte dpkg-Datenbank/PrivateTmp; Collectorhook endet immer -nichtzero, zusätzlicher dpkg-Wrapper verweigert sämtliche mutierenden Aufrufe. -Kein Installerstart/Providerhook/Grant-/Markerrücksetzen. - -Realer APT-Protocol-v3-Stream und beide Hook-Umgebungsvariablen korrekt; -Parser und normalisierte Configprüfung bestanden. Installationszeile enthält -jedoch **`**ERROR**` statt absolutem Archivpfad**. `validate_actions` verweigert -korrekt `ACTION_PATH_OR_REMOVAL`; Configure-Zeile vorhanden. Eingrenzung erklärt -die fehlende Hookübergabe, genaue Entstehung des fehlerhaften Dateinamens noch -im Vergleich. Kein Umdeuten von `**ERROR**` zu einem erlaubten Pfad. -Originalstatus/Fehlversuch/Marker bytegleich; kein dpkg-Effekt angefragt. -Geschützte Evidenz: `devstate/cloud-apt-followup/diagnosis-hook/`. - -## APT-Acquisition-Diagnose ohne Pakettransaktion bestanden — 2026-11-13 - -Weiterer separat beantragter und über echte simulierte WebUI genehmigter -Root-Diagnosejob auf bestehender Cloud-VM. Vor Genehmigung 0/0/0, danach 1/1/1, -Audit gebunden. Ausschließlich `apt-get --download-only --no-download` gegen -kopierte dpkg-Statusdatei und private Scratchpfade: leerer Cache und vorbefüllter -Cache jeweils **Exit 0**, identische Ausgabehashes, keine Fehlerausgabe. -Damit ist fehlender Cacheinhalt bei `--no-download` ebenfalls nicht als Ursache -belegt; weder Downloadschutz noch Sandbox wurden gelockert. Originaler -dpkg-Status, `active/`, Fehlversuchsmarker bytegleich; Fixture weiter nicht installiert. - -Gesamtsnapshot nun **8 succeeded / 1 failed / 1 cancelled; 10/10/9**, sechs -abgeschlossene Rootversuche. Keine neue native Paket-Acceptance; ursprünglicher -Exit 100 muss im verbleibenden Pre-dpkg-/Hookpfad weiter eingegrenzt werden. -Geschützte Daten: `devstate/cloud-apt-followup/diagnosis-acquisition/`. - -## Windows-Bootstrap zum HTTPS-Download bereitgestellt — 2026-11-13 - -Auf ausdrücklichen Userwunsch Public-only ZIP auf dem Cloudserver über einen -separaten, zeitlich begrenzten HTTPS-8443-Endpunkt bereitgestellt. Öffentlich -gültige Let's-Encrypt-Kette, extern mit unverändertem Systemtrust verifiziert; -heruntergeladener Bundlehash identisch. Root-ACME-/TLS-Schlüssel ausschließlich -auf dem Server, Downloadprozess als DynamicUser mit systemd-Credentials und -readonly System. Kein privater Schlüssel im ZIP, kein neuer RMM-/Verwaltungspfad. -RMM auf 443 unverändert. HTTP80 nach ACME tatsächlich wieder geschlossen. - -Download bis 2026-11-14 12:55:31 UTC; persistenter Ablauf-Timer stoppt Service und -schließt Firewallport 8443. Blockierende erste TLS-Annahme korrigiert, anschließend -echter externer Download mit paralleler langsamer TCP-Verbindung erfolgreich. -Fremde Datei-/Administrations-/Traversalpfade 404; drei lokale Download-Guards -bestanden. Windows-Skript noch vom User auszuführen, keine native Windows- -Abnahme. Beschreibung: [Windows-Entwicklungszugang](../deploy/windows/README.md). - -## Sandbox-Fix nativ auf Cloud-VM geprüft — 2026-11-13 - -`deploy/cloud_apt_sandbox_upgrade.py` tatsächlich erfolgreich ausgeführt. Neuer -Helper und eingebetteter Provider kontrolliert installiert, alte Dateien/Proofs -versioniert gesichert. Beide Agentidentitäten/-journale, gemeinsames Ledger samt -Inode, fünf bekannte abgeschlossene Rootversuche, gesamtes `active/`, Archive, -Baselines und ursprünglicher Create-once-Marker vor/nach Installation identisch. -Keine neue Enrollmentgeneration, kein Reset, kein Paketversuch. - -Tatsächlicher Readonly-Probe unter exakt gehärteter `rmm-apt-helper.service` -bestanden. Neuer Provider prüft im echten Worker, dass auch `/etc/rmm-remote` -und `/var/lib/rmm-agent-remote` verborgen/leer sind; Host-dpkg-Status nur kopiert. -Beide Helper danach zehnmal aktiv/running ohne Restart. Neue Runtime -`8d03b28975a90904bb4f5a0de43923ef23e27e97a3b6f1ce0251c1f00a21ddd2`; -neue Native-Readiness, ausdrücklich **keine** Paket-Acceptance. APT-Daemon nach -Probe wieder gestoppt, kein APT-Endpoint im Agentdrop-in aktiviert. -Cloud-Agent und allgemeiner Helper laufen mit unveränderter Gerätebindung weiter. -Private Reports: `devstate/cloud-apt-followup/sandbox-*.json`, VM-Backups unter -`/var/lib/rmm-bootstrap-history/cloud-sandbox-*`. - -Der vorangegangene Dry-Run-Diagnoseschritt ist als `fbef0e4` auf Gitea gepusht. -Die konkrete APT-100-Ursache bleibt nach bestandenem Solver-Dry-Run weiter offen; -als Nächstes sichere Diagnose der Acquisitionphase ohne dpkg-Ausführung. - -Windows parallel ausdrücklich erlaubt (Spezifikation 1.8): Public-only Bootstrap- -Paket vorbereitet, Cloud-Tunnelprofil validiert und Root-SSH unverändert geprüft. -PowerShell-AST-Parse bestanden. **Windows-Skript noch nicht auf VM ausgeführt**, -Warten auf öffentliche VM-Konsolenausgabe; keine Windows-Abnahme behauptet. -Details: [Windows-Entwicklungszugang](../deploy/windows/README.md). - -## APT-Diagnose, erster Folgeschritt — 2026-11-13 - -Tatsächlicher neuer Root-Diagnosejob auf bestehender Cloud-VM, Server weiterhin -`discovery.ease-technologies.de`. Plan/Antrag und separate Genehmigung über reale -WebUI mit sichtbar simuliertem Testprincipal; vor Genehmigung 0/0/0, danach -genau 1 Job/Outbox/Startgrant, Audit mit festem Planhash bestätigt. Ein zunächst -ordnungssensitiver JSON-Objektvergleich stoppte den Browser **vor** Genehmigung; -dasselbe nachweislich noch ausführungslos wartende Gesuch nach Korrektur geprüft -und genehmigt, kein neuer Antrag/Versuch. - -`deploy/linux/apt-diagnostic.py` führte ausschließlich zwei `apt-get --simulate` -Aufrufe aus: ursprüngliche Argumente sowie dieselben ohne `--`-Separator. -Beide **Exit 0**, identische Ausgabehashes, Fixture vom Solver erkannt; keine -Pakettransaktion. Separate Scratchpfade in PrivateTmp; gesamte Dateien des -aktiven Fehlversuchs, Versuchsmarker und dpkg-Status nachher bytegleich. -Der Separator ist als Ursache ausgeschlossen. Das ist **keine** Paketabnahme -und noch kein Nachweis der Ursache des ursprünglichen APT-100-Fehlers. - -Gesamtsnapshot nun **7 succeeded / 1 failed / 1 cancelled; 9/9/8**. Temporäre -Diagnosepolicy beschränkt auf allgemeines Rootskript, genau eine VM und den -simulierten WebUI-Principal, keine Dienst-/Reboot-/APT-Erlaubnis. Noch aktiv, -wird nach Abschluss geschlossen. Sandbox-Fix gebaut; native Prüfung folgt. -Geschützte Belege unter `devstate/cloud-apt-followup/diagnosis/`. -8 Cloud- und 3 Bootstrap-Guards, Node-Syntax und Diffprüfung bestanden. - -Userauftrag: Nach jedem Abnahmeschritt dokumentierte Projektquellen committen -und nach Gitea pushen; private Daten bleiben ausgeschlossen. Erster Push umfasst -auch den bisherigen noch uncommitteten Cloud-/Rootstand. 220 nichtignorierte -Sourcepfade geprüft, kein bestätigter Secretfund; ein Literal ausschließlich -als synthetische Canary im bestehenden Diagnose-Unit-Test klassifiziert. - -## Cloud-Root/Dienste bestanden; APT-Versuch fehlgeschlagen — 2026-11-13 - -Nur bestehende Cloud-Test-VM und `discovery.ease-technologies.de`; Notebook -weiter ausschließlich Entwicklung. Tatsächlich über die WebUI als sichtbar -simulierter Testprincipal beantragt und separat genehmigt: - -| Fester Einzelplan | Tatsächliches VM-Ergebnis | -| --- | --- | -| Root-Skript: vorerzeugten Testdienst einrichten | `succeeded`, Exit 0, exakte Ausgabe und Nachbedingung | -| `rmm-mvp-test.service` starten | `succeeded`, Nachbedingung bestätigt | -| denselben Dienst stoppen | `succeeded`, Dienst anschließend `inactive` | -| APT Native Acceptance: Fixture 1.0 | `failed`, `HOOK_NOT_HANDED_OFF`; **keine Paketabnahme** | - -Jeder Antrag vor Genehmigung persistent `pending_approval` mit **0 Jobs / -0 Outbox / 0 Startgrants**, danach genau **1/1/1**. Alle vier Audits binden -Planhash und `simulated-testprincipal-a`, `dev_test_browser_simulation`, -`testsimulation=true`. Rootplan-Vorbereitung ebenfalls über echte UI-Bedienung; -keine Erweiterung der MCP-Berechtigungen, keine API-/DB-Genehmigung. - -- Neuen Helper kontrolliert auf der VM installiert; alte/neue Agentidentitäten, - Journale, Rootledger-Inode und vorherige Artefakte erhalten. Erster nativer - APT-Readonly-Probe bestand, aber die Daemons starben anschließend an einer - blockierten Zeitabfrage: Ubuntu-glibc verwendet `clock_adjtime` für den - read-only `adjtimex(modes=0)`-Aufruf. Alias eng erlaubt, **kein CAP_SYS_TIME**, - keine abgeschaltete Clockprüfung. Danach neuer nativer Probe, zehn stabile - Daemonprüfungen und gemeinsames gebundenes Ledger ohne Fehler bestanden. - Das anfängliche `completed=true` des alten Spawnchecks war **kein** stabiler - Readinessnachweis; korrigierter Bootstrap wartet jetzt tatsächlich. -- Nonce-/Root-Peer-/Identitäts-/Profil-/Hash-gebundene Controlantworten als - tatsächlicher UID993-Peer geprüft. Beide Helper teilen dieselben Ledger- und - Lock-Inodes; aktueller Server-Signierschlüssel, keine Ledgerneuerzeugung. -- APT-Versuch erreichte echte private Namespaces, Cap-/NNP-/Seccompprüfungen, - readonly Controlmounts und echten APT-Frontend-Lockkonflikt. Danach APT **100**, - kein `hook-armed.json`, keine Acceptance. Elternprozess verglich den gesamten - Paketbaselinezustand unverändert; frisches gespeichertes passives Inventar - bestätigt unveränderte Baseline/Statusfingerprint und Fixture nicht installiert. - Die genaue APT-100-Ursache ist **nicht nachgewiesen**; stdout/stderr des nativen - APT-Prozesses wurden vom bisherigen Provider verworfen. Kein spekulativer Fix - als bestanden ausgegeben, kein zweiter Paketversuch. -- Einmaliger `bootstrap-attempt-rmm-apt-fixture-install-1.0.json`, `active/`, - Grant/Versuch und alle Fehlernachweise erhalten. **4 verbrauchte, abgeschlossene - Rootversuche, 0 offene Rootwirkungen, 0 sticky Syncfehler**, Ledgerintegrität ok. - Install/Update/EnsurePackage/ApplyUpdates bleiben offen; ein neuer Versuch darf - den Create-once-Marker nicht durch Löschen, neue Identität oder Rezeptalias umgehen. -- Nachprüfung fand fehlende Maskierung der neuen `/etc/rmm-remote`- und - `/var/lib/rmm-agent-remote`-Pfade in der bisherigen Paketsandbox. Quellcode - blendet jetzt alte und neue Layouts aus und verweigert sichtbare Inhalte/ - Symlinks. **Lokal geprüft, noch nicht auf VM installiert oder abgenommen.** - Dieser Fix ändert Provider-/Helper-/Runtimehashes und erfordert kontrollierte - Migration mit erhaltenem Ledger/Versuchsmarker und erneute native Readiness. -- Abschließend Testpolicy explizit abgelaufen gesetzt; APT-Helper gestoppt und - deaktiviert, nur seine eigenen Socket-/Proof-Umgebungswerte aus dem gesicherten - Agentdrop-in entfernt. Cloud-Agent und allgemeiner Helper bleiben aktiv. - Abschließend Cloudgerät `online`, signierter Sync `ready`, kein Restoreblock, - keine APT-Capability mehr; Policy tatsächlich abgelaufen, UID10001/0600 geprüft. - Keine Reboots, Systemupdates, Paketinstallation per SSH oder Notebook-Clients. - -Cloud-Gesamtsnapshot nach den vier neuen Versuchen: **6 succeeded / 1 failed / -1 cancelled; 8 Jobs / 8 Outbox / 7 Startgrants; 0 ungeklärte/laufende Jobs**. -Die Werte 4/4/3 im folgenden Basisabschnitt sind historische Zwischenstände. - -Lokale Prüfungen: **58 APT-Pythontests**, **8 Cloud-Guards**, **28 MVP-Guards**, -**3 Bootstrap-Guards** bestanden. Helpertests nach Clockprofiländerung: -**25 Library / 3 Binary / 20 Sync** bestanden; separater Lauf nach dem -Cloud-Controlpfad-Fix ebenfalls **25 / 3 / 20 bestanden**. -Initiale Container-Testaufrufe ohne Fixturemount bzw. `/tmp/opencode` scheiterten; -vollständiger Lauf mit readonly Quellen/Fixtures und privatem tmpfs bestand. -Kein VM-Nachweis aus diesen Containerläufen abgeleitet. - -Werkzeuge, private Belegpfade und konkrete Fortsetzungsgates: -[server-deployment.md](server-deployment.md#root--apt-abnahmelauf-2026-11-13). -Linux-MVP weiterhin nicht vollständig abgenommen; kein Commit/Push. - -## Cloud-MVP-Basisjobstrecke real nachgewiesen — 2026-11-13 - -Ausschließlich bestehende Cloud-VM als Client, endgültiger Server -`discovery.ease-technologies.de`, Notebook nur Entwicklung. Neuer Cloudadapter -`deploy/cloud_mvp_acceptance.py` und tatsächliche UI-Bedienung -`deploy/browser/cloud_approve.cjs`; weder Enrollment noch lokaler Executor, -direkte API-/DB-Genehmigung oder automatischer Ausführungsretry. - -- **Hello World auf WSS und HTTPS-Long-Polling** erfolgreich, jeweils eigener - MCP-Plan/Antrag, `pending_approval` mit gemessenen 0/0/0, tatsächliche simulierte - WebUI-Genehmigung und exakt ein Job/Outbox/Startgrant. Exit 0, exakte Ausgabe - und Nachbedingung auf der tatsächlichen unprivilegierten Cloud-VM bestätigt. -- **Live-Inventur** separat über die WebUI genehmigt, Erhebung neuer als der - gebundene Planbeginn; keine Tarnung als passives Inventar. Nativer Job war - erfolgreich, während der Python-3.10-Verifier Rust-Nanosekunden zunächst nicht - verarbeiten konnte. Parser korrigiert, vorhandenen Nachweis lesend bestätigt; - kein neuer Versuch oder erneute Wirkung. -- **Abbruch vor künftigem Start:** eigener genehmigter Plan, MCP-Abbruch, - `cancelled` und 0 Startgrants. Kein Nachweis eines laufenden Installerabbruchs. -- Insgesamt **3 succeeded / 1 cancelled**, **4 Jobs / 4 Outbox / 3 Grants**, - keine ungeklärten/laufenden Jobs. Alle Genehmigungen mit festem Planbezug, - Testprincipal, `approval_origin=dev_test_browser_simulation`, `testsimulation=true`. -- **MCP-Tenantgrenze** für Gerät und Job belegt; erneutes Submit derselben - Pläne/Schlüssel erzeugt keine neuen Operationen/Jobs. -- **Gateway-Wiederanlauf:** HTTPS-Verwaltungssitzung blieb gültig; anfängliche - Generationserhöhungserwartung für diese persistente HTTPS-Sitzung lief ins - Testlimit. Tatsächlichen WSS-Reconnect anschließend separat gemessen: - höhere Generation, frischer Heartbeat, erfolgreicher signierter Sync, - unveränderte 4/4/3. Agent abschließend wieder auf WSS. -- **5 neue Cloud-Guards**, **28 bestehende MVP-Guards**, **3 Bootstrap-Guards** - bestanden; Node-Syntaxprüfung bestanden. In diesem Abschnitt keine Rustquellen - geändert, keine neue Rust-/Frontend-Gesamttestbehauptung. - -Einzelbelege/ausgeführte Befehle und Grenzen: -[server-deployment.md](server-deployment.md). Root-/APT-/Reboot-/Offline-/ACK- -Fault-Abnahmen und vollständiges Linux-MVP weiterhin offen. Keine Produktions- -freigabe, kein Commit/Push. - -## Wiederaufnahme und dedizierter Server — 2026-11-13 - -Useroverride: Entwickler-PC kein RMM-Server mehr; dedizierter Internetserver mit -`discovery.ease-technologies.de`. Spezifikation **1.7**. **Neueste Userkorrektur:** -Notebook ausschließlich Entwicklung, kein RMM-Client. Aktueller Client ist die -Cloud-VM, der festgelegte Cloudserver ist endgültig. Tatsächliche Einrichtung, -Sicherheitsgrenzen, Start-/Zugangspfade und offene Gates: -[server-deployment.md](server-deployment.md). Die darunterstehende Pause ist historisch. - -- Server nativ auf Ubuntu 26.04/aarch64 gebaut und gestartet, PostgreSQL frisch - migriert. API/Gateway als UID 10001, Dockerports ausschließlich Loopback, - PostgreSQL intern. Öffentlich nur Agent-TLS über separaten TCP-Ingress, keine - Dev-Anmeldung/UI/MCP. Privater WebUI-Login über SSH-Tunnel geprüft. -- Hostkey vom User bestätigt, bestehender SSH-Key funktioniert; Passwortlogin - deaktiviert und Key-Zugang erneut geprüft. Hostfirewall nur SSH/TLS. -- Cloud-Test-VM (x86-64): neue getrennte Agentidentität direkt am Server, - mTLS-WSS, Inventar/frische Heartbeats und signierter Sync bestanden. - Ein zunächst eingerichteter Notebook-Client wurde nach Userkorrektur gestoppt, - deaktiviert und deinstalliert; Geräteidentität über die WebUI widerrufen. - Nur Cloud-VM als aktiver Client; widerrufene Notebook-Historie erhalten. - Kein Gerät in B; 0 Jobs/Outbox/Startgrants. Alte VM-Identität, - Journale und gestoppte Helper unverändert erhalten. Keine Produktionsfreigabe. -- Konfigurierbarer, streng validierter `RMM_SERVER_NAME` ersetzt feste DNS-Namen - in sämtlichen Agenttransporten einschließlich Rotation und Signierbootstrap. - Öffentlicher Gateway bietet ausschließlich mTLS-gebundenen Signierschlüsselbezug; - kein Cookie-/Bearerersatz und keine administrativen Routen. -- Bekannter Skript-/SHA-Konflikt korrigiert, Python- und Browserpin konsistent. - Zusätzlicher Guard prüft beide Pins gemeinsam, bevor eine native UI-Genehmigung - überhaupt versucht wird. -- APT-Controllerursache auf tatsächlicher VM diagnostiziert: unter systemd 255 - entfernt explizites `User=root` CAP_SETUID aus E/P und hinterlässt Setup-Caps - in I. Default-Root im unverändert strengen Schutzprofil besteht alle bisherigen - Controllerprüfungen. Quelle der APT-Unit korrigiert und gebaut; die temporäre - Diagnosekonfiguration ist entfernt. **Keine dauerhafte Umstellung des alten - VM-APT-Helfers, keine neue Native-Readiness oder Paket-Acceptance.** -- Native Erstinstallation des neuen VM-Clients hatte Dateimodusfehler (Exit 203). - Eigene neue Dateimodi unter Hashprüfung korrigiert und denselben Bootstrap - fortgesetzt; Regression ergänzt. Keine Identität neu erzeugt, um einen Fehler - zu verbergen. Neuer Client auf VM als Systemdienst aktiv. Notebook-Userdienst - entfernt, lokales Binary entfernt, private Journalhistorie archiviert. Lokalen - Installationspfad aus Bootstrapwerkzeug entfernt. - -Tatsächlich ausgeführte lokale Prüfungen dieses Durchgangs, getrennte Suites: - -- `python3 tests/vm_mvp_guards.py`: **28 bestanden**. -- Python-APT-Unittest-Discovery: **56 bestanden**. -- `python3 tests/test_remote_client_bootstrap.py`: **3 bestanden**, einschließlich - Verweigerung der entfernten Notebook-Installationsoption; 4 neue Pythondateien - zusätzlich per AST geparst. -- `npm run typecheck`, `npm test`, `npm run build`: erfolgreich, **23 UI-Unit-Tests**. - Keine neue browsergesteuerte Jobgenehmigung oder Browser-Gesamtabnahme behauptet. -- Im isolierten Docker-Build mit gepinnter Rust-Toolchain: - `cargo fmt --all --check` bestanden; - Clippy Helper/Agent/Server all-targets mit `-D warnings` bestanden. - Helper-Suites **25 Library / 3 Binary / 20 Sync** bestanden; - Agent-Suites **24 Binary / 8 Rotation / 5 HTTPS / 18 Sync** bestanden. - Gemeinsame eingebundene Tests nicht als unterschiedliche Featureabnahmen addieren. - Tests benötigten das vorhandene Testfixture-Elternverzeichnis `/tmp/opencode` - im isolierten Container; erster Aufruf ohne dieses Verzeichnis scheiterte, - danach mit privatem tmpfs bestanden. Kein Eingriff in Host-/VM-Paketzustand. -- Beide Releasebinaries für Server/Agent gebaut; Server zusätzlich nativ ARM64 - auf dem neuen Server. Sourcehash-Abgleich und externer TLS-/Port-/Routennachweis - in der Deploymentdokumentation. ARM64-Agenten bleiben unfreigegeben. - -M0–M5 weiterhin offen, insbesondere aktive UI-genehmigte Job-/Root-/APT-/Fehler- -abnahmen auf dem neuen Bestand. Kein Commit/Push ausgeführt. - -## Historisch: Entwicklung pausiert — Übergabe 2026-11-12 - -Kompakter Einstieg, bekannte ungeprüfte Snapshotfehler und Fortsetzungsgates: -[handover.md](handover.md). Die nachfolgenden Worker-Nachweise bleiben erhalten. - -User hat aktuelle Entwicklung unterbrochen und Push/Übergabe angefordert. -**Keine weiteren Implementierungen, Builds, Tests, Deployments, Anträge oder -Folgejobs starten.** Git-Commit/Push übernimmt der zuständige Orchestratorworker; -dieser VM-Worker hat weder Commit noch Push ausgeführt. - -### Unmittelbar vor Pause tatsächlich abgeschlossen - -- Neuer `deploy/vm_runtime_upgrade.py`: versionierter Bookworm-Agent-/Helperbuild, - strikter Vergleich mit eigenen alten Deploymenthashes, Root-private atomare - Backups, Loaderprüfung vor Binärwechsel, erhaltene Identitäten/SQLite-Journale, - neue getrennte Helperkonfigurationen/Public-Pins und dedizierter APT-Probeaufruf. -- Tatsächlicher neuer Docker-Releasebuild beider Binaries erfolgreich. Build-ID - **68741ab0b1c84e15bf3fc442bd812558**, Kontext 1.433 MB; beide ELF x86-64, - maximal glibc **2.34**, OpenSSL **3**, konkrete VM-Loaderauflösung bestanden. - Agent SHA256 `46821cc7544019830507ffaa0c5385f88f7b645a5a1d1c8a54aa56ebbd8e8f20`; - Helper `f867ac51e82fc7d0f0050cb7629e1ff92d8af9b493d6cb8ae4839accb5694e30`. - Source-/Artefaktmanifest und getrennte, nur vom Sourceowner berichtete - 115/56/2-Testreferenz unter `devstate/vm-final//build.json`. - Diese 115 Rust-/56 APT-/2 Installertests wurden hier **nicht erneut ausgeführt**. -- Tatsächlicher kontrollierter VM-Upgrade erfolgreich, Stage - `installed_not_started`. Vor/nach Installation Agent- und Helperstate inklusive - Dateibytes/SQLite-Schema/Rows identisch, keine Reenrollment-/Journal-/PKI-Resets. - Vorhandene alte Binärdateien/Units und nachweislich unbenutzte alte Provider- - Code-/Storedirectories bleiben Root-privat erhalten unter - `/var/lib/rmm-bootstrap-history//report.json` samt zugehörigen Backups. -- Neue Rootkonfigurationen `/etc/rmm/helper-general-v2.json`, `apt-helper.json`, - Public-Pins `general-helper-proof-v2.json`, `apt-helper-proof-v2.json` (Root, - Gruppe984 lesbar 0640), Agent-Drop-ins `20-runtime-v2.conf` und - `21-log-units-v2.conf`, private Logunit-Allowlist. Schlüssel/Journale nicht ersetzt. - Generalhelper bleibt ohne SYS_ADMIN/MKNOD, Rootscripts/Reboot bleiben false. - Nur genau ein vorerzeugter leerer Root-0600-Inode - `/etc/systemd/system/rmm-mvp-test.service` ist als späteres UI-Schreibziel - freigegeben, **keine gültige Business-Testunit eingerichtet/gestartet**. - Kein pauschales ReadWritePaths=/etc. Ausschließlich adjtimex-Read-Ausnahme - zusätzlich zum weiter beschränkten Generalprofil, keine SYS_TIME-Capability. -- Tatsächliche administrative Fixturevorbereitung über festes - `provision-fixture-store` erfolgreich: bekannte versiegelte Fixturearchive und - Root-private Baseline-/Prefetchmetadaten, **keine Paketinstallation**. - -### Konkreter offener Native-Probe-Fehler / sicherer Endzustand - -Dedizierte tatsächliche `rmm-apt-helper.service`-Probe wurde gestartet und scheiterte -**vor** Native-Readiness-Publikation mit statischem Sourcefehler -**APT_CONTROLLER_PROFILE_REQUIRED**. Systemctl-Start Exit **1**, -Result=exit-code; im Fehlerzeitpunkt SubState=auto-restart. Root-private Diagnose -enthält Exceptionklasse RuntimeError und generierte Zeilen 183/6; keine privaten -Exceptioninhalte/Logs veröffentlicht. Keine Probedateien, keine -native-readiness.json und keine Native-Acceptance-/Job-/Grantbelege erzeugt. -RootGate/SDK-/Providercode wurde **nicht** zur Umgehung gepatcht. Fehlerursache -innerhalb des tatsächlichen Controllerprofils ist noch nicht weiter eingegrenzt; -kein erneuter Probeversuch nach Userpause. - -Unmittelbare, ausschließlich lesende Pauseprüfung bestätigt: - -- `rmm-agent.service`: **inactive** -- `rmm-helper-dev-test.service`: **inactive** -- `rmm-apt-helper.service`: **inactive**, kontrolliert nach nachgewiesen leerem - Rootverbrauch gestoppt; kein aktiver automatischer Neustart mehr -- **kein VM-18443-Reverselistener**, kein von diesem Lauf gestarteter PC-Tunnel -- Rootledger **0 Verbräuche / 0 ungeklärte Verbräuche** -- Serverseitig für die erhaltene VM ausschließlich **1 succeeded** (historischer - früherer Hello-World-Job), **keine neuen RMM-Jobs/Genehmigungen/Anträge** -- Lokaler Projekt-Docker **server running**, ausschließlich - **127.0.0.1:18443**, **postgres running** ohne publizierten Datenbankport; - für User bewusst unverändert laufengelassen -- Kein laufender Installer-/Paket-/Rebootauftrag dieses Workers. Letzter Build- - Hintergrundprozess war bereits erfolgreich beendet, kein Build zu stoppen. - -Geschützte Übergabeevidenz: `devstate/vm-final//{build,install,probe-diagnostic}.json`, -auf VM `/etc/rmm/runtime-v2-probe-report.json` und oben genannter Root-Backupreport. -Da die Probe fehlschlug, wurde lokal **kein erfolgreicher probe.json** erzeugt. -Keine Backup-/Journal-/Identitydateien entfernen oder die create-only Phasen -blind erneut aufrufen. Installierte neue Laufzeit bleibt absichtlich gestoppt. - -### Quelländerungen und noch ungeprüfte Arbeit - -- Neues Upgradehelper-Skript wie oben; Änderungen an - `deploy/vm_mvp_adapters.py`, `deploy/vm_mvp_acceptance.py`, - `deploy/vm_mvp_runtime.py`, `tests/browser/mvp-actions.spec.ts` und - `tests/vm_mvp_guards.py` für gewünschte **1.1** im normalen Ensure-Job, - UPDATE-Rezept/fresh-baseline/Noopflags und begrenztes vorerzeugtes Unit-Inodeziel. - Keine Änderungen an gemeinsamen Client-/Helper-/Backend-/Domain-/APTtool-Sources. -- **28 MVP-Guardtests und Syntaxprüfung waren vor der letzten Änderung der - SERVICE_SETUP-Bytes erfolgreich.** Danach wurde das Setupskript an den leeren - vorerzeugten Inode angepasst; dabei sind die hart gepinnten bisherigen - Script-SHA-Konstanten in Browser/Guardtests **noch nicht nachgezogen/geprüft**. - Dieser bewusst offene Arbeitsstand muss bei Wiederaufnahme zuerst konsistent - gemacht werden. Nicht als aktuell vollständig grüne Testsuite ausgeben. -- Keine weiteren Tests oder Format-/Buildprüfungen nach Pause ausgeführt. - Kein neues UI-/MCP-Ausführungsergebnis, kein Paket-/Diensttest-/Update-/Reboot- - Nachweis. Rootscope auf Server wurde von diesem Worker nicht aktiviert, - kein lokaler Serverrestart und keine Rollen-/Freigabe-DB-Manipulation. -- Zuerst tatsächliches dediziertes Controllerprofil gegen - `verify_controller_profile()` diagnostizieren; Härtung nicht blind lockern. - Danach neue Peer-/Sync-/Passive-planning-Nachweise und erst dann einzeln - WebUI-genehmigte Jobs. Aktueller Stand ist **keine Linux-MVP-Abnahme**. - -## Neuester Adapterstand: 15 Fälle nach aktuellem Backend-/APT-/Sync-Vertrag - -Die vorher unten als `pending_protocol` bezeichneten neun Fälle sind **nicht mehr -pauschal wegen unbekannter Routen gesperrt**. Aktuelle Verträge aus -`proto/BACKEND_CONTRACT.md`, `deploy/linux/apt-helper-README.md`, -`tools/apt-transaction/HELPER-CONTRACT.md`, `tests/agent_sync/README.md` und -`tests/agent_transport/README.md` wurden herangezogen. **Kein VM-Nativlauf wurde -in diesem Adapterincrement gestartet; das aktuelle Client-Wire-up-Verdikt fehlt.** - -### Executorabdeckung (Code vorhanden, nicht nativ abgenommen) - -| Case | Executorstatus / konkretes Laufzeitgate | -| --- | --- | -| `hello` | ready_adapter; echter frischer nichtprivilegierter Agent, aktueller Sync | -| `refresh_inventory` | ready_adapter; linux.base und neue gebundene Erhebungszeit | -| `query_logs` | ready_adapter; exakte Testunit-Allowlist, fünf Minuten/50 Zeilen/64 KiB | -| `service_setup` | ready_adapter; festes UI-Rootskript, echte Rootpolicy und geprüfte Schreibpfade erforderlich | -| `service_start` | ready_adapter; ausschließlich rmm-mvp-test.service, tatsächlicher Helperpolicy-/Syncnachweis | -| `service_stop` | ready_adapter; dieselbe Unit, feste Reihenfolge setup/start/stop | -| `apt_native_install` | ready_adapter; schema-2-Manifest, passiver/genehmigter Planungsdatensatz, Rootprobe, versiegeltes Archiv 1.0 | -| `apt_native_update` | ready_adapter; entsprechendes 1.0→1.1-Manifest und echte aktuelle 1.0-Baseline | -| `ensure_package` | ready_adapter; vollständiges apt-execute-Manifest und echter install-Rezept-Acceptancebeleg | -| `apply_updates` | ready_adapter; festes Testpaket, reboot_policy=never, echtes Upgrade-Rezept und Acceptance | -| `duplicate_offer` | unsupported_native_fault_injection; separater ausführbarer Originalresult-Replay-Regressionsdriver vorhanden | -| `lost_result_ack` | unsupported_native_fault_injection; derselbe Driver, kein behaupteter ACK-Verlusttest | -| `cancel_queued` | ready_adapter; eigener Agent vorher inaktiv, feste future-start Hello-Bytes, UI-Antrag, MCP-Cancel, null Grants | -| `expired_offline` | ready_adapter; eigener Agent offline, feste 60-s-Frist, Wiederanmeldung erst danach, expired und null Grants | -| `reboot_last` | ready_adapter; eigener Lifecycle, tatsächliche Root-Rebootpolicy, Checkpoint vor UI-Klick, neue Boot-ID/Inventar/Sync/Result | - -Neue Module `deploy/vm_mvp_adapters.py` und `deploy/vm_mvp_runtime.py` enthalten -die tatsächlichen Executorpfade, nicht nur einen Statuskatalog. Core, separater -Browserrunner/-test und Guards sind angepasst. Keine Änderungen an gemeinsamen -Agent-/Helper-/Backend-/Domain-/APTtool-/WebUI-Quelldateien. - -### Plan-/Freigabe- und Lifecyclegrenzen - -- Nonroot-Fälle planen/beantragen über echten MCP 2025-11-25. Rootfälle verwenden - **echte UI-Planerstellung und UI-Submit durch den simulierten Testhuman**, weil - der Default-Automatisierungstoken bewusst kein root:execute besitzt. Keine - Membership-/Scope-DB-Änderung, kein geborgter Cookie und kein direkter - Freigabe-API-Aufruf. Erste Browserphase verlässt den Antrag pending_approval - ohne Genehmigungsrequest; MCP liest denselben gespeicherten Antrag nach. -- Danach werden null Jobs/Outbox/Grants verifiziert und IDs/Versuch/Planhash privat - gespeichert. Beim Reboot zusätzlich native alte Boot-ID; ein Bootwechsel noch - vor Genehmigung sperrt den Klick. Erst die zweite Browserphase prüft sämtliche - exakten angezeigten Plan-/Skript-/Manifestbytes und klickt Checkbox/Button. - Audit bleibt explizit dev_test_browser_simulation/Testprincipal, kein Mensch- - oder Produktionsnachweis. Browser-Zeitzone ist für die UI-Minutenfelder UTC; - die tatsächlich erzeugten gespeicherten Bytes werden erneut vollständig geprüft. -- Rootpolicy kommt aus frischem UID993-IPC mit Root-SO_PEERCRED, Root-eigenem - unabhängig provisioniertem Public-Pin, Nonce, Identität/Generationen, aktuellem - authentisiertem Signingkey und exaktem Policydigest. APT verwendet ausschließlich - den dedizierten Socket/Stackpin. Beide Profile müssen dieselben Ledger-/Lock- - Geräte und Inodes melden. Ein Capabilitystring oder Benutzerartefakt genügt nie. -- Technischer Runtimeadapter übernimmt nur inaktiven Agent/Tunnel oder bricht ab; - verifiziert installierte aktuelle Buildhashes, erhaltene Identität, UID, tatsächliche - Prozess-UID, NoNewPrivileges und keine effektiven/ambienten Agentcapabilities. - Er erzeugt nur eigenen versionierten Transport-Drop-in und eigenen Loopback- - Tunnel mit StrictHostKeyChecking/Keepalive. Roothelperstarts nur für zwei feste - eigene Unitnamen mit unabhängig gelieferten tatsächlichen Unithashes. Bereits - aktive fremde Helper werden nicht als eigene Cleanupziele übernommen. -- Neuer Hello/Transport muss eine höhere Verbindungsgeneration und realen - serverseitigen Sync-/Restorezustand plus frischen Kontakt ergeben. Eigene - Prozesse werden nur bei terminalen Serverjobs und ohne unklare Helperverbräuche - gestoppt; private Journale/Identitäten werden nie gelöscht oder umgeschrieben. - Reboot aktiviert bei Bedarf nur die eigene bestehende Agentunit als technischen - Startbootstrap und stellt den früheren Enablezustand nach terminalem Ergebnis - wieder her. Kein SSH-Reboot, Paketresolver oder Service-Geschäftseffekt. -- Rebootdriver wartet begrenzt auf strikt authentisierten SSH-Wiederkontakt und - echte neue /proc-Boot-ID, setzt nur seinen eigenen PC-Tunnel neu auf und verlangt - autogestarteten nichtprivilegierten Agenten, neues Inventar, Server-/Helper-Sync - und den gebundenen endgültigen Job. Exitcode 0 ist kein Rebootnachweis. -- Zusätzliche ausgearbeitete Lifecycleoptionen: `--transport wss|https`, optional - `--exercise-server-restart` (bestehendes Compose-Profil unverändert, kein OIDC- - oder Datenreset) und `--exercise-native-renewal`. Letzterer beobachtet nur echte - native Rotation, exportiert keine privaten Schlüssel und erzwingt keine neue - CSR über einen Ersatz-PC-Client. Fehlt ein nativer Fälligkeits-/Triggerpfad, - endet er not_configured statt Rotation zu behaupten. Für den verlangten API- - Fingerprintnachweis fehlt aktuell außerdem `certificate_sha256` im Geräte-DTO; - das ist ein präzises Metadatengate, keine unbekannte Renewroute. - -### Replay ist nicht erfundene Fault-Injection - -Der Driver liest auf der VM ausschließlich das tatsächlich archivierte originale -`reconcile_results.envelope` des **gleichen** abgeschlossenen Hello-Jobs/Versuchs. -Agent/Job/Versuch/terminales Result werden aus Protobuf geprüft. Er verwendet den -nativen aktuellen Zertifikatselector und Geräteschlüssel ausschließlich auf VM, -normale CA-/DNS-Verifikation und zweimal denselben originalen MessageBatch an -`POST /agent/v1/messages`. Message-ID/Boot/Sequenz/Zeit/Output bleiben unverändert. -Danach müssen lokaler Verbrauch, serverseitiger Job/Grant, Ergebnis und genau -ein konkreter Receipt unverändert sein. Kein neues Offer, neuer Job/Versuch, -neuer Grant, umverpacktes Ergebnis oder Journal-/Safetyreset. - -Gezieltes Offerduplizieren und echtes ACK-Unterdrücken haben keinen öffentlichen -Native-Testhook. Deshalb bleiben die zwei Fault-Resultfelder ausdrücklich -`unsupported_native_fault_injection` und `native_fault_test_passed=false`, auch -wenn der separate Replay-Regressionsdriver später erfolgreich läuft. Dieser -Driver wurde hier **nicht gegen die VM ausgeführt** und nicht als Nativepass markiert. - -### Konkrete APT-Collectorübergabe – derzeit wirklich fehlend - -Die echte read-only MCP-Antwort enthält weiterhin **keine** gespeicherte -`linux.apt.planning`-Observation. Der Planbuilder fällt nicht auf SSH-Live- -Paketinventur/Resolver, manuelles Baseline-/Acceptance-Schreiben oder Capability- -Overrides zurück. Die bestehende additive Inventory-JSON-Route genügt; benötigt -wird eine reale erlaubte passive Standarderhebung oder ein eigener UI-genehmigter -Read-Diagnoseauftrag mit folgendem Mapping: - -```text -scope/source_id: linux.apt.planning -quality: valid; completeness: complete; truncated: false -observed_at: tatsächlicher RFC3339-Zeitpunkt (für Ausführung <90 s) -data: - fixture_package: tatsächliche Projektion baseline["rmm-mvp-test:all"] oder null - baseline_sha256, sealed_baseline_sha256 - status_fingerprint, dpkg_updates_empty, pending_triggers_empty - runtime, runtime_sha256 - provider_sha256, hook_sha256, apt_config_sha256 - prefetch: {: {schema_version:1,sha256,size,sealed_at_ms}} -``` - -Ableitung exakt nach Toolvertrag, keine erfundenen Zeitpunkte/Hashes: - -1. `installed_snapshot()` liest dpkg-query Package/Architecture/Version/Status, - prüft Eindeutigkeit und konsistente Statuswerte. Baselinehash = SHA256 der - kanonischen ASCII-JSONbytes (`sort_keys`, kompakt, **ohne LF**). Die gesamte - Baseline muss nicht in die 32-KiB-Observation: Fixtureprojektion plus Hash reichen; - ein optional mitgeliefertes Vollobjekt wird zusätzlich gehasht/geprüft. -2. `sealed_baseline_sha256` bestätigt eine tatsächlich bereits erzeugte, - Root-private unveränderliche Baseline mit genau diesem Inhalt. Nicht durch - Kopieren des behaupteten Hashs als Proof erzeugen; Helper prüft Datei/Hash vor Effekt. -3. `status_fingerprint()` hasht kanonische Pfad→SHA256/null-Records für - /var/lib/dpkg/status, arch, /var/lib/apt/extended_states und sortierte Trigger - außer Lock. Dpkg-updates muss leer und triggers/Unincorp leer sein. Optional - Records können mitgeliefert und erneut gehasht werden. -4. Runtimehash = SHA256 des echten kanonischen `inspect-runtime`-Objekts ohne LF; - Code-/Hookhash über tatsächliche installierte Bytes, Confighash über exaktes - print-config. Root-readiness-IPC/Rootprovisionierung und beide Ledgerinodes - werden unabhängig geprüft; Runtime-/Codepins stimmen mit administrativ - gelesener bestehender Rootkonfiguration überein, nicht nur mit Agentbehauptungen. -5. Prefetchfelder stammen aus echten Root-sealed Receipts vor der finalen Grant- - not_before-Zeit. Archive sind ausschließlich die zwei gepinnten bekannten - Fixturebytes. Kein Native-Acceptance-Record vor dem tatsächlichen UI-genehmigten - Paketjob. Der Suitecode ruft `prepare-baseline`/`provision-fixture-store` niemals - über SSH auf: letzteres kombiniert im aktuellen Tool Vorbereiten und aktive - Baselineerhebung und wäre kein verdeckter lesender Planungsersatz. - -**Zusätzlicher tatsächlicher Fixture-Sequenzkonflikt:** Nach Nativeacceptance 1.0 -ist 1.0 bereits installiert, das bestehende install-Rezept erlaubt jedoch nur -old_version=null. Nach Nativeacceptance des Upgrades ist bereits 1.1 installiert, -während apply_updates exakt old_version=1.0 verlangt. Die normalen Adapter -verweigern solche falschen Baselines ausdrücklich. Ohne zusätzlich genehmigten -Reset-/Removalpfad oder überprüften neuen Idempotenzvertrag kann nicht ehrlich -alle vier Hosttransaktionen nacheinander als neu ausgeführt abgenommen werden. -Keine heimliche Entfernung/Downgrade und keine gefälschte Abwesenheitsbaseline. - -### Benutzerfreigabe getrennt von Readiness - -Tatsächlich lokal erzeugt, aus der bereits gegebenen Chatfreigabe (2026-11-12): -`devstate/mvp-acceptance-optins/chat-user-20261112.json`, Verzeichnis 0700, Datei -0600, gitignored. Enthält feste Ziel-IDs, gewählte Cases, simulationskennzeichnung, -Chat-Herkunft/Datum und kurze Gültigkeit. **Kein** wiring_verified/ready/capability- -Flag und keine neue Autorisierung im Produkt. Erneute manuelle Abschrift der -gleichen Userentscheidung ist nicht nötig; tatsächliche WebUI-Plangenehmigung -bleibt für jeden Job erforderlich. - -Ein getrenntes tatsächliches Wireworker-Verdikt ist vor Nativebootstrap Pflicht: -feste agent_id, tatsächliche aktuelle `agent_sha256`, `helper_sha256`, optional -`helper_units:{fester Unitname: tatsächlicher Unithash}`, `general_pin_file` und -`apt_pin_file` für unabhängig Root-provisionierte Public-Pins. Die Suite hat -**kein solches Verdikt gefälscht oder automatisch erzeugt**. Die Hashangaben -werden vor Ort nochmals gegen echte Installation, Peer, Pin, Unit und Sync geprüft. - -### Tatsächlich ausgeführte Verifikation dieses Adapterincrements - -- Python-Syntaxprüfung der fünf betroffenen Pythondateien bestanden. -- Abschließend **27 neue/erweiterte MVP-Guardtests** und **15 bestehende VM-Guardtests** - bestanden, einschließlich echter generierter Replay-/Inspect-Syntax, Root-UI- - Prepare-vor-Approval-Reihenfolge und getrennte-Ledger-Inode-Verweigerung. -- TypeScript-Typecheck bestanden; neun lokale API/UI-Tests bestanden. -- Browserdiscovery der getrennten Root-Prepare-/Approvaltests erfolgreich; - **kein Browserlauf**. Kein neuer Rustbuild/-test oder fremder Worker-Testpass behauptet. -- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM sichtbar, - nichttrunkierte Liste, **unreachable**, weiterhin nur alte Basis-/Hello-/Inventory- - Capabilities. Kein frischer Root-/APT-/Sync-/Transport-/Rotationsnachweis. - Tatsächlich bestätigt: linux.apt.planning fehlt und das Geräte-API liefert - noch kein certificate_sha256. Benutzerartefakt abschließend auf 0700/0600, - 15 Cases und Abwesenheit sämtlicher Readiness-/Acceptanceflags geprüft. -- **0 neue RMM-Anträge/Pläne/Genehmigungen/Jobs, 0 SSH-/VM-/Rootänderungen, - 0 Dienst-/Tunnelstarts, 0 Serverrestarts, 0 Pakete/Updates/Reboots** in diesem Lauf. - -Tatsächlich ausgeführtes Defaultkommando: `python3 deploy/vm_mvp_acceptance.py`. -Geplante, **nicht ausgeführte** Fortsetzung erst nach aktuellem realem Wireverdict: - -```sh -python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \ - --user-artifact devstate/mvp-acceptance-optins/chat-user-20261112.json \ - --wire-verdict devstate/vm-wire/current.json --transport https \ - --case hello --case duplicate_offer --case lost_result_ack -``` - -Die Freigabedatei muss noch gültig sein (bei Bedarf create-only neu aus derselben -Chatfreigabe mit `--create-chat-user-artifact` erzeugen). Reboot nur letzter Case, -eigene Lifecyclekontrolle und tatsächlich aktivierte eng begrenzte Rootpolicy; -die aktuell falsche allow_reboot/allow_root_scripts-Policy wird nicht von der -Suite geändert. Root-Testunit braucht echten erlaubten ReadWritePaths-Pfad, -sonst not_configured; niemals stille SSH-Geschäftsmutation. **Kein Linux-MVP-Abschluss.** - -## Neueste Vorbereitung: modulare VM-MVP-Abnahmesuite, noch keine neue Ausführung - -Diese Ergänzung ist **Testvorbereitung während des parallelen Agent-/Helper-/Sync- -Wire-ups**, kein weiterer VM-Feature- oder MVP-Erfolgsnachweis. Bestehende positive -Hello-World-/Root-Readiness-Nachweise unten bleiben getrennte frühere Läufe. - -### Geliefert und Sicherheitsgrenzen - -- Neu: `deploy/vm_mvp_acceptance.py`, `tests/vm_mvp_guards.py`, - `deploy/browser/run_mvp_actions.py`, `tests/browser/mvp-actions.spec.ts`. - Keine Änderungen an WebUI-/Agent-/Helper-/Domain-/Server-/APTtool-Quellen, - keine Rootkonfigurations-/Policyerweiterung und kein Build/Serverrestart. -- Defaultkommando ist ausschließlich lesend. Echter rmcp-Streamable-HTTP-Client, - Protokoll 2025-11-25 mit initialize/initialized/Session-ID; liest - `tenants.list`, `inventory.list_devices`, `inventory.get_device`, - `monitoring.get_health`, tatsächlichen Dev-Loginmodus und gespeicherte Jobzustände. - Die erhaltene konkrete Linux-VM ist fest gebunden, nicht durch Konfiguration - auf beliebige andere Geräte erweiterbar. Trunkierte Gerätelisten ersetzen - niemals den authentisierten Einzelgeräteabgleich. -- Ausführung verlangt ausdrücklich `--run-realtime-dev-ui-acceptance`, ausgewählte - feste Cases und ein vorhandenes Benutzerartefakt (Eigentümer aktuell, regulär, - kein Symlink, 0600, höchstens 1 MiB, keine doppelten JSONfelder). Artefakt enthält - exakt `profile`, `tenant_id`, `asset_id`, `agent_id`, `approved_cases`, - `expires_at`, `wiring_verified`, `expected_principal`. Profil dev/test, gleiche - erhaltene Gerätebindung, explizite Cases, Ablauf höchstens eine Stunde und - `simulated-testprincipal-a` sind zwingend. Dieses lokale Opt-in ist **keine - Jobgenehmigung und kein Sync-/Capabilitybeweis**. Es wird nicht automatisch - erzeugt oder auf wahr gesetzt; echte Worker-Wiringnachweise müssen zuerst vorliegen. -- Unveränderliche TLS-Origin `https://rmm-dev.internal:18443`, TCP nur - `127.0.0.1:18443`, vorhandene öffentliche Dev-CA; kein alternativer Hostname, - Credential-in-URL, Proxy-/Redirect-/Invalid-Cert-Bypass. UID0 als Netzwerkagent - wird abgewiesen. Für Jobs werden frischer tatsächlicher Kontakt unter 90 s, - ausgehandelte Aktion plus `rmm.sync.v1` und bei Root zusätzlich `helper.root.v1`, - `root:` und exakter Helperpolicydigest verlangt. Serverseitiger Sync-/ - Policy-/Grantgate bleibt unabhängig bestehen; kein Capability-DB-Override. -- Vor jedem Case blockieren queued/accepted/running/verifying/unknown/ - awaiting_reboot im bestehenden VM-Ledger. Nichts wird zurückgesetzt, gelöscht, - über SSH repariert oder als neuer Versuch automatisch wiederholt. Ein fehlender - Ergebnisnachweis/Timeout bleibt Fehler mit erhaltenem privaten Checkpoint; - Suite stoppt, statt Folgecases/Retry auszulösen. Sie übernimmt keine fremden - Tunnel-/Dienst-PIDs und startet/stoppt keinen technischen VM-Prozess. - -### Vorbereitete Caseabdeckung und ausdrücklich offene Adapter - -**Sechs ausführbar implementierte, hier nicht ausgeführte Caseadapter:** - -1. `hello`: unveränderte exakte POSIX-Shellbytes, stdout mit LF und Exitcode 0. -2. `refresh_inventory`: linux.base, echter Ergebnis-Erhebungszeitpunkt mindestens - so neu wie der im genehmigten Job gebundene Startzeitpunkt. -3. `query_logs`: ausschließlich `rmm-mvp-test.service`, feste fünf Minuten, - höchstens 50 Zeilen/65536 Outputbytes; gültige Qualität statt erfundenem Erfolg. -4. `service_setup`: nur ein fest eingebautes, vollständig UI-genehmigtes - Rootskript für create-only Testunit, `/usr/bin/sleep infinity` unter - `rmm-agent`, keine Paketinstallation, kein Enable/Start. Geladene Unit wird - im gebundenen Skript nachgeprüft, erwartete stdout exakt festgelegt. - Browser bindet die Skriptbytes zusätzlich an SHA256 - `159ff240504b8a350b46a56fdf9cd50e5768816de7e6683829f05144978449f0`. - Aktuelle Rootscriptpolicy/Writesandbox wird dadurch nicht eingeschaltet. -5./6. `service_start`/`service_stop`: typisierte Rootaktion ausschließlich für - diese Unit, 180 s; nur als ausdrücklich genehmigte Reihenfolge - setup → start → stop auswählbar. Kein beliebiger Dienstname/Restart. - -Für jeden Case: eigener MCP-Plan/Submit, gespeicherte Planbytes/SHA256 und genau -ein festes Ziel, vor UI-Genehmigung je reserviertem Job **0 Jobs/Outbox/Grants**, -Antrag pending_approval und keine Executionaggregation. Danach ausschließlich -geschütztes Casefile an Browserrunner; echtes normales TLS-Login, sichtbare -Simulation und tatsächliche Sessionfelder/Principal geprüft, vollständiger -angezeigter Plan/Job/Hash/Bytes/Fristen/Identität geprüft, Checkbox und sichtbarer -Genehmigungsbutton geklickt. Keine direkte API-/SQL-Genehmigung. Anschließend -bestätigtes Ergebnis plus Nachbedingungen, genau 1/1/1 und tatsächliches Audit -mit Principal, Planhash, approval_origin und testsimulation. Keine Log-/Script- -Outputinhalte in öffentlichen Testergebnissen; keine Screenshots/HAR/Traces. - -**Neun ausdrücklich `pending_protocol` und nicht ausführbare Cases:** -`apt_native_install`, `apt_native_update`, `ensure_package`, `apply_updates`, -`duplicate_offer`, `lost_result_ack`, `cancel_queued`, `expired_offline`, -`reboot_last`. Ihre Auswahl wird vor Plan/Submit verweigert, auch bei einem -lokalen Opt-in-Artefakt. Sie sind weder übersprungene bestandene Tests noch -pauschal durch neue Jobs ersetzte Replaynachweise. - -- APT: reiner strikter Formatvalidator für vollständiges Helper-schema-2-Manifest, - Originaltransactionbytes/Hash/typed object, alle Runtime-/Provider-/Hook-/Config- - und Baselinepins, exakt ein rmm-mvp-test-Archiv 1.0/1.1, Herkunft/Größe/Pfad und - no_reboot. Das sind nur Fixture-/Parsertests, **keine aktuelle Baseline oder - Native-Acceptance**. Ausführungsadapter wartet auf echten UI-genehmigten - Planungs-/Preseal-Diagnosebeleg oder genehmigte passive Planungsdaten; kein - SSH-Live-Resolve, kein manuelles Schreiben von Baselines/Acceptance-Markern. -- Replay/ACK: kontrollierter same-job/same-attempt Zustell-/ACK-Fault-Adapter fehlt. - Keinen zweiten Job als vermeintlich erfolgreiche Redelivery ausführen. -- Cancel/offline/Fristen: kontrollierter nachgewiesener Nichtstart-/Offline-Sync- - Fence fehlt; reine Zeit-/Parserchecks werden nicht als VM-Abnahme ausgegeben. -- Reboot zuletzt: reiner Checkpoint-/Ergebnisvalidator vorhanden, aber echter - eigener Tunnelrecovery-/SSH-Wiederkontakt-/authentisierter Syncadapter fehlt. - Vor tatsächlichem Reboot müssen alte Boot-ID, Tenant/Agent/Asset, Operation, - Job/Versuch und Planhash privat persistiert sein. Gleiche Boot-ID und Exitcode 0 - sind nie Erfolg. Kein Reboot wurde geplant, genehmigt oder ausgeführt. - -### Tatsächlich in diesem Vorbereitungslauf geprüft - -```sh -python3 tests/vm_mvp_guards.py -python3 tests/vm_job_guards.py -python3 -m py_compile deploy/vm_mvp_acceptance.py deploy/browser/run_mvp_actions.py tests/vm_mvp_guards.py -python3 deploy/vm_mvp_acceptance.py -# jeweils in web/: -npm run typecheck -npm run test:browser -- mvp-actions.spec.ts --list -npm test -- src/api.test.ts -``` - -- **12 neue Guardtests**, **15 vorhandene VM-Guardtests**, Syntaxprüfung und - TypeScript-Typecheck bestanden; **9 lokale API/UI-Tests** bestanden. - Browserkommando war ausschließlich Discovery: **kein Browserlauf**. -- Echte read-only MCP-/Backendstrecke erfolgreich; erhaltene VM eindeutig - aufgelöst, Liste nicht trunkiert, Dev-Loginprofil bestätigt. Gespeicherte - Präsenz tatsächlich **unreachable**, alte Capabilities nur linux.base/1, - heartbeat/1, run_script, refresh_inventory. Deshalb kein aktueller Live-/Sync-/ - Root-/APT-Readinessbeweis und keine Ausführung begonnen. Kein Credentialinhalt, - Hostname oder Inventar-/Logpayload veröffentlicht. -- **Neue Flowzählung dieses Laufs: 0 Pläne/Submit, 0 UI-Genehmigungen, 0 Jobs, - 0 VM-Änderungen, 0 Tunnel-/Dienststarts.** Keine SSH-Geschäftsaktion, - Rootconfig-/Policyänderung, Paketinstallation, Update oder VM-Reboot. - -### Ausführbare Kommandos / noch nicht ausgeführte Fortsetzung - -Lesendes Defaultkommando, tatsächlich wie oben geprüft: -`python3 deploy/vm_mvp_acceptance.py`. - -**Geplant, nicht ausgeführt**, erst nach tatsächlichem Worker-Wire-up, frischer -VM-Verbindung und gesondertem geschütztem Benutzerartefakt: - -```sh -python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \ - --user-artifact devstate/mvp-user-opt-in.json --case hello --case refresh_inventory -# Separat und nur mit tatsächlich freigegebenem Rootscript-/Serviceprofil: -python3 deploy/vm_mvp_acceptance.py --run-realtime-dev-ui-acceptance \ - --user-artifact devstate/mvp-root-opt-in.json \ - --case service_setup --case service_start --case service_stop -``` - -Suite erzeugt private neue Nachweisverzeichnisse und Checkpoints, aber keine -Autofreigaben oder VM-Prozess-/Journalreparatur. Bei Fehler zuerst festen Versuch, -Helper-/Agentledger und eigenen technischen Lifecycle abgleichen, keine Identität -oder Journale löschen. Technischer Rollback betrifft ausschließlich nachweislich -eigene inaktive Prozesse/Units; Root-Geschäftseffekte/Retry benötigen weiterhin -neuen festen UI-genehmigten Plan. **Vorbereitete Suite ist kein Linux-MVP-Abschluss.** - -Diese Datei beschreibt Entwicklungsnachweise; kein M1-/MVP-Abschluss. -Die älteren Abschnitte unten protokollieren den passiven Erstslice und sind keine -aktuelle Aussage, dass Job-/UI-Code weiterhin fehlt. Für aktuelle additive -Schnittstellen gelten außerdem `proto/BACKEND_CONTRACT.md` und -`deploy/linux/README.md`. Deren Implementierung ist keine positive VM-Abnahme. - -## Aktueller VM-Jobversuch: vor Deployment sicher blockiert (2026-11-12) - -### Neuester Bootstrapnachweis: separater RootHelper vorbereitet, APT bewusst gesperrt - -- `deploy/vm_root_bootstrap.py`, explizite - `deploy/linux/rmm-helper-dev-test.service` und - `deploy/linux/ROOT-READINESS.md` ergänzt. Keine Rust-/Domain-/Backend-/APTtool- - Quelldateien verändert. Vorgaben aus `tools/apt-transaction/HELPER-CONTRACT.md` - und konkreter Helperkonfiguration gelesen; bestehende gehärtete Standardunit - nicht abgeschwächt. Root-/APT-Jobs wurden nicht ausgeführt oder genehmigt. -- Tatsächlich vor Installation lesend auf VM geprüft: alle neun neuen Helper-/ - Provider-/Drop-in-Pfade fehlten, kein Agent/Helper aktiv, kein Listener auf 18443; - erhaltenes Agentkonto UID 993/GID 984 und privater Agentstate unverändert sicher. - Ein unresolved-Job-Guard liest den bestehenden Serverledger; keine DB-Schreiboperation. -- `python3 deploy/vm_root_bootstrap.py build`: separater Docker-OpenSSL-3- - Helperbuild erfolgreich. Kein Serverimage deployt oder Server neugestartet. - Der erste Buildcontext war unnötig groß (2.575 GB); der Copyfilter schließt - künftig ausdrücklich `target`, `node_modules`, `devstate`, Credentials und - Secrets auch innerhalb kopierter Bäume aus. Dieser Filter wurde nicht durch - einen zweiten vollständigen Imagebuild als Größenmessung ausgegeben. -- `python3 deploy/vm_root_bootstrap.py install` nach einem korrigierten - generierten-Code-Importfehler erfolgreich. Fehler transportierte ausschließlich - `NameError` und numerische Zeilennummern, keine Meldung/Payload/Locals. - Ein neuer Test führt echte generierte Hash-/Manifestfunktionen aus und deckt - deren Imports ab; der gescheiterte erste Versuch hatte laut erneutem echten - Preflight noch keine RootHelperressourcen angelegt. -- Aktuelles Helperartefakt benötigt maximal glibc **2.34**; konkrete Auflösung - mit VM-Loader vor Start bestanden. SHA256: - `e8faa5a54c9d693618d497149bf448cf8b52456e9d225038950d5f04c2a6bc8a`. - Installation create-only unter `/usr/local/libexec/rmm-privileged-helper`. -- Authentisierter öffentlicher Signingkey-GET mit normaler CA-/DNS-Verifikation; - exakter Abgleich von Tenant/Agent/Asset/Enrollmentgeneration/Assignmentversion - und bereits gepinntem Agentkey vor Rootprovisionierung. Separate Rootdateien - `/etc/rmm/helper-dev-test-v1.json` und `helper-signing-key-v1.json` sind Root:Root - **0600**. Keine privaten Serverkeys kopiert oder Agentidentitäten verändert. -- Kompilierter Helper installierte ausschließlich feste eingebettete APTtool-/ - Hookbytes mit `--install-apt-provider`, leere `archives`, `baselines`, `history` - und Root-0600-Installmetadata. Exakte Hashes/Metadata geprüft; keine Archive, - Baseline, active-Kontexte, Grants oder Acceptancebelege erzeugt. - Durch geerbte UMask entstanden zunächst 0600/0700-Payloadmodi; v2 korrigiert - ausschließlich nach geprüftem Rootowner, Single-Link und exaktem Buildhash auf - die vertraglichen Code-/Hookmodi 0644/0755, Codedirectory 0755. Folgeinstallationen - setzen nur für den separaten Codeinstaller UMask 0022, Trust/State bleiben privat. -- Native readonly Messungen: Ubuntu-24.04-amd64, Python 3.12.3, APT 2.8.4, - dpkg 1.22.6, mount/unshare util-linux 2.39.3. Gemessene Pins: - Runtime `223016938765625ac7e71ebd5f021c6911c9e2013fafdba1c4497c7e4dc69acc`, - APT-Config `045f1bb45f4532112b7a5503e368ed3e1aae03fcc5b6275cbaa3caf7e8a48941`, - Provider `3591bf16a1c0f78d2f53fb366ac93d723f3d82e63ed2b5085eb1649e5ba5dec6`, - Hook `5b4caa7fc1fd6acf1f2b1b9a03e56074ee5595c86592b183fa6da76fe9e8f609`. - Vollständiges gemessenes Runtimeobjekt liegt ausschließlich im privaten Report. -- Direkter rootseitiger `inspect-sandbox` endete tatsächlich mit **100/Veto**, - **nicht bestanden**. Der Parent ist nicht der fertige signierte APT-Worker; - es wurden keine Hostnamespace-/Sandbox-ready-/Acceptance-Dateien gefälscht, - keine Paketmutation und kein Reboot-/Host-PID1-Systemcontrolprobe durchgeführt. -- `systemd-analyze verify` der neuen Unit bestanden. Helper ist unter ausdrücklich - benannter dev/test-Unit **enabled, jetzt gestoppt**. Bei echtem Start Socket - Root:GID984, **0660**, Runtimeparent Root:GID984 **0750** geprüft. UID993 konnte - ausschließlich connecten und schließen, ohne Request/Grant. Das ist ACL-Readiness, - keine signierte IPC-/Rootaktionsabnahme. Helperledger **0 Verbrauchseinträge**. -- Post-exec-Kernelprüfung separat bestätigt: Helper-PID **4146110**, UID0/GID984, - **NoNewPrivs=1**, **Seccomp=2**, CapBnd `00000000800001db`, CapEff - `000000008000015b` (strengere Teilmenge). Erste Statusmessung direkt nach - systemd-Type=simple-Start traf noch Pre-exec-Zustand und ist ausdrücklich kein - Confinementbeleg. v2 verlangte irrtümlich alle acht Capabilities auch effektiv; - nach lesender Diagnose wurde nur der Guard auf erlaubte effektive Teilmenge - korrigiert, **keine Unit-/Kernelrechte gelockert**. Der schon laufende Probehelper - wurde ohne Neustart weiter geprüft und nach bestätigtem leerem Ledger gestoppt. - v3 ist der maßgebliche Sandboxbeleg, ältere Reports bleiben nachvollziehbar. -- Netzwerkaccount kann weder Helperconfig/-Pin/State noch Provider/Installmetadata - schreiben; Helperpin und State sind für UID993 nicht lesbar. Rootstate **0700**; - Agentidentitäts-/Journal-Dateihashes und SQLite-Schema/Rows vor/nach unverändert. - Agentunit bekommt nur einen neuen Root-eigenen versionierten Drop-in: - `RMM_HELPER_SOCKET=/run/rmm-helper/control.sock`; kein Agentrestart, keine - Enrollment-/Binding-/Journalmigration in diesem Schritt. -- Abschließend VM bestätigt: Agent **gestoppt**, Helper **gestoppt**, Runtime- - Socketverzeichnis entfernt, kein 18443-Listener. Kein Tunnel angelegt. Testpaket - `rmm-mvp-test` nicht installiert und Testservice-Datei nicht vorhanden. Keine - Paket-/Diensttest-/Update-/Rebootwirkung. Helper bleibt enabled für einen späteren - ausdrücklich freigegebenen Systemstart; daraus folgt keine RMM-Jobgenehmigung. -- Private Evidenz: `devstate/vm-root/{build,result,readiness-v3}.json` sowie - `/etc/rmm/root-bootstrap-v1-report.json`, `root-readiness-v2-report.json` und - maßgeblich `root-readiness-v3-report.json`. Teil-/Fehlerreports nicht löschen. -- Tatsächliche Prüfungen: **15 Python-Guardtests bestanden**, Python-Syntaxprüfung - bestanden. Tests prüfen generiertes Remoteprogramm/Hashabhängigkeiten und - Secretcanary, Rootconfig ohne Paket-/Reboot-/Rootscript-Autorisierung, konservativen - Cleanup und Verweigerung von Pre-exec-/überprivilegierten Kernelzuständen. - Keine erneute Behauptung der früheren 18 Rusttests; hier Helper-Releasebuild, - native Readiness und gezielte Pythonprüfungen, keine volle Workspace-Suite. - -**Konkrete verbleibende APT-/Root-Ausführungsgates:** `apt_provider=null`, -`allow_reboot=false`, `allow_root_scripts=false`; ausschließlich zukünftige -`rmm-mvp-test.service` als erlaubte Dienstkennung. Keine Paketcapability aus -Installation ableiten. Die Readinessunit hat kein CAP_SYS_ADMIN/CAP_MKNOD und -verweigert Mount-/Rebootsyscalls; ProtectSystem=strict verhindert notwendige -Paketdatenbank-/Payloadschreibzugriffe. Ein separat überprüfter APT-Setup-Runner -braucht private Mount/PID/Netznamespace- und Devicenode-Erstellung, muss danach -den Packagechild auf exakt die acht vorgesehenen Capabilities/NNP/seccomp -reduzieren und Hostkontrollsocket-/Readonlypfade sicher ausblenden. Dies wurde -nicht blind durch Entfernen der Unit-Härtung ermöglicht. Backend muss vollständige -signierte Root-/APT-Manifeste erhalten; Agent muss Helperfähigkeiten ausdrücklich -aushandeln und vorhandenen Sync-/Reconnectzustand abgleichen. Erst dann neue feste -UI-genehmigte Jobs. **Kein Paket-/Rootaktions- oder Linux-MVP-Abschluss.** - -### Neuester Nachweis: erster tatsächlicher nichtprivilegierter VM-Job erfolgreich - -Der frühere Blocker in der Abschnittsüberschrift ist für **diesen ersten** -Hello-World-Lauf behoben. Historische Fehlversuche darunter bleiben Nachweisprotokoll, -keine Aussage über den jetzt bestätigten Endzustand. - -- Tatsächlich ausgeführt: `python3 deploy/vm_job_test.py --run-service-hello`. - PC-eigener strikter Reverse-Tunnel, VM-Listener ausschließlich - `127.0.0.1:18443`, vertrauenswürdige CA/DNS-Prüfung `rmm-dev.internal`; - keine Hostkey-/Firewall-/sshd-/Hostsänderung. Native systemd-Agent-PID - **4144575**, tatsächliche UID **993**, kein Root-Netzwerkagent. -- Zwei verschiedene frische Heartbeats derselben erhaltenen Geräteidentität: - **18:04:45.200243 UTC** und **18:05:20.200437 UTC** am 2026-11-12. - Zum Prüfzeitpunkt jeweils unter 90 s alt; `run_script` tatsächlich gemeldet. - Tenant-B-Leser erhält für dieses Tenant-A-Gerät HTTP 404. -- Echter rmcp-Streamable-HTTP-Client mit `initialize`/`notifications/initialized`, - Protokoll **2025-11-25**; `operations.plan` und `operations.submit` beantragen - exakt einen festen Job auf genau diesem VM-Asset. Exakte Bytes: - `printf '%s\n' 'Hello World'` mit abschließendem LF, `/bin/sh`/`posix_sh`, - `agent_service`, erwartete stdout `Hello World` mit LF, Laufzeitlimit 60 s, - Outputlimit 65536 Bytes, Planstartfrist 15 Minuten, Parallelität 1. -- Vor Genehmigung realer persistenter Antrag `pending_approval`, null Jobs, - keine Executionaggregation; gerätebezogene DB-Leseprüfung ergab - **Jobs/Outbox/Startgrants = 0/0/0**. Keine direkten Freigabe-API-/DB-Aufrufe. -- **Tatsächlicher Playwrightlauf bestanden**, nicht nur Discovery: normales - TLS-Login mit geschützter Loginfile, sichtbar simulierter Testprincipal, - bestehenden Antrag öffnen, vollständigen unveränderlichen Einziel-Preview, - Bytes/Nachbedingung/Identität/Limits und SHA256 der gespeicherten Planbytes prüfen, - Checkbox und sichtbaren Genehmigungsbutton klicken, Ergebnis anzeigen, Logout. - NSS-Trust isoliert, keine Screenshots, HAR, Traces oder Geheimnisausgaben. -- Danach **Jobs/Outbox/Startgrants = 1/1/1**, genau ein serverseitiger - `start_reserved`-Audit und ein `plan_authorization`-Audit. Serverjob `succeeded`, - Revision 2, nichtleerer Journalannahmenachweis, exakte Agent-/Asset-/Jobbindung - und `execution_identity=agent_service`. Ergebnis: Exitcode 0, stdout exakt - `Hello World\n`, `postconditions_passed=true`. Kein separat beobachtetes - `verifying`-Zwischenereignis behauptet; bestätigtes Endergebnis liegt vor. -- Genehmigungsaudit: `approval_origin=dev_test_browser_simulation`, - `testsimulation=true`, Principal `simulated-testprincipal-a`, exakt gebundener - Planhash `b58910cdbdb1047355ddc36d03c0dd3c7d3a58eb39a91b965242b3c2c8c2fda9`. - Ausschließlich Entwicklungs-Browsersimulation, **kein menschlicher - Produktionsfreigabenachweis**. -- Nachträgliche echte lesende VM-Prüfung: `journal.sqlite` enthält genau einen - passenden Job/Versuch mit `succeeded` und derselben Grant-ID wie der Server; - `job_events` leer (kein unbestätigtes Jobevidence mehr). `consumption.sqlite` - enthält genau einen Verbrauch mit demselben Job und Grant sowie genau einen - zugehörigen Executionevidence-Eintrag. Keine neue Wirkung oder Redelivery - zum Beweis provoziert. Serverjob hat keine persistierte Bootspalte; deshalb - kein zusätzlicher unabhängiger Boot-Bindungs-/Replaynachweis behauptet. -- Erst nach terminalem Jobende eigenen Dienst gestoppt und eigenen Tunnel-PID - **2110999** beendet. Nachträglich VM bestätigt: Dienst nicht aktiv, kein Listener - auf 18443. Installation bleibt erhalten, nicht enabled; Identität/Journal nicht - gelöscht, State 0700 und sämtliche State-Dateien 0600. Kein aktiver lokaler - Testrecord. Geschützte Evidenz/PIDs/IDs: `devstate/vm-jobs/result.json`. -- Abschließende **10 Python-Guardtests bestanden**, Syntaxprüfung bestanden, - TypeScript-Typecheck und **9 lokale API/UI-Tests bestanden**. Regressionen prüfen - tatsächliches generiertes Bootstrapprogramm, Secretcanary-Fehlertransport und - dass aktive/unknown Zustände keinen automatischen Dienst-/Tunnelstop erlauben. -- **Wiederaufnahme (geplant, nicht erneut ausgeführt):** zuerst PC-initiierten - strikten Tunnel gemäß `docs/development.md` mit `-N -T`, - `ExitOnForwardFailure=yes`, Keepalive 30/3 und - `-R 127.0.0.1:18443:127.0.0.1:18443` über vorhandene vertrauenswürdige SSH-Daten - aufbauen; anschließend über denselben verifizierten Bootstrapzugang - `systemctl start rmm-agent.service`. Dienst benötigt diesen Dev-Tunnel. - Kein neuer Job vor bestätigtem Backend-/Agent-Reconnectabgleich: der vorhandene - Safetyzustand wird niemals gelöscht/umgeschrieben. Der Erstlauf-Testbefehl - verweigert absichtlich vorhandene VM-Jobhistory und ist kein Wiederholungsbefehl. -- **Offen:** Sync-/Reconnect- und Redelivery/ACK-Verlustabnahme, unabhängiger - Bootnachweis, weitere UI-genehmigte Inventory-/Logjobs, Long Polling, - Roothelper-/Dienst-/Paket-/Update-/Rebootstrecken. Keine dieser Zielwirkungen - wurde ausgeführt. Rotation/Recovery/weitere Sicherheitsabnahmen weiterhin offen. - Dieser positive Hello-World-Nachweis ist **kein M1-/Linux-MVP-Abschluss**. - -### Fortsetzungsversuch mit ausdrücklich genehmigtem Dienstkonto-Bootstrap - -**Nachtrag: kontrollierte Reparatur und Migration inzwischen erfolgreich.** - -- Vor erneutem Installationsversuch tatsächlichen VM-Teilzustand ausschließlich - lesend geprüft: Originalstate vorhanden, Zielstate fehlte; dediziertes nologin- - Konto UID 993/GID 984 und eigene Binary/geschützter Bootstrapreport vorhanden, - noch keine Unit. Keine supplementary Gruppenmitgliedschaft des Kontos. -- Tatsächlicher ursprünglicher Loaderfehler zusätzlich konkretisiert: Hostbuild - benötigt `libssl.so.1.1`/`libcrypto.so.1.1`; Ubuntu-VM-Loader meldete Exit 127 und - fehlendes `libssl.so.1.1`. Der reine glibc-Vergleich genügte ausdrücklich nicht. -- Reportinitialisierung vor Seiteneffekte gezogen, geschützten Report über - `try/finally` persistiert, Fehlertransport auf Exceptionklasse und numerische - Tracebackzeilen begrenzt. Keine Fehlermeldungen, Locals oder Payloads übertragen. - Provenienzgeprüfte Fortsetzung verweigert fremde Dateien, veränderten Originalstate - und unbekannte Configeinträge. Eigene alte Binary nur nach exaktem lokalem - SHA256-Abgleich durch vorher VM-loadergeprüftes neues Artefakt ersetzt. -- Aktuelles Artefakt separat in Docker gebaut: - `docker build --target build -f deploy/Dockerfile -t rmm-vm-agent-build:dev .`. - Build erfolgreich, **kein Serverdeploy/-restart**. Dockercontext schließt Secrets - aus. Extrahiertes Agentartefakt benötigt glibc 2.34 und OpenSSL 3; dessen konkrete - Bibliotheksauflösung auf der tatsächlichen Ubuntu-VM erfolgreich. -- `python3 deploy/vm_job_bootstrap.py` danach **erfolgreich**: gleiche erhaltene - Geräteidentität/Privatekey/SQLite-Dateibytes per atomarem Rename nach - `/var/lib/rmm-agent` migriert, Source-Statepfad nicht als zweite aktive Identität - erhalten. Vorher/nachher sämtliche Datei-SHA256 und SQLite-Schema-/Rowdigests - identisch; ursprüngliches Journal hatte `counter` (1 Row), `pending` (0 Rows), - noch keine Job-/Safetyhistory. Keine Tabellen-/Safetyflagänderung zur Migration. - Geräteidentität nicht neu enrollt; keine DB-/PKI-Resets. -- Stateverzeichnis 0700 und Dateien 0600, Konto UID 993; Root-eigene Binary/Unit, - Root-eigene Configdirectory 0755, service-eigene Bindingdatei 0600 (vom Agentreader - verlangt), öffentliche CA 0644. Eigene zuvor durch UMask 0077 versehentlich 0700 - angelegte Installationsdirectories nach Provenienzprüfung auf 0755 korrigiert. - Unit hat `User/Group=rmm-agent`, keine Capabilities, NoNewPrivileges und strikte - systemd-Sandbox. Nur daemon-reload, kein enable/start durch den Bootstraphelper. -- Geschützte Evidenz: lokal `devstate/vm-jobs/bootstrap.json`, auf VM - `/etc/rmm/vm-bootstrap-report.json`. Root-Helper nicht installiert/provisioniert. - Keine Root-Jobs, Zielpakete, Updates oder Reboots ausgeführt. -- **Rollbackplan:** Nur bei nachweislich inaktiven Jobs Dienst stoppen; nach - internem Manifestabgleich gesamten State atomar zurück zum im privaten Report - gespeicherten alten Pfad verlagern und ursprüngliche Rootownership wiederherstellen. - Nie beide Identitätspfade gleichzeitig starten; keine automatische pauschale - Ressourcen-/Accountlöschung. Erfolg dieses Plans wurde nicht praktisch getestet. -- Zwei neue Regressionen führen das **wirklich generierte Remoteprogramm** isoliert - mit gemockten OS-/Account-/Loaderaktionen aus: fehlender Binaryparent plus - erfolgreiche Report-/Migrationsstrecke; Loaderexception mit Secretcanary im - argv/stderr, nur Klasse/Zeilennummern im Transport und persistenter Teilreport. - Erster Regressionslauf blockierte korrekt wegen eines vom Test offengehaltenen - SQLitehandles; Test schließt dieses jetzt explizit. Danach **9 Guardtests bestanden**. - Python-Syntaxprüfung bestanden; TypeScript-Typecheck und **9 lokale API/UI- - Unit-Tests bestanden**. Kein neuer Rustquellcode geändert. -- `deploy/vm_job_live.py` und `deploy/vm_job_test.py --run-service-hello` ergänzen - begrenzte eigene Tunnel-/systemd-/MCP-/Browserorchestrierung. Sie lassen aktive - oder unbekannte Jobs samt eigenem Tunnel konservativ bestehen und führen keine - Freigabe über API/DB aus. Positive Laufzeitergebnisse sind separat nachzuweisen; - dieser Bootstrapnachtrag allein ist **kein positiver Job- oder MVP-Nachweis**. - -- Neue Bootstrapfreigabe erlaubt ausschließlich dediziertes nichtprivilegiertes - Systemdienstkonto samt Agentinstallation und verlustfreier Zustandsmigration; - keine Root-RMM-Jobs, Pakete, Updates oder Reboots wurden daraus abgeleitet. -- `deploy/vm_job_bootstrap.py` implementiert einen create-only Installationsversuch, - authentisierten öffentlichen Signingkey-Bezug, atomare State-Verlagerung auf - derselben Partition und Vergleich von Datei-SHA256 sowie SQLite-Schema-/Rowdigests. - Der Code ist **nicht erfolgreich auf der VM abgenommen**. Nach Fehlern nicht - unverändert erneut ausführen: zuerst VM-Zustand und etwaigen Teilbootstrap prüfen. -- Tatsächlich erfolgreicher aktueller Releasebuild: - `~/.cargo/bin/cargo build --locked --release -p rmm-agent --target-dir devstate/vm-jobs/build`. - Zuvor fehlte das lokal erwartete Docker-Rustimage, und `cargo` war nicht im PATH; - der vorhandene explizite Cargo-Proxy funktionierte. Keine Serverneubauten/-neustarts. -- Tatsächliche CA-verifizierte Operator-GETs erfolgreich: Gerätebestand HTTP 200 - mit erhaltenem Agentrecord einschließlich Enrollment-/Assignmentgenerationen; - öffentlicher Job-Signierschlüssel HTTP 200. Keine privaten Serverkeys übertragen. -- `python3 tests/vm_job_guards.py`: **7 bestanden** (zusätzlich Dateibytes und - SQLite-Schema/Rows, Symlink-/Hardlink-Verweigerung). Syntaxprüfung des Bootstraphelpers - bestanden. Kein erneuter positiver Browser- oder nativer Agentdienstnachweis. -- Zwei konkrete Bootstrapaufrufe scheiterten im privaten Remote-Kommandopfad: - `command failed; private diagnostics withheld`. Nach dem zweiten Fehlschlag - angehalten. **Remote-Teiländerungen nicht ausgeschlossen**, Migration/Dienstkonto/ - Installation nicht als abgeschlossen behaupten. Kein erfolgreiches lokales - `bootstrap.json`-Ergebnis. Vor Fortsetzung remote etwaiges - `/etc/rmm/vm-bootstrap-report.json` und create-only Ressourcen kontrolliert prüfen; - keine pauschale Löschung, kein Journalreset oder Reenrollment zur Reparatur. -- Der Helper ruft keinen Agentstart auf; kein eigener Tunnel wurde erstellt. - Hello-World-Plan, UI-Genehmigung, Audit- und Jobnachweise weiterhin nicht ausgeführt. - Erforderliche nächste Arbeit ist die Fehlerdiagnose/Teilzustandsprüfung, nicht - eine Behauptung erfolgreicher Migration oder ein blind wiederholter Installationslauf. - -- Vollständige Spezifikation 1.5, Projektentscheidungen, Entwicklungsweg sowie - Agent-/Backend-/Browserverträge vor dem Versuch gelesen. Kein RustDesk-Auftrag. -- Tatsächlich erneut über SSH mit vorhandenen Hostkeys und - `StrictHostKeyChecking=yes` geprüft: SSH-Benutzer hat UID 0, das erhaltene private - Testverzeichnis gehört UID 0, vorhandene Geräteidentitätsdatei ist vorhanden. - Kein bestehender dedizierter unprivilegierter Account namens `rmm-agent` oder - `rmm-test` gefunden. Andere Konten wurden weder als Testaccount interpretiert - noch übernommen. Keine Accountnamen-/Adress-/Identitätsinhalte ausgegeben. -- `deploy/vm_job_test.py` ergänzt und tatsächlich ausgeführt. Es ist derzeit - ausschließlich ein lesendes Readiness-Gate, **kein fertiger Deploy-/Jobrunner**. - Exit 2 mit drei konkreten Blockern: Root-SSH braucht kontrolliertes Deployment - unter bestehendem unprivilegiertem Account; kein solcher dedizierter Testaccount - vorhanden; Root-eigener alter Zustand braucht kontrollierte Accountmigration. - Kein Agentprozess und kein Listener auf 18443 vorgefunden. Geschütztes Ergebnis: - `devstate/vm-jobs/preflight.json` (0600, Verzeichnis 0700). -- Keinen Root-Netzwerkagenten als `agent_service` gestartet. Keine Accounts erstellt, - keine Ownership-/Journal-/Identitätsänderung, kein Reenrollment, kein Journalreset, - kein Tunnel, Deployment oder Serverrestart. Deshalb keine eigenen neuen Agent-/ - Tunnel-PIDs und kein Cleanup laufender Jobs erforderlich. -- `tests/browser/vm-jobs.spec.ts` und `deploy/browser/run_vm_jobs.py` als **noch nicht - positiv ausgeführte** Fortsetzung ergänzt. Der Browser öffnet einen ausdrücklich - bezeichneten bestehenden Antrag, prüft null Jobs vor Genehmigung, vollständigen - festen Einziel-Hello-World-Preview mit `agent_service`, exakte Skriptbytes, - erwartete Ausgabe, Limits und gespeicherten Planhash, dann ausschließlich Checkbox - und sichtbaren Genehmigungsbutton. Keine direkte API-/DB-Freigabe. Isolierter - NSS-Truststore und bestehender geheimnisunterdrückender Reporter bleiben erhalten. -- Tatsächlich ausgeführt: `python3 tests/vm_job_guards.py` (**5 bestanden**), - Python-Syntaxprüfung der drei neuen Pythondateien, `npm run typecheck` - (**bestanden**), `npm test -- src/api.test.ts` (**9 bestanden**). - `npm run test:browser -- vm-jobs.spec.ts --list` war nur Testdiscovery; - ausdrücklich **kein Browserlauf und kein VM-Jobnachweis**. -- Nicht ausgeführt: aktueller kompatibler Agentbuild/-transfer, Signingkey-bootstrap, - Bindingsabgleich, native nichtprivilegierte Agentstrecke, MCP-Plan/Submit für die VM, - positive UI-Genehmigung, Audit-/Grant-/Journal-/Outputprüfung, Inventory-/Logjobs, - Redelivery/ACK-Replay, systemd-, Paket-, Update- oder Rebootwirkungen. Das alte - Artefakt aus dem passiven Nachweis wurde nicht als aktueller Build ausgegeben. -- Nächster konkreter Schritt: dedizierten unprivilegierten Testaccount und eng - begrenzte Migration der **erhaltenen** VM-Geräteidentität abstimmen. Danach - Agentbuild und Deployment implementieren; vorhandenen Sync-/Reconnect-Schutz - respektieren, niemals Safetyflag/Journal löschen. Frische Telemetrie unter 90 s, - Auditursprung/Testprincipal und authentisierte Job-/Bootbindung bleiben offene - Nachweise. Bei unklarer Wirkung kein weiterer Versuch. **Kein Linux-MVP-Abschluss.** - -## Implementiert - -- Sechs tatsächlich verwendete Rust-Crates: Domain, Protobuf-Protokoll, SQLx-Persistenz, - Server (interne API-/Gateway-/TLS-Module), Linux-Collector und Agent (Transport/SQLite). - Weitere Spec-Crategrenzen werden erst bei benötigten Anwendungsfällen extrahiert; - keine leeren Worker-, MCP-, UI- oder Executor-Platzhalter. -- Gepinnte stabile Toolchain 1.99.1. Beim Bootstrap live über den offiziellen Stable- - Manifestkanal ermittelt: Manifestdatum 2026-10-15, rustc Commit `58cf8f9c3`. - Cargo.lock hält die tatsächlich aufgelösten Bibliotheksversionen fest. -- Docker-Compose-Projekt `rust-discovery-dev`, PostgreSQL intern, separater Migrator, - API/Gateway nur über PC-Loopback 18443. Migrationen und Keys werden nicht im Image erzeugt. - Serverrollen `api|gateway|all` getrennt auswählbar; API-only lädt keinen CA-Privatschlüssel. - GitHub-Actions-Prüfworkflow angelegt, aber noch nicht auf einem CI-Runner ausgeführt. -- Zwei Dev-Mandanten, zufällige getrennte Leser-Bearer. Expliziter Dev-Modus; Produktion - wird grundsätzlich verweigert, bis echte Produktionsauthentisierung implementiert ist. -- RLS auf Tenant-/Asset-/Agent-/Beobachtungsdaten. App ist weder Eigentümer, Superuser - noch BYPASSRLS. Kontext über `set_config(..., true)` je Transaktion. Eng begrenzte, - nicht öffentlich ausführbare SECURITY-DEFINER-Funktionen nur für Tokenverbrauch und - Zertifikatfingerprint → Gerätebindung. Keine tenant_id im Telemetriepayload. -- Atomarer Verbrauch eines gehashten einmaligen 15-Minuten-Enrollment-Tokens und - Geräteanlage. Lokal erzeugter EC-Geräteschlüssel; CSR-Signaturprüfung; 30-Tage-Clientzertifikat. -- rustls-TLS direkt im Rust-Server. Optionale Clientidentität ausschließlich für Enrollment/ - Dev-Lese-API; WSS verlangt gültiges Clientzertifikat plus registrierte, nicht widerrufene - Leaf-Fingerprintbindung. Identität kommt aus der TLS-Verbindung, nie HTTP-Headern. -- Binäre Protobuf-Envelope 1.0, begrenzte Frames, Hello, DB-Verbindungsgeneration/Fencing, - flüchtiger frischer Heartbeat, einteiliger SHA-256-geprüfter `linux.base`-Snapshot, - dauerhafter ACK nach Commit. Unbekannte Typen/Versionen werden nicht ausgeführt. -- SQLite mit synchronem Sequenzzähler, einem begrenzten unbestätigten Snapshot, - Replay/Deduplizierung und exklusivem Prozesslock. Kein Jobjournal, weil keine Jobs existieren. -- Read-only nativer Linux-Collector für OS, Hostname, Architektur, verfügbare Root-Bytes/Inodes. - Quelle/Erhebungs-/Empfangszeit, Teilinventar und unbekannter Gesundheitszustand sind sichtbar. -- Begrenzte Fehlerantworten mit Code/Korrelation ohne Request-/Secret-Echo. 128 Verbindungen, - TLS-/Hello-/Send-/Idle-Timeouts, Body-/Frame-Limits und einfache Kanalrate. Keine Lastfreigabe. - -## Prüfprotokoll - -Letzter tatsächlich ausgeführter Stand: - -- Native Toolchaininstallation 1.99.1 erfolgreich. -- `cargo build --locked -p rmm-server -p rmm-agent`: erfolgreich. -- Vier betroffene Unit-Tests: erfolgreich (Dev-/Prod-Grenze, Golden-Wire, - native lokale Linux-Inventur, SQLite-Persistenz/Lock). -- Clippy aller sechs verwendeten Crates/Targets mit `-D warnings`: erfolgreich. -- Abschließender nativer Build, `cargo fmt --all --check`, dieselben vier Unit-Tests - und Clippy inklusive Fehlermiddleware/Serverrollen: erfolgreich. -- Python-Syntaxprüfung für `deploy/dev.py`/`tests/local_integration.py`: erfolgreich. -- Docker-Releasebuild von Server und Agent erfolgreich. PostgreSQL auf frischem eigenen - Volume gestartet; SQLx-Migration erfolgreich (Migrationscontainer mit Exit 0). -- **Dev-PKI repariert und lokal geprüft (2026-11-12).** Frühere Fehler: doppelte - BasicConstraints aus Host-Konfiguration/`-addext`, danach fehlgeschlagener - `/dev/null`-Konfigurationsversuch. Jetzt vollständige isolierte `deploy/openssl.cnf` - mit CA-/Server-/Clientrollen, expliziten Extensions und DNS-SAN `rmm-dev.internal`. -- `python3 tests/bootstrap.py`: zweimal erfolgreich auf Host-OpenSSL **1.1.1w**. - Prüft frische PKI trotz absichtlich defekter Host-Konfiguration, eindeutige CA-/Server- - BasicConstraints/KeyUsage, Servername/-zweck, Clientzweck, TLS-Parser, Dateirechte - und Verweigerung des Überschreibens. -- Bestehende projektlokale Dev-Zertifikate kontrolliert neu ausgestellt: zuvor **0** - registrierte Agentidentitäten geprüft; CA-/Serverschlüssel unverändert, alte öffentliche - Zertifikate privat unter gitignored `devstate/` gesichert. Kein DB-/Volume-Reset. -- Erster Integrationslauf nach PKI-Reparatur: `ConnectionRefusedError`, obwohl der - Server erfolgreich startete. Docker zeigte konfigurierte PortBindings, aber leere - NetworkSettings.Ports auf internem Backend-Bridge-Netz. Separates Ingress-Netz nur - für den Server ergänzt; danach `127.0.0.1:18443` tatsächlich veröffentlicht, - PostgreSQL weiterhin ohne veröffentlichten Port (beides per Docker inspect geprüft). -- Folgender Lauf erreichte TLS/RLS/Enrollment, scheiterte aber an `BrokenPipeError` - beim Senden eines absichtlich übergroßen Frames: Server darf bereits den Header - ablehnen. Test berücksichtigt nun Transportabbruch auch während `sendall`. -- `python3 tests/local_integration.py`: anschließend **vollständig erfolgreich**. - Echte lokale Enrollment-/mTLS-/WSS-/Heartbeat-/Inventarstrecke, TLS-Trust-/Namensfehler, - anonyme/gefälschte Identität, Protokollmajor/fremde Agent-ID, alte Heartbeats, Größenlimit, - RLS ohne Kontext/Transaktionsreset/Cross-Tenant-Insert, Leser-Tenantgrenzen, - Rollenrechte, Enrollment-Rennen/CSR-Rollback, Agentneustart/Fencing und Widerruf geprüft. - Keine Job-/Outbox-/Startgranttabellen vorhanden. Kein VM-Erfolgsnachweis. -- Wiederholter Migrationscontainer: Exit **0**. Python-Syntaxprüfung für `deploy/dev.py`, - `tests/bootstrap.py`, `tests/local_integration.py`: erfolgreich. Rust-Code unverändert; - Rust-Build/Unit-Tests/Clippy in diesem PKI-Fix nicht erneut ausgeführt. -- CI und VM-/systemd-Abnahme weiterhin **nicht ausgeführt**. Keine SSH-/Tunnel-/VM- - Verbindung und keine Jobs, Updates oder Reboots in diesem Reparaturlauf. - -## VM-Zugang und echter passiver VM-Nachweis - -### VM-Zugangsvorbereitung, 2026-11-12 - -- `deploy/vm_access_check.py` ergänzt: striktes Datenparsing ohne Credentialausgabe, - Prüfung von Eigentümer/0700-/0600-Modi und Ignore-Regel, vorhandene Benutzer-Hostkeys, - strikte SSH-Namens-/Hostkeyprüfung. Fehlende/geänderte Hostkeys werden nicht akzeptiert; - ein gegebenenfalls ausgegebener Scan-Fingerprint ist ausdrücklich unbestätigt. -- Auf der tatsächlichen VM erfolgreich ausgeführt: minimaler lesender SSH-Check. - Beobachtet: Ubuntu 24.04, Linux x86-64, glibc 2.39, Benutzerhome vorhanden; - Port 18443 zum Prüfzeitpunkt frei. Keine privaten VM-Ziel-/Hostnamewerte dokumentiert. -- `python3 tests/vm_access_check.py`: fünf Tests bestanden. Python-Syntaxprüfung bestanden. - Keine Rust-Änderungen; Rust-/Docker-/Integrationstests in diesem Schritt nicht wiederholt. -- Beim ersten Zugangscheck noch kein Reverse-Tunnel/Agentdeployment; nach ergänzter - Pflichtlektüre wurde die folgende reale passive Strecke ausgeführt. - -### Tatsächliche VM-Passivstrecke, 2026-11-12 - -- `deploy/vm_passive_test.py` ergänzt und erfolgreich ausgeführt: vorhandene Prozesse/ - Portbelegung prüfen, konkretes Docker-Agentartefakt auf ELF/glibc/Libraries prüfen, - strikten PC-initiierten Loopback-Reversetunnel mit Keepalive herstellen und VM-Listener - prüfen, ausschließlich benutzerlokal in neuem privaten Testverzeichnis deployen. -- VM Ubuntu 24.04 x86-64/glibc 2.39; Artefakt benötigt maximal glibc 2.34. Konkrete - Bibliotheksauflösung mit VM-Loader vor nativem Agentstart erfolgreich. -- Enrollment mit einmaligem Dev-A-Token, lokal auf VM erzeugter Geräteidentität, - vertrauter öffentlicher CA und bestehendem TCP-Override erfolgreich. TLS-SNI und - Namensprüfung bleiben `rmm-dev.internal`; keine Zertifikatsprüfung ausgeschaltet. -- Echtes VM-Inventar serverseitig über tenantgebundene Lese-API bestätigt: OS/Architektur, - intern verglichener Hostname und positive verfügbare Root-Bytes/Inodes; - `linux.base`, `partial`, Erhebung 16:40:12.632 UTC, Empfang 16:40:12.796518 UTC. - Zwei frische Heartbeats um 16:40:44.849118 und 16:41:12.779675 UTC; Präsenz `online`. - Leser von Dev-Mandant B sieht diese Geräteidentität nicht. -- Eigene Agent-PID 4141792 nach exakter Executable-Prüfung per SIGTERM beendet und - Prozessende bestätigt; eigene Tunnel-PID 1869118 beendet und darauf gewartet. - Kein aktiver Testrecord; privates Benutzer-Testverzeichnis bleibt mit Zustand/Log, - Tokenkopie entfernt. Geschützte Evidenz/PIDs/privater Pfad unter - `devstate/vm-passive/result.json`; Details und ausgeführte Befehle in `docs/development.md`. -- Fünf Parser-Tests und drei lokale Orchestrierungs-Guardtests bestanden, - Python-Syntaxprüfung bestanden. Abschließender lesender VM-SSH-Check bestätigt - Port 18443 nach Testende wieder frei. Keine Ruständerung; - Build/Clippy/andere Integrationstests in diesem Schritt nicht wiederholt. -- Kein systemd-/Rootbootstrap, keine Pakete/Hosts-/Firewall-/sshd-Änderungen, keine Jobs, - Updates oder Reboots. Kein DB-/PKI-Reset. Passiver VM-Erstnachweis, **kein M1-Abschluss**. - -## Bewusste Grenzen / keine Abnahmen behaupten - -- Linux-M1 ist **teilimplementiert**, nicht abgenommen: passiver realer VM-Erstnachweis liegt vor, - keine systemd-Installation, Zertifikatsrotation, Recovery nach Zertifikatsablauf, - Long Polling, Proxyabnahme oder belastbare Klon-/Restoreerkennung. -- Windows beginnt erst nach Linux-MVP-Abnahme; kein Windows- oder ARM-Supportnachweis. -- CA-Signierung befindet sich nur im expliziten lokalen Dev-Gateway. Keine produktive - Rollentrennung/Signer-Isolation, OIDC, UI/MCP, Audit-WORM, HA oder Betriebsreife. -- Keine Jobs, Pläne, Genehmigungsendpunkte oder Executor. M2 darf erst mit echter - interaktiver WebUI-Freigabe implementiert/ausgeführt werden; keine Testausnahme. -- Snapshot-Scope beschränkt auf ein Root-Dateisystem, Qualität `valid` nur bei erfolgreicher - vollständiger lokaler Erhebung dieses Teilscopes. Fehler schließen den Kanal statt Werte - zu erfinden. Weitere Volumes/Software/Updates/Dienste sind nicht implementiert. -- Journal auf einen Snapshot begrenzt. Alter über 72 Stunden sperrt Übertragung und braucht - noch einen ausdrücklich entworfenen Gap-/Recoverypfad. Kein stilles Verwerfen/Erfolgs-ACK. -- Antwortverlust nach Enrollment-Commit benötigt in diesem Entwicklungsslice ein neues - Token/Enrollment; keine automatische Recovery mit unbewiesener Identität. Teilgeschriebene - lokale Identitätsdateien benötigen kontrollierte manuelle Recovery. -- Widerruf wird bei Reconnect und jeder Nachricht geprüft. Keine CRL/OCSP-Infrastruktur; - bestehende stille Kanäle enden spätestens durch 65-Sekunden-Idle-Timeout bzw. nächste - Nachricht. Keine Jobzustellung, die dieses Intervall ausnutzen könnte. -- Geräteliste max. 100 mit sichtbarer Trunkierung, keine Cursor/Einzelgeräteansicht. Alte - Beobachtungen aktualisieren keine Präsenz; aktuelle Inventaransicht wählt neueste Erhebungszeit. -- Image-Tags/Lockfile sind gepinnt, Images noch nicht über Digest/SBOM/Supply-Chain-Verfahren - freigegeben. Keine Produktionspasswörter/Private Keys oder VM-Credentials im Quellcode. - -## Nächster Slice - -1. Lokaler PKI-/TLS-/RLS-E2E-Nachweis liegt vor; vor weiterer Nutzung Gerätestatus und - Testhistorie prüfen. Fehlgeschlagene frühere Integrationsläufe können Testidentitäten - hinterlassen; keine vorhandenen Agentidentitäten oder Schlüssel pauschal ersetzen. -2. SSH-Zugang, konkretes Artefakt und passive VM-Strecke über Loopback-Reversetunnel - sind geprüft; private Testidentität/Verzeichnis für kontrollierte Fortsetzung erhalten. -3. Reconnect, Widerruf und systemd-Lebenszyklus auf VM nachweisen; eine dauerhafte - Dienstinstallation erst nach klarer Bootstrapfreigabe durchführen. - PID/Logs ohne Secrets dokumentieren; keine Updates/Reboots/fremden Paketinstallationen. -4. Linux-M1 um Rotation/Recovery/Long Polling und gezielte Fehlerabnahmen vervollständigen. -5. Erst danach M2 mit persistenter Antragsstrecke und minimaler menschlicher WebUI-Genehmigung. - -## Windows-PowerShell über MCP und WebUI nativ bestanden — 2026-11-16 - -Der konkrete LocalService-Testauftrag `645ad11b-9ecd-4efe-8f92-8ad2fb6ed5cf` -wurde auf der bestehenden Windows-VM über MCP angelegt und in der echten -WebUI mit sichtbar simulierter Identität genehmigt. Ergebnis `succeeded`, -Exit 0, exakte Ausgabe `Zeitprofil-Test`, stderr leer und Prozessprofil -RemoteSigned. Audit und unabhängige native SQLite-Nachlesung bestätigten -einen Grant und einen Verbrauch. Die VM ist wieder passiv. WebUI/MCP sind -nur an Server-Loopback gebunden, der Zugriff erfolgt per SSH-Tunnel. -OIDC ist keine MVP-Voraussetzung. Der persistente Testscope erlaubt genau -diesen Auftrag. Allgemeine Windows-/SYSTEM-Wartung und weitere Aktions- -abnahmen bleiben offen. Alle Originaljournale und die Geräteidentität -sind erhalten. [Ergebnis samt Fehlerkorrektur und IDs](windows-profile-acceptance.md#erfolgreicher-tatsächlicher-powershell-auftrag) diff --git a/docs/journal-capacity-acceptance.md b/docs/journal-capacity-acceptance.md deleted file mode 100644 index 10046d5..0000000 --- a/docs/journal-capacity-acceptance.md +++ /dev/null @@ -1,88 +0,0 @@ -# Finite journal capacity during the final Cloud reboot acceptance - -On 2026-11-13 the original approved Cloud-VM reboot had already happened, but -normal reconciliation stopped before producing a new Agent SyncRequest. The -Root database occupied 268,414,976 bytes: 65,531 pages of 4,096 bytes, against -the helper's 65,536-page limit. Helper checkpoint 1378 and both journals stayed -fault-free; generic transport/dependency errors did not identify the cause. -The VM still had approximately 21.6 GB of filesystem space available, so the -configured SQLite limit was distinct from disk exhaustion. - -The helper persists a capture before the Agent constructs its SyncRequest. -That transaction inserts the complete bound snapshot and advances the helper -checkpoint together. The configured limit prevented the insert, explaining -the unchanged helper checkpoint and absence of a new request. Historical -captures, signed responses and consumption tombstones intentionally remain -durable; this change deletes or rewrites none of them. - -## Actual copied-database proof - -The bootstrap adapter made a consistent private SQLite backup of the actual -Root database. On that copy, the old 65,536-page limit rejected a 524,288-byte -test insertion with **SQLITE_FULL, code 13**. After rollback, the exact same -insertion succeeded at the new finite limit of **262,144 pages / 1 GiB**. -It was rolled back again. The original database's bytes and inode remained -unchanged, and both copies of the schema/row fingerprint matched. No package -effect, RMM job or reboot was involved in this proof. - -## Preserving runtime maintenance and normal completion - -The shared `bounded_journal_capacity` now enforces 1 GiB on both Agent and -helper, still refusing unexpected page sizes. The Agent uses this same routine -when opening its journal, so both binaries were rebuilt. Qualified Bookworm -builds, **126 affected Rust tests**, formatting and warning-denying Clippy -passed. The existing capacity tests verify the new limit while retaining the -original consumed grant, start evidence, sequence and replay protection. - -The native maintenance versioned only the two binaries. It preserved all -18 Root consumptions, the original unresolved reboot, old signed histories, -device identity, database inodes, General policy/pin, provider and all APT -attempt/acceptance files. The helper was started first while the Agent remained -stopped for independent receipt verification. The qualified binaries are: - -- Agent: `9e9f323075f44e02e3900267b846f124303179171476a23d023708fc8339f9b4` -- Helper: `d6fbfc25263243475c50e703c014772c359533548bccc3f09ff91072b0e8b929` -- Unchanged provider: `1dc0237dd8df9c9d22568bb1f6b047ede73bc2a5fca5c7fcedb7f24ab2a58b1e` - -After the normal Agent resumed, the **same** original reboot grant -`25a4bf3f-772c-487d-825d-73bcbbc418fd` completed through signed RootSync. -The actual Root ledger then contained **18 consumed, 0 unresolved, 0 faults**; -the old 17 Root rows and database inodes remained unchanged. No second reboot, -new grant, direct outcome update or journal reset was used. The verified final -reboot result and restored non-reboot General policy are separate native -receipts in the original session. - -Protected witnesses, excluded from Git, are under -`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/`: - -- `capacity-copy.json`: actual SQLite error 13 and unchanged original database. -- `capacity-runtime.json`: completed preserving binary maintenance. -- `capacity-upgrade.json`: bound index of actual runtime and build receipts. -- `result.json`: verified completion of the original single reboot. -- `closed.json`: verified restoration of the original non-reboot policy. - -The APT endpoint remained disabled throughout. Because runtime measurement -includes the helper binary, its earlier closed APT pin becomes historical after -this replacement. A separate post-reboot tool remeasures the unchanged provider -and performs only the existing copied-database readiness probe after all -18 Root attempts are closed. It does not create a new package acceptance or -change any historical acceptance record. - -The initial post-reboot readiness run failed before launching the Python probe. -The bootstrap had incorrectly added three measurement fields to installation -metadata, whose Rust parser permits exactly four fields. Independent readback -confirmed the seven current keys, the exact original four-field backup and -unchanged values for those original fields. The failed report and all original -backups remain retained. A narrowly bound source correction restores a copy of -the original four-field bytes while separately versioning the invalid file; -it leaves the already correct runtime config/proof unchanged. This recovery -requires the original reboot to be closed and does not repeat any package job. -Its native completion must be recorded separately from the earlier failure. - -## Follow-up after the MVP - -The 1 GiB limit is finite reserve, not permanent retention management. Durable -capture/decision history continues to grow and another exhausted limit must -fail closed. Investigate measured growth, storage visibility and a separately -specified safe archival policy after the MVP; do not add deletion, compaction -or automatic limit increases to this acceptance fix. diff --git a/docs/journal-capacity.md b/docs/journal-capacity.md deleted file mode 100644 index 81417d3..0000000 --- a/docs/journal-capacity.md +++ /dev/null @@ -1,110 +0,0 @@ -# Begrenzte Journalgröße und SQLite-Kapazitätsfehler - -## Aktuell:256MiB-Grenze am Original-Reboot nativ reproduziert - -Spec1.15, tatsächliche Cloudkopie2026-11-13: OriginalRootDB268414976Bytes/ -65531Seiten. Eigene konsistente SQLitekopie mit65536Seiten und512KiB-Insert -scheiterte mit **SQLITE_FULL13**; vollständiger Rollback erhielt alle Zeilen -und Schema. Derselbe Insert auf derselben Kopie bei262144Seiten/1GiB gelang, -wieder vollständiger Rollback/Integritätok. Originalbytes/Größe/Inode unverändert, -Root18 und genau ursprünglicher Rebootgrant25a weiter offen/unverändert. -Keine Original-SQLmutation, Paketwirkung oder weiterer Reboot. Privater Beleg: -`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/capacity-copy.json`. - -Minimaler gemeinsamer Rustfix setzt für Agentjournal/Verbrauchsledger und -Helperledger262144Seiten bei strikt4096Bytes, ohne Kompaktierung/Löschung. -BookwormReleasebuildc8f567a84f1c483e8cfea753e34e2c8f und126Tests im gleichen -Lockfile-/Buildimage sowie Format/AlltargetsClippy bestanden. AgentSHA -`9e9f323075f44e02e3900267b846f124303179171476a23d023708fc8339f9b4`, -HelperSHA`d6fbfc25263243475c50e703c014772c359533548bccc3f09ff91072b0e8b929`; -ELFx64/OpenSSL3/GLIBC2.34. Provider1dc unverändert. Native Installation danach ebenfalls bestanden: ausschließlich Agent/Helper -versioniert ersetzt, General gestartet, Agent zunächst bewusst gestoppt. Vor -und nach Austausch/start alle18Verbrauchszeilen, DBinodes, Journal-/Identitäts-/ -APT-Historybytes sowie Generalpolicy/-pin erhalten. Keine Jobs/Grants/Paketwirkung -oder weiterer Reboot. Private capacity-runtime.json und separat hashgebundener -capacity-upgrade.json erhalten Originalbefore.json/Checkpoint unverändert. -Nach normalem signiertem Abschluss desselben Rebootgrants und Wiederherstellung -der ursprünglichen Generalpolicy folgte die aktuelle kopierende APT-Qualifikation. -Ein zunächst fehlerhaftes Bootstrap ergänzte drei unbekannte InstallMetadatafelder; -der strikte Rustparser verweigerte vor Pythonprobe. Originaler failedReport bleibt. -Separater versionierter Resume stellte genau ursprüngliche vierFeldbytes5566bc26… -wieder her; richtige Runtime-/Policy-Pins blieben unverändert. Tatsächlicher -kopierender NativeReadinesslauf unter Runtime6545c784… bestanden, alleRoot18/ -DBinodes/altenAcceptance-/Historydaten erhalten. APTgestoppt/Endpunktentfernt, -General+Agent wiederaktiv. readiness_onlytrue/native_acceptancefalse; **keine neue -Paketabnahme** oder Pakettransaktion, alte3bac-Paketnachweise nicht umgedeutet. -Details:[getrennter Kapazitätsbericht](journal-capacity-acceptance.md). - -Die folgenden256MiB-Angaben sind historische Vorgängerqualifikationen; sie -werden weder überschrieben noch als aktuelles1GiB-Installationszeugnis benutzt. - -Stand 2026-11-13. **Quellkorrektur implementiert, lokal geprüft und x86-64- -Releaseartefakte gebaut; nachfolgende native Kopier-/Installationsbelege stehen unten.** Die -erhaltene Cloudhistorie darf weder gelöscht noch kompaktiert/zurückgesetzt werden. - -Der erfasste Cloudbefund zeigte das Rootledger mit **67.076.096 Byte**, also -16.376 Seiten zu 4.096 Byte, unmittelbar unter dem bisherigen Limit von -16.384 Seiten / 64 MiB. Trotz freiem Datenträger konnten neue größere -Checkpointnachweise damit an `SQLITE_FULL` scheitern. Der allgemeine -Helperfehler verdeckte diese Ursache. Das Agentjournal lag ebenfalls bereits -nahe derselben Begrenzung. Dies ist ein aktueller MVP-Korrektheitsblocker. - -Die bestehende Helperbibliothek setzt nun für gemeinsam genutztes Rootledger, -lokales Verbrauchsledger und Agentjournal denselben **endlichen Grenzwert von -65.536 Seiten bei zwingend 4.096 Byte**, also **256 MiB**. Die Grenze wird vor -Schema-/Checkpointzugriffen eingerichtet und ihr tatsächlicher Rückgabewert -geprüft. Eine andere Seitengröße oder bereits nicht einhaltbare Grenze verweigert -den Start. Keine Journalbereinigung, kein Löschen von Tombstones, kein unbegrenzter -Modus und kein Übergehen fehlgeschlagener Schreibvorgänge. - -`max_page_count` ist eine SQLite-Verbindungseinstellung. Ein isolierter -Reproduktionstest muss daher das alte bzw. neue Limit **auf seiner eigenen -Testverbindung** einstellen; eine neue administrative Leserverbindung belegt -nicht den bisherigen Grenzwert des laufenden Daemons. - -Der Helper klassifiziert tatsächlich verkettete SQLite-`DiskFull`-Fehler jetzt -bei Anfrage und Start als **`JOURNAL_STORAGE_CAPACITY_BLOCKED`**. Fehlerausgaben -enthalten keine SQLtexte, privaten Kontexte oder rohen Datenbankmeldungen. - -Tatsächlich lokal bestanden: - -- Ursprünglich signierter Verbrauch/Startnachweis bleibt beim Wiederöffnen und - erneuten Begrenzen unverändert; derselbe Grant bleibt verbraucht. -- Unerwartete 8-KiB-Seitengröße wird verweigert, gespeicherter Inhalt bleibt. -- Ein echtes `SQLITE_FULL` auf einem winzigen Vierseiten-Testjournal wird - bereinigt klassifiziert; SQLite rollt die fehlgeschlagene Transaktion zurück, - erhält früheren Inhalt und Integrität. Kein 256-MiB-Fülltest. -- Agentjournal erhält Sequenz und neue endliche Grenze beim Wiederöffnen. -- Agent-/Helper-Clippy aller Targets mit `-D warnings` und beide Releasebuilds. - -Geschützte qualifizierte Artefakte (native Verwendung im letzten Abschnitt): - -| Artefakt | SHA-256 | -| --- | --- | -| `devstate/cloud-apt-recovery/agent-journal-capacity` | `2ce885cf5e6881e77383482b7d3a87a02c6847aa26b82e5fd70d2ebd8a45360d` | -| `devstate/cloud-apt-recovery/helper-journal-capacity` | `332eae004d9416234eabf7ed3d5c9ece5440d1e0c764ea63357961c16b673b6b` | - -Beide ELF x86-64, höchste benötigte GLIBC-Version 2.34; private Begleitdateien -halten Quellhashes und Prüfungen fest. Der APT-Provider blieb unverändert bei -`5ff260f75cb2959678f6be729d3a806a4ea29febd5ae4003317fed41afc25327`. -Native Installation muss alle Identitäten, Schlüssel, Ledgerinodes und -ursprünglichen Versuchsnachweise erhalten sowie Runtime-/Providerpins neu -nachweisen. Lokale Guards und Build sind noch keine native M4-Abnahme. - -## Tatsächliche Cloud-Abnahme danach - -Isolierte VM-Kopie reproduzierte `SQLITE_FULL`13 beim512KiB-Schreiben unter -16.384Seiten; derselbe Vorgang unter65.536Seiten gelang, beide Tests rollback, -Originalbytes/Größe/Inode unverändert. Privater Kopierbeleg -`journal-capacity-copy-6e882a74-507a-4af0-8baf-8f9005e4ac08.json`. - -Qualifizierter Austausch von Agent/Helper und helpergebundenem Runtime-/APTpin -nativ bestanden. Provider und Installmetadata unverändert, alte Artefakte/Reports -versioniert; vor normalem Restart vollständiger State/DBbytes und Inodes gleich, -zehn bestehende Rootgrants geschlossen. Kopierte dpkg-Probe bestanden, keine -Paketwirkung. Gewöhnlicher signierter Sync danach tatsächlich bereit, -Rootledger10/0offen/0faults, Zentrale19/19/17/0. APT-Endpunkt geschlossen. -Private Nachweise `journal-capacity-runtime.json`/`journal-capacity-native-ready.json`. -Ein zuvor tatsächlich UI-genehmigter Configure-Plan blieb unzugestellt und -expired mit0Grants; er wird erhalten, ein neuer Versuch braucht einen eigenen -festen WebUI-Plan. Paket-/Crash-/Offline-MVP-Abnahmen dadurch nicht vorgetäuscht. diff --git a/docs/linux-updater-compatible-bootstrap-plan.md b/docs/linux-updater-compatible-bootstrap-plan.md deleted file mode 100644 index 21f6f2b..0000000 --- a/docs/linux-updater-compatible-bootstrap-plan.md +++ /dev/null @@ -1,237 +0,0 @@ -# Linux-Updater: erhaltender Bootstrap und erste reale Abnahme - -Stand 16. November 2026. **Plan und tatsächliche lesende Vorprüfung; noch keine -Installation, kein Dienstwechsel und kein Apply.** Der koordinierende -Rootprozess führt Zieländerungen und WebUI-Abnahmen durch. Die neue Datei -`deploy/linux_updater_bootstrap.py` besitzt ausschließlich `inspect` und lokale -Paketvorbereitung `prepare`; sie implementiert keinen versteckten Applymodus. - -## Tatsächlich gelesen - -`python3 deploy/linux_updater_bootstrap.py inspect` las die bestehende -Cloud-Linux-VM über den vorhandenen streng geparsten SSH-Zugang mit bestätigtem -Hostschlüssel. Der private Originalbeleg liegt in -`devstate/linux-updater-bootstrap/eb9ad00e-0229-4ebf-8ba4-09861bb246c5/read-only.json`. -Boot: `45aba743-be1d-4ae5-ba00-139fb9363bfe`. - -| Gegenstand | Tatsächlicher Zustand | -|---|---| -| Agent | aktiv/enabled, SHA256 `0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f` | -| General/Full | beide aktiv, gemeinsame Binary `79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf`; General enabled, Full disabled | -| Updater | Unit, Binary, Konfigurations- und Stateverzeichnis fehlen | -| APT/Legacy | inaktiv/disabled, keine beobachteten General-Rollbacktimer | -| Agentjournal | 30 Aufträge, kein offener Auftrag, kein Fault, Integrität ok | -| Agentverbrauch | 27 Verbräuche und 27 Startzeugen, kein offener Verbrauch | -| Rootverbrauch | 19 Verbräuche und 19 Startzeugen, kein offener Verbrauch/Fault | - -Die Root-Evidenzaggregate blieben lesend gebunden an -`def53ce39f60ebe6815352df2ef1980d5170569519bbca0a9e132d3eecb470d1`, -die Agent-Evidenz an -`61e54815aecb8b5625ff7a8e5b09a5a509ba39d23f3682ad5c969bcb93ff7836`. -Dies sind Hashes der auf dem Ziel gehashten Originalstart-/Outcomebytes mit -Grantbezug, kein Export von Jobausgaben. Die Vorprüfung exportiert ausschließlich -öffentliche Konfigurationsfelder, feste Unit-/Binärhashes und Dateimetadaten. -Private Schlüssel und Agentumgebungsdatei wurden ausschließlich `stat`-geprüft. -Die vorhandenen Datenbanken wurden read-only im tatsächlich vorhandenen -DELETE-Journalmodus geöffnet; es entstanden keine WAL-/SHM-Sidecars. - -Der erste lesende Versuch stoppte beim Stabilitätsvergleich einer öffentlichen -Datei, weil der Vergleich auch die durch Lesen veränderliche atime einschloss. -Die Korrektur vergleicht Identität, Größe, mtime und ctime; der nächste vollständige -Read bestand. Der TLS-Selektor wird anhand seines tatsächlichen Felds `version` -behandelt. Kein fehlgeschlagener Read wurde als Bootstraperfolg ausgegeben. - -## Verbindliche Reihenfolge - -Die bisherigen Images sind kein geeigneter Rückfall für den neuen Updater: -ihnen fehlen Decoder-/Owner-/Healthteile. Deshalb zunächst **kompatible neue -Baseline**, erst anschließend ein separat genehmigtes Update auf andere Bytes. -„Release 0“ bezeichnet unten die Baselinegeneration mit positiver Sequenz 1; -Sequenz 0 ist im Releasecodec ungültig. - -1. Den gemeinsamen Quellsatz einfrieren. Agent, Helper und stabilen Updater für - Linux x86-64 bauen, genaue Quellen-/Listen-/Hashbelege aufbewahren und die - dafür vorgesehenen nicht destruktiven Vertragsprüfungen zuerst auf der - tatsächlichen Cloud-Linux-VM ausführen. Containerfixtures, die feste vorhandene - Agent-Statepfade voraussetzen, dort ausdrücklich nicht starten. -2. Einen frischen Ziel-CAS und den zentral geschlossenen Devtestscope prüfen. - Agent, General und Full in einem begrenzten administrativen Dienstwechsel - stoppen; APT/Legacy bleiben geschlossen. Beide ursprünglichen Sperren halten. - DB-Dateien, Identität, PKI und sämtliche Originalzeilen/Outcomebytes erhalten. - Alte Binaries create-only als historische Bootstrapbelege aufbewahren. -3. Die kompatiblen neuen Agent-/Helperbytes an den bisherigen festen Zielpfaden - bereitstellen und den Full-Konfigurations-/Policy-/Binärpin auf genau diese - Helperbytes binden. Generalpolicy und Generalpin bleiben erhalten. Keine - APT-Rezept-/Proofanpassung und kein Paketjob. Eine geänderte gemeinsame - Helperbinary ist **kein** neuer APT-Laufzeitqualifikationsnachweis. -4. General, Full und Agent genau einmal starten, tatsächliche neue PID/Birth/ - Image-/Unitzeugen lesen, normale signierte Agent-/Helpersynchronisierung und - passives Inventar nachweisen. Erst daraus den öffentlichen tatsächlichen - Baselinequalifikationsbeleg bilden; er enthält keinen Hash einer noch zu - erzeugenden Baseline/Registry/Policy, sodass keine Hashzirkularität entsteht. -5. Auf dem Server getrennte Release-/Baselinesignier- und Healthschlüssel - erzeugen. Keine privaten Schlüssel verlassen den Server. Der Releasekey - bleibt Root vorbehalten; der separate Healthkey wird ausschließlich dem - vorhandenen unprivilegierten Gateway-Dienst als geschützte PEM-Datei zugänglich - gemacht. Der tatsächliche Handler `/agent/v1/update-health` läuft im Gateway. - Job- und Zeitsignierer werden nicht wiederverwendet. -6. Release-0-Manifest exakt für die kompatibel installierten Agent-/Helperbytes - signieren, daraus den kanonischen Initialrecord mit Sequenz/Floor 1, - tatsächlicher Aktivierungszeit, Bootstrapqualifikationshash und - `rolled_back=false` bilden und separat signieren. Identität und bestehende - Journale werden nicht durch diese Recorddatei ersetzt. -7. Die neue feste Updaterunit installieren, reale Unit-Inodes/Kompositionen - nachlesen und die vollständige 21-Unit-Registry plus tatsächliche etwaige - Rollbacktimer erzeugen. Geschützte Registry enthält den Baselinebeleg und - den unveränderten Readervertrag; dazu die tatsächlichen PID-/User-/Cgroup- - Namespace-/Procidentitäten. Erst dann Registryhash und signierte Baseline - in der lokalen Policy binden. Keine Unit-Pins aus einem Quelltext statt der - tatsächlich installierten Dateien übernehmen. -8. Den Updater einmal als eigenes Root-Systemd-Programm starten; sein eigener - PID/Birth/Image/Unitbeleg muss passen. Danach den Full-Aufruf - `update_observe_v1` als tatsächlicher UID-993-Agent prüfen. Nur daraus - gültige Apply-/Checkcapabilities und CandidatePreview veröffentlichen. -9. Release 1 als tatsächlich neue Codepaarbytes bauen, beispielsweise aus - demselben eingefrorenen Runtimequellsatz mit sauberer Version 0.1.1 und - eigener nachvollziehbarer Buildprovenienz. Der bereits gebundene stabile - Updater bleibt unverändert. Full rendert den neuen Konfigurations-/Pinwechsel - aus dem unabhängig geprüften Kandidaten. Veröffentlichung im bestehenden - Tenantkatalog erzeugt noch keinen ausführbaren Job. -10. MCP muss einen persistenten `pending_approval`-Plan für genau diese Bytes - erstellen. Der tatsächliche sichtbar simulierte Devtest-WebUIprincipal - genehmigt interaktiv. Vorher keine Jobwirkung oder Startgrants. Danach - genau einen ursprünglichen Verbrauch, Staging, Stop/Lock/Census/Swap/Start, - neuen unabhängigen signierten Sync-/Baseinventar-Healthbeleg und endgültigen - Originalrecord-/Floor-/Outcomestand prüfen. Nach diesem Abnahmeschritt - Dokumentation und Code nach Gitea pushen. - -## Pfade und Berechtigungen - -| Pfad | Geplante Bindung | -|---|---| -| `/usr/local/libexec/rmm-agent-updater` | qualifiziertes stabiles ELF, Root:Root, 0755; nie Teil des Job-Codepaars | -| `/etc/systemd/system/rmm-agent-updater.service` | feste geprüfte Rootunit, 0644, kein automatischer Wiederanlauf eines unsicheren Handoffs | -| `/etc/rmm-agent-updater` | Root:Root, 0755; keine Schreibrechte für Agent/Gruppe/Andere | -| `binding.json` dort | vorhandenes öffentliches Binding, Root:Root 0600 | -| `policy.json`, `keyring.json`, `health-key.json` dort | öffentliche geschützte Trustmetadaten, Root:Root 0644 | -| `reader-registry.json`, `retained-files.json` dort | feste lokal provisionierte tatsächliche Belege; Root besitzt die Schreibautorität | -| `/var/lib/rmm-agent-updater` | ursprünglicher privater Record-FS-Vertrag: Root:Root 0700 | -| `installed-record.json`, Recordarchive/Handoffs | private Rootdateien/-verzeichnisse, 0600/0700; keine öffentliche Projektion | -| Agentcache | fester vorhandener UID-993-Statebaum; neue Unterverzeichnisse 0700, Prefetchdateien 0600 | - -Der Agent erhält die **öffentlichen Recordbytes** über dieselbe authentisierte -Full-Antwort wie den aktuellen gemessenen Zustand. Hash, Binding und exakte -Predecessor-/Floorwerte werden geprüft. Der bestehende private Recordport wird -hierfür nicht auf öffentliche Dateirechte umgestellt. Full schreibt dabei nichts. - -Die Retainedliste bindet mindestens die drei bestehenden DB-Dateien, zwei -ursprünglichen Locks, öffentliche Binding-/Identitäts-/Jobkeydateien, die -Original-PKI-Dateien sowie den tatsächlichen TLS-Selektor und die aktuell aktive -TLS-Version. Für Schlüssel ausschließlich Dateimetadaten, nie Schlüsselbytes. -Unit-/Binär-/Trustdateien erhalten ihre getrennten eigenen Hash-/FD-Pins. - -## Bekannter kontrollierter Fehlerfall - -Der vorbereitete Linuxrückweg qualifiziert zunächst einen tatsächlich gescheiterten -neuen Fullstart nach bereits erfolgreichem Generalstart. Ein allgemeines -`exit 1`-Helperfixture genügt dafür nicht: dieselbe Binary bedient beide Rollen -und würde bereits General scheitern lassen. Ein separater privater, signierter -Fixturequellsatz muss General normal bedienen und ausschließlich den neuen -Fullstart vor Arbeitsaufnahme eindeutig beenden; kein Produktions-Failureflag -oder versteckter ausführbarer Sonderkanal wird dafür eingeführt. - -Die derzeitige Fullunit hat `Restart=on-failure` mit 5 Sekunden. Ein solcher -weiter geplanter automatischer Wiederanlauf ist kein bekannter geschlossener -Fehler. Für diesen Test muss bereits **vor Baseline/Registry** ein ausdrücklich -geprüfter `Restart=no`-Full-Override zum qualifizierten kompatiblen Setup gehören, -oder ein tatsächlich terminaler Startlimitfall unabhängig bewiesen sein. -Eine nachträgliche ungepinnte Unitänderung während des Updatejobs ist verboten. -Die tatsächlichen negativen Start-/Stopbelege, Rückführung beider Codeversionen, -Originalfristen sowie frisch signierte Vorgänger-Health müssen anschließend -nativ bestehen. Unklare Rename-/Socket-/Startantworten bleiben Unknown und -werden weder wiederholt noch als bekannte Rückführung ausgegeben. - -## Stand der Ausführung - -Tatsächlich abgeschlossen sind der lesende Zielbeleg, lokale -Python-Syntaxprüfung der Vorbereitung und das unten abgegrenzte lokale Buildpack. -Quell- und Containerprüfungen der Runtime -stehen separat in [Runtimequellen](agent-updater-runtime-source.md). Bootstrap, -Schlüsselprovisionierung, neuer Dienststart, passiver qualifizierter Fullbeleg, -WebUI-genehmigter Apply und native Rückführung sind **geplant, nicht ausgeführt**. - -## Eingefrorenes Linux-Buildpack, tatsächlich lokal gebaut - -`deploy/linux_updater_qualification.py build` erstellte den unveränderten Fall -`devstate/linux-updater-qualification/21d20391-6102-4996-8a7a-efbd3e78bd7d`. -615 öffentliche Eingabedateien wurden mit vorherigem/nachherigem Hashvergleich -eingefroren; Zugangsdaten, Devstate und Schlüssel gehören nicht zum Paket. -Source0 verwendet Workspaceversion 0.1.0. Source1 unterscheidet sich ausschließlich -in `Cargo.toml` und den erbenden internen Paketversionen in `Cargo.lock` (0.1.1). -Externe Abhängigkeiten bleiben exakt gleich. Windowsquellen wurden ausschließlich -als Provenienz mitkopiert; dieser Linuxlauf qualifiziert sie nicht. - -Beide Quellsätze bestanden `cargo clippy --locked --offline` mit `--all-targets --- -D warnings` für Agent, Agentcore, Domain, Helper, Linuxupdater, Worker, -Handoff und Updatehistory. Source0 linkte Agent, Helper und stabilen Updater als -Release; Source1 Agent und Helper. Beide neuen Paarbytes unterscheiden sich -tatsächlich von Source0. Der stabile Updater wird ausschließlich aus Source0 -verwendet. Alle Befehle liefen ohne Netzwerk in Docker mit schreibgeschütztem -Sourcebaum, eigenem Targetcache und gepinntem Builder -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`. - -| Artefakt unter `artifacts/` im Fall | SHA-256 | -|---|---| -| `source0/rmm-agent` | `61a073f44be95a9e2a9edf816104fa198452f9512bc099b59b4931000fc98b1e` | -| `source0/rmm-privileged-helper` | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` | -| `source0/rmm-agent-updater` | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` | -| `source1/rmm-agent` | `c27319f312294f96583a2ecb14c9b1ed0b54e205c70dcd156ae511a1dc254e63` | -| `source1/rmm-privileged-helper` | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` | - -Manifesthash: `9ed5f153fe76665150aaab298c4b21d74d7199b2312a28fa23aa9e30b13ddd08`. -Source0-Archiv: `9b9e16c754f233c8675057aa44f89f86c2574ced0ba9d85d60157402363008de`; -Source1-Archiv: `b2bdf4962a1beacf27903263952f4db025dbadfd7705fecc0b02dea3b32dde61`. -Die vollständigen Einzeldateimanifeste und exakten Docker-/Cargoargumente samt -Exitcodes und Loghashes liegen im Fall. Acht Unit-/Integrationsexecutables -wurden gebaut und ihre tatsächlichen Testnamen aufgezeichnet. Nur die im -Manifest explizit aufgeführten 18 Filter sind für den nächsten VM-Schritt -vorgesehen: sieben zielgerichtete Parser-/Ack-/Sync-/SQLiteverträge und elf reine -Handoffverträge. Diese 18 liefen im isolierten lokalen Container erfolgreich. -Andere gelinkte Tests sind durch dieses Paket nicht zur Zielausführung vorgesehen. -Noch keines dieser Programme wurde durch diesen Buildschritt auf der Cloud-VM -ausgeführt; kein Produktdienst oder Zieljournal wurde geändert. - -Diese Aussage beschreibt ausschließlich den damaligen Buildschritt. Der spätere -koordinierte native Lauf aller 18 vorgesehenen Filter auf der Cloud-Linux-VM -bestand; dessen Originalbelege und Abgrenzung stehen in -[Compatible-Linux-Vertragsprüfungen](updater-compatible-linux-contracts.md). -Er ersetzt weiterhin keinen tatsächlichen Updaterjob. - -Der erste erhaltene Fall `7c030441-81e0-4235-9565-0b413b0cedae` scheiterte -an `items_after_test_module` im Linuxunit-Testtarget. Das Parser-Testmodul wurde -ohne Verhaltensänderung ans Dateiende verschoben; der erfolgreiche Fall entstand -anschließend aus einem neuen Snapshot. Der fehlgeschlagene Originalbeleg bleibt -erhalten. - -## ARM64-Serverbuild, geplant und nicht ausgeführt - -Der Source0-Quellsatz enthält auch den aktuellen Server-/Zeitbrokerquellcode. -Für die später separat koordinierte Serverbereitstellung muss dieser exakte -Archivhash auf dem ARM64-Server geprüft und jede reguläre Archivdatei gegen -`source0-inputs.json` geprüft werden. Der vorhandene ARM64-Rustbuilder wird erst -mit `docker image inspect` auf Architektur/OS/Image-ID geprüft und danach über -seine tatsächliche Image-ID angesprochen. In einem neuen eigenen Targetcache -und ohne Netzwerk sind dort geplant: - -```text -cargo clippy --locked --offline -p rmm-server -p rmm-time-broker-linux --all-targets -- -D warnings -cargo build --locked --offline --release -p rmm-server -p rmm-time-broker-linux --bins -``` - -Der Container erhält den verifizierten Quellsatz ausschließlich lesend sowie -private temporäre Verzeichnisse. Artefakte müssen anschließend als tatsächliche -AArch64-ELFs, mit Hash/Buildlog/Image-ID und unverändertem Eingabemanifest -nachgewiesen werden. Keine Dockerfile-APT-Schritte, Netzwerkdownloads oder -Abhängigkeitsänderungen sind Teil dieses Plans. Serverdienste, bestehende -Ingress-/Broker-/Zeitpins und private Signierschlüssel werden durch einen -Build nicht geändert. Der lokale x86-64-Lauf ist kein ARM64-Buildnachweis. diff --git a/docs/linux-updater-compatible-controllers.md b/docs/linux-updater-compatible-controllers.md deleted file mode 100644 index 793697d..0000000 --- a/docs/linux-updater-compatible-controllers.md +++ /dev/null @@ -1,333 +0,0 @@ -# Kompatibler Linux-Updater: konkrete administrative Controller - -Stand 16. November 2026. Die nachstehenden Quellen sind vorbereitet und lokal -geprüft. Der spätere freigegebene native Teilschritt steht unten; die Baseline -ist noch nicht qualifiziert. Kein Signierschlüssel, gestarteter Updater oder -Updatejob entstand dabei. Die Zielphasen koordiniert der Rootprozess; RMM-Aufträge brauchen -weiterhin den tatsächlichen Weg MCP → `pending_approval` → WebUI → Originalgrant. - -## Genau verwendbare Artefakte - -Das unveränderte ursprüngliche Buildpack `21d20391-6102-4996-8a7a-efbd3e78bd7d` -bleibt erhalten. Der neue Agent muss zusätzlich die beiden bereits bestehenden -Domaincapabilities `agent.update.apply/1` und `agent.update.check/1` nach einem -gültigen geschützten Fullobserver melden. Außerdem muss der bestehende -60-Sekunden-Tick das fertige Observerergebnis vor seinem Capabilityvergleich -abholen. Andernfalls wurde die alte Probe erst nach dem Vergleich geerntet und -konnte beim nächsten Vergleich bereits älter als die erlaubten 90 Sekunden sein. -Der Tickaufruf wurde verschoben, ohne Samplerate oder Gültigkeitsgrenze zu ändern. - -Beide Änderungen sind in der eigenständigen Derivation -`devstate/linux-updater-capability-build/9923a97f-4c8c-4e0a-bbad-4f1d88f0d43a` -eingefroren. Manifest-SHA256: -`a41ad700b4b7527bf911bf00f2745914188760c631af0c3255364c05f1ef4fbc`. -Source0/Source1 verwenden unverändert 0.1.0/0.1.1. - -| Artefakt | SHA256 | -|---|---| -| Source0 Agent | `7fef8d0f1e2bcf5cd6c373e567a0c17bfb08d8c780cd4d1925b6c1355e572547` | -| Source1 Agent | `4d212066bef226af3fa679ffe95f69c43a9668cbef7e665d53328f4e41aa3799` | -| Source0 Helper, unverändert aus 21D | `8fdc6ded02278eb18e64003d0bc7bf45d452cd48ded0450e6e900ca66e44d449` | -| Source1 Helper, unverändert aus 21D | `89b28db3afe870c667297dff97ad7a042c550ccce1f712d69108e8de672ad450` | -| Stabiler Updater, unverändert aus 21D | `dec6336728eac8af1e0d84d4921c7c9ecbcc45bc4619d357d346b716336be90a` | - -Die Derivation verwendet einen eigenen kopierten Buildcache. Beide Agenten -bestanden all-targets Clippy mit `-D warnings` und den Releasebuild im gepinnten -Offlinebuilder. Alle 18 zuvor nativ geprüften Contractexecutables, Helper und -Updater wurden nicht neu gebaut und ihre Originalhashes erneut verglichen. -Der frühere reine Capabilitymarker-Fall `f89fbb79-…` bleibt historisch erhalten; -er enthält die Tickkorrektur noch nicht und ist hier nicht die Baseline. - -Der separate öffentliche Metadaten-SDK liegt im eingefrorenen Fall -`devstate/linux-updater-bootstrap-sdk/d309c949-3a70-4448-88da-49c710093221`. -Manifest-SHA256 `cf9464ff21b48b28903369692e3bb63148b2c488297ec709e8fd9c9881448528`, -Binary-SHA256 `6fcc543d538fca30ceb499364880e4dc3689700d50597f18bd11bfe3559a0021`. -Sein Worker-all-targets-Clippy und Releasebuild bestanden. Er schreibt keine -Zieldateien und startet keine Dienste. Er rendert Full über die bestehenden -Rusttypen, erzeugt kanonische öffentliche Manifest-/Record-/Policybytes und -misst bei `qualify_pair`/`registry` ausschließlich die wirklichen Zielzeugen. -Die Bundlecodecoperation kennzeichnet ausdrücklich nur die Formprüfung. - -## Vorbereitete erhaltende Phasen - -`deploy/linux_updater_compatible_apply.py` trennt folgende explizite Phasen; -keine Fehlerantwort startet einen bereits begonnenen Schritt erneut: - -1. `prepare`: Nur lesender Original-CAS auf der VM und lokale Paketvorbereitung. - Diese Phase wurde tatsächlich ausgeführt. Der lokale Fall - `devstate/linux-updater-compatible/ac6cf439-e0a6-4323-82e1-c55df96b2441` - enthält `package.json`, den lesenden Vorbeleg und Manifest-SHA256 - `d3917236c03b93273b4f43f1df3b6773cc04873018262567d3d31510c993c082`. - Es wurde noch kein Paket auf der VM bereitgestellt. -2. `stage`: Ausschließlich create-only sieben feste geprüfte öffentliche - Artefakte in einem neuen Root-700-Fallverzeichnis bereitstellen. -3. `install`: Frischen geschlossenen zentralen Scope und null offene Jobs prüfen; - echte Original-PIDs halten, Agent/General/Full stoppen, beide Originalflocks - halten und alle ursprünglichen DB-Inodes/Start-/Outcomeaggregate bewahren. - Vier feste Dateien mit create-only Vorgänger- und Kandidatennamen ersetzen. - Alle drei Dienste bleiben danach gestoppt. Bei bestehendem Intent nur lesen. -4. `units`: Den stabilen Updater und die feste Unit create-only installieren, - Full-Override `Restart=no` vor der Registry bereitstellen, daemon-reload und - tatsächlichen inaktiven Updater/Restartzustand prüfen. Keine Dienststarts. -5. `start`: General, Full, Agent jeweils genau einmal starten. Das ist zunächst - nur ein Dienststart, noch kein Baselinequalifikationsnachweis. -6. `qualify`: Der SDK prüft echte PID/Birth/Image-/Unitzeugen und dieselbe frisch - signierte normale Agent-/Helpersynchronisierung mit aktuellem NativeClock, - unabhängig gepinnten öffentlichen Jobkeys und erhaltener History. Kein - vergangener Clockwert und kein administrativer Ready-Ersatz. Die ausgegebene - Qualifikation enthält `ready/helper_ready/unlock/job_authority=false`. -7. `registry`: Die wirkliche feste 21-Unit-Schließung, etwaige Rollbacktimer, - Host-/Namespaceidentitäten und tatsächliche Dateipins zweimal messen. Ein - geladener APTdienst verlangt seinen vierten lokalen Servicepin, bleibt aber - inaktiv/disabled und erhält keine neue APT-Laufzeitqualifikation. -8. `trust`: Kanonische Form nativ mit dem SDK prüfen, Release- und separate - Baselinesignatur über genau diese Bytes zusätzlich mit OpenSSL prüfen, - aktuelle Artefakt-/Identitäts-/Registrybindungen vergleichen und die festen - Trustdateien create-only anlegen. Private Originalkeys werden nur per - Metadaten in die Retainedliste aufgenommen, niemals gelesen oder exportiert. -9. `updater-start`: Nach vollständiger Trustinstallation den stabilen Dienst - genau einmal starten und seinen echten gehaltenen PID/Imagezeugen prüfen. -10. `passive-check`: Nur serverseitig lesen. Die wirkliche normale Agentmeldung - muss weniger als 90 Sekunden alt sein, gültige Fullobserver-/Syncbezüge, - den exakten Vorgänger/Updater/Policy/Keyring/Healthpin und die benötigten - Runtimecapabilities enthalten. Es gibt keinen SQL-Schreibersatz für eine - fehlende Capability. `readback` holt nach einem verlorenen Transport nur - feste öffentliche Belege ab. - -Der vorhandene Generalpin Schema 1 enthält ausdrücklich keinen Binarypin; der -Produktcode verlangt hier `helper_binary_sha256=None`. Seine exakten Bytes und -Policy bleiben erhalten. Das erlaubt keine Umdeutung des alten Pins zu einem -Native-Abnahmenachweis für die neuen Helperbytes. Dafür ist Schritt 6 getrennt -notwendig. Der alte APTproof bleibt unverändert und weiterhin geschlossen. - -## Servertrust und Signieren - -`deploy/updater_server_signing_bootstrap.py` ist ein separat aufzurufender -Server-Rootbootstrap. Der reine Read `public-separation` wurde tatsächlich -ausgeführt: Er las ausschließlich den bestehenden öffentlichen Timepin und -verglich ihn mit dem unabhängig geschützten öffentlichen Jobkey. Timepin-Rawhash -`c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`; -die beiden tatsächlichen Publickey-SHA256-Werte sind -`1d9b8f83191a99d69b435dc69e8c9b52650680e8e02025f3e338e5083924def8` und -`4338aabe7e7ba77428e969750a7a5323d7b7349aa52ef7e1a5f24c90be12ca7a`. -Der Read erzeugte keine Schlüssel und änderte keinen Dienst. Der öffentliche -Beleg und der noch nicht ausgeführte `signer-provision-input.json` liegen im -lokalen kompatiblen Bootstrapfall `ac6cf439-…`. - -`provision` erzeugt für Linux und Windows jeweils einen -eigenen Release-/Baselineschlüssel. Der globale Healthschlüssel wird nur beim -ersten Aufruf erzeugt und später ausschließlich nach unveränderter öffentlicher -Provenienz und Schlüsselmetadaten wiederverwendet. Der Aufruf verlangt echte -Job-/Zeit-Publickey-SHA256-Werte als Ausschlussliste; Rollenalias-IDs genügen -nicht. Kein privater Schlüssel verlässt den Server oder erscheint im Output. - -Releasekeys bleiben Root in 0700/0600. Der tatsächliche Server-Trustreader -verlangt den bestehenden Jobkey-Dateiowner 10001 auch für Keyring/Healthdatei, -Datei 0600/ein Link und geschützten Elternpfad. Deshalb erhält jede Plattform -ein eigenes öffentliches Verzeichnis 10001/0700 mit `keyring.json` 0600. -Dieses wird später read-only in API **und** Gateway gemountet; der separate -Healthkey wird read-only ausschließlich in das Gateway gemountet. Der Container -behält seine vorhandene UID und schreibgeschützte Root-FS. Private Releasekeys -werden überhaupt nicht in Anwendungscontainer gemountet. - -Neue statische Serverkonfiguration: - -| Einstellung | Zweck | -|---|---| -| `RMM_AGENT_UPDATE_LINUX_KEYRING_FILE` | ausschließlich geschützter Linux-Keyring | -| `RMM_AGENT_UPDATE_WINDOWS_KEYRING_FILE` | ausschließlich geschützter Windows-Keyring | -| `RMM_AGENT_UPDATE_KEYRING_FILE` | unveränderter Legacyfallback, nur wenn der Plattformslot fehlt | -| `RMM_AGENT_UPDATE_HEALTH_KEY_FILE` | separater Gateway-Healthsignierer | - -Ein vom Netz empfangener Plattformenum wählt ausschließlich einen dieser zwei -fest konfigurierten Pfade. Ein leerer/relativer expliziter Plattformslot wird -verweigert. Danach gelten weiterhin sämtliche Signatur-, Plattform-, Revocation-, -Generation- und Original-Rawhashprüfungen. Ein gemeinsamer Mehrplattformkeyring -würde die bestehenden streng plattformgebundenen Clients nicht erfüllen; -deshalb wird deren Trustvertrag nicht gelockert. Die beiden gezielten -Serververträge bestanden mit echten lokalen Ed25519-Signaturen für beide -Plattformen und negativen Kreuzkeyring-/Signatur-/Revocation-/Generation-/ -Rawhashfällen; Server-all-targets-Clippy bestand ebenfalls. Diese Quellen -brauchen noch einen neuen, getrennt koordinierten ARM64-Imagebuild/Deploy. - -`deploy/linux_updater_public_materials.py` verwendet den sealed SDK für -`release-input`, `record-input`, `trust-package`. Es signiert nichts. Der Server -signiert ausschließlich die zwei fest qualifizierten Linux-Codepaare und die -Initialbaseline mit dem tatsächlichen Qualifikationshash. Ein Ausgabe-JSON ist -keine lokale Vertrauensquelle. Die kanonischen Manifestcodec-Rundläufe für beide -wirklichen Linux-Artefaktpaare und Python-Syntaxprüfung aller drei Controller -bestanden lokal; dabei wurden weder Schlüssel noch Signaturen erzeugt. - -Windows-GNU-Artefakte werden ausdrücklich nicht als kanonische Windows-MSVC- -Releases signiert. Die tatsächliche MSVC-Qualifikation ist ein eigener offener -Schritt. Das ändert weder das Linux-first-Gate noch einen Plattformvertrag. - -## Danach noch tatsächlich abzunehmen - -Die beschriebenen Zielphasen sind weiterhin auszuführen. Neue Servermounts, -plattformbezogener Keyring, Gateway-Healthkey, enger Update-Denyscope und -Tenantkatalog müssen anschließend konkret und mit erhaltenen Composepins -bereitgestellt werden. Erst dann folgen der tatsächlich über MCP beantragte -und in der WebUI genehmigte Linux-Updatejob, dessen Originalverbrauch, -Codepaarwechsel, signierte Health und endgültiger Record/Floor sowie der -bekannte geschlossene Fullstart-Fehlerfall mit erhaltender Rückführung. Lokale -Codec-/Build-/Syntaxbelege ersetzen diese nativen Abnahmen nicht. - -## Tatsächlicher Baselineteilschritt und offener Startfehler - -Nach Quellencommit und Giteapush `96a2b6e` bestand der frische Cloud-Linux-CAS: -unveränderter Boot/Originalcode, drei Originaldatenbank-Inodes, 27 Agent- und -19 Rootverbräuche, keine offene Wirkung/kein Fault. Der zentrale Rootscope war -tatsächlich abgelaufen, es gab null offene Linuxaufträge. Anschließend wurden -`stage`, `install`, `units`, `start` tatsächlich ausgeführt. Die vier ursprünglichen -Dateien bleiben unter ihren create-only `.bootstrap-…previous`-Namen erhalten. -Im Stop/Swap wurden beide ursprünglichen Locks gehalten; die Datenbank-Inodes, -Originalstart-/Outcomeaggregate sowie sämtliche gehaltenen Identitäts-/PKI-/ -Generalmetadaten blieben nach unabhängigem Readback unverändert. - -Der Agent läuft als PID 183607 mit `7fef…`, General als PID 183601 mit `8fdc…`. -Full startete am 16. November um 14:28:05 UTC, beendete sich jedoch nach rund -96 ms mit Exit 1. Das gebundene `Restart=no` verhinderte eine Wiederholung; -`NRestarts=0`. Die normale SDKqualifikation verweigerte daher korrekt den -Erfolg. Es entstanden kein Qualifikationsrecord, keine Registry, kein Trust -und kein Updaterstart. Full wurde nicht erneut gestartet. - -Die rein lesende Diagnose zeigte: Derselbe neue Helper bestand -`--inspect-full-maintenance-profile` mit dem tatsächlichen neuen Policyhash -`e1ca870c3ff2ff1b9485ff9413178b5f3f934169b3595cb444b5235ada42c1ae`. -Kein alter Socket blieb liegen, keine AppArmor-/Seccomp-Verweigerung wurde -beobachtet. Das Fehlerlog enthält ausschließlich den sicheren generischen -Code `HELPER_VALIDATION_OR_IO_FAILURE`; daraus wird keine bewiesene Ursache -abgeleitet. Die Startzeiten überlappen Generalinitialisierung und Fullstart; -der bestehende nichtblockierende exklusive Initialisierungslock kann diese -Parallelität verweigern. General hält ihn nur im Initialisierungsblock und bei -Wirkungen, nicht lebenslang. Eine eng begrenzte Initialisierungsrobustheits- -korrektur und ihre native Prozessprüfung sind der nächste ausdrücklich -koordinierte Schritt. Der fehlgeschlagene Lauf bleibt als solcher erhalten. - -Öffentlicher Originalbeleg: -[native Teilabnahme](evidence/linux-updater-compatible-partial.json). -Vor einem späteren Updateauftrag ist zusätzlich zu beachten: Full initialisiert -seine optionale Updaterclock beim Dienststart. Start ohne Trust bleibt korrekt -geschlossen; nach separat freigegebener Trustinstallation braucht Full einen -eigenen abgestimmten Start mit anschließend erneut normalem signiertem Sync. - -Der neue ARM64-Serverbuild für die statischen Keyrings bestand unabhängig: -Image `sha256:577b3af6b4948d17786bc1fea302e7c490f3bed3d5848c78d6e95e66935f54a7`, -Serverbinary `6c7f197ad87dc405f5bd221e4b5e2c915ada448eff7bee9c8e5922d30d64a8ec`. -Der separat gebaute Broker blieb bytegleich `da8e…`. API/Gateway/PostgreSQL -hatten vor/nach dem Build exakt dieselben Container-IDs, Startzeiten und -Restartzähler. **Nur gebaut: kein Deploy, keine Migration, keine Mount-/Env-/ -Keyänderung.** Der öffentliche [Buildbeleg](evidence/server-updater-platform-keyrings-build.json) -bindet Source-Manifest `376b744896e3ca7845c4824ae41286e1fb0c486118e491993435724446a3ef31`. - -## Begrenzter Initialisierungslock: tatsächlich nativ geprüfter Folgefix - -Der Produktstart verwendet jetzt ausschließlich für die Ledgerinitialisierung -`startup_lock_state`: Ein einziger geöffneter Original-Lock-FD und der gehaltene -Stateverzeichnis-FD bleiben über die Wartezeit erhalten. Nur `WouldBlock` auf -demselben exklusiven Lock wird für höchstens fünf Sekunden abgewartet. Pfad- und -FD-Identitäten werden vor jeder Probe verglichen; andere I/O-Fehler verweigern -sofort. Fristüberschreitung meldet `HELPER_STARTUP_EXECUTOR_LOCK_TIMEOUT`. -Normale Wirkungslocks, Grants, Jobs und Sync werden dadurch nicht wiederholt. -Das ändert die noch unbewiesene Ursache des ursprünglichen 96-ms-Fehlers nicht. - -Die separate Source0/Source1-Helperderivation liegt unter -`devstate/linux-updater-helper-start-build/d674db1c-ebca-48ed-b04c-8f7ec9e45ca1`, -Manifest-SHA256 `3520d0cfdda856b2c9c075197059047e47a24dab42270f4676416dd1ec5871cf`. -Geändert wurden ausschließlich Helperlib, Helpermain und der gezielte native -Prozessvertrag. Beide Helper bestanden all-targets Clippy mit `-D warnings` -und Releasebuild. Neue Helperhashes: - -| Version | SHA256 | Bytes | -|---|---|---:| -| 0.1.0 | `eaee85d7d9d7d9592928448186d883ccb8384cdad967b5d98f47e925b9a8ae8d` | 13323816 | -| 0.1.1 | `1a65e2d9ca7f862578c12fb3d3bff9f1a381a44ce9e8bccd47271a129e64e6e7` | 13328416 | - -Die beiden Agenten bleiben exakt `7fef…`/`4d21…`, der stabile Updater exakt -`dec6…`. Frühere Artefakte/Snapshots wurden nicht überschrieben. Der erste -erhaltene Buildversuch verweigerte einen nun unbenutzten Import; nach dessen -Entfernung entstand der erfolgreiche neue Fall, ohne Warningunterdrückung. - -Der eine gezielte Zweiprozessvertrag lief zuerst auf der tatsächlichen -Cloud-Linux-VM: **1 passed, 0 failed, 42 filtered, 5.22 Sekunden**. Ein Child -wartete auf den vom Parent gehaltenen Original-Lock und erhielt nach Freigabe -denselben Inode; ein weiteres Child verweigerte nach fünf Sekunden den weiter -gehaltenen Lock. Im temporären Root-Fall entstand ausschließlich die leere -Lockdatei. Keine ursprüngliche DB und kein Produktdienst wurde dabei geöffnet -beziehungsweise verändert. Executable-SHA256 -`3d22b6831d3922ec1c6b92de930b7af4dc7b44ad13d6e44759d72f504ff18859`. -[Originalbeleg](evidence/linux-helper-startup-lock-native.json). - -Diese neue Helperderivation ist zu diesem Zeitpunkt **noch nicht im laufenden -Agent/General/Full installiert**. Der anschließend freigegebene eigene -Followupbootstrap muss den bekannten gestoppten Fullzustand und alle -Originalhistorien erneut prüfen, die drei betroffenen Dateien mit erhaltenen -Vorgängern ersetzen und vor Fullstart eine tatsächlich authentisierte -General-Policyprobe bestehen. Erst die folgende normale signierte Synchronisierung -kann die neue Baseline qualifizieren. - -## Tatsächlicher Folgebootstrap, anschließend angehalten - -Der freigegebene Folgefall -`devstate/linux-updater-compatible/8fa5c0bd-b0ae-45ec-8cde-3d766d0576d4` -stellte die neue Helperbinary und die zwei exakt gerenderten Fulldateien bereit. -Die native staged Binary reproduzierte den erwarteten Fullpin unabhängig: -Policy-SHA256 `4b0900b3f3fe550d829352b6174649bd1e64aa89bdf766ec07f49ee04c582877`. -Agent `7fef…` und stabiler Updater `dec6…` wurden nicht ersetzt. - -Beim ersten Stopvergleich zeigte sich ein enges administratives Statusproblem: -`systemctl stop` lässt einen bereits gescheiterten Dienst unter Umständen im -Zustand `failed`, obwohl MainPID/ControlPID null und Job/Cgroup leer sind. -Der Controller brach deshalb **vor jeder Dateiänderung** ab. Es gab ausschließlich -das ursprüngliche Stopintent, keine Swapintents/Kandidaten/Vorgänger. Der -Fehlerzustand wurde weder mit `reset-failed` gelöscht noch ein Stop wiederholt. -Eine eigene, auf genau diesen Fall beschränkte Fortsetzung prüfte anschließend -die identische ursprüngliche InvocationID/Exit-1-/`NRestarts=0`-/`Restart=no`- -Bindung, beendete Original-PIDs, unveränderte Originaldateien, Datenbank-Inodes, -Wirkungsaggregate und Retainedmetadaten. Unter beiden gehaltenen Originalflocks -ersetzte sie danach genau die drei Dateien, mit create-only erhaltenen -Vorgängern. Unklare oder schon begonnene Swaps werden von diesem Pfad verweigert. - -Die vorhandenen Units und Updaternamespace wurden unverändert übernommen. -General bestand vor Fullstart eine echte Policy-Challenge als provisionierte -UID 993 mit geprüftem Rootpeer/PID, exaktem Policyhash und ursprünglichen -Ledger-/Lock-Inodes. Die Antwort enthielt weder Snapshot noch freigegebene -Grants. Danach starteten Full und Agent. Der abschließende rein lesende Beleg -zeigt tatsächlich: - -| Rolle | Zustand | PID | Tatsächliche Imagebytes | -|---|---|---:|---| -| Agent | active/running | 185883 | `7fef…` | -| General | active/running | 185875 | `eaee…` | -| Full | active/running | 185880 | `eaee…` | -| Stabiler Updater | inactive | 0 | installiert, nicht gestartet | -| APT | inactive | 0 | unverändert geschlossen | - -Alle drei ursprünglichen Datenbank-Inodes, die 27 Agent- und 19 Rootverbräuche -samt Originalevidenzen sowie sämtliche ursprünglichen Identitäts-/PKI-/ -Generalmetadaten blieben erhalten. Datenbankintegrität ist jeweils `ok`, keine -offene Wirkung und kein Reconcile-/Helperfault. Es gab keine Betriebssystem- -oder Paketoperation, keinen Reboot, keinen Job, keine Signierschlüsselerzeugung -und keinen Serverdeploy. - -Die Baselinequalifikation bleibt trotzdem **nicht bestanden**: Das tatsächliche -Helperlog meldet `JOURNAL_STORAGE_CAPACITY_BLOCKED`, der Agent schließt mit -`SYNC_OR_TRANSPORT_DEPENDENCY_UNAVAILABLE`. Beide Metas bleiben bei derselben -ursprünglichen Generation 134/Entscheidung -`d6f2b8e3-73a4-47f7-9aa0-664b3829bfd4`; es wurde kein neuer normaler signierter -Abgleich behauptet. Der Rootledger besitzt tatsächlich 262138 Seiten à 4096 -Bytes und null freie Seiten. Die normative Grenze beträgt 262144 Seiten -(1 GiB; Spezifikation Kapitel 0, Journalbudgetentscheidung). Die nächsten -Captures passen offenbar nicht mehr in die verbleibenden sechs Seiten; die -beobachtete konkrete Verweigerung wird nicht durch Anheben des Limits oder -Löschen/Ersetzen von Historie umgangen. Agentjournal: 195068 Seiten/43 frei; -Agentverbrauch: 21284 Seiten/0 frei. Dieser Kapazitätspunkt braucht eine eigene -verbindliche Lösung, bevor neue Linux-Wirkungen oder Updaterabnahmen möglich sind. - -Auf ausdrückliche neue Fokussierung auf die Windows-SYSTEM-PowerShell-Abnahme -wurde Linux nach genau diesem lesenden Schlussbeleg angehalten. Es gibt -weiterhin keinen Baselinequalifikationsrecord, keine Registry, keinen Trust, -keinen gestarteten Updater und keinen Updateauftrag. -[Tatsächlicher Schlussbeleg](evidence/linux-updater-helper-followup-final.json), -SHA256 `7c69a4ac4f295cef4e6bf6feacb86492ee3066cbadf7eeda7772e1b4285edb2a`. diff --git a/docs/mvp-completion-plan.md b/docs/mvp-completion-plan.md index 5955462..565ffb8 100644 --- a/docs/mvp-completion-plan.md +++ b/docs/mvp-completion-plan.md @@ -1,137 +1,35 @@ -# Lieferplan für Skriptverwaltung, Installation und Agentupdates +# Abnahme des Rust-Discovery-MVP -**Abschlussstand 17. November 2026. Echte Windows-Updates und der Wiederanlauf nach frühem Abbruch sind nativ abgenommen.** Ziel ist ein Gerät, das sich per HTTPS-Installer anmeldet, im Leerlauf Inventar meldet, einen Bibliotheksauftrag abholt, sein Ergebnis liefert und den nächsten signierten Release selbst übernimmt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) +**Am 18. November 2026 abgeschlossen.** Je vier über den öffentlichen MCP-Endpunkt eingereichte Skriptaufträge liefen nach persönlicher WebUI-Genehmigung auf der Linux- und der Windows-Test-VM erfolgreich. Die Auftragsergebnisse, Gerätekennungen und Bootbezüge sind im [gemeinsamen Prüfprotokoll](evidence/mcp-scoped-script-requests-20261118.json) festgehalten. -## Aktive Freigabeprüfung am 18. November 2026 +## Stand der Testumgebung -**Der Skript- und Neustartablauf ist auf beiden Testgeräten abgenommen.** Server `5889964`, Schema 39, Linux `0.1.0-mvp.6` und offizielles Windows GNU `0.1.15` sind bereitgestellt. Die öffentliche WebUI zeigt je Gerät beide Ausführungskontexte und die passende Bibliotheksrevision. Die Genehmigungen der VM-Abnahme sind als dev/test-Browsersimulation protokolliert. [VM- und WebUI-Abnahme](evidence/script-channel-vm-acceptance-20261118.json) +| Komponente | Bei der Abnahme verifiziert | +| --- | --- | +| Server | Interne API, öffentliche API und Gateway auf `discovery.ease-technologies.de` mit Revision `c4e0647`, Datenbankschema 39 | +| Linux | `dev-znuny-db`, Ubuntu 24.04.2 LTS x64, Agent `0.1.0-mvp.6` | +| Windows | `discwindowstest`, Windows 11 Pro x64, Agent `0.1.16` aus dem offiziellen GNU-Kanal | +| Quellstand mit Dokumentation | Gitea-Branch `main` | -| Gerät | Dienstkonto | Administrator | Neustart über die Bibliothek | Folgeauftrag | -| --- | --- | --- | --- | --- | -| dev-znuny-db | rmm-discovery, UID 990 | root, UID 0 | Version 1, Kernel-Bootwechsel bestätigt | rmm-discovery, Exitcode 0 | -| discwindowstest | LocalService, S-1-5-19 | SYSTEM, S-1-5-18 | Version 2 auf 0.1.15, Kernel-Bootwechsel bestätigt | LocalService, Exitcode 0. Am 18.11. behob Windows GNU 0.1.16 in Development A den blockierten Helper-Abgleich nach einer quittierten Ergebnismeldung. Agent und Helper blieben auch nach einem Verbindungswechsel bereit. Der bereits genehmigte Auftrag zum Updateverlauf lief einmal als LocalService und meldete bei der Windows-Update-Abfrage Zugriff verweigert, Exitcode 1. [Nachweis](evidence/windows-helper-result-recovery-20261118.json) | +## Geräteaktionen über MCP -Auf Windows lieferte der erste Vorversuch Exitcode 0 und keine Ausgabe. Revision 2 meldete auf `0.1.14` den nativen Fehler 203. Der eingeschränkten Prozessumgebung fehlte `COMPUTERNAME`. Der aktualisierte Client ergänzte den nativen Rechnernamen. Dieselbe genehmigte Skriptrevision lieferte danach die Ankündigung des Neustarts, anschließend bestätigten Gast und Gateway den neuen Boot. +Alle acht Versuche lieferten Exitcode 0. Bei beiden Neustarts wurde die Wiederanmeldung derselben Kopplung nach einem tatsächlichen Bootwechsel geprüft. Der Ping wurde jeweils erst nach dieser Wiederanmeldung eingereicht. Die Zeiten in der Tabelle sind UTC. -**Manifest-Gültigkeit für installierte Administrator-Helper.** Im Quellstand behoben. Der Server prüft die Gültigkeit zum gespeicherten Katalogzeitpunkt und verwendet den aktuellen Schlüsselring. Der Regressionstest prüft ein abgelaufenes Manifest in beiden Pfaden sowie den Widerruf des Signierschlüssels. Die HTTPS-Aufnahme und der Release-Katalog wurden zusätzlich mit isoliertem PostgreSQL geprüft. - -**MCP-Abnahme mit individuellen Tokenrechten.** Auf Serverrevision `c4e0647` hat die Linux-VM drei persönlich genehmigte MCP-Aufträge mit Exitcode 0 abgeschlossen. Der Root-Dateitest schrieb und las `HelloWelt`, die Katalogrevision meldete `Linux 6.8.0-149-generic`. Nach dem Neustart um 15:50:38 UTC meldete sich dieselbe Installation mit neuer Boot-ID. Die Datei war anschließend im beim Start bereinigten `/tmp` verschwunden. Der danach eingereichte Ping meldete dieselbe neue Boot-ID und zwei Antworten von Google bei 0 % Paketverlust. Auf Windows sind Dateitest als SYSTEM, PowerShell-Katalogrevision und Neustart erfolgreich. Die Datei enthält auch nach dem Bootwechsel neun Bytes mit dem erwarteten Inhalt. Das Kernelereignis 12 und der Gatewaykontakt bestätigen die neue Sitzung, Agent und Helper sind bereit. Der nach Wiederanmeldung eingereichte Windows-Ping wartet auf persönliche Freigabe. [Anträge, Ausgaben und Bootbezug](evidence/mcp-scoped-script-requests-20261118.json) · [Betriebsweg](public-access.md#administrator-skripte-anfordern) - -## Ergänzte Lieferungen am 17. November 2026 - -- Umlautdarstellung für native PowerShell-Ausgabe korrigiert und am gespeicherten Updateergebnis in der WebUI geprüft. [Darstellung](evidence/powershell-output-encoding-20261117.json) -- Öffentliche WebUI mit Passwort/TOTP sowie MCP mit eigenen widerrufbaren Bearer-Tokens bereitgestellt. 25 öffentliche Prüfungen bestanden, die Testtokens sind widerrufen. [Betrieb](public-access.md) · [Nachweis](evidence/public-access-20261117.json) - -## Geräteübersicht und Kundenzugriff · abgeschlossen - -1. Bestand und Historie über dieselbe Geräteidentität in WebUI und MCP abfragen. Zwei authentisierte Testgeräte, drei belegte Altinstallationen archiviert, zwei frühere Widerrufe in der Historie. -2. Die sieben Inventarspalten mit den Linux- und Windows-Gästen abgleichen. CPU-Modell, logische Prozessoren, RAM und Laufwerksgröße stimmen mit den nativen Werten überein. Freien Platz mit dem Inventarzeitpunkt anzeigen. -3. Kundenverwaltung und Aufnahme je Kunde prüfen. Anlegen und Umbenennen sind in PostgreSQL und im lokalen Browser getestet. Der öffentliche Installer-Endpunkt liefert für Development B signierte Linux- und Windows-Pakete samt passenden Updatern. -4. Einzel-, Mehrkunden- und globale Tokens auf dem öffentlichen MCP prüfen. Der direkte Fremdzugriff wurde abgewiesen. Alle Abnahmetokens sind widerrufen. Später angelegte Kunden, eingeschränkte Tokenverwaltung und Rechteentzug wurden auf isoliertem PostgreSQL getestet. -5. API und Gateway mit Schema 31 bereitstellen. Die öffentliche WebUI in Desktop- und Mobilgröße prüfen. [Messwerte, Revisionen und Abnahme](evidence/customer-fleet-20261117.json) - -## Produkt und Betriebsstand - -| Funktion | Im Entwicklungssystem nachgewiesen | Nächster Schritt oder Beleg | +| Prüfung | Linux | Windows | | --- | --- | --- | -| Server, WebUI und MCP | Dedizierter ARM64-Server mit TLS, getrenntem Gerätegateway und öffentlicher Verwaltung mit Passwort/TOTP und scoped MCP-Tokens. Die WebUI genehmigte je eine feste Skriptrevision auf Linux und Windows. MCP und WebUI lieferten dieselbe Ausgabe und dieselbe Versuch-ID. | Die öffentliche [MCP-Tokenverwaltung](../web/src/mcp-token-management.tsx) zeigt ab WebUI `acbff00` ein curl-Beispiel für die Bearer-Anmeldung. Die Anleitung wurde nach öffentlicher Passwort-/TOTP-Anmeldung in Chromium geöffnet. [Ergebnisse beider Geräte](evidence/script-library-acceptance-20261117.json) | -| Linux- und Windows-Client | Auf beiden Gästen HTTPS-Polling mit mehreren echten Kontakten. Ein Leerlaufkontakt übermittelt Inventar und Heartbeats auch bei leerer Auftragsliste. | [Bereinigung und Geräteabgleich](evidence/dev-cleanup-pull-20261117.json) | -| Skriptbibliothek | Versionierte, mandantengebundene Skripte, feste Revision im Plan, WebUI und MCP. KB890830 v5.147 über den festen SYSTEM-Bibliotheksauftrag installiert. [Installationsbeleg](evidence/windows-update-installation-20261117.json) | Zwölf lesende Standardvorlagen und typisierte Neustartplanung für beide Plattformen. PostgreSQL prüfte Anlage, Mandantengrenze, feste Revisionen und die verweigerte SYSTEM-Planung ohne passende Rechte. Je fünf Diagnosen liefen nativ erfolgreich. Linux meldete fehlenden Journalzugriff, Windows verweigerte die Updatesuche als LocalService. Die Vorlage verlangt deshalb SYSTEM und die passende Wartungsrichtlinie. Beide Neustartentwürfe im lokalen Browser geprüft. Auf der öffentlichen WebUI blockiert die Vorprüfung den nächsten Schritt bei beiden Testgästen, weil die passende Neustartfähigkeit fehlt. [Katalogmigration](../migrations/0033_standard_diagnostic_scripts.sql) | -| Veröffentlichung und Erstaufnahme | Auf dem dedizierten Server liegen signierte Linux- und Windows-GNU-Releases. Beide öffentlichen Installer wurden mit einem per WebUI erzeugten Einmalcode auf den Testgästen erfolgreich ausgeführt. Ein regulärer PowerShell-Auftrag auf dem frisch aufgenommenen Windows-Gerät lieferte Exitcode 0. [Nativer Windows-Beleg](evidence/windows-gnu-official-vm-20261118.json) | [Anleitung zur Geräteaufnahme](../web/src/main.tsx) aus `acbff00` am 18. November auf dem öffentlichen Server bereitgestellt. Build und 78 Tests bestanden. Chromium prüfte lokal mit Testantworten die Downloadlinks, Codeanzeige, Plattformvarianten und optionalen Helper-Parameter. Die öffentliche Sichtprüfung bestätigte die Anleitung unter der Code-Erstellung auf Desktop und Mobil. Beide HTTPS-Installer antworteten mit HTTP 200. | -| Selbstupdate | Linux wechselte auf `0.1.0-mvp.2`, der frische Windows-GNU-Client nach seinem Skriptauftrag auf `0.1.3` und anschließend `0.1.4`. Prozesshash und Geräteidentität wurden nativ geprüft. | [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows](evidence/windows-https-release-20261117.json) | -| Entwicklungsbereitstellung | Linux-, Windows- und ARM64-Builder nutzen feste Git-Revisionen. SSH-Staging prüft den übertragenen Hash. Der Serverrunner prüft laufende Binärdatei, Migrationen, beide TLS-Healthchecks und die ausgelieferte WebUI. | Öffentlicher HTTPS-Rücklesetest für das WebUI-Bundle aus `acbff00` bestätigte die Startseite (SHA-256 `9ed4d8777e66ee99c33a89bb501388d232ec728747de7762a8a9d898a0e6a9f8`) und bytegleiche JS- und CSS-Dateien. API, öffentliche API und Gateway liefen mit denselben Containern weiter. [Entwicklungsbefehle](development.md) | +| Einmaliges Administrator-Skript | UID 0 schrieb und las `HelloWelt` in `/tmp/HelloWelt.2r0DodNJ`. Beim Systemstart wurde `/tmp` bereinigt. | SYSTEM schrieb `HelloWelt` unter `C:\Windows\Temp`. Nach dem Neustart wurden die neun Bytes auf dem Gast erneut gelesen. | +| Festes Bibliotheksskript | „Linux-Kernelversion“ v1 lief unter dem Dienstkonto und meldete `Linux 6.8.0-149-generic`. | „Windows-PowerShell-Version“ v1 lief als LocalService und meldete `PowerShell 5.1.26100.9818`. | +| Neustart per Bibliotheksskript | Neuer Kernelstart um 15:50:38, neue Boot-ID, Agent aktiv und authentisierter Kontakt um 15:50:57. | Neuer Kernelstart um 15:56:40, Ereignis 12 und passende Boot-ID am Gateway. Agent und SYSTEM-Helper meldeten sich bereit. | +| Folgeauftrag auf dem neuen Boot | Zwei Antworten von `google.com`, 0 % Paketverlust. Der Auftrag gab auch die neue Boot-ID aus. | Zwei Antworten von `google.com` mit jeweils 17 ms, ausgeführt als LocalService. | -## Schritt für Schritt +## Weitere abgenommene Produktwege -### 1 · Geräte im Leerlauf und unter Pull betriebsbereit machen — auf den Testgästen nachgewiesen +| Funktion | Beobachtung und Beleg | +| --- | --- | +| Öffentliche Verwaltung und Kundengrenzen | HTTPS-WebUI mit Passwort/TOTP, MCP mit widerrufbarem Token. Gerätebestand, Historie, eingeschränkter und kundenübergreifender Zugriff sowie Widerruf sind geprüft. [Öffentlicher Zugang](evidence/public-access-20261117.json) · [Kunden und Geräte](evidence/customer-fleet-20261117.json) | +| Von der Auswahl zur Ausgabe | Die WebUI bindet die ausgewählte Skriptversion, zeigt den Inhalt vor Genehmigung und verlinkt das Ergebnis je Gerät. Ein abgelehnter Antrag erzeugte null Jobs. [Auftragsablauf](evidence/webui-auftragsablauf-20261117.json) · [Ergebnislinks und Entscheidungen](evidence/webui-order-history-20261118.json) | +| Frische Installation und periodisches Agentupdate | Beide VMs wurden über HTTPS aufgenommen und übernahmen anschließend ein signiertes Folgepaket mit derselben Geräteidentität. Auf Windows ist der öffentliche GNU-Kanal einschließlich Prüfung des offiziellen Schlüssels belegt. [Linux](evidence/linux-public-installer-update-20261117.json) · [Windows GNU](evidence/windows-gnu-official-vm-20261118.json) | +| Betriebssystemupdate per PowerShell | Die Windows-Updatevorlage installierte KB890830 v5.147 als SYSTEM. Ergebnis und Windows-Ereignis 19 bestätigen die Installation. [Installationsbeleg](evidence/windows-update-installation-20261117.json) | +| Wiederanlauf | Nach einem Gatewaywechsel wurde der Windows-Agent ohne manuellen Dienstneustart wieder bereit. Der Helper glich seine bereits quittierte Ergebnismeldung ab. [Gatewaywechsel](evidence/windows-gateway-clock-recovery-20261117.json) · [Helper-Abgleich](evidence/windows-helper-result-recovery-20261118.json) | -1. Der ausdrücklich benannte Windows-Entwicklungsantrag zu Job `7d756c34…` wurde mit Plan, Operation, Grant und Outbox gelöscht. Ein zweiter Versuch `5007cbd9…` ist zentral korrekt abgelaufen. Der Server hatte dafür keinen Grant ausgegeben. Die veraltete lokale Ergebnisnachricht blockierte das Replay. Beide Projektionen wurden auf dem Gast bereinigt, beide Dienste wieder gestartet. -2. Gerätesperre, Parallelquoten und Rollout zählen `closed_unknown` als abgeschlossen. Ein offenes `unknown` mit Reservierung hält die Sperre. Bei abgelehntem Start behandelt die neue Agentversion nur eine explizit an genau den unreservierten Versuch gebundene Antwort als erneut planbar. Vor einem neuen Abruf durchläuft der Agent den signierten Abgleich. Die Regression einschließlich vertauschter Versuchs-ID und mehrdeutiger Ablehnung wurde im gemeinsamen Agentkern getestet. -3. Auf Linux wurden 81 veraltete Kontroll-Captures ohne zugehörige Entscheidung entfernt. Danach wurden die 3.961 vorhandenen Snapshots bytegenau in eine Darstellung mit geteilten identischen Versuchsdaten überführt. Die Transaktionen prüften jeweils den vollständigen Rücklesewert. Die Freiliste stieg von 51 auf 113.176 Seiten bei 4 KiB pro Seite, SQLite `quick_check` ergab `ok`. Entscheidungsdaten wachsen weiterhin mit der Zahl der Abgleiche. -4. Nach der Bereinigung meldeten beide Gäste am 17.11. gegen 14:51 UTC wiederholt `https`, `sync_ready=true` und `helper_sync_ready=true`. Die Windows-Uhr war beim nativen Nachtest qualifiziert. Bereits vorhandene Abnahmen für einzelne Skripte stehen unter [Linux](script-console-linux-full-results.md) und [Windows](windows-general-script-acceptance.md). - -### 2 · Ein Bibliotheksskript von der Anlage bis zum Ergebnis liefern — auf beiden Entwicklungsgeräten abgenommen - -„Linux-Kernelversion“ und „Windows-PowerShell-Version“ wurden je als v1 geplant, anschließend als v2 geändert und als v1 in der sichtbaren dev/test-WebUI genehmigt. Vor dem Klick gab es je null ausführbare Jobs, danach je einen. Die Testgeräte lieferten `Linux 6.8.0-149-generic` und `PowerShell 5.1.26100.9818` mit Exitcode 0. Die Ausgaben und Versuch-IDs stimmen in WebUI und MCP überein. Fremdmandant über MCP abgewiesen. Die Updatevorlage wurde hierbei nicht ausgeführt. [Nativer Beleg](evidence/script-library-acceptance-20261117.json) - -### 3 · Windows-Updates als Bibliotheksfunktion abbilden — Vorlage und administrative Skriptstrecke geprüft - -„Windows-Updates installieren“ ist eine versionierte PowerShell-Vorlage im serverseitigen Katalog. Sie verwendet die Windows Update Agent API, protokolliert die Ergebnisse je Update und meldet den Neustartbedarf. Der feste Plan bindet Skriptinhalt, Ziel, SYSTEM-Rechte und Zeitlimit. Nur für die freigegebene Vorlagenrevision kann die gesonderte Wartungsrichtlinie bis zu 3.600 Sekunden zulassen. [Vorlagentext](../crates/domain/src/windows_update.ps1) · [Laufzeitprüfung](../crates/domain/src/jobs.rs) - -Der Windows-Installer richtet den Agenten als LocalService ein. Der [Dev-Operator](windows-update-dev-window.md) richtet für die konkrete Geräteidentität und das signierte Agentpaar ein befristetes Wartungsfenster ein. Auf Windows `0.1.4` wurde die feste lesende Identitätsabfrage über die sichtbare dev/test-WebUI genehmigt und als regulärer Pullauftrag genau einmal mit Exitcode 0 und `S-1-5-18` ausgeführt. WebUI und MCP zeigen denselben Versuch. Anschließend wurden der zentrale Scope entzogen, der lokale Helper entfernt und die exakt gebundenen abgeschlossenen Arbeitsprojektionen archiviert. Ein neuer Geräteabgleich bestätigte um 16:08 UTC `sync_ready=true` ohne SYSTEM-Capability, bei laufendem Agent und Updatedienst. Am 17. November installierte der separat genehmigte Auftrag KB890830 v5.147 mit Exitcode 0, WUA-Resultcode 2 und HRESULT 0. Das Windows-Systemprotokoll bestätigt Ereignis 19. Ein bereits vorher erforderlicher Neustart wurde administrativ ausgeführt und anhand der neuen Bootzeit bestätigt. Danach waren WUA- und CBS-Neustartmarker gelöscht. [Echte Installation](evidence/windows-update-installation-20261117.json) [Nachweis für Einrichtung, Ausführung und Rückbau](evidence/windows-update-window-20261117.json) - -### 4 · Signierte Binaries zentral veröffentlichen — im Entwicklungsmandanten nachgewiesen - -Jeder Plattformkanal besitzt einen eigenen Ed25519-Schlüssel. Agent und Helper werden mit ihren exakten Hashes vor Veröffentlichung geprüft. Der anfangs erforderliche stabile Updater ist separat an den plattformspezifischen Bootstrap-Hash gebunden. Für Linux und Windows GNU wurden je zwei Versionen über die reguläre Verwaltungs-API veröffentlicht. [Veröffentlichungsbefehl](development.md) - -### 5 · Über öffentliches HTTPS aufnehmen — beide Plattformen nativ aufgenommen - -Die [Linux-](https://discovery.ease-technologies.de:8443/install/linux.sh) und [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) sind über die öffentliche Zertifikatskette erreichbar. In der privaten WebUI erzeugte Einmalcodes wurden jeweils beim Enrollment verbraucht. Auf den vorhandenen Testbetriebssystemen entstanden neue Produktidentitäten. Linux läuft als `rmm-discovery`, Windows als LocalService. Der Notebook-Host ist weiterhin ausschließlich Entwicklungsrechner. - -### 6 · Automatischen Versionswechsel auf dem Gerät prüfen — beide Plattformen nativ nachgewiesen - -Das über den Installer neu aufgenommene Linux-Gerät `dda2c891…` führte die freigegebene Bibliotheksrevision mit Exitcode 0 aus. Der systemd-Timer aktivierte am 17.11. um 15:06 UTC den Release `0.1.0-mvp.2`. Der SHA-256 des über `/proc` geprüften laufenden Agenten und der Helperdatei stimmen mit dem signierten Manifest überein. Enrollmentgeneration und Geräteidentität blieben gleich. [Vollständiger Beleg](evidence/linux-public-installer-update-20261117.json) - -Windows-A meldete sich mit neuer Identität `1626b5a3…`, Version `0.1.0` und gültigem `windows.base`. Der reguläre Updaterdienst aktivierte um 15:10 UTC Version `0.1.1` mit derselben Identität. Die Manipulationskontrolle wies eine um ein Byte veränderte Helperkopie ab. Das neu aufgenommene Windows-GNU-Gerät `858a27db…` mit Prüfer v2 führte unter `0.1.2` die PowerShell-Bibliotheksrevision erfolgreich aus. WebUI und MCP bestätigen denselben Versuch und Exitcode 0. Beim ersten nachfolgenden Abruf lagen die geprüften Dateien bereits auf dem Gast. Eine Windows-Dateisperre verhinderte zunächst das atomare Umschalten. Der stabile Updater wurde über den direkten Entwicklungsweg korrigiert und mit dem wiederverwendbaren Repo-Befehl übernommen. Anschließend aktivierte er um 15:45:22 UTC selbstständig `0.1.3`. Der Prozesshash stimmt mit dem signierten D-Paket überein, beide Dienste laufen und die Geräteidentität ist gleich. Der nächste reguläre Abruf aktivierte um 15:50 UTC auch `0.1.4`, wiederum mit Hash- und Gerätekontrolle. [Nativer Windows-Beleg](evidence/windows-https-release-20261117.json) - -### 7 · Lieferung von einem frischen Checkout nachvollziehen — geprüft und im Lieferbranch gesichert - -Aus einem sauberen Klon von `95aa707` wurden drei Buildpläne geprüft und der Rustserver offline mit dem Lockfile gebaut. Releasewerkzeug, SSH-Staging und Deploymentrunner sind im Checkout vorhanden. Fünf Linux-Installerregressionen sowie die Release-, Mandanten-, Token- und Rotationstests gegen einen isolierten TLS-Server und echtes PostgreSQL 17 bestanden. Der Migrationsbenutzer ohne Superuserrechte wendete alle 25 Migrationen an. Der Direktweg für ein bereits gebautes WebUI-Bundle wurde zusätzlich auf dem Entwicklungsserver ausgeführt. [Befehle](development.md) - -**Abnahme.** Ein zweiter Entwickler kann Build, Bereitstellung, Release, Erstaufnahme und Ergebnisabruf den dokumentierten Einstiegspunkten zuordnen. Für beide Geräte gibt es die Kette Installer → Leerlauf → Bibliotheksskript/Ergebnis → automatischer Versionswechsel. Bereits ausreichend belegte Schritte werden referenziert. - -**Arbeitsverteilung.** Der Integrator bündelt die noch fehlenden Zielbelege. Künftige Teilaufträge bekommen jeweils einen konkreten Fehler oder ein gesondert beauftragtes Nutzerergebnis. Sie ändern getrennte Dateien oder stimmen gemeinsame Routen vorher ab. Bei einem Blocker die nächste fehlende Beobachtung hier im betroffenen Schritt eintragen. Abnahmeprotokolle liefern den Beleg, keine weitere Aufgabenliste. Zusätzliche native Provider, Relay/Terminal, RustDesk und Hypervisor-/Backupfunktionen liegen außerhalb dieser Lieferung. - - -## Fortsetzung nach dieser Lieferung - -### WebUI für Skriptaufträge · umgesetzt und abgenommen - -1. **Skript veröffentlichen.** Die Bibliothek zeigt je Skript Name, Plattform und aktuelle Version. Im Detail lassen sich ältere Versionen lesen und neue veröffentlichen. -2. **Auftrag einreichen.** Unter „Aufträge“ Kunde und Geräte wählen oder eine Auswahl aus „Geräte“ übernehmen. Eine feste Bibliotheksversion oder ein einmaliges Skript angeben und die Zusammenfassung einreichen. Inkompatible Geräte sind gekennzeichnet. Der Antrag bleibt nach einer unterbrochenen Übermittlung wiederauffindbar. -3. **Entscheidung treffen.** „Genehmigungen“ bündelt offene WebUI- und MCP-Anträge für die Kunden, für die der angemeldete Benutzer entscheiden darf. Den festen Plan mit Zielgeräten, Skript, Ausführungsrechten und Zeitfenster prüfen und genehmigen oder ablehnen. Frühere Entscheidungen stehen im Verlauf. -4. **Ergebnis und Skript nachlesen.** „Aufträge“ zeigt die neuesten Anträge zuerst. Das Auftragsdetail zeigt den beim Einreichen gebundenen Skripttext und kennzeichnet unterschiedliche Varianten nach Gerät. Bei einem einzelnen Gerät ist die Ausgabe direkt im Auftrag sichtbar. Bei mehreren Geräten öffnet „Ergebnis anzeigen“ die Ausgabe an der jeweiligen Gerätezeile. Technische Kennungen und Prüfsummen stehen in den Details. Geräteaufnahme und Agent-Releases haben eigene Verwaltungsansichten. -5. **Abnahme.** Die Linux-Test-VM lieferte für Version 1 des Bibliotheksskripts trotz bereits verfügbarer Version 2 die Kernelversion, Exitcode 0. Zwei abgelehnte Anträge aus WebUI und MCP erzeugten je null Jobs. Alle drei Entscheidungen liefen über den gekennzeichneten Testprincipal im Entwicklungsprofil. Die öffentlichen Ansichten wurden nach Passwort-/TOTP-Anmeldung in Desktop- und Mobilbreite geprüft. [Abnahmeprotokoll](evidence/webui-auftragsablauf-20261117.json) - -Den aktuellen Kernablauf mit den vorhandenen Build-, Deployment- und Operatorbefehlen benutzen. Die Windows-Updatevorlage ist mit einer tatsächlichen Installation und dokumentiertem Neustartbedarf abgenommen. Dafür das dokumentierte Fenster öffnen, die gespeicherte Updatevorlage wählen und den festen Plan in der WebUI genehmigen. Den automatischen Agentversionswechsel und bereits erfolgreiche Bibliotheksaufträge nur bei einem betroffenen Fehler erneut abnehmen. - -Der integrierte Quellstand für diese WebUI-Lieferung liegt auf `codex/webui-review`. Bei dieser WebUI-Abnahme liefen API und Gateway `a0b3aa4`, WebUI `6d4f53d` und Datenbankschema 35. Linux meldete Release `0.1.0-mvp.4`, Windows GNU `0.1.9`. Den aktuellen Verteilstand nennt die Freigabeprüfung weiter unten. Ältere, aufgabenfremde Arbeiten liegen weiterhin gesondert im Arbeitsbaum. - -### WebUI-Review · Ausführungsstopp und Wartung - -1. Den Mandantenstatus unter „Rechte & Ausführungsstopp“ direkt vom Server lesen und nach einer Änderung neu laden. Die Seite zeigt die passende Aktion für den gelesenen Zustand. -2. Neustarts unter „Neuer Auftrag“ vorbereiten. Der Assistent prüft auf genau ein Ziel, passende Berechtigung und die Gerätefähigkeiten. Der gespeicherte Plan durchläuft die reguläre Einreichung und Genehmigung. Den alten JSON-Planer unter „Verwaltung → Erweitert“ für die übrigen Wartungsfunktionen erreichbar halten. -3. Entwicklungsabnahmen im Gerätedetail nur im simulierten Testprofil zeigen. Geräteinformationen, Historie und gespeicherte Ergebnisse gehören zur öffentlichen WebUI. -4. Geräteaufnahme, Agent-Releaseübersicht und MCP-Tokens vereinfachen. Der Paketkatalog zeigt verständliche Leerzustände unter „Erweitert“. -5. **Abnahme.** Öffentlich in beiden Kunden den Ausführungsstatus gelesen. Die Neustartprüfung, das historische Gerät und die neuen Verwaltungsansichten wurden im Browser geöffnet. Der gestoppte Zustand und der Übergang vom fehlenden zum gemeldeten Neustartfähigkeit sind mit Testdaten geprüft. [Nachweis](evidence/webui-review-20261117.json) -6. **Abgenommen am 18. November.** Der Server filtert Aufträge vor der Seiteneinteilung. Name oder Anlass, Gerät, Status und Erstellungszeitraum sind kombinierbar. Geräteansichten verlinken auf den festen Job. Genehmigungsverlauf und Detail zeigen die belegte Person und Entscheidungszeit. In der öffentlichen WebUI wurden ein Treffer von einer späteren Seite und vier kombinierte Treffer, ein direkter Ergebnislink und die übereinstimmende Entscheidung nachgelesen. [Nachweis](evidence/webui-order-history-20261118.json) - -7. **Abgenommen am 18. November.** Skriptnamensuche und Plattformfilter arbeiten zusammen über die aktuellen Versionen der Bibliothek. Die Kopfzeile zeigt den aktiven Kunden. Beim Wechsel zwischen Geräten, Aufträgen, Skripten und Genehmigungen blieb Development B sichtbar. Ein Geräte-Detail aus Development A übernahm seinen Kunden in die folgende Auftragsansicht. [Nachweis](evidence/webui-script-catalog-context-20261118.json) - -### Freigabeprüfung am 18. November 2026 - -Der vollständige Linux-Ablauf wurde auf dem aktiven Server erneut nachgewiesen. Version 2 von „Linux-Kernelversion“ wurde im Gerätebestand zugewiesen, als Antrag mit null Jobs eingereicht und im gekennzeichneten Entwicklungsprofil genehmigt. Der Linux-Agent `0.1.0-mvp.3` führte den festen Versuch einmal aus. Die öffentliche WebUI zeigte `Linux` und Exitcode 0. Der Auditvergleich bestätigt außerdem eine frühere echte WebUI-Genehmigung mit erfolgreicher Ausführung. Beide HTTPS-Installer antworteten mit HTTP 200. [Abnahmeprotokoll](evidence/webui-mvp-recheck-20261118.json) - -Der erste Windows-Versuch unter `0.1.8` endete nach dem Abbruch durch die WebUI mit null Startgrants. Die VM hatte fünf abgeschlossene Versuche und eine qualifizierte Uhr. Der Agent hatte die signierte Entscheidung für Checkpoint 4387 übernommen, der Helper stand bei 4383. Der korrigierte Agent prüft bei dieser Abweichung die Originalsignaturen, den bestätigten Vorgänger und die abgeschlossenen Wirkungen. Auf der VM war Checkpoint 6639 in Verbindungsgeneration 293 signiert und von beiden Rollen bestätigt. Generation 294 begann vor dem anschließenden Gatewayneustart. Nach dem Neustart bestätigte derselbe Agentprozess weitere Checkpoints, darunter 6710 nach dem Skriptlauf. - -**Auf Development A am 18. November abgenommen.** Geräteauswahl, Einmalskript, Einreichung ohne ausführbare Jobs und sichtbare Testgenehmigung führten auf Windows zu genau einem Startgrant. Der Auftrag zeigte „Geräteabgleich geprüft“ und Exitcode 0. Linux lieferte beim anschließenden Bibliotheksauftrag „Linux“ und Exitcode 0. Die öffentliche WebUI bestätigte beide Ergebnisse nach Passwort-/TOTP-Anmeldung. Windows-Zeilenenden erscheinen im Ausgabetext als Zeilenumbruch. Die gespeicherte Ausgabe enthält weiterhin das originale CRLF. - -Schema 35 und der bereitgestellte Server prüfen die Berechtigung von Planersteller, tatsächlichem Einreicher und Genehmiger für ihre jeweilige Rolle. Sensible gespeicherte Logausgaben und historische Logergebnisse ohne Schutzklasse erfordern zusätzlich `logs:read_sensitive`. Auf beiden VMs stimmen die Hashes von Agent, Helper und stabilem Updater mit den geprüften Buildartefakten mit SQLite 3.54.1 überein. Auf Linux läuft der Updatetimer wieder. [Native Nachweise und WebUI-Ergebnisse](evidence/windows-release-blockers-20261118.json) - -**Verteilstand am 18. November.** Windows x64 wird offiziell als GNU-Release veröffentlicht. API, Gateway und WebUI laufen auf `9c7ccbb` mit Schema 37. Development A, Development B und der Starter für neue Kunden enthalten das signierte Paket `0.1.11`. Die öffentliche API hat das Paket in beiden Kunden angenommen und das mit dem Entwicklungsschlüssel signierte Vorgängerpaket abgewiesen. Auf der Windows-Test-VM lief der HTTPS-Installer mit seinem GNU-Standardziel. Der reguläre Updater wechselte von `0.1.10` auf `0.1.11` unter derselben neuen Geräteidentität. [Veröffentlichung](evidence/windows-gnu-official-release-20261118.json) - -**Native Abnahme und Bereinigung.** Der neue Agent meldete nach dem Selbstupdate auf `0.1.11` denselben Kopplungsbezug. Der im Entwicklungsprofil interaktiv genehmigte [PowerShell-Auftrag](https://discovery.ease-technologies.de:8443/#auftraege/ansehen/11111111-1111-4111-8111-111111111111/c40aa3cc-47bf-45b7-87a6-9772b77473f2) zeigte „GNU-Selbstupdate geprüft“ und Exitcode 0 in der öffentlichen WebUI. Dieselbe Oberfläche widerrief und löschte die frühere Kopplung. Der Direktabruf der alten Installation ergab HTTP 404. Die neue Installation war weiterhin online. Die abgesprochene Sicherung liegt als geschützte WIM-Datei im Gast. [VM- und WebUI-Nachweis](evidence/windows-gnu-official-vm-20261118.json) - -### Wiederanlauf nach frühem Abbruch — nativ abgenommen - -Der Controller wurde nach registriertem Helperkontakt vor der zentralen Freigabe mit Exitcode 85 beendet. Ein unabhängiger erneuter Aufruf stellte den normalen Geräteabgleich wieder her. Geräteidentität, Archivnachweise und Release blieben gebunden, die Probe erzeugte keine Aufträge. [Abnahme vom 17. November](evidence/windows-update-early-abort-20261117.json) - -### Tatsächliche Updateinstallation — abgenommen - -Der ursprüngliche Installationsversuch `6d5f9437…` wurde nach kurzzeitigem `unknown` durch den signierten Abgleich als `succeeded`, Revision 2 bestätigt. Es gab genau einen nativen Grantverbrauch und Start je Ledger, keinen weiteren Versuch. Das Wartungsfenster wurde anschließend geschlossen. Um 17:05 UTC liefen Agent und ReleasePull mit bereitem Sync, ohne SYSTEM-Fähigkeit und ohne offene Jobs. Die Windows-Zeitsynchronisation wurde aktiviert und ihre zuvor gemessene Abweichung korrigiert. Die WebUI erlaubt nun das feste 3.600-Sekunden-Budget der Originalvorlage auch in der gemeinsamen Planprüfung. Drei Python-Zeitstempelregressionen und 68 WebUI-Tests bestanden. [Gesamtbeleg](evidence/windows-update-installation-20261117.json) - -### Windows-Zeitfreigabe nach Gatewaywechsel — nativ abgenommen - -Version `0.1.5` verwendet die beim Systemstart protokollierte UTC-Zeit aus Kernel-General-Ereignis 12. Die protokollierte Zeit und der später korrigierte CIM-Wert auf der VM erklären die zwei unterschiedlichen Boot-IDs des [ursprünglichen Vorfalls](evidence/windows-gateway-reconnect-20261117.json). Der Agent benötigt beim Lesen der Boot-ID einen zugänglichen Startdatensatz im Systemprotokoll. Fehlt er, schlägt die Abfrage fehl. - -Der Windows-Updater aktivierte den signierten Release mit Sequenz 6. Beim anschließenden Gatewaywechsel und kontrollierten Zeitsprung meldete derselbe Prozess (PID 4768) die Uhr in Verbindungsgeneration 51 zunächst als unqualifiziert. Nach Rückstellung der Gastzeit und erfolgreicher W32Time-Synchronisation meldete er sich mit neuer signierter Entscheidung und angewendetem Checkpoint 1926 bereit. Die temporäre Netzregel wurde entfernt. Es gab null offene Jobs. [Abnahme auf der Windows-Test-VM](evidence/windows-gateway-clock-recovery-20261117.json) +[Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) · [Übergabe für die Weiterentwicklung](handover.md) diff --git a/docs/mvp-final-audit.md b/docs/mvp-final-audit.md deleted file mode 100644 index 8ba8f3e..0000000 --- a/docs/mvp-final-audit.md +++ /dev/null @@ -1,272 +0,0 @@ -# Linux-MVP M0–M5: begrenzte dev/test-Abnahme abgeschlossen - -Stand 2026-11-13 · Spezifikation **1.15**. M0–M4, alle drei aktiven -Offlinevarianten, Zustellung/ACK-Verlust und kontrollierter Agentprozessabbruch -sind im dokumentierten begrenzten Linuxumfang nachgewiesen. Der eigene letzte -Reboot ist mit rechtzeitigem neuem Bootkontakt und frischer Verifikation durch -normalen signierten Sync desselben Grants abgeschlossen. Die ursprünglichen -Rebootrechte sind zurückgenommen. **Der native DoD-Endabgleich ist bestanden; -M0–M5 ist für dieses eine Linuxziel im begrenzten dev/test-Umfang abgenommen.** -Produktionsbetrieb, weitere Plattformen und Mehrgeräteausführung sind dadurch -nicht abgenommen. - -Dieser Dokumentationsabgleich liest Quellen und gespeicherte Berichte; er -führt keine Builds, Tests, Browseraktionen, Jobs oder VM-/Serveränderungen aus. -Qualifikation, Installation, nativer Funktionsnachweis und Gesamtabnahme bleiben -getrennt. Umfang ist eine **Ubuntu-24.04-x86-64-Cloud-VM** gegen -`discovery.ease-technologies.de`; Notebook ausschließlich Entwicklungsrechner. -Windows ist separat parallel erlaubt, kein zusätzlicher Linux-MVP-Blocker. - -Alle positiven Jobfreigaben erfolgten über tatsächliche WebUI-Klicks der -sichtbar simulierten dev/test-Identität nach persistentem Antrag und Nullgate. -Vor Klick keine ausführbaren Jobs, Outboxeinträge oder Grants. Das ist kein -menschlicher Produktionsfreigabenachweis; MCP und Policies genehmigen nicht. - -## Tatsächlich abgeschlossene Funktionsgates - -| Bereich | Realer Nachweis | Begrenzung | -| --- | --- | --- | -| M0 | Gepinnte Rusttoolchain/Lockdatei, native ARM64-Serverbuilds und erhaltende Deployments; frischer isolierter PostgreSQL-Bestand mit Migrationen 1–13, nicht besitzende Anwendungsrolle und RLS geprüft | ARM64-Server ist kein ARM64-Agent; CI-Dateien sind kein ausgeführter CI-Runnernachweis. | -| M1 | Unprivilegierter systemd-Agent, Enrollment/mTLS, WSS/HTTPS, passive Inventur/Heartbeats, Reconnect; echter automatischer WSS→HTTPS-Fallback nach zwei authentisierten 503 | WSS anschließend operativ durch erhaltenen Agentneustart wiederhergestellt; kein automatischer Switchback behauptet. | -| M1 / AT-03 | Falsche CA/Name und korrekt signiertes abgelaufenes Leaf nativ verweigert; Rotation mit erhaltenen IDs und tatsächlichem Peerwechsel; UI-Zertifikatswiderruf/Kanalfencing | Passive Lifecycleidentitäten auf derselben VM; Jobgenehmigungsentzug separat geprüft. | -| M2 | Hello über WSS/HTTPS, eigene Live-Inventur, Rootdienst setup/start/stop, Abbruch vor Start; feste Pläne/Versuche und eigene Grants | Jede neue Wirkung braucht ihren eigenen festen UI-Plan. | -| M2 / AT-07/33 | Doppeltes ursprüngliches Offer und verlorenes Ergebnis-ACK: dieselben IDs/Hashes, genau ein Verbrauch/eine Wirkung; eigene genehmigte Lesejobs bestätigten Zähler 1 | Keine HTTPS-Fault- oder gleichzeitige Helper-/Maschinencrashabnahme. | -| M2 / AT-06/09 | Aktiver Agent offline über frühesten Start; gültiger Wiederkontakt mit frischem signiertem Sync vor einem Grant; eigener Ablauf und eigener tatsächlicher WebUI-Widerruf ohne Grant/Wirkung | Alle drei Fälle auf derselben permanenten Cloudidentität; Browser-Auswertungsfehler beim Widerruf offengelegt, kein zweiter Klick. | -| M2 / AT-08 | Nach einer Rootzählerwirkung nur Agentprozess per gebundener PID/Startzeit beendet; dauerhafter lokaler und zentraler Unknown, unabhängiger Helperabschluss, normaler signierter Sync desselben Verbrauchs; eigener Lesejob bestätigte Zähler 1 | Kein frei gestartetes Skript mit unauflösbarem Ausgang, kein gleichzeitiger Helpercrash. | -| M3 | Genehmigte Rootlogs aus fester Unit: 300 s, höchstens 50 Zeilen/65.536 Bytes; vier tatsächliche Zeilen, Quelle/Zeit und ehrliche Teilabdeckung; gespeicherter DTO über tatsächliche UI-/HTTP-/MCP-Lesesicht gleich, Mandant B verweigert | Kein vollständiger Journalzugriff oder persistenter Cursor. | -| M4 | Eigenes natives Update 1.0→1.1 mit unabhängiger Paket-/Nutzdateinachprüfung und Acceptance; eigene erfolgreiche `ensure_package`-/`apply_updates`-Noops auf 1.1 | Ausschließlich gepinnte `rmm-mvp-test`-Rezepte, keine allgemeine Paket-/Repository-/OS-/Kernelabnahme. | -| M5 | Gespeicherter MCP-Endbericht mit sieben bestehenden erfolgreichen Referenzoperationen einschließlich Originalreboot, eindeutiger Zielmenge und ursprünglicher Submit-Idempotenzreceipt; letzter Reboot mit rechtzeitigem Originalinventar, frischer Verifikation und normalem signiertem Rootabschluss; DoD-Endsnapshot bestanden | Genau ein reales Linuxziel; kein Mehrgeräte-/Mischplattform- oder Produktionsnachweis. | - -Die Offlinefälle sind `8d2d0d7c-f844-48b6-bb8d-b9d00c229c5b` (gültiger -Wiederkontakt, eine Wirkung), `5869480b-d06c-450c-8163-838bf2dda6bc` (expired, -0 Grants/0 Wirkung) und `68148362-e21e-4bd0-9126-12e5a6e03945` (UI-Widerruf, -cancelled, 0 Grants/0 Wirkung). Beim Widerruf wurde nach dem erfolgreichen -Klick nur derselbe Fall mit bestehenden Audit-/Vorher-/Nachherbelegen fortgesetzt. -Kein erfundener lückenloser Zwischenverlauf. Der Agent-Nichtstart-Folgesync wurde -mit erhaltenen Journalen nativ korrigiert; konsumierte oder unklare Versuche -bleiben gesperrt. - -Crashfall `644c06eb-24b0-41b0-9a90-f60ea1fe38a9` belegte -`AGENT_PROCESS_INTERRUPTED`/Revision 2 bei weiterhin arbeitendem Helper. -Grant `a3cbc544-0582-4d64-8237-017a82d7cddf` wurde einmal verbraucht und durch -normalen signierten RootSync geschlossen. Der gesonderte UI-Lesejob ist ein -eigener Versuch, keine zweite Wirkung dieses Grants. Einzelberichte: -[Offlinefälle](cloud-offline-acceptance.md), [Agentabbruch](agent-crash-acceptance.md), -[Zustellung](delivery-acceptance.md), [Transport](transport-acceptance.md), -[TLS](tls-expiry-acceptance.md), [Implementierungsstand](implementation-status.md). - -## M4: Erfolg und erhaltene Misserfolge getrennt - -| Vorhandener Versuch | Tatsächlicher endgültiger Ausgang | -| --- | --- | -| Ursprüngliche APT-Teilwirkung, Grant `31ef5e5e-5dbd-4428-a9a1-cbd15de2f5a0` | Originalsignatur, Hook-/Paketbelege und vollständige Teilbaseline lesend geprüft; normaler signierter RootSync schloss ehrlich `failed/APT_PARTIAL_UNCONFIGURED_VERIFIED`. Originalunknown und Partial-Proof erhalten. | -| Eigener Configureversuch, Grant `33775478-15b0-46ec-b059-44f500dbb0b6`, Root 11 | Paketwirkung vollständig installiert 1.0 nachgewiesen, Abnahme endgültig **failed**: `APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED`, `effect_complete=true`, `postconditions_passed=false`, aktueller Neustartbedarf true und historischer Host-Vorherwert ausdrücklich null. Originalunknown/24-Feld-Proof append-only erhalten; normaler signierter Sync schloss denselben Verbrauch. Keine rückwirkende Acceptance. | -| Native Update-Acceptance, Grant `6b68c65b-8c0c-4cab-964d-e12a2d7f0626`, Root 12 | Eigener UI-Plan 1.0→1.1, `succeeded`, unabhängiger vollständiger Paketbestand und Nutzdatei 1.1; native Acceptancedatei `a88d6b10…`. Hostflag vorher/nachher true, `reboot_required_introduced=false`; kein Reboot. | -| Erster Noop, Grant `b7fbd250-c382-4d2f-950d-ae6001e4c48e`, Root 13 | Endgültig `failed/STATUS_FINGERPRINT`: veraltete passive Baseline vor dem Update. Gespeicherter Kontext tatsächlich in active 13, aber kein Launch/Hook/Precheck/Kindresultat. Native Acceptance und alte Belege erhalten. Kein erfolgreicher Noop und keine Pakettransaktion. | -| Neuer eigener `ensure_package`-Plan, Grant `b8f95463-383d-47c7-a127-25ac3ce64510`, Root 14 | Frische passive 1.1-Baseline nach dem verifizierten Update; separate tatsächliche UI-Genehmigung. `succeeded`, Postconditions true, `already_desired=true`, `changed=false`, `transaction_executed=false`, `postcondition_already_met=true`. | -| Eigener `apply_updates`-Plan, Grant `c267f82b-328f-4d36-8d70-9aa81108646d`, Root 15 | Dieselben unabhängig verifizierten Noop-Nachbedingungen auf 1.1; separate tatsächliche UI-Genehmigung. Keine zweite Updateausführung oder Pakettransaktion. | - -Die drei positiven aktuellen M4-Checkpoints wurden in diesem Abgleich gelesen: -`devstate/cloud-apt-recovery/configured-reconcile-runtime/cases/apt_native_update/checkpoint.json`, -`cases/no-change-retry/ensure_package/checkpoint.json` und -`cases/apply_updates/checkpoint.json`. Jeweils `verified=true`, vor Klick -0 Jobs / 0 Outbox / 0 Grants, danach 1/1/1/0 und Audit -`dev_test_browser_simulation` / `simulated-testprincipal-a` mit ursprünglichem -Planhash. Der erste Fehlversuch bleibt in `cases/ensure_package/checkpoint.json`. -Sein eigener No-Effect-Bericht und alle alten Reconcile-/Markerbelege bleiben erhalten. - -Die neue native Acceptance gehört zu Provider `1dc0237d…`, Helper `bbd2cf80…` -und gemessener Runtime `3bac…`. Beide späteren Noops berichten den tatsächlichen -Host-Neustartbedarf weiterhin `true`; ein Noop braucht keinen erfundenen -Host-Vorherwert und führt keine Paketwirkung aus. Die fehlende historische -Vorhermessung des alten Configureversuchs wird dadurch nicht nachträglich ersetzt. - -Dokumentierter **M4-Abschlussreadback**, keine neue Liveabfrage dieses Audits: -Rootledger **15 Verbräuche / 0 offen / 0 Faults**, zentral -**24 Jobs / 24 Outbox / 22 Grants / 0 offen**; Journale integritätsgeprüft. -APT-Testpolicy geschlossen, APT-Endpunkt am Agenten entfernt und APT-Dienst -inaktiv; Agent-/Generalstrecke aktiv. Das ist ein zeitgebundener Snapshot, -keine Aussage über später begonnene Offline-/Crash-/Rebootpläne. - -## Tatsächlicher Reboot und Kapazitätsbefund - -Der eigene feste UI-Plan verbrauchte Job -`8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa` / Grant -`25a4bf3f-772c-487d-825d-73bcbbc418fd` genau einmal. Zentrale Reservierung -**20:26:12.430245 UTC**, unveränderte 180-s-Frist bis **20:29:12.430245 UTC**. -Neuer Boot `45aba743-be1d-4ae5-ba00-139fb9363bfe` und authentisiert gespeicherte -Inventare um **20:27:40.878097** und **20:28:40.877951 UTC** belegen den -rechtzeitigen Wiederkontakt. - -Der Generalhelper verweigerte beim Boot ehrlich `CLOCK_UNTRUSTED`; seine -bisherige Unit mit `Restart=no` wiederholte den Start nicht. Nach nachgewiesener -vertrauter Kerneluhr wurde ausschließlich derselbe Helper gestartet. -Servervariante `7be1f330…` mit dem Zwei-Inventar-Vertrag wurde erhaltend deployt. -Bei verspäteter Erstverifikation bleiben ursprünglicher fristgerechter Beleg -und separater frischer Sameboot-Beleg samt aktuellem mTLS-Kontext erforderlich; -beide IDs/Serverzeiten werden in signiertem Ergebnis und Audit gebunden. -Drei echte isolierte PostgreSQL-Prüfungen, Format und Clippy bestanden. -Kein zweiter Reboot, keine Fristverlängerung oder manuelle Outcomeänderung. - -Danach blockierte die erneut erreichte endliche Journalgrenze den normalen -Sync. Eine konsistente Kopie der tatsächlichen Rootdatenbank hatte -**65.531 Seiten zu 4.096 Bytes**. Ein 512-KiB-Insert bei 65.536 Seiten scheiterte -mit **SQLITE_FULL 13**; vollständiger Rollback erhielt Schema und Zeilen. -Derselbe Insert gelang bei **262.144 Seiten / 1 GiB**, wiederum mit vollständigem -Rollback. Originalbytes, Größe und Inode blieben unverändert. Keine SQLmutation -am Original, keine Paketwirkung oder Kompaktierung. [Einzelbeleg](journal-capacity.md). - -Die neuen Bookwormartefakte Agent `9e9f3230…` / Helper `d6fbfc25…` sind x86-64, -GLIBC höchstens 2.34 und mit **126 bestandenen lokalen Tests, 0 Fehlern/Skips**, -Formatprüfung sowie Agent-/Helper-Clippy aller Targets qualifiziert. Provider -`1dc0237d…` unverändert. Der geschützte Installationsbericht -`capacity-runtime.json` meldet abgeschlossenen erhaltenden Artefaktaustausch, -Agent damals noch gestoppt und **18 Rootverbräuche / 1 offen**, ohne neue Jobs, -Grants, Paketwirkung oder Reboot. `capacity-upgrade.json` bindet diesen Bericht, -Qualifikationen, Originalsession und alle 18 ursprünglichen Rootzeilen/DB-Inodes. -Dieser Installationsbeleg bleibt vom anschließenden endgültigen Rebootabgleich -getrennt. - -**Danach nativ bestanden:** `result.json` meldet `verified:true` und -`succeeded` für denselben Originaljob/-versuch/-grant. Ursprünglicher -Inventarbeleg `1cf6146c-15fb-491f-a35a-8c4a0bb8f679` um -20:28:40.877951 UTC blieb innerhalb der festen 180 Sekunden. Separater frischer -Verifikationsbeleg `c8214203-04e8-4c75-9aa3-7a786bf64692` wurde um -21:11:02.272955 UTC empfangen; genau ein Serveraudit bindet beide Belege. -Aktueller Kanal Generation 103, Agent und Helper bereit, neuer Boot identisch. -Alle **18 Rootverbräuche geschlossen**, keine andere offene Wirkung; alte -17 Rootzeilen und alle drei DB-Inodes erhalten. Genau 1 Job / 1 Outbox / -1 Grant für diesen Plan, tatsächlicher simulierter WebUI-Audit mit Originalhash. - -`closed.json` ist ebenfalls `verified:true`: zentrale Scope geschlossen, -ursprüngliche Generalconfig-/Pinbytes mit `allow_reboot:false` -wiederhergestellt, Zustand erhalten und kein weiterer Reboot ausgelöst. -Das spät verifizierte Ergebnis datiert weder den Originalkontakt noch die -Frist um. Der vorherige Unknown und die notwendigen Korrekturen bleiben -nachvollziehbar dokumentiert. - -Private Belege stehen unter -`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/`; insbesondere -`actual-reboot-receipts.json`, `capacity-copy.json`, `capacity-runtime.json`, -`capacity-upgrade.json`, `result.json`, `closed.json` und die beiden -`*-reboot-capacity.json`-Qualifikationen. -Historische `before.json`/Plan-/Versuchspins werden nicht umgeschrieben. - -## Helper-Startwiederholung nativ bestanden - -Nach geschlossenem Reboot wurde die General-Unit auf `Restart=on-failure` und -`RestartSec=5` begrenzt geändert, gemessener Unitstand `104a7d6f…`. -Eine kontrollierte fehlende Konfiguration führte tatsächlich zu Exit 1; -`NRestarts` stieg auf 1. Nach Wiederherstellung der Konfiguration lief der -Dienst ohne zweiten Startbefehl automatisch stabil mit `NRestarts=2` an. -Der native Bericht meldet `completed:true`, `automatic_recovery:true` und -`state_preserved:true`. Derselbe Boot, erhaltene Identitäten/Journale, -kein neuer Job/Grant und kein weiterer Reboot. Die Startprüfung blieb -verweigernd; die Uhr wurde für diesen Nachweis nicht manipuliert. - -## Aktuelle APT-Kopienqualifikation und MCP-Endbericht bestanden - -Die neue Helperlaufzeit wurde separat nativ an einer Kopie nachqualifiziert. -Bericht `post-reboot-apt-recovery.json`: `completed:true`, -`readiness_only:true`, `native_acceptance:false`, Runtime -`6545c78462a23be67b283e22e084fa889e094973e91fea9f4abd207e4d515f63`. -Provider `1dc0237d…`, Helper `d6fbfc25…`; alle 18 Rootverbräuche geschlossen, -alte Zeilen, DB-Inodes und Paket-/Acceptance-/Recoveryhistorie erhalten. -Generalhelper/Agent wieder aktiv; APT-Dienst inaktiv und Endpunkt entfernt. -Keine Paketwirkung, neue Acceptance oder weiterer Reboot. - -Ein erster Vorbereitungslauf wurde an einer Sieben-Felder-Metadatenerwartung -**vor** der Pythonprobe verweigert. Der separate eng gebundene Wiederaufnahmepfad -prüfte anschließend den tatsächlichen Vier-Felder-Vertrag und exakte Bytes. -Dieser Fehler bleibt dokumentiert; eine Verweigerung wird nicht als -bestandene Probe gewertet. Die nachfolgende erfolgreiche Kopienqualifikation -etikettiert frühere Paket-Acceptance nicht auf eine neue Runtime um. - -`devstate/cloud-mcp-reference-final.json` ist tatsächlich `verified:true`: -genau sieben vorhandene erfolgreiche Operationen (`hello`, -`refresh_inventory`, `service_setup`, `service_start`, `service_stop`, -`offline_wait`, `reboot_last`), ursprüngliche Submit-Idempotenz -`observed`, eindeutiger berechtigter Kunde und genau ein reales Linuxziel. -Gespeichertes frisches Inventar, feste Pläne/Versuche und korrekte -Operationsaggregate wurden gelesen. Keine neuen Jobs oder Genehmigungen. - -## Tatsächlicher DoD-Endsnapshot bestanden - -Geschützter Abschlussbeleg `devstate/cloud-mvp-final-closeout.json`, -`verified:true`, bindet den unveränderten tatsächlichen Readback -`devstate/cloud-mvp-final-readback.json` über SHA-256 -`147d070432ed58705ed3fb7d9fef812cdefa0caa25f62584f76f7b1e2384409f`. -Erhebung **21:26:13.951997 UTC**, Verifikation **21:27:12.786016 UTC** am -2026-11-13. Der Collector bestätigte: - -- Zentral **30 Jobs / 30 Outbox / 26 Grants / 0 ungeklärte Wirkungen**; - alle **18 Rootverbräuche** mit exakten definitiven Ergebnissen geschlossen, - keine Faults, alte Zeilen und drei DB-Inodes erhalten. Agent und Helper - bereit mit derselben tatsächlich angewandten signierten Entscheidung. -- Agent und Generalhelper aktiv und dauerhaft `enabled`; Agentprozesse - tatsächlich UID 993 / GID 984. Aktuelle Artefakte Agent `9e9f3230…`, - Helper `d6fbfc25…`, Provider `1dc0237d…` stimmen mit ihren Qualifikationen. -- Originale Generalconfig-/Pinbytes mit `allow_reboot:false` und geschlossene - Rootscope; Unit `104a7d6f…` mit fünfsekündiger Fehler-Startwiederholung. - Test-Probeoverride entfernt, Rollback inaktiv. Beide Legacydienste und - APT inaktiv/deaktiviert, APT-Agentendpunkte entfernt. -- Serverkandidat `7be1f330…`: gebautes Image, Kandidatentag und tatsächliche - API-/Gatewaylaufzeit identisch, beide Rollen UID 10001. PostgreSQL gesund - und ohne veröffentlichten Port; API ausschließlich `127.0.0.1:18443`, - Gateway `127.0.0.1:18444`. Explizites dev/test-Profil, Faultflags aus und - keine Fault-Dateipfade konfiguriert. - -Der erste Finalisierungsschreiber verweigerte das Überschreiben der schon -vorhandenen Readbackdatei mit `FileExistsError` (`O_EXCL`). Ihr ursprüngliches -`verified:false` und sämtliche Bytes bleiben erhalten. Die reine lokale -`--verify-existing-observations`-Prüfung bestätigte dieselben tatsächlich erhobenen Daten; -eine **separate** hashgebundene Abschlussdatei enthält `verified:true`. -Kein zweiter VM-Leselauf, keine Umdatierung, neue Wirkung oder gefälschte -Erfolgsschreibung in den ursprünglichen Beleg. - -Quellen-/Artefaktpins, passende lokale Prüfungen, native Ergebnisse, -Capabilitygrenzen und erhaltene Historien sind damit für diese Lieferung -abgeglichen. Weitere Arbeit gehört in die ausdrücklich nachgelagerten -Ausbaustufen; keine zusätzliche Featurearbeit ist Voraussetzung dieser -begrenzten Linux-MVP-Abnahme. - -## Geschützte Belege und Abnahmegrenzen - -Der bereits tatsächliche MCP-Vorbericht -`devstate/cloud-mcp-reference-prereboot.json` benutzt ausschließlich gespeicherte -Leseoperationen: `hello`, `refresh_inventory`, `service_setup`, `service_start`, -`service_stop`, `offline_wait` und dessen originale Idempotenzreceipt. Keine -neuen Pläne, Jobs oder Genehmigungen durch den Bericht. Der Rebootleser kann -den Originalcheckpoint und dessen separates verifiziertes `result.json` -zusammenführen; das wurde im Endbericht tatsächlich ausgeführt. Crash- und -passive Transportberichte sind keine flachen -MCP-Operationscheckpoints. Das vor Reboot geprüfte Manifest bindet die neun -vorher abgeschlossenen APT-/Offline-/Crash-/Transport-/MCP-Gates per Dateihash. - -Genau ein reales Linuxziel genügt für diese vorhandene feste Zielmenge. -`max_parallel=1`, feste Skriptbytes/Versuche und korrekte Einzelaggregate sind -belegt; Mehrgeräteparallelität, Mischplattformausführung und reale Mehrziel- -Teilergebnisse werden daraus nicht abgeleitet. Bestehende gezielte lokale -RLS-/Tenant-, Signatur-/Attempt-/Generations-, Rollen-/Cookie-/Bearer-, -Telemetrie-/Output-/Backpressure- und feindliche Loganzeigeprüfungen bleiben -von nativen Einzelbelegen getrennt. Eine bestandene dev/test-Simulation ist -kein Produktions-IdP-/Betreibernachweis und kein ausgeführter CI-Runner. - -Windows-Jobausbau, weitere Paketrezepte/Agentplattformen, PVE/PBS/Cluster/Backups, -Monitoringausbau, Terminal, Produktions-IdP/HA/Agentupdates, Restore-/Lastbetrieb -und sichere Journal-Kompaktierung bleiben [nachgelagert](post-mvp.md). -RustDesk ist ausdrücklich ausgelassen. Keine zusätzlichen VMs oder Windowsjobs -werden allein für eine größere MVP-Demo verlangt. - -## Abschließende Quellenprüfung - -314 nichtignorierte Quelldateien auf vollständige private Schlüsselblöcke und -versehentlich enthaltene Laufzeitdateien geprüft: keine bestätigten Funde. -Ein Credentialliteral-Kandidat ist der synthetische Canary einer bestehenden -Diagnostikprüfung. Keine Dateien aus `credentials/` oder `devstate/` getrackt; -Ignore-Regeln für Zugänge und Abschlussbelege bestätigt. Dies ist eine -heuristische Quellenprüfung, keine Garantie über unbekannte Secrets. -AST-Prüfung der beiden neuen Readonly-Abschlussadapter, `git diff --check` -und lokale Dokumentlinks bestanden. Die 126 qualifizierten Rusttests sowie -gezielten früheren Server-/UI- und nativen Einzelbelege werden dadurch nicht -als erneut ausgeführt ausgegeben. Kein ausgeführter CI-Runner behauptet. diff --git a/docs/mvp-gates.md b/docs/mvp-gates.md deleted file mode 100644 index 4c7e2b8..0000000 --- a/docs/mvp-gates.md +++ /dev/null @@ -1,47 +0,0 @@ -# Linux-MVP: historische Abnahmegates vom 13. November - -**Aktualitätshinweis 16. November:** Diese Abnahmen bleiben historische Belege. -Die heutige Linuxinstallation ist beim frischen SignedSync durch das volle -1-GiB-Helperjournal blockiert. Der erweiterte Windows-/Updater-MVP ist offen. -Maßgeblicher aktueller Stand und Abschlussfolge: [mvp-completion-plan.md](mvp-completion-plan.md). - -Stand 2026-11-13 · Spezifikation 1.15. **M0–M5 sind im vereinbarten begrenzten -Linux-dev/test-Umfang abgeschlossen.** Tatsächlicher Client ist eine -Ubuntu-24.04-x86-64-Cloud-VM gegen `discovery.ease-technologies.de`. -Das Notebook dient nur der Entwicklung. Windows ist separat passiv geprüft; -RustDesk und M6–M8 gehören nicht zum Umfang. - -| Gate | Tatsächlicher Abschluss | Einzelbeleg | -| --- | --- | --- | -| 0: gespeicherte APT-Teilwirkungen | Originalgebundene Readonlybelege und normaler signierter Sync schlossen alte Versuche ehrlich als failed. Keine rückwirkende Acceptance oder ungeklärte Wirkung. | [Implementierungsstand](implementation-status.md), [APT-Hostflag](apt-ambient-reboot.md) | -| 1: M4-Paketkatalog | Eigenes natives Update 1.0→1.1 mit unabhängigen Paket-/Nutzdateinachbedingungen; eigene erfolgreiche ensure_package-/apply_updates-Noops auf 1.1. Alte Baselineverweigerung erhalten. | [APT](apt-ambient-reboot.md), [Audit](mvp-final-audit.md) | -| 2: M1-Identität/Transport | Unprivilegierter Agent, Enrollment/mTLS/WSS/HTTPS, Inventar/Heartbeats; falsche CA, Name und abgelaufenes Leaf verweigert; Rotation, Peerwechsel, UI-Widerruf und tatsächlicher automatischer WSS→HTTPS-Fallback. | [TLS](tls-expiry-acceptance.md), [Transport](transport-acceptance.md) | -| 3: M2-Wiederholung/Unterbrechung | Doppelte Offerzustellung und verlorenes Ergebnis-ACK ohne zweite Wirkung. Agent-SIGKILL nach einmaliger Rootwirkung, dauerhafter Unknown, unabhängiger Helperabschluss und normaler Sync desselben Grants. Eigene Lesejobs bestätigten Zähler 1. | [Zustellung](delivery-acceptance.md), [Crash](agent-crash-acceptance.md) | -| 4: M2-Offlinefälle | Aktiver Agent über frühesten Start offline: gültiger Wiederkontakt mit frischem Sync führte zu genau einer Wirkung. Ablauf und tatsächlicher UI-Planwiderruf jeweils ohne Grant/Wirkung. Nichtstart-Folgesync nativ korrigiert. | [Offline](cloud-offline-acceptance.md) | -| 5: M3-Logs/Sichten | Eigener genehmigter begrenzter Rootlogauftrag, tatsächliche Quelle/Zeit und partielle Abdeckung. Gespeicherte UI-/HTTP-/MCP-Ergebnisse gleich; Mandant B verweigert. Feindliche Loganzeige separat lokal als Text geprüft. | [Audit](mvp-final-audit.md) | -| 6: M5-MCP | Sieben bestehende erfolgreiche Operationen, einschließlich ursprünglichem Reboot. Genau ein festes reales Linuxziel, berechtigter Kunde, frisches gespeichertes Inventar, richtige Aggregate und originale Submit-Idempotenzreceipt. | Geschützt: `devstate/cloud-mcp-reference-final.json`, verifiziert | -| 7: M5-Reboot | Genau ursprünglicher Job 8ffd / Grant 25a, neue Boot-ID, Originalinventarempfang innerhalb unveränderter 180 s und separate frische Verifikation. Normaler signierter Sync schloss denselben Verbrauch; Rechte exakt geschlossen. | [Reboot](reboot-acceptance.md) | -| 7a: reale Abschlussfehler | Uhr-/Startfehler und volles 256-MiB-Journal diagnostiziert. Native automatische 5-s-Startwiederholung und endliche 1-GiB-Kapazität mit Kopier-/Erhaltungsnachweis bestanden. Aktuelle APT-Runtime nach strikter Metadatenverweigerung eng versioniert und kopierend qualifiziert. | [Journal](journal-capacity.md), [Kapazität](journal-capacity-acceptance.md), [Reboot](reboot-acceptance.md) | -| 8: M0/DoD | Tatsächlicher Endzustand: 30 Jobs / 30 Outbox / 26 Grants / 0 ungeklärt; Root 18 geschlossen und faultfrei. Historische Zeilen/Inodes erhalten, qualifizierte Artefakte, aktive unprivilegierte Dienste. APT/Legacy disabled, Rechte/Faults geschlossen; DB intern und Verwaltung an Loopback. | Geschützt: `devstate/cloud-mvp-final-closeout.json`, verifiziert; [Audit](mvp-final-audit.md) | - -Jeder tatsächliche Job begann als persistenter `pending_approval` mit -0 Jobs/Outbox/Grants. Erst der tatsächliche WebUI-Klick der sichtbar simulierten -Testidentität erzeugte die festen Jobs. Das Audit bindet Testprincipal und Plan -mit `approval_origin=dev_test_browser_simulation`, `testsimulation=true`. -MCP, Policies und Automatik genehmigen nicht. Kein menschlicher -Produktionsfreigabenachweis und kein direkter API-/DB-Freigabeweg. - -M4 umfasst ausschließlich die gepinnten `rmm-mvp-test`-Rezepte auf dieser VM, -keine allgemeinen Paket-, Repository-, OS- oder Kernelupdates. Historische -positive Paketabnahmen bleiben an ihrer Originalruntime `3bac…` gebunden. -Aktuelle Storageartefakte `9e9f…`/`d6fb…` mit Provider `1dc…` und Runtime -`6545…` wurden separat nur kopierend als `readiness_only=true`, -`native_acceptance=false` qualifiziert. Keine neue Paket-Acceptance behauptet; -der APT-Endpunkt bleibt geschlossen. - -Das größere Journalbudget ist endlich und kein Langzeitbetriebsnachweis. -Gleichzeitiger Helper-/Maschinencrash, Mehrgeräteparallelität, Produktions-IdP, -CI-Runner und weitere Plattformen sind aus den Einzelbelegen nicht abzuleiten. -Es gibt kein offenes Gate im vereinbarten MVP-Umfang. Weitere Entdeckungen und -Ausbaustufen stehen in [post-mvp.md](post-mvp.md); sie werden mit diesem -Abschluss nicht automatisch begonnen. diff --git a/docs/operations-access.md b/docs/operations-access.md index 3084d0c..bfe9b51 100644 --- a/docs/operations-access.md +++ b/docs/operations-access.md @@ -1,278 +1,47 @@ -# Zugänge für eine andere AI auf diesem Entwicklungs-PC +# Betriebszugänge für die Entwicklung -**Aktuell öffentlich.** WebUI und MCP sind über [den Passwort-/TOTP- und Tokenzugang](public-access.md) erreichbar. Die nachstehende SSH-Anleitung beschreibt zusätzlich den internen Entwicklungsweg. +WebUI und MCP sind öffentlich über HTTPS erreichbar. Die folgenden Zugänge dienen der Wartung des dedizierten Entwicklungsservers und der beiden Testgeräte. Der normale Geräteverkehr geht vom registrierten Agenten zum Server. [WebUI und MCP](public-access.md) · [Serveraufbau](server-deployment.md) +## SSH-Ziele -Die nachstehenden Zugangsproben stammen vom 17. November 2026, 09:14–09:38 Uhr MEZ. Am Nachmittag waren alle drei SSH-Ziele erreichbar. Den aktuellen Produktzustand mit Zeitstempeln und Zielbelegen nennt der [Lieferplan](mvp-completion-plan.md). Die [Bestandsaufnahme](evidence/product-audit-20261117.json) dokumentiert den Zustand vor der Reparatur. Für die direkte Entwicklungsbereitstellung siehe [Entwicklungsweg](development.md). -Diese Anleitung beschreibt vorhandene Zugänge, keine Erlaubnis für neue Jobs, -Deployments, Konten, Schlüssel, Reboots oder Wiederherstellungen. +Die Werkzeuge werden im Repository als Eigentümer der lokalen Entwicklungsprofile ausgeführt. `tools/dev_stage.py` findet `credentials/` im Checkout oder bei einem verknüpften Worktree im gemeinsamen Hauptcheckout. Die Profile enthalten Zugangsdaten und werden vom Parser als Daten gelesen. Das Verzeichnis hat Modus 0700, private Dateien haben Modus 0600. Die Ausgabe von Profilinhalten, Tokens, Schlüsseln, Zugangscodes und privaten Diagnosen gehört weder in Git noch in den Chat. -## 1. Vom richtigen Arbeitsverzeichnis und Benutzer ausgehen - -~~~bash -cd /home/kevin/Schreibtisch/Coding/rust-discovery -git status --short -git log -1 --oneline -~~~ - -Als lokaler Benutzer **kevin** arbeiten, nicht Python mit sudo starten. -Die Parser verlangen Dateien im Eigentum des aktuellen Unixbenutzers. -Ein neuer Checkout/Worktree enthält die absichtlich ignorierten credentials/ -und devstate/ nicht. Die Originale liegen **hier auf diesem PC** im obigen -Arbeitsverzeichnis. Nicht neu enrollen oder den User nach Schlüsseldateien -fragen, nur weil eine andere Arbeitskopie sie nicht enthält. - -| Ziel/Zweck | Vorhandenes lokales Profil oder Quelle | Transport | +| Name für das Werkzeug | Ziel | Lokale Vertrauensgrundlage | | --- | --- | --- | -| Server 88.99.80.202 | credentials/server.conf | root per bestehendem SSH-Key | -| Cloud-Linux 116.203.20.85 | credentials/linux-vm.conf | vorhandener Key/Benutzer aus Profil | -| Windowsgast | credentials/windows-dev-access.json | vollständiger vorhandener ssh_prefix mit ProxyCommand | -| Öffentliche Server-CA | credentials/server-ca.pem | TLS-Kette und SAN prüfen | -| WebUI-Testlogin | credentials/server-browser-login.json | nur geschützter lokaler Browserlogin | -| Windows-Hostpin | credentials/windows-dev.known_hosts | Alias rmm-windows-dev, bereits vorhandener Trust | -| Server-/Linuxpins | normale bestehende SSH-known_hosts | keine automatische Neuannahme | +| `server` | Dedizierter ARM64-Host `discovery.ease-technologies.de` | `server.conf`, vorhandener SSH-Schlüssel und geprüfter Hostkey | +| `linux` | Cloud-Linux-Gast `dev-znuny-db` | `linux-vm.conf`, vorhandener SSH-Schlüssel und geprüfter Hostkey | +| `windows` | Windows-11-Gast `discwindowstest` | `windows-dev-access.json`, `windows-dev.known_hosts`, Alias `rmm-windows-dev` und SSH-Rückkanal über den Server | -credentials/ hat 0700, geprüfte Profile/Keydateien 0600; Profile und devstate -sind gitignoriert. Nur gezielt programmgesteuert verwenden. Keine Passwörter, -Tokens, privaten Schlüssel oder gesamten Profile drucken oder in Git kopieren. -Niemals source/eval für diese Dateien verwenden. Standard-SSH darf den -bestehenden Schlüssel zur Authentisierung verwenden; er wird nicht exportiert. +Der folgende Befehl liest vom Wurzelverzeichnis des Worktrees aus den Hostnamen der Linux-Test-VM. -## 2. Server und Cloud-Linux: geprüfter lesender SSH-Einstieg - -Das Datenformat der conf-Dateien liest -[vm_access_check.py](../deploy/vm_access_check.py) mit striktem Parser. -Der folgende feste Befehl liest ausschließlich den Kerneltyp: - -~~~bash -python3 - <<'PYCODE' -from pathlib import Path +```sh +python3 - <<'PY' import subprocess, sys -sys.path.insert(0, "deploy") -import vm_access_check as access +sys.path.insert(0, "tools") +from dev_stage import ssh_prefix +subprocess.run([*ssh_prefix("linux"), "hostname"], check=True, timeout=20) +PY +``` -profile = "server.conf" # Für die Cloud-Linux-VM: "linux-vm.conf". -cfg = access.load_config(Path("credentials") / profile) -args = [ - "ssh", "-F", "/dev/null", "-T", - "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes", - "-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no", - "-o", "ControlMaster=no", "-o", "ControlPath=none", - "-o", "ConnectTimeout=7", "-p", cfg.get("port", "22"), - "-i", str(Path(cfg["ssh_key_path"]).expanduser()), - cfg["username"] + "@" + cfg["address"], "uname -s", -] -r = subprocess.run(args, capture_output=True, timeout=20) -if r.returncode: - raise SystemExit("SSH-Prüfung fehlgeschlagen; private Fehlerausgabe zurückhalten") -print(r.stdout.decode().strip()) -PYCODE -~~~ +`ssh_prefix` verwendet Batchbetrieb, bestehende Schlüssel und strikte Hostprüfung. Die Hostpins für Server und Linux stehen im vorhandenen SSH-Truststore des Benutzers (`~/.ssh/known_hosts`). Windows verwendet die oben genannte separate Hostpindatei. Für Windows wird der geprüfte Proxyweg mit dem gespeicherten Profil abgeglichen. Vor Änderungen an einem Pin den neuen Fingerabdruck unabhängig mit dem Zieladministrator bestätigen. [SSH-Auflösung und Staging](../tools/dev_stage.py) -Heute beide Zielverbindungen erfolgreich, ohne SSH-Multiplexing. -Der bestehende Linux-Preflight kann alternativ mit -python3 deploy/vm_access_check.py aufgerufen werden; er ist lesend, prüft mehr -OS-Metadaten und kann bei fehlendem Trust nur **unbestätigte** Scan-Fingerprints -zeigen. Diese nicht automatisch übernehmen. Das neue Linux-RMM-Verbindungsziel -ist direkt discovery.ease-technologies.de, **kein** alter PC→VM-RMM-Reversetunnel. +## Interne Test-WebUI -Serverarbeitsverzeichnis: /opt/rust-discovery. API/Gateway/Postgres heißen -rust-discovery-server-api-1, rust-discovery-server-gateway-1, -rust-discovery-server-postgres-1. Reine Lesebefehle über die oben gebildete -SSH-Verbindung sind beispielsweise docker ps oder ein enges docker inspect. -Niemals komplette Config.Env, .env, private PKI oder Tokenfiles ausgeben. +Die interne Entwicklungs-API ist auf dem Server an `127.0.0.1:18443` gebunden. Für einen Test mit dem expliziten Entwicklungsprofil auf dem Notebook einen freien lokalen Port zum Server weiterleiten. Dieses Beispiel verwendet lokal ebenfalls 18443 und hält den Tunnel bis zum Beenden des Befehls offen. -**Bei einer später ausdrücklich beauftragten Bereitstellung:** Die tatsächlich -laufende Compose-Dateikette erst aus dem Label -com.docker.compose.project.config_files der API/Gatewaycontainer lesen. -Beim morgendlichen Abruf enthielt sie neun Basis-/Broker-/Release-/Policydateien. Nur die Basisdatei -mit compose up/recreate zu verwenden würde den falschen Stand erzeugen. -Die genaue heutige Reihenfolge steht im -[öffentlichen Zugangsbeleg](evidence/ai-handover-access-20261117.json). -Heute wurde kein Compose-/Dienstaufruf mit Wirkung ausgeführt. - -## 3. WebUI und MCP: privater SSH-Forward, gültiges TLS - -API/MCP auf Server 127.0.0.1:18443, Gateway auf127.0.0.1:18444; PostgreSQL -ohne Portveröffentlichung. Öffentlicher Agenteningress und SSH sind getrennt. -Keine öffentliche Dev-Anmeldung einrichten. - -Für einen eigenen lokalen Verwaltungsforward ist dieser Befehl vorbereitet. -Er läuft im Vordergrund bis Strg+C. Vorher prüfen, ob18443 schon belegt ist; -keinen fremden Listener beenden oder verwenden. - -~~~bash -python3 - <<'PYCODE' -from pathlib import Path +```sh +python3 - <<'PY' import subprocess, sys -sys.path.insert(0, "deploy") -import vm_access_check as access -c = access.load_config(Path("credentials/server.conf")) -args = [ - "ssh", "-F", "/dev/null", "-N", "-T", - "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes", - "-o", "IdentitiesOnly=yes", "-o", "ForwardAgent=no", - "-o", "ExitOnForwardFailure=yes", "-o", "ConnectTimeout=7", - "-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=2", - "-p", c.get("port", "22"), - "-i", str(Path(c["ssh_key_path"]).expanduser()), - "-L", "127.0.0.1:18443:127.0.0.1:18443", - c["username"] + "@" + c["address"], -] -subprocess.run(args, check=True) -PYCODE -~~~ +sys.path.insert(0, "tools") +from dev_stage import ssh_prefix +ssh = ssh_prefix("server") +subprocess.run([*ssh[:-1], "-N", "-o", "ExitOnForwardFailure=yes", + "-L", "127.0.0.1:18443:127.0.0.1:18443", ssh[-1]], check=True) +PY +``` -Danach WebUI https://localhost:18443/ und MCP https://localhost:18443/mcp. -Die CA gezielt aus credentials/server-ca.pem verwenden; kein curl -k, -ignoreHTTPSErrors oder falscher TLS-Name. Heute über einen eigenen temporären -Loopbackforward tatsächlich geprüft: gültige Kette/localhost-SAN, healthz200, -MCP ohne Authentisierung401. Kein neuer Browserlogin. Ein zusätzlicher authentisierter MCP-Leseaufruf ist -unten separat nachgewiesen. +Für `https://localhost:18443/` die Entwicklungs-CA aus `credentials/server-ca.pem` gezielt vertrauen. Der private Browser-Testlogin liegt im geschützten Profil `credentials/server-browser-login.json`. Persönliche Freigaben für die öffentliche Verwaltung verwenden das lokale Benutzerkonto mit TOTP. [Browsertests](../deploy/browser/README.md) -Vorhandene Anwendungshelfer, erst lesen und nur passend verwenden: +## Windows-Gastkonsole -- deploy/cloud_mvp_acceptance.py: Backend() spricht echtes MCP über den Server; - gespeicherte Daten etwa mit inventory.get_device/jobs.get lesen. - Der normale CLI-Abnahmelauf ist **nicht** bloß ein Zugangstest. -- deploy/browser/windows_mvp_approve.cjs: führt echte UI-Genehmigung durch; - **niemals** als Erreichbarkeitsprobe oder mit einem alten Checkpoint ausführen. -- prepare_browser() aus cloud_mvp_acceptance.py richtet gezielten Browsertrust - im vorhandenen isolierten NSS-Verzeichnis ein. Der Browser liest die geschützte - Login-JSON selbst; keine Kennwörter kopieren. -- Entwicklungslogin und sichtbar simulierte Freigaben sind für diesen MVP - beauftragt; kein OIDC nötig. Das ersetzt keine neue Risikoentscheidung. - -Beim morgendlichen Abruf bestanden: authentisierter MCP-Aufruf jobs.get, -nur gespeicherter Job7d756c34… gelesen, Ergebnis unknown/Revision2. Die -vorhandenen Zugangsdaten bleiben auf dem Server; kein Submit, Plan oder Approval. -Der reproduzierbare lesende Einstieg ist: - -~~~bash -python3 - <<'PYCODE' -import sys, json -sys.path.insert(0, "deploy") -import cloud_mvp_acceptance as c -record = c.Backend().call("jobs.get", { - "tenant_id": "11111111-1111-4111-8111-111111111111", - "job_id": "7d756c34-3506-4545-8ecd-0e94b9fe7569", -}) -print(json.dumps({"state": record["state"], "revision": record["revision"]})) -PYCODE -~~~ - -Alte private Browserwrapper mit festgehaltener PID 1689414 oder historischem -Portbesitzer nicht übernehmen. Einen eigenen Forwardprozess identifizieren -und nach Benutzung ausschließlich diesen schließen. - -## 4. Windows: vorhandenen Prefix benutzen, nicht neu bootstrappen - -Der vorhandene Weg ist: - -~~~text -Entwicklungs-PC - └─ SSH-Key/Hostpins → root@88.99.80.202 - └─ Server 127.0.0.1:22240 - └─ bestehender Windows→Server-Reversetunnel - └─ Windows127.0.0.1:22222 (sshd) - └─ rmm-dev -~~~ - -Der ProxyCommand und die richtigen Key-/Hostpinpfade sind bereits vollständig -im ssh_prefix der geschützten JSON gespeichert. Nicht von Hand aus alten -Chatbefehlen rekonstruieren. Schlüssel-/Hostpinexistenz und die Optionen -BatchMode/IdentitiesOnly/StrictHostKeyChecking wurden heute lokal geprüft. - -Bevorzugter lesender Einstieg mit dem vorhandenen Helper: - -~~~bash -python3 - <<'PYCODE' -import sys, json -sys.path.insert(0, "deploy/windows") -import client_bootstrap as cb -result = cb.powershell(r""" -[pscustomobject]@{ - utc = [DateTime]::UtcNow.ToString('o') - sshd = [string](Get-Service sshd).Status - tunnel = [string](Get-ScheduledTask RmmDevReverseTunnel).State - agent = [string](Get-Service RmmDiscoveryWindows).Status - helper = [string](Get-Service RmmDiscoverySystemHelper).Status -} | ConvertTo-Json -Compress -""", timeout=30) -print(json.dumps(result)) -PYCODE -~~~ - -Beim morgendlichen Versuch scheiterte der Gaststatusbefehl: -Dem Windows-SSH-Zugang fehlte damals der Serverlistener 22240. Eine frische -Verbindung mit deaktiviertem äußerem Multiplexing bestätigte Connection refused. -Am Nachmittag bestätigte der Zugriff über den vorhandenen Prefix die laufenden Agent- und Helperprozesse. [Betriebsnachlese](evidence/product-audit-20261117.json) - -Der User hat am 16. November permanenten Entwicklungs-SSH ausdrücklich erlaubt. -Konto rmm-dev ohne Ablaufdatum und SYSTEM-Task RmmDevReverseTunnel sind -historisch eingerichtet und nachgewiesen. **expires_at in der lokalen JSON -ist noch der historische abgelaufene Bootstrapwert.** Die Funktion -client_bootstrap.powershell() nutzt den vorhandenen Prefix und prüft dieses -alte Fristfeld nicht. JSON nicht nur für alte Runner umschreiben und keinen -neuen User-Wartungsfensterbefehl erzeugen. -[Historischer Nachweis](windows-development-access.md). - -Weitere Stolperstellen: cb.powershell() erwartet eine einzelne JSON-Ausgabe. -Keine Schlüssel/Tokens oder breite Diagnoseausgaben zurückgeben. -[Console]::In.ReadLine()-Payloads haben über diesen Transport bereits gehangen; -alte Upload-/Renewal-CLI nicht als Allzweckzugang ausführen. Für einen später -beauftragten Import nur die vorhandenen geprüften Hash-/Stagingpfade verwenden. -remote_signed=True setzt RemoteSigned nur für den einzelnen Bootstrapprozess; -keine globale ExecutionPolicy ändern. - -## 5. Wenn der Windows-Tunnel fehlt: lokale Gastkonsole ist der zweite Weg - -Tatsächlich heute lesend geprüft: - -- libvirt-Verbindung qemu:///system, Domain win11-test: Running. -- DHCP-Lease laut libvirt192.168.122.170/24; **keine** Aussage über einen dortigen - SSH-Listener. Windows-sshd ist absichtlich nur an Gast-Loopback gebunden. -- virsh, virt-viewer und virt-manager sind auf diesem PC vorhanden. -- Konsole konnte ohne Tasteneingabe aufgenommen werden. Bild schwarz, - ein entsperrter Administrator-PowerShellprompt wurde heute nicht bestätigt. - -~~~bash -virsh -c qemu:///system domstate win11-test -virsh -c qemu:///system domifaddr win11-test --source lease -~~~ - -Zum späteren Öffnen der bestehenden Konsole ist vorbereitet, hier nicht gestartet: - -~~~bash -virt-viewer --connect qemu:///system win11-test -~~~ - -Der schon benutzte lokale Tastatur-/Screenshothelfer liegt unter -devstate/windows-client/mvp-closeout-20261116/console.py. -Er verwendet virsh send-key für **diesen Gast**, deutsche Tastenbelegung und -nur eingeschränkte Zeichen. Ein Aufruf mit Argument tippt tatsächlich in die -gerade aktive Gastoberfläche; enter sendet Enter. Nicht blind aufrufen, -importieren oder unbekannte laufende Befehle unterbrechen. -Ohne Argument überschreibt er seine privaten live-Bilder. -Heutige neue, getrennte Bilder: -devstate/ai-handover-20261117/windows-console.png und .ppm. - -Bei beauftragter Zugangswartung zuerst die Konsole/Anmeldung klären und -ausschließlich den bestehenden Task und sshd **lesen**. Erst danach gegebenenfalls -den bereits beauftragten Entwicklungstransport erhaltend wieder starten. -Kein RMM-Dienstwechsel, kein Reboot/Update, keine neuen Schlüssel/Accounts/Ports -und kein alter Bootstrap-Reparaturlauf sind dafür automatisch nötig/autorisiert. -Heute wurde nichts davon ausgeführt. Ein vorhandener Konsolenlogin wurde -nicht vorausgesetzt; erforderliche Benutzerinteraktion offen melden. - -## 6. Historische Werkzeuge sind keine Wiederaufnahmeanweisung - -console_access_recovery.py/precision/hash/original_bootstrap, Open-*Window, -Recover-*, Set-PersistentDevelopmentAccess, die221-/205-SDKs, -Install-*Successor und windows_system_scope_renew.py besitzen feste alte Fälle, -Fristen, Inodes oder create-once-Intents. **Nicht erneut ausführen oder deren -Guards passend machen.** Ebenso keine credentials-/devstate-Snapshots über -die aktuellen Originale kopieren. - -Heute wurden ausschließlich Profile/Dateiexistenz, SSH, gespeicherter Serverzustand, -VMstatus und TLS geprüft. Kein Zugang ist als Jobgenehmigung zu verstehen. +Bei geschlossenem Entwicklungsrückkanal zuerst auf dem Notebook `virsh -c qemu:///system domstate win11-test` prüfen. `virt-viewer --connect qemu:///system win11-test` öffnet die vorhandene Konsole. Im entsperrten Gast lassen sich der Dienst `sshd` und die geplante Aufgabe `RmmDevReverseTunnel` prüfen. Der registrierte Rückkanal endet auf dem Server an `127.0.0.1:22240`. Der Agent meldet sich unabhängig davon über das Gerätegateway. diff --git a/docs/parallel-mvp-status.md b/docs/parallel-mvp-status.md deleted file mode 100644 index dc8d11d..0000000 --- a/docs/parallel-mvp-status.md +++ /dev/null @@ -1,183 +0,0 @@ -# Parallele MVP-Fortsetzung2026-11-14 - -**Historische Chronik, ersetzt als aktuelle Übersicht am 16. November.** -Den tatsächlichen Betriebsstand, offenen Umfang und die verbindliche -Agentreihenfolge beschreibt [mvp-completion-plan.md](mvp-completion-plan.md). -Frühere Clockblocker und Quellenstände unten sind keine aktuelle Aussage; -Windows-SYSTEM und echte Selbstupdates fehlen, Linux ist aktuell storageblockiert. - -**Integrierter Quellencheckpoint2026-11-15:** Main13d9491 vereinigt -Windows-Zeitprofil1.23 und Updater-Readercensus. Lokaler locked/offline -Alltargetscheck für Server, Linuxagent, Windowslibrary und Updaterworker -bestanden (keine Tests/VM-Wirkung dadurch). Fall0d6736fc, Log-SHA256 -`9ce99acc46912e3bd96f064ae5db330bbd23d325d63935d126592360104a2cb9`. -Zwei frühere Harnessläufe stoppten vor Kompilierung (Entrypoint, Owner des -eigenen neuen Targets); Fehlerlogs erhalten, kein ursprünglicher Cache -entsperrt. Die separat gefrorenen Produkt-/VM-Nachweise behalten ihre -eigenen Source-/Artefaktbindungen; dies ist keine neue native Applyabnahme. - -**Updater-Quellenfortschritt1.21:** Gemeinsamer Checkpoint1e89c45 ist gepusht -und nach Main integriert. Server/Katalog/Streaming/UI, Healthpfad bei Ready=false, -Corehandoff/native CAS, geschützte Provisionierungscodecs und erster konkreter -Linuxworker sind implementiert und lokal geprüft. Core64, Domain23, Server45; -fünf DB-Harnessfälle ausdrücklich nicht ausgeführt. Check/Clippy/Format bestanden. -Worker-Signatur-/Floor-Gegenbeleg1/1. Siehe [Workerumfang und Grenzen](agent-updater-worker.md). -Noch keine neue Runtimebereitstellung, keine Applycapability und kein echter -Agent-Austausch. Baselinebootstrap, konkrete komplette Engine/Fullguards, -Updated-Recordhistory und Rollback bleiben offen; Windowsclock weiter geschlossen. - - -**Neuester Stand:** Linux-Skriptkonsole einschließlich MCP-Antrag, tatsächlicher -simulierter WebUI-Freigabe und Rootausführung ist bestanden. Windows und der -vollständige Selbstupdater bleiben offen. Linux-Updaterkern8 sowie isolierter -Linux-OS-Port5 sind inzwischen nativ und mit getrenntem Readback bestanden; -[OS-Ergebnis](agent-updater-linux-native-results.md). Das ist kein Applynachweis. -Der private Linuxruntimeindex ist erhaltend fortgeschrieben; Fullhelper läuft, -sein Autostart ist weiterhin deaktiviert. Windows-Impersonate3 liefert erstmals -RPC0/Stage80, die notwendige zusätzliche Dienstidentität ist nicht qualifiziert. -Erste QOS5-Bindung meldet87 vor jeder Query; W32Time war im separaten lesenden -Status unsynchronisiert. Keine neue Windowswirkung und keine Clockfreigabe. -Alle älteren Zahlen darunter gehören zu ihren jeweiligen historischen Schritten. - - -Der Benutzer hat die parallele Umsetzung ausdrücklich beauftragt. Schwerpunkt -ist die Skriptkonsole: AI/MCP hinterlegt vollständige Shell-/PowerShellskripte -als feste Anträge; erst die WebUI-Genehmigung erlaubt den genau gebundenen -Root-/SYSTEM-Versuch. Passive Heartbeats/gespeicherte Telemetrie bleiben davon -getrennt. Das Notebook ist ausschließlich Entwicklungsrechner, Linux läuft auf -der Cloud-Test-VM, der permanente Server ist discovery.ease-technologies.de. - -## Tatsächliche neue Nachweise - -- **Entwicklungszugang:** User-Konsolenrecovery und gepinnter SSH-Kontakt im - Fallfc7a6ad5 bestätigt; anschließend vollständige öffentliche Datei-/Key- - Metadaten-/Task-/SID-Erhaltung490e0180 geprüft. Lokale Accessfrist erst danach - per CAS erneuert; identische SSH-Pins und Schlüssel. Der zusätzliche - Downloadclose-Nachbelegb046e30d bestätigt nach tatsächlicher Timerwirkung: - Bootstrapdienst inaktiv, kein8443Listener und keine8443Allowregel, Closeaktion - erfolgreich. Kein neues Enrollment oder RMM-Job. -- **Pipe-v2:** Erhaltender Paarupgrade14fb einmal ausgeführt, tatsächlicher - LocalService/SYSTEM-Peertransport bestanden. Agentf10c78dd und Helper5f8c62fa - laufen unter unveränderten Konten/Startarten. Zwei neue Heartbeats, - Inventar-ACK, Tenantverweigerung und ursprüngliche PKI-/DB-/Lockdatei-IDs/ - Historie erhalten. Resultatd5c49968; lokale Mainindizes erst danach per CAS - fortgeschrieben. Windows0/0/0/0, Linux30/30/26/0, Clock/Jobs/Wirkungenfalse. - [Quellen und genaue Grenzen](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/b4dbeba/docs/windows-system-pipe-upgrade.md). -- **Runtimeunits:** Erster Windowslauf25971084 scheiterte an einer fehlenden - `SystemDrive`-Variable im bereinigten Testprozess. Ausschließlich Runner - korrigiert, kein Test entfernt und keine Produktquelle geändert. Neues - Manifest341866b7: zuerst Cloud-Linux10 (a8978cd0/7c314685), danach - Windows35+7 (b377daad/9bf7aef4) bestanden, keine Skips/Filter. - [Ergebnis und ursprünglicher Fehler](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/1136707/docs/windows-msi-runtime-units.md). -- **Zeitdienstdiagnose:** Microsoft-MIDL-Tools vor Ausführung nativ mit gültiger - Authenticode-/Onlinekettenprüfung zugelassen (4b10a063). Codegen149bafe2 - abgeschlossen, Dateien getrennt lesend bestätigt (0dc23738). Tatsächliches - HeaderSHA256db5dbe5b, StubSHA256d806adb4. Das ist Compilererfolg, keine - erfolgreiche W32Time-RPC-Abfrage. Frühere1783Fehler bleiben fehlgeschlagen. - -## Aktueller Betrieb nach weiteren tatsächlichen Schritten - -Cloudserverfall14dcc27d ist gebaut und erhaltend bereitgestellt, Migration14 -angewandt; API/Gateway als UID10001, Loopbackports und private WebUI erhalten, -öffentliche Adminrouten geschlossen. Ursprüngliche Job-/Audit-/Identitätsgeschichte -bytegleich, keine neuen Jobs/Genehmigungen. [Nachweis7ef068f](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/7ef068f/docs/script-console-cloud-upgrade-v2.md). - -Linux nach separater erster Startfortsetzung66a537bb aktiv: Agent66132, -General65562 und Full66122, genaue neue Images0a7ad6ee/79442727, korrekte Konten, -gleicher Boot und erhaltene ursprüngliche SQL-/PKIzeugen vor Starts. Die alten -Install-/Probeberichte bleiben fehlgeschlagen. [Belegcfd32ea](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/cfd32ea/docs/script-console-bootstrap-results.md). -Aktuelle Windowsunits36+7 im Fall76bb47dd danach vollständig bestanden, -keineSkips/Filter, separatesReadback. [Beleg5b2f07b](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/5b2f07b/docs/script-console-windows-link.md). -Das ersetzt keine laufende Windows-Runtime-/Clock-/SYSTEM-Abnahme. - -Danach vollständige native passive Nachattestation mit drei Beobachtungen -bestanden (efd310b), ursprüngliche Identität/PKI/DBinodes/Root18 sowie -SignedSync und gespeicherte Kontakt-/Inventarfortschritte nachgewiesen. -Automation erhielt ausdrücklich nur das fehlende root:execute, keine -Genehmigungsrechte (afccf95). - -**Die erste vollständige Skriptkonsole ist auf Cloud-Linux nativ bestanden -(76440e1):** Einmal MCPplan/submit, persistentes pending_approval mit null -ausführbaren Artefakten; echte WebUI mit geprüftem TLS und Chromium-Sandbox, -Originalplanbytes vollständig verglichen, sichtbarer SIMULIERT-Freigabeklick. -Ein Root/Fullskript, Exit0, stdout28/stderr27Byte ungekürzt und bytegenau auch -über echte WebUI-Downloads geprüft; MCP-Ergebnis gleich. Zwei authentisierte -MCP-Fremdmandantenabfragen verweigert. Native Root19/0 mit18 unveränderten -Originalzeilen, ServerLinux31/31/27/0, Windows0/0/0/0. Der Zwischenzustand -running wurde im Browser verpasst und nicht durch Wiederholung erzeugt. -Temporäre Scopes geschlossen; Originalpolicycf15cbb6 separat lesend bestätigt. -[Genaue Ergebnisse und Grenzen](script-console-linux-full-results.md). -Die folgenden älteren Zwischenstände bleiben historische Belege. - -Windowsclock danach weiter gesperrt: tatsächlicher Discovery-Erfolg mit -nicht-NULL Emptyprincipal; eigener ursprünglicher Guard stoppte vor Query. -Separater Empty-Vergleich führte eine Opnum6 aus und ergab weiter RPC5/Stage90, -keinen Status. Vorhandenes SeSystemtimePrivilege im SYSTEM-Diagnoseprozess war -deaktiviert; daraus folgt noch keine bewiesene alleinige Ursache. Separates -Readback, Cleanup und vollständige native RMM-Erhaltung bestanden; Windows -weiter0/0/0/0. Die parallel genehmigte Linuxänderung ist ausdrücklich erfasst. -[Beleg98f4edf und Grenzen](windows-clock-spnego-empty-trace.md). -Ein separater Prozessprivilegvergleich wird vorbereitet, noch nicht nativ -ausgeführt. Updater-Handoffkernel nach unabhängigem Review als isolierter -Quellschritt a2efb79 gepusht und anschließend **Cloud-Linux8 nativ bestanden**, -keine Skips/Filter, separater Readback und bekannte Dienst-/Kontroll-/ -Stateidentität erhalten. [Ergebnis](agent-updater-handoff-linux-results.md). -Runtimeintegration läuft getrennt; weder Apply noch Windows dadurch abgenommen. - -## Fortschreibung: reale Quellenprüfungen und Bereitstellungsgrenzen - -- Skriptkonsole im Branch `codex/script-console`, Commit - [ff78b6a](https://gitea.incoso.eu/kevin_janssen/rust-discovery/commit/ff78b6a): - Vertrag1.20, Helper-Codepin und vollständiger Runtime-/UI-Pfad implementiert - und unabhängig geprüft. Tatsächlich Cloud-Linux84 bestanden; fünf DB-Fälle - dort explizit ausgelassen und separat in PostgreSQL45/45 bestanden. Web49, - Typecheck und Build bestanden. Windows derselben158 Eingaben ist gelinkt; - nativer Lauf offen. Erster Stagingfall4e59 stoppte an einem falschen absoluten - SFTP-Pfad vor Listen-/Testausführung; separates Readback bestätigt beide Marker - abwesend. Das ist ein Harnessfehler, kein Produktnachweis. -- Linux-Bootstrap2e27c312 hat die geprüften neuen Images installiert, - General-/APT-Steuerdateien und sämtliche ursprünglichen SQL-/PKI-/Dateizeugen - vor Restart unverändert geprüft. Danach Guardfehler vor erster Startwirkung: - die effektiven leeren systemd-Denylisten werden als `~` angezeigt, nicht als - leerer String. Originalreportf752258c bleibt fehlgeschlagen. Readback bestätigt - alle drei neuen Dienste inaktiv/PID0, APT weiterdisabled. Eine gesondert - geprüfte erstmalige Startfortsetzung ist offen; keine Wiederholung des - ursprünglichen Installers, kein Job und kein Reboot. -- Cloudserverfall499e stoppte vor Dockerbuild an wechselnder Reihenfolge - identischer vollständiger Mountobjekte. Originalfall unverändert, kein - Imagewechsel/Migration. Neuer getrennt geprüfter v2-Runner normalisiert nur - deren Reihenfolge und verlangt eine frische Baseline; Bereitstellung offen. -- Native Windows-Clockdiagnose mit echtem Microsoft-MIDL meldet unter - LocalService wie SYSTEM RPC5/Stage90 ohne Status. EEInfo-Falle4e6 lieferte - Runtime-Component2/Status5/Detection1750; die konkrete Ursache ist damit nicht - belegt. Separates Readback, gezieltes Cleanup und vollständige Erhaltung - bestanden. Clockgate bleibtfalse. - [Tatsächlicher Beleg und Grenzen](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/commit/29e35c4/docs/windows-clock-eeinfo-trace.md). -- Updater-Verifier nach Linux9 auch Windows9 nativ bestanden; beide Schritte - separat gepusht. [Branchstand3543e07](https://gitea.incoso.eu/kevin_janssen/rust-discovery/commit/3543e07). - Das ist der signierte reine Prüfkern; Applydienst/Releasekatalog/Streaming/ - WebUI-Updatepläne und Wiederanlauf bleiben offen. Kein aktiver Autoupdater. - -Die nachfolgende Tabelle beschreibt den früheren Quellenzwischenstand; diese -Fortschreibung hat bei widersprechenden Build-/Betriebsangaben Vorrang. - -## Parallele Quellenarbeit und verbleibende MVP-Arbeit - -| Thema | Tatsächlich umgesetzt/geprüft | Noch offen | -|---|---|---| -| Skriptkonsole | Vertrag1.20 implementiert/geprüft, Cloudserver/WebUI und Linuxruntime bereitgestellt. Nativ CloudLinux84, Windows43 und separatPG45 bestanden; erste tatsächliche MCP/WebUI/Rootskriptstrecke samt Rohbyteausgabe und Mandantengrenze bestanden. | Native Windows-PowerShell/SYSTEM-Ausführung; weitere erforderliche aktuelle Abbruch-/Unknown-Gates, abschließende Integration und aktuelle private Runtimeindizes. | -| Windowslaufzeit | Positive echte Pipe-v2-Peerstrecke und passive Erhaltung; portable Runtime-/Domainunits nativ. | Tatsächliche TrustedClock-Abnahme, synchrone Helper-/Intent-/PERSIST-Strecke, genehmigte Skriptausführung und verbleibende Windows-MVP-Gates. | -| Agent-Selbstupdater | Reiner signierter Verifier auf CloudLinux9 und Windows9 nativ bestanden. Neuer isolierter Handoff-/Fullrenderer-/Healthkernel lokal8/8 und unabhängig geprüft; noch keine Applyruntime. | Atomare bestehende Ledgertransaktion, Inflight-/Serviceownership und authentisierter Healthanschluss, Katalog/Streaming, feste WebUI/MCP-Updatepläne, OSaustausch/Erhaltung/zulässiger Rollback und native Applynachweise. Kein aktiver Autoupdater. | - -APT-/MSI-Paketfixtures prüfen Verwaltung anderer Software; sie implementieren -keinen Agent-Selbstupdater. Weitere Paketfeatures sind der Skriptkonsole -nachgeordnet. EXE-Normvorschläge sind nicht freigegeben. Volle Hostwartung ist -ein explizites neues Profil: Root/SYSTEM kann selbst Agent, Dateien, Dienste oder -Neustartzustand verändern; daraus folgt keine Sandbox-/Rollback-/No-Reboot- -Zusage. Keine impliziten destruktiven Tests oder Hostneustarts. - -Alle tatsächlichen RMM-Wirkungen bleiben hinter der unveränderten -`pending_approval`→interaktiven WebUI-Grenze. Neue Profile, Builds, lokale Tests -und Bootstrapnachweise sind keine Produktionsfreigabe und kein vollständiger -Windows-MVP-Abschluss. Quellen und Dokumentation werden nach jedem -Abnahmeschritt nach Gitea gepusht; private Rohbelege bleiben ignoriert. diff --git a/docs/platform-support.md b/docs/platform-support.md deleted file mode 100644 index 7390a0e..0000000 --- a/docs/platform-support.md +++ /dev/null @@ -1,63 +0,0 @@ -# Tatsächlich geprüfte Plattformen - -**Historische Matrix. Aktueller Stand und Grenzen am 16. November:** -[mvp-completion-plan.md](mvp-completion-plan.md). Windows hat inzwischen einen -nativ bestandenen allgemeinen LocalService-Skriptpfad; SYSTEM ist offen und -beide RMM-Dienste sind gestoppt. Linux läuft, aber frischer Sync ist storageblockiert. -Die ältere Aussage „kein Jobexecutor“ unten ist damit überholt. - -Stand 2026-11-13 · Spezifikation 1.15. Dies ist eine Entwicklungsmatrix, -keine Produktionsfreigabe. Build, native Teilabnahme und vollständige MVP-Abnahme -sind getrennt; Notebook-Host ausschließlich Entwicklungsrechner ohne Agent. -**Linux-MVP M0–M5 ist für die genannte Cloud-VM im begrenzten dev/test-Umfang -abgenommen.** - -| Ziel | Build | Tatsächlicher nativer Nachweis | Offene Grenzen | -| --- | --- | --- | --- | -| Ubuntu 24.04 x86-64, Cloud-Linux-Client | Rust 1.99.1, GNU/glibc, Bookworm-Buildbasis; Agent-/Helperartefakte benötigen höchstens GLIBC 2.34; neue 1-GiB-Variante mit 126 lokalen Tests qualifiziert | systemd-Agent, mTLS/WSS und HTTPS/Auto-Fallback, TLS-Lifecycle, Inventar/Heartbeat; genehmigte Skript-/Rootdienst-/begrenzte Logstrecke, Doppelzustellung/ACK-Verlust; alle drei aktiven Offlinefälle und Prozessabbruch mit dauerhaftem Unknown, signiertem Abschluss und unabhängigem Zähler; begrenztes M4-Update 1.0→1.1 und beide 1.1-Noops; eigener einmaliger Reboot mit signiertem Abschluss; automatische Helper-Startwiederholung; aktuelle native APT-Kopienqualifikation; MCP-Endbericht mit sieben erfolgreichen Operationen und DoD-Endabgleich bestanden | Begrenztes dev/test-MVP M0–M5 abgeschlossen. Genau eine reale Ziel-VM, keine Mehrgeräte-/Mischplattform- oder Produktionsabnahme. Rebootrechte und APT-Endpunkt geschlossen; 18 Rootverbräuche abgeglichen, alte APT-Fehlschläge erhalten. | -| Windows 11 Pro, Build 26300, x86-64, eigener Gast | `x86_64-pc-windows-gnu` Crossbuild Debug/Release und Clippy bestanden | LocalService/Service-SID, Enrollment, ausgehendes mTLS/WSS sowie separat natives explizites HTTPS und automatischer WSS→HTTPS-Fallback nach zwei authentisierten503, gespeichertes `windows.base`, frische Heartbeats und konkrete Inventar-ACKs; Tenant-B-Verweigerung, sieben native Rusttests. Bestehende VM anschließend dauerhaft auf `auto` mit bevorzugtem WSS umgestellt und nativ geprüft; Identität/ACLs erhalten. Separate native Admin-TLS-Proben verweigerten falsche CA/Name und abgelaufenes Clientzertifikat bei gültigen Kontrollen. | Unsignierter Entwicklungsbuild. Kein Jobexecutor/Helper/PowerShell-/Paketpfad. Rotation/Widerruf, MSI/EXE, signierter Installer und Rebootpersistenz noch nicht nativ abgenommen. Installerdefault `auto` ohne neue Installationsabnahme. Registry-Produktname meldet noch den tatsächlichen Legacywert „Windows 10 Pro“; unabhängige CIM-Probe bestätigt Windows 11. | -| Windows MSVC-Ziel | Geplant | Nicht ausgeführt | GNU-Build/-Lauf ist kein MSVC-Nachweis. | -| ARM64-Agenten, weitere Windows-/Linux-Versionen | Nicht freigegeben | Keine entsprechende native Agentabnahme | Keine Supportableitung aus einem Compilerziel oder ARM64-Server. | -| Ubuntu 26.04 ARM64, dedizierter Cloudserver | Native ARM64-Serverbuilds bestanden | API/Gateway/PostgreSQL, Migrationen 1–13 und Clientverbindungen auf `discovery.ease-technologies.de` | Öffentliche WebUI/OIDC und Produktionsbetrieb nicht abgenommen; Verwaltungs-UI nur über SSH-Tunnel. Kein ARM64-Agentnachweis. | - -Windows verwendet denselben Domain-/Protobuf-/TLS-Vertrag; passive Beobachtungen -benötigen keine Einzelgenehmigung. Jeder künftige Ausführungsjob braucht den -unveränderlichen Plan und WebUI-Genehmigung. Keine eigene Desktop-Engine, -RustDesk aus dieser Umsetzung ausgelassen; PVE/PBS/Cluster bleiben nachgelagert. - -Die Linux-Paketabnahme umfasst ausschließlich die exakt gepinnten -`rmm-mvp-test`-Rezepte für 1.0/1.1 auf der genannten Ubuntu-VM. Native -Update-Acceptance ist an Provider `1dc0237d…`, Helper `bbd2cf80…` und die -damals gemessene Runtime gebunden. `ensure_package` und `apply_updates` waren auf 1.1 -nachgewiesene Noops: kein weiterer APT-Transaktionsstart, kein Reboot. -`reboot_required=true` bezeichnet den zu diesen Paketjobs wahrheitsgemäß -beobachteten Hostbedarf. Weitere Katalogeinträge, allgemeine Repository-/OS-/Kernelupdates, -andere Distributionen und Mehrgeräteparallelität sind dadurch nicht abgenommen. - -Die TLS-Lifecycleprüfungen verwenden erhaltene passive Testidentitäten auf -derselben Cloud-VM. Sie belegen keine zusätzlichen Zielmaschinen und ersetzen -keine Genehmigungsentzugsprobe bei einem bereits geplanten Ausführungsjob. -Letztere wurde inzwischen mit eigenem tatsächlichem UI-Widerruf und -0 Grants / 0 Wirkung auf der permanenten Cloudidentität separat bestanden. - -Die gemeinsame Journalgrenze wurde nach erneutem `SQLITE_FULL` auf einer -erhaltenen VM-Datenbankkopie von 256 MiB auf endliche 1 GiB erhöht; keine -Kompaktierung oder Historylöschung. Qualifizierte neue Artefakte sind Agent -`9e9f3230…` und Helper `d6fbfc25…`, Provider `1dc0237d…` unverändert. -Ihr nativer erhaltender Austausch und der nachfolgende Rebootabschluss sind -getrennt belegt; keine neue Paketwirkung und kein zweiter Reboot. -Die aktuelle Helperlaufzeit wurde an einer Kopie nativ nachqualifiziert, -Runtime `6545c784…`, `readiness_only=true`, `native_acceptance=false`. -APT bleibt gestoppt und der Agentendpunkt entfernt. Historische M4-Erfolge -werden weder zurückdatiert noch auf eine neue Runtime umetikettiert. - -Der native Endsnapshot bindet Agent `9e9f3230…`, Helper `d6fbfc25…`, Provider -`1dc0237d…`, laufende Agent-/Generaldienste und deren Rechte. Zentral -30 Jobs / 30 Outbox / 26 Grants / 0 offen; Root 18 geschlossen, keine Faults, -gleicher angewandter signierter Sync in Agent und Helper. Kein Langzeit-, -Restore- oder Produktions-IdP-Nachweis aus diesem Entwicklungsabschluss. - -Genaue Tests, Artefakthashes und Grenzen: -[Implementierungsstand](implementation-status.md), -[Windows-Client](../deploy/windows/CLIENT.md), -[Server](server-deployment.md), [MVP-Abschlussaudit](mvp-final-audit.md). diff --git a/docs/post-mvp.md b/docs/post-mvp.md deleted file mode 100644 index 1990a7b..0000000 --- a/docs/post-mvp.md +++ /dev/null @@ -1,40 +0,0 @@ -# Entdeckungen und Aufgaben nach dem Linux-MVP - -Stand 2026-11-14. Die begrenzten Linux-[M0–M5-Gates](mvp-gates.md) sind -abgeschlossen. Windows wird auf eigenen Auftrag fortgesetzt; seine aktuellen -Voraussetzungen stehen in [Windows-Gates](windows-gates.md) und -[Jobgrenze](windows-job-boundary.md). Diese Liste erweitert den Auftrag nicht. -Weitere Entdeckungen hier einordnen, anstatt nebenbei Produkteigenschaften -zu bauen. Sicherheits- oder Korrektheitsfehler in einem aktuell bearbeiteten -Pfad bleiben dort sofort relevant. - -| Entdeckung / späteres Thema | Tatsächlicher heutiger Stand | Spätere Aufgabe | -| --- | --- | --- | -| Gesundheitsübersicht für größere Flotten | Beim Quellabgleich nach der MCP-Abnahme vom 15. November fiel auf, dass `monitoring.get_health` die erste Inventarseite liest und deren Fortsetzungscursor verwirft. Der aktive Testbestand passte auf eine Seite. | Vor Nutzung für größere Mandanten den Cursor für HTTP und MCP durchreichen und den Bezugszeitpunkt beibehalten. `inventory.list_devices` unterstützt bereits Folgeseiten. | -| Verfügbarkeit der signierten Serverzeit | Tatsächliche Quellproben derselben laufenden Chronygeneration lieferten50.834ms bei43.596s Syncalter und später295.609ms bei320.110s. Beide gültig; kein kontinuierlicher Verfügbarkeitsnachweis. | Nach dem MVP natürlichen Poll-/Kernel-Fehlerverlauf und Verfügbarkeit messen, gegebenenfalls separat genehmigte Betriebsoptimierung. Fehlende Qualität muss bereits jetzt deny bleiben; keine500ms-Grenzlockerung, erfundene Frische oder implizite Resync-/Konfigurationsänderung. | -| Windows-PE nach erneutem Debugstrip | Zwei Lieferkopien mit identischen unveränderten Original-Linkdateien unterscheiden sich nach erneutem Strippen nur an vier Bytes: COFF-Zeitstempel/PE-Prüfsumme, Offsets136/137/216/217. Lokal tatsächlich verglichen; beide ursprünglichen Packs bleiben erhalten. Jeder Pack pinnt seine konkreten Lieferbytes. | Reproduzierbare PE-Werkzeugpipeline vor M7 festlegen. Bis dahin niemals gleichen Lieferhash aus gleicher Rustquelle/gleichem Original-Link behaupten oder ein altes Manifest überschreiben. Kein aktueller Autorisierungs- oder Abnahmebypass. | -| Dev-Reversetunnel ohne Zielbanner | Windows-RMM-Heartbeats liefen tatsächlich weiter, während Serverlistener/TCP-Verbindung auf127.0.0.1:22240 vorhanden waren, aber kein SSH-Banner durchkam. Der Bootstraploop überwacht nur das äußere ssh.exe und verbindet nach dessen Ende neu; der Task hat kein RestartOnFailure. Konkrete Ursache des blockierten SSH-Ziels unbewiesen. Keine SSH-/Hostkey-/Expirygrenze gelockert. | Nach dem MVP begrenzte Transport-/Workerdiagnose verbessern. Keine automatische Schlüsselverlängerung, öffentliche Windowsportfreigabe oder pauschalen sshd-/UID-Resets. Der aktuelle manuelle Konsolenneustart bleibt ausdrücklich zeitlich abzustimmen und ist kein RMM-Rebootnachweis. | -| Legacy-Syncflag ohne signierten Sync | Bei Clients ohne `rmm.sync.v1` setzt der bisherige Hello-Kompatibilitätspfad `sync_ready=true`. Auf dem passiven Windowsclient nach Serverneustart tatsächlich beobachtet; weiterhin keine Jobcapabilities und kein signierter Syncnachweis. | In Status/API `sync_required`, Unterstützung und tatsächlichen signierten Checkpoint trennen. Das Legacyflag niemals als Windows-Jobabnahme verwenden. | -| Nichtstart zwischen Grant und Helperdelegation | Beim Windows-SCM-Source-Review2026-11-14 wurde eine lokale Consumption ohne Helperzeile als strenger Sync-Fault erkannt. Die Linux-Root-Quelle besitzt strukturell denselben frühen Pfad; dieser konkrete Linuxfall wurde noch nicht nativ reproduziert. Aktuelle Rootscope bleibt geschlossen. | Vor Wiederöffnung für weitere Rootjobs den engen Vor-Delegation-Cancel-/Fencefall reproduzieren und analog gebunden lösen; keine Missing-Row-Guardlockerung oder Historienänderung. Der aktuelle Windowsfixvertrag steht in Spec1.17/[Abandonvertrag](windows-system-abandon.md). Historische Linux-Abnahmen werden dadurch nicht rückwirkend als dieser Nachweis ausgegeben. | -| Rohoutput und kanonischer Sync-Outcome | Das vorhandene Sync-Outcome-Limit von 512 KiB betrifft JSON; Zahlenarrays können den erlaubten Rohoutput deutlich vergrößern. Kleine bisherige MVP-Fixturen sind davon nicht betroffen. | Vor breiter Freigabe großer Ausgaben effektive Adapterlimits, Codec-/Kontrollnachrichtenbudget und gegebenenfalls Artefaktreferenzen konsistent qualifizieren. Keinen erfolglosen Sync als übernommen ausgeben. | -| Windows-Produktname | Reale Windows-11-Pro-VM meldet über RegistryProductName den Legacywert „Windows 10 Pro“; unabhängige CIM-Probe bestätigt Windows 11. Rohquelle wird nicht umgedeutet. | Windows-OS-Anzeige über geeignete versionierte Quellen normalisieren und Herkunft weiter sichtbar halten. Keine ungeprüfte Buildnummern-Heuristik. | -| Vollständiger Windows-Client (W) | Passiver LocalService-/Enrollment-/mTLS-WSS-/HTTPS-/Inventar-/Tenantpfad, automatischer HTTPS-Fallback und sieben native Tests bestanden. Bestehende VM separat mit dauerhaftem Auto-Default und bevorzugtem WSS nativ geprüft; keine neue Installationsabnahme. Separate Admin-TLS-Negativproben bestanden; keine LocalService-Negativprobe. Kein Windows-Jobexecutor; Entwicklungsbuild unsigniert. | Zuerst die ausdrücklich beauftragte Windows-Jobgrenze qualifizieren: Clock, gemeinsamer signierter Sync-/Journal-/Einmalverbrauchskern und Interpreterbindung. Rotation/Widerruf, Rebootpersistenz, Helper, geprüfte MSI/EXE sowie MSVC-/Signier-/Installerabnahmen folgen nur im gewählten Windowsumfang. Kein Linux-MVP-Blocker. | -| Breitere Paket-/Updateunterstützung | Aktuelle APT-Abnahme betrifft ausschließlich die beiden gepinnten Testrezepte, nicht beliebige Pakete/Repositories oder OS-/Kernelupdates. | Weitere tatsächlich benötigte Rezepte und Plattformmatrix mit eigener Herkunfts-/Closure-/Nativeabnahme hinzufügen; keine Erweiterung durch frei gewählte URL/Installerargumente. | -| Produktionsanmeldung und öffentliche Verwaltung | Explizites dev/test-Profil und sichtbar simulierte UI-Bedienung; Verwaltungszugang über SSH-Tunnel. Externer IdP/öffentliche Produktionsverwaltung nicht abgenommen. | OIDC-/MFA-/Betriebsprofil mit echtem Betreiber und getrennten Nachweisen konfigurieren/abnehmen. Keine öffentliche Dev-Anmeldung. | -| Dauerhafter Produktivbetrieb (M7) | Ein dedizierter Cloudserver, getrennte API/Gateway-Rollen, interne DB; Wiederanläufe ohne Historienreset belegt. | HA, getestete Backups/zentraler Restore, vereinbarte RTO/RPO, externe Plattformüberwachung, signierte Agentupdates und getrennt gesicherter Auditbestand. Grundlegende aktuelle Wiederholungssperren bleiben schon im MVP Pflicht. | -| Gleichzeitiger Build und Deployment | Entdeckt beim Zustellungstest und inzwischen im aktuellen Upgradepfad behoben: eindeutiger Kandidatentag + aufgezeichneter Digest; nur explizites geprüftes Deploy bewegt den Runtimetag. Abgeschlossener nativer Build ließ Runtime unverändert. Historische Buildrunner bleiben getrennt zu prüfen. | Verfahren später auf alle Release-/Rollbacks-/CI-Pfade übertragen. Historische mutable Runner bis dahin nur ausdrücklich koordiniert verwenden. | -| Monitoringausbau (M6a) | Präsenz, Quellen-/Datenalter und unbekannte Gesundheit werden getrennt dargestellt. | Sollservice-/Funktionschecks, Alarmdauer/Hysterese, Vorfälle und produktiver Metrikpfad samt nativen AT-28-Nachweisen; keine erfundenen Patchdaten. | -| Langzeitjournale und Kompaktierung | Reale Sync-Historien erreichten64MiB nach zehn Rootverbräuchen. Isoliert reproduziert; auch die folgende256MiB-Grenze wurde im Rebootabschluss erreicht; Spec 1.15 setzt weiterhin endliche 1 GiB pro Datei. Native Kopier- und Artefakterhaltungsqualifikation bestanden, alle Historien erhalten. Volle/inkonsistente Journale sperren weiterhin neue Wirkungen. | Dokumentierte beidseitige Kompaktierung und Kapazitätsplanung; niemals stille Löschung von Unknown oder unbestätigten Ergebnissen. | -| Automatische Rückkehr von HTTPS zu WSS | Tatsächlicher Auto-Fallback nach zwei authentisierten WSS503 bestanden. Auch der passive Windows-LocalService-Fallback ist nativ geprüft. Ein bestehender HTTPS-Aktor bleibt gegebenenfalls bestehen; operativer Agentneustart mit erhaltener Konfiguration stellte WSS wieder her. | Nur bei produktivem Bedarf einen begrenzten, zustandserhaltenden Transportwechsel untersuchen; derzeit kein automatischer Switchback versprochen und kein zusätzliches MVP-Feature. | -| Dauerhaft ungültiges passives Inventar vor Reconnect-Sync | Der neue Recovery-Scope wurde zunächst vom zentralen Zeichenvalidator abgewiesen. Das unverändert persistierte Inventar wurde vor dem Sync erneut gesendet und blockierte so den Kanal; der unmittelbare MVP-Fix erlaubt ausschließlich diesen bekannten Linux-Scope. | Einen expliziten Umgang mit dauerhaft abgewiesener passiver Telemetrie untersuchen, der Originalbytes, Nachrichten-ID, Herkunft und Ablehnungsbeleg erhält und keine Bestätigung erfindet. Job-/Ergebnisjournale und unbekannte Wirkungen dürfen dabei niemals übersprungen werden. | -| Windows-Updatequalifikation für mehrere Geräte | Der neue Quellpfad wählt eine geschützte native SYSTEM-Qualifikation über exakte Agent-/Helper-/Policyhashes und prüft tatsächlichen signierten Startzeugen, WebUI-Audit, SYSTEM-Outcome und Source-/Nativebelege. Ein Katalogeintrag ist keine Readiness oder Jobfreigabe. Aktuelle MVP-Provisionierung/VM-Abnahme stehen noch getrennt aus. | Nach dem MVP Geräte-/OS-/Signierkeywechsel und Releaseprovisionierung skalieren. Keine Qualifikation von einer anderen VM ableiten; keine generische Hersteller-CI oder zusätzliche öffentliche API für den jetzigen MVP bauen. | -| Weitere Windows-Updatefehler | Der enge MVP-Quellrückweg behandelt den unabhängig belegten Fehler des ersten Helperstarts ohne gestarteten Kandidatenreader. Die reale Abnahme dieses Falls bleibt MVP-Pflicht. Agent-Teilstart, verlorene Antworten, abgelaufene Fristen und unbelegte Healthfehler werden konservativ als unsicher behandelt. | Erst später zusätzliche Rückwegfälle mit eigenen tatsächlichen Fehlerzeugen qualifizieren. Weder HTTP-Timeout noch ein gemeldeter Fehlerstring dürfen als Nichtstart gelten; Unknown und ursprüngliche 180-/600-Sekunden-Grenzen bleiben erhalten. | -| Weitere Plattformen / Skalierung | Ubuntu 24.04 x86-64 als Linux-Testclient; ARM64-Serverbuild ist kein ARM64-Agentnachweis. Nur eine tatsächliche Linux-Zielmaschine im aktuellen Aufbau. | Native Agentmatrix und realistische Last-/Mehrgeräteabnahmen erst zur vereinbarten Ausbaustufe erweitern; keine erfundenen Parallelitätszahlen. | -| Proxmox/PBS/Cluster/Backups (M6b) | Kein Hypervisorzugang für eigenständige Gastagenten nötig; bewusst nicht Teil des Linux-MVP. | Separater späterer Integrationsauftrag mit eigenen ACL-/Discovery-/Backup-/Clusterabnahmen. | -| Terminal/Relay/Business Services | Spätere Architekturverträge; kein Auftrag für eine Desktop-Engine. | Erst M7/M8 und eigener Umfang. RustDesk bleibt aus dieser Umsetzung ausgeschlossen und wird auch danach nicht automatisch begonnen. | -| Historische Dokumentationsschichten | Mehrere READMEs/Statusabschnitte beschreiben frühere lokale Topologie, alte Runtimepins oder inzwischen gelandete Schnittstellen. Aktuelle Overrides und neueste Nachweise haben Vorrang. | Historische Texte und Runtime-Manifeste zusammenführen/archivieren und Querverweise vereinheitlichen. Aktuelle Pins aus dem Abschlussaudit verwenden; alte geschützte Qualifikations-JSONs bleiben historische Belege und werden nicht überschrieben. Aktuell gefährliche Startanweisungen bereits vor Ausführung korrigieren; insbesondere alte PC-Server-/Reverse-Tunnelrunner nicht blind verwenden. | - -Grenzen und echte Ergebnisse stehen im -[Implementierungsstand](implementation-status.md), der -[Plattformmatrix](platform-support.md) und im -[Windows-Clientvertrag](../deploy/windows/CLIENT.md). diff --git a/docs/project-decisions.md b/docs/project-decisions.md deleted file mode 100644 index e086091..0000000 --- a/docs/project-decisions.md +++ /dev/null @@ -1,561 +0,0 @@ -# Verbindliche Projektentscheidungen - -Stand: **2026-11-18**, Spezifikation **1.41** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. - -## Zentrale Rechte für MCP-Skriptanträge (Version 1.41) - -Die Rechte für Administrator-Skripte werden pro Token und Kunde auf dem Server vergeben. Ein vorbereiteter Client kann solche Aufträge ohne Benutzereingriff am Gerät abarbeiten. Für Betreiber gehört die Auswahl zulässiger Skripte zur Geräteregel und die Freigabe des konkreten Auftrags zu „Genehmigungen“. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md#012-mcp-anträge-für-administrator-skripte-version-141) - -## Release-Gültigkeit für installierte Skripthelfer (Version 1.40) - -Der Betreiber hat entschieden, dass ein abgelaufenes Release-Manifest Administrator-Skripte auf bereits installierten Clients nicht sperrt. Bei der Prüfung des installierten Helfers zählt der unveränderliche Registrierungszeitpunkt im Katalog. Der aktuelle Schlüsselring entscheidet weiterhin über die Vertrauensstellung. Bei Neuinstallationen und Updates prüft das System die Gültigkeit zum aktuellen Zeitpunkt. - -## Aktionen über Skripte (Version 1.39) - -Der Betreiber hat einen einzigen Ausführungsweg gewählt. Sowohl ein einmaliges Skript als auch eine Bibliotheksrevision durchlaufen denselben Genehmigungs- und Rückmeldeweg. Die Neustartvorlagen benutzen die Betriebssystemfunktion mit einer Minute Vorlauf für die Ergebnismeldung. Für die erfolgreiche Wiederkehr zählt der Bootwechsel mit anschließendem Auftrag. Die Geräteansicht unterscheidet das Dienstkonto vom verfügbaren Administrator-Kontext. Ein früher eingerichtetes enges Wartungsprofil behält seinen Umfang. Der dauerhafte Skripthelfer braucht eine ausdrückliche lokale Einrichtung sowie eine passende zentrale Geräte- und Rollenbindung. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md#010-ausführbare-geräteaufträge-version-139) - -## Offizieller Windows-x64-Release (Version 1.38, 18. November 2026) - -Der Betreiber hat GNU für den öffentlichen Windows-Kanal gewählt. Der Linux-Entwicklungsrechner baut alle drei Windows-Binaries. Der Windows-Gast dient der nativen Abnahme. Offizielle und Entwicklungsmanifeste führen dasselbe tatsächliche Ziel und verwenden getrennte Ed25519-Schlüssel. Das Installationsskript wählt GNU. MSVC bleibt optional. Eine bestehende lokale Entwicklungsvertrauensstellung erfordert eine bewusste Migration. Die Neukopplung und die Löschung der alten Kopplung auf der Windows-Test-VM wurden ausdrücklich freigegeben. - -Für ausgeschiedene Geräte gilt die identitätsgenaue endgültige Löschung nach Widerruf gemäß Kapitel 0.9. Die Bedienung und die Folgen für Auftragsdaten sind im [Betriebsablauf](public-access.md#alte-gerätekopplung-endgültig-löschen) beschrieben. - -## Bedienwege für Skriptaufträge (Version 1.37) - -Bibliotheksarbeit, Gerätezuweisung und die abschließende Entscheidung haben eigene Reiter. Die Bibliotheksversion wird beim Planen gebunden. Für Einreichungen aus WebUI und MCP gilt derselbe Genehmigungseingang mit Prüfung je Kunde. „Aufträge“ zeigt Ergebnis und Ausgabe je Gerät. [Bedienung und Abnahme](mvp-completion-plan.md) - -## Kunden und Gerätebestand (Version 1.36) - -Die WebUI startet mit den authentisierten Geräten der berechtigten Kunden. Die Historie bewahrt ausgemusterte und unbestätigte Installationen getrennt auf. Jedes Gerät gehört über seine Aufnahme zu genau einem Kunden. MCP-Berechtigungen bestehen aus Aktionsrechten und einer festen Kundenauswahl oder einem ausdrücklich globalen Kundenkreis einschließlich künftiger Kunden. Die frühere Beschränkung auf genau einen Kunden je Token entfällt. [Produktvertrag](../Rust_RMM_Implementierungsspezifikation.md) - -## Öffentliche WebUI und MCP ohne OAuth (Version 1.35) - -Der Betreiber will beide Verwaltungsoberflächen über das Internet erreichen und hat OAuth ausdrücklich ausgeschlossen. Für die WebUI hat er Passwort plus TOTP gewählt. Der öffentliche Produktions-API-Dienst verwendet deshalb lokale Human-Accounts, der MCP-Endpunkt eigenständige mandanten- und rechtegebundene Bearer-Tokens mit Ablauf und Widerruf. Die frühere Tunnelpflicht und öffentliche OIDC-Pflicht werden ersetzt. Der interne Entwicklungszugang bleibt für native Abnahmen bestehen. [Aufbau und Belege](public-access.md) - -## Native Windows-Updateabnahme am 17. November 2026 - -Der Betreiber hat die Installation echter Windows-Updates auf der Windows-Test-VM, erforderliche Wartungsneustarts und die Prüfung des Wiederanlaufs nach einem frühen Abbruch der Wartungseinrichtung ausdrücklich beauftragt. Die Updatevorlage wird als eigener fester Bibliotheksauftrag über die WebUI genehmigt. Ein benötigter administrativer Neustart der Entwicklungs-VM kann über den geprüften SSH-Zugang erfolgen und wird mit Bootwechsel und anschließendem Agentkontakt belegt. - -## Entwicklungsdaten und MVP-Abnahme (Version 1.34) - -Der Betreiber hat für das Entwicklungssystem die Löschung der benannten Anfrage und der blockierenden Testdaten freigegeben. Eine frische Geräteidentität ist für die Installationsabnahme zulässig. Der reguläre Updatepfad erhält die Identität. Der Windows-GNU-Entwicklungsbuild ist als eigener signierter Release adressierbar. Für die mitgelieferte unveränderte Windows-Update-Vorlage dürfen feste Freigabe, Server- und Helperpolicy bei passender Capability bis 3600 Sekunden erlauben. Der dedizierte Gateway stellt den Geräteauftrag über HTTPS-Polling zu. Der Entwicklungsoperator darf nach geschlossenem Wartungsscope, terminalem Ergebnis und geprüftem Geräte-/Releasebezug die abgeschlossenen lokalen Arbeitsprojektionen archivieren und die dazugehörige Helper-Zuordnung lösen. Das ermöglicht den Rückbau eines temporären Wartungshelpers. Serverergebnisse und native Ausführungsnachweise werden dabei erhalten. [Bereinigungsnachweis](evidence/dev-cleanup-pull-20261117.json) - -## Skriptverwaltung, HTTPS-Installation und automatischer Releasewechsel (Version 1.33) - -Auftrag vom 17. November 2026. Der Betreiber will einen Server mit WebUI und MCP und zwei eigenständige Plattformclients. Wartungsfunktionen wie Windows-Updates werden als versionierte Skripte hinterlegt. Die Clients melden auch im Leerlauf Inventar und Heartbeats, holen optional Arbeit ab und liefern Ergebnisse. Das neue Produktprofil verwendet den vorhandenen HTTPS-Abruf. SSH ist für schnelle Entwicklungsbereitstellungen ausdrücklich zulässig. - -Eine Einzelgenehmigung jedes `update_agent`-Versuchs aus 1.21 würde dem automatischen Versionswechsel widersprechen. Künftig autorisiert der berechtigte Herausgeber durch Veröffentlichung einen festen, signierten, plattformgebundenen Agent-Release. Der Client prüft und installiert diesen regelmäßig ohne Geräteeinzelklick. Skript- und OS-Wartungsjobs behalten ihre feste WebUI-Freigabe. Öffentliche HTTPS-Installer nehmen neue Geräte mit Einmalnachweis auf. Die frühere Linux-/Windows- oder S2-Reihenfolge ist durch die Nutzerabläufe des aktuellen Lieferplans ersetzt. [Normativer Umfang](../Rust_RMM_Implementierungsspezifikation.md) · [Abgleich und Plan](mvp-completion-plan.md) - -## Gelockertes Zeitfenster für Zeitbelege (Version 1.32) - -Userentscheidung 17. November 2026: „Du kannst das harte Zeitfenster -auflockern. Mir ist das nicht wichtig … nimm das harte Zeitfenster gerne -großzügiger an und dokumentiere diese Entscheidung.“ Signierte Zeitbelege -gelten jetzt bis fünf Minuten nach Empfang statt 100 ms; die untere -Intervallgrenze läuft mit, Driftzuschlag 0,1 %. Auffrischfehler verwerfen -gültige Belege nicht mehr. Auftragsfristen und alle Vertrauensprüfungen -bleiben unverändert. Details Spezifikation 0.3. - -## Menschlicher Abschluss von unknown-Jobs (Version 1.31) - -Userentscheidung 17. November 2026 („Ja, setze das so um“): Statt weiterer -Einzelausnahmen (221, 357) gibt es einen allgemeinen menschlichen -WebUI-Abschluss eines `unknown`-Jobs als Endzustand `closed_unknown`. Die -Wirkung bleibt unbekannt, kein Retry, keine neue Genehmigung; nur die -Gerätesperre wird aufgehoben. Nicht über MCP/KI/Automatik. Originale bleiben -erhalten. Erster Anwendungsfall ist Job `7d756c34…`. Details Spezifikation 0.2. - -**Technische S2-Korrektur, keine neue Userausnahme:** Der normale frische -Onlineabgleich kann eine genau bewiesene, bereits wirkungslos geschlossene -Windows-Teilkante fortsetzen. Die alten150/205/221-Verwaltungsfreigaben werden -nicht erweitert; keine alte Antwort wird nachträglich angewandt. Neue -Serverantwort, beide aktuellen Uhren und tatsächliches neues Helper-ACK bleiben -Pflicht. Ein typisierter Fehler vor dem ersten SQLite-BEGIN darf ausschließlich -innerhalb derselben ursprünglichen Applyanfrage begrenzt erneut geprüft werden. -Keine Zeitlockerung oder Ausführungswiederholung. [Vertrag und Nachweise](windows-closed-control-online-continuation.md). - -## Windows-Abgleich 205 ausdrücklich historienerhaltend wiederherstellen (Version 1.28) - -Der Betreiber hat den [konkreten Vorschlag](windows-sync-alignment-205-proposal.md) -am 16. November ausdrücklich mit „Ja, historienerhaltend wiederherstellen“ -freigegeben. Der enge Fall betrifft genau die erhaltenen Entscheidungen -1a4758ad/2af359c5, die abgeschlossene Echohistorie und einen abgelaufenen -allgemeinen Auftrag ohne Grant. Ein neuer administrativer WebUI-Beleg, -unabhängige Originalprüfung und dauerhafte Herkunfts-/Anwendungszeile sind -Pflicht. Keine Identitäts-/Journalrücksetzung, keine Ready-/Unlockwirkung, -keine Anwendung mit künstlicher historischer Uhr. Erst regulärer neuer -SignedSync beider Rollen und jeder feste neue WebUI-Plan erlauben neue Jobs. -Die Freigabe gilt nicht für beliebige andere Abweichungen oder Unknowns. - -## Technische Selbstupdatepräzisierung (Version 1.27) - -Innerhalb des beauftragten Windows-MVP erhält der stabile Updater eine eigene -signierte Zeitrolle mit eigener geschützter Qualifikation. Er verwendet keine -Helperzeit als Ersatz. Das separate Handoffschema2 normiert den endlichen -einmaligen Rückweg mit Originalowner, unverlängerten Fristen, erhaltenen -Dateiversionen und neuem signiertem Vorgänger-Healthbeleg. Unklare Wirkungen -bleiben Unknown. Private Recordrechte werden durch einen authentisierten -lesenden Full-Metadatenbeleg erhalten, statt sie für den Agenten aufzuweiten. -Dies ändert weder die WebUI-Genehmigung noch den Umfang zu einem freien -Installer oder Updater-Selbstupdate. Die technischen Grenzen stehen in -Spezifikation0.1; native Installation/Apply/Rückführung werden weiterhin -ausdrücklich erst nach tatsächlicher Prüfung ausgewiesen. - -## Windows-MVP vollständig fortsetzen (Version 1.26) - -Der Betreiber beauftragt die verbleibenden Windows-MVP-Arbeiten möglichst -parallel. Der vorhandene dev/test-Login und die ausdrücklich gekennzeichnete -simulierte WebUI-Bedienung reichen auch für die folgenden festen Abnahmepläne; -OIDC wird keine neue MVP-Voraussetzung. Die zusätzliche Einschränkung auf den -bereits erfolgreich ausgeführten Echoauftrag darf nur durch einen eigenen -interaktiven administrativen Abschluss mit unabhängig geprüften Originalen -und append-only Nachweisen historienerhaltend beendet werden. Keine direkte -API-/DB-Jobgenehmigung, keine Journal- oder Identitätsrücksetzung. Der Abschluss -verleiht weder Bereitschaft noch eine Jobgenehmigung. Regulärer unabhängiger -SignedSync beider Rollen und jeder feste WebUI-genehmigte Job bleiben nötig. - -Die parallelen Quellarbeiten und tatsächlichen nativen Abnahmen werden in -[windows-mvp-completion.md](windows-mvp-completion.md) getrennt protokolliert. -Ein Updater-OS-Port oder ein Build ist kein durchgeführtes Selbstupdate. - -## MVP-Verwaltung über SSH-Tunnel ohne OIDC (Version 1.25) - -Der Betreiber hat klargestellt, dass kein OIDC-Anbieter vorhanden ist. -WebUI und MCP sollen für den MVP nur an Loopback erreichbar sein. Die -Bedienung erfolgt durch einen SSH-Tunnel. Der vorhandene Entwicklungslogin -und die ausdrücklich erlaubte simulierte WebUI-Genehmigung werden für -den PowerShell-Test verwendet. Die zusätzliche OIDC-Abhängigkeit war eine -Implementierungsentscheidung der KI, keine ursprüngliche MVP-Anforderung. -Die tatsächlichen Dienst- und Abnahmenachweise bleiben erforderlich. - -## Historienerhaltende Windows-Recovery ausdrücklich beauftragt (Version 1.24) - -Der Betreiber hat die Wiederherstellung des dokumentierten wirkungslosen -Windows-Testfalls mit Erhalt von Identität und allen Journalen erlaubt. -Kapitel 0 bindet die beiden erhaltenen Originalentscheidungen 6755 und 6756. -Die bisherigen Regeln für ungesendete Requests behandeln diesen Fall nicht. -Der neue administrative Weg braucht einen überprüfbaren historischen -Abgleich, dauerhaftes Audit und anschließend einen normalen signierten Sync. -Die Ausführungsjobs erhalten jeweils ihren eigenen WebUI-genehmigten Plan. -Implementierung und tatsächliche Abnahmen bleiben getrennt nachzuweisen. - -## Aktives Windows-KVM-Zeitprofil ausdrücklich erlaubt (Version1.23) - -2026-11-15: „Ja, dieses begrenzte Zeitprofil umsetzen“. Der ausdrücklich -versionierte Opt-in-Modus `trusted_os_active_guest` vertraut den dokumentierten -Windows-/KVM-/Hardwarezeitgebern als nomineller OS-Intervalluhr. Eine zusätzliche -unabhängige physikalische Timerkalibrierung entfällt ausschließlich hier; keine -willkürliche Kalibrierungszahl oder gemessene SI-Genauigkeit behaupten. -Geschützte Rollen-/Image-/Plattform-/Belegbindung, eigene konservative -Softwarebrackets, signierter Serververgleich, kurze Fristen und WebUI bleiben. -Vor Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend müssen -Agent und Helper beendet und danach frisch gestartet werden. Laufende Prozesse -über solche Ereignisse sind nicht unterstützt; keine lückenlose Erkennung -ohne VMGenID behaupten. Kein automatischer Konfigurations-/Clockgatewechsel. -[Angenommener konkreter Vertrag](windows-kvm-clock-contract-proposal.md), -normativ SpezifikationKapitel0/1.23. Neue reale Nachweise weiter erforderlich. - -## Signierter Windows-Zeitvergleich ausdrücklich erlaubt (Version1.22) - -2026-11-14 hat der User den konkret beschriebenen alternativen Zeitvergleich -mit „Ja, signierten Zeitvergleich umsetzen“ angenommen. Die unabhängige -Agent-/SYSTEM-Prüfung und bestehende WebUI-/Zeitgrenzen bleiben verbindlich. -Kapitel0 der Spezifikation1.22 ersetzt den früheren Ausschluss eines -Serverzeitankers ausschließlich durch den gebundenen Onlinevergleich mit dem -festgelegten Server. Separater Ed25519-Pin, eigene Challenges/Timer je Verifier, -mTLS-Geräte-/Verbindungsbindung, vollständiger RTT im Unsicherheitsintervall, -kein Holdover und kein neuer Grant durch Belegrefresh. W32Time-Rohstatus bleibt -separat; keine Zeitstellung, kein manueller Resync hiermit genehmigt. - -[Vertrag und offene Nachweise](windows-clock-attestation-proposal.md). -Angenommene Produktentscheidung, noch keine qualifizierte Zeitquelle oder -Windowsjobfreigabe. Fehlende tatsächliche Server-/Timerqualität bleibt deny. - -## Präzisierung des engen Updatervertrags (Version1.21) - -Healthsignatur und vor Genehmigung gebundener lokaler öffentlicher Healthpin -verwenden einen separat provisionierten Schlüssel; kein Jobsignerfallback. -Auf Linux autorisiert und prüft Full den Updateowner. General bleibt während -des Inflightfalls geschlossen, ohne aus Nichtzuständigkeit Unknown zu erzeugen. -Keine Capabilitylockerung umgeht die tatsächliche Prozessimageprüfung. -Native Dateiteilintents und Stop-/Startbeobachtungen gehören append-only an den -Originalhandoff im selben Ledger. ReturnIntent und feste Startreservation -committen vor Lockabgabe; keine Zeile erlaubt späteren Workerresume. -Details und offene Runtimegrenzen stehen in Spezifikation0.1 und -[agent-updater-handoff.md](agent-updater-handoff.md). - -## Historischer manueller Updatejob (Version 1.21) - -Auf ausdrücklichen Userwunsch wird ausschließlich der signierte Agentupdater -parallel ausM7 vorgezogen. `update_agent` bleibt fester, tatsächlich WebUI- -genehmigter Job mit `updates:apply` plus Root-/SYSTEM-Recht für beide Akteure, -separatem immutable Releasekatalog und zwei gebundenen Rohbinaries. Altes -Paketlimit bleibt bestehen; Update-only-Streaming ist keine allgemeine -Installer-/Dateiupload-/Rootskriptfreigabe. Passive Beobachtung `agent.update` -alle60s ist von Baseinventar und täglichem Releasecheck getrennt; fehlende -Provisionierung/Qualifikation erzeugt `not_configured`, niemals Applybereitschaft. - -Der verbindliche Handoff-/Owner-/Inflight-/Healthvertrag steht in Kapitel0.1. -Atomarer Originalverbrauch+Start+Handoff+Delegation+Stopintent im erhaltenen -Helperledger, echter gemeinsamer Lock nur während Helperstop, Rückgabe vor -neuem Helperstart und exakter eigener Inflightabgleich bei Ready=false sind -Pflicht. Kein zusätzlicher ungebundener Server-Journalslot oder Unknown-Healing. -Die nur für diese Aktion signierte `agent_update_plan_id` erhält alte Grantbytes -bei allen anderen Aktionen. Fullpins werden eng aus konkreten geschützten -Rawbytes gerendert; zentrale Fullrechte werden nicht automatisch migriert. - -Erste Baseline und erlaubtes Rollback müssen bereits die neue Update-/Handoff- -Historie dekodieren können. Das aktuelle1.20-Codepaar ist daher kein späteres -Rollbackziel. Erhaltender kompatibler Bootstrap, separat release-signierter -InstalledRecord/Floor und tatsächliche Linux-first-Qualifikation sind vor dem -ersten Apply erforderlich. Keine Daten-/PKI-/Generation-/Journalrücksetzung. - -Quelle ist kein Applynachweis: isolierter Verifier/Handoffkernel und lokale -OS-/SQL-/UIteile sind getrennt dokumentiert. Unabhängige Reviews und tatsächliche -Messwerte stehen in den verlinkten Updaterberichten; Workerinstallation, -genehmigter realer Codewechsel und Windowsnachweis bleiben eigene Gates. - -## Skriptkonsole und vollständige Hostwartung (Version1.20) - -Der User stellt die Batch-Skriptkonsole vor weitere Paketfixture-Erweiterungen: -KI/MCP schreibt vollständige Shell-/PowerShell-Skripte und beantragt feste -Aufträge; der Mensch genehmigt exakt gespeicherte Bytes, Ziele, Interpreter, -Argumente, Rechte und Limits in der WebUI. Status und abschließende begrenzte -Rohbyteausgabe verwenden die bestehende Jobstrecke. Keine neue PTY-/ConPTY- -Sitzung und kein behauptetes laufendes Streaming. Regelmäßiges passives -Inventar/Heartbeat ist getrennt; Live-Erhebung per Skript bleibt Job. - -Das neue additive Feld `privileged_script_profile="full_maintenance_v1"` -bindet die ausdrücklich gewünschte Root-/SYSTEM-Hostwartung vor Genehmigung. -Fehlend bleibt es aus alten Bytes ausgelassen; null/unbekannt/agent_service mit -Profil verweigert. Bestehende Linux-Root-Skripte ohne Profil behalten ihre -bisherige begrenzte Runtime. Windows-SYSTEM-Skripte brauchen das neue Profil; -SCM-/MSI-Policies erben keine Skripterlaubnis. Die historische Aussage1.18 -„SYSTEM-Skripte außerhalb des engen SCM-Vertrags“ bleibt für dessen Profile -richtig; sie verbietet nicht den nun gesondert beauftragten Vollwartungspfad. - -Zentrale/lokale Policy erlauben Vollwartung nur ausdrücklich versioniert über -`allowed_script_profiles`: Linuxversion2, Windowsversion3; fehlend bedeutet deny, -vorhandene null/unbekannte Profile verweigern. `scripts:execute` plus jeweiliges -`root:execute`/`system:execute` gelten für Ersteller und Freigeber aktuell; -zusätzlich exakte Geräte-/Helperpins, qualifizierte Capability -`script.full_maintenance/1`, TrustedClock und unabhängiger signierter Sync. -Linux bekommt ein eigenes explizites Helperprofil; bisherige General-/APT- -Sandboxprofile bleiben erhalten. Windows verwendet SID18 und einen eigenständig -geprüften SYSTEM-Pfad. Volle Originalsignaturen, dauerhafter Einmalverbrauch, -Intent/Dispatch/RawMirror/Abandon und Journalidentitäten werden weiterverwendet. - -Vollwartung ist volle Hostautorität, einschließlich möglicher Agent-/PKI- -Änderungen und Neustarts. Keine Sandbox-/No-Reboot-/Rollbackzusage für beliebigen -Root-/SYSTEM-Code; nachgeladener Inhalt ist nicht automatisch gebunden. Jede -Wirkung braucht ihren festen WebUI-Plan. Kein ungeplanter destruktiver Test, -keine Rebootabnahme aus einem Skript. Timeout/Abbruch/unklare Wirkung bleiben -ehrlich `unknown`, kein automatischer Retry oder nachträgliches Heilen durch -Exit0. Eigene Prozesse werden kontrolliert beendet, fremde nicht übernommen. -Die konkreten Bounds und Kompatibilitätsregeln stehen in Spezifikation0.1. - -Dies ändert den Produktauftrag, behauptet keine Implementierung oder native -Abnahme. Linux-Cloud-VM zuerst; Windows-VM separat; Notebook nur Entwicklung. -Die zusätzliche tatsächliche Linux-Helperbinarybindung des Fullprofils ist -verpflichtend: geschützter Schema2-Pin, gehaltenes laufendes Rootimage, -authentisierte Probe und passende zusätzliche Binärcapability; keine -Agent-/proc-Lesebehauptung und keine Änderung der General-/APT-Legacybytes. -Lokale frühere Qualifikation und noch offener separater Korrekturdurchlauf: -[deploy/linux/full-maintenance-README.md](../deploy/linux/full-maintenance-README.md). -Agent-Selbstupdates sind ein getrennter signierter Updatepfad; APT/MSI- -Paketfixtures und Vollwartungsskripte sind keine fertigen Agent-Autoupdater. - -## Enger Windows-M4-MSI-Schnitt (Version1.19) - -Die beauftragte Windows-MVP-Fortsetzung erhält als nächsten getrennten Schnitt -zwei feste eigene MSI-Rezepte1.0 und1.0→1.1. Dies ist eine explizite technische -Präzisierung innerhalb des bereits beauftragten M4-Umfangs, keine neue pauschale -Userfreigabe für Paketwirkungen. Kapitel0 bindet vollständiges optionales -Windowsmanifest, unveränderlichen Tenantkatalog, exakte automatisch abgeleitete -Job-/Versuch-/Artefaktreferenz, neue getrennte SYSTEM-Paketerlaubnis und sichtbare -Planbytes. Alte SCM-only-Policies erteilen keine Paketrechte. Native -Installation/Upgrade/Noop bleiben jeweils eigene WebUI-genehmigte Jobs. - -APT-/Windowsmanifest schließen sich aus; alte Linuxbytes und freie Linux- -Artefaktpfade behalten ihre bisherigen Verträge. Kein freier Installer oder -Rezeptargumentvektor, kein Repair/Downgrade/Fresh1.1, keine EXE-/Skript-/Reboot- -Erlaubnis in diesem Schnitt. Cache-/Provider-/Installerwirkung bleibt bei -Abandon ausgeschlossen. Noop und tatsächliche Nachbedingungen müssen innerhalb -des ursprünglichen Budgets unter gültigem Clock-/Fence-/Abbruchkontext liegen. -Ein später belegter Zustand heilt keinen Timeout. Die ursprünglichen MSI- -Artefakt- und Nativeberichte bleiben unverändert. Quelle/Build/Unitnachweis -öffnet keine Capability und ist keine tatsächliche Paketabnahme. - -## Begrenzte Windowsfreigaben des Users (Version1.18) - -- `RemoteSigned` ist ausschließlich für den einzelnen zuvor WebUI-genehmigten - Windows-PowerShell5.1-Jobprozess erlaubt. Die feste Prozessoption muss vor - Genehmigung sichtbar im unveränderlichen Plan stehen und in den signierten - Originaljobbytes gebunden sein. Kein stilles Nachrüsten alter Pläne, kein - `Bypass`/`Unrestricted`, keine persistente CurrentUser-/Maschinen-/GPOänderung - durch den Executor. GPO-Vorgaben bleiben wirksam; Linux und andere Interpreter - erhalten keinen solchen Override. SYSTEM-Skripte bleiben außerhalb des engen - SYSTEM-SCM-Vertrags. [Entwurf und Nachweisgrenzen](windows-powershell-policy.md). -- Der bestehende `W32Time` darf gezielt gestartet werden. Startart, NTPserver/ - Peers und ACLs dürfen hierfür nicht verändert werden. Ein laufender Dienst - eröffnet keine TrustedClock-/Syncbereitschaft; diese braucht eigene tatsächliche - Status-/Unsicherheits-/Bootnachweise. -- Ein manueller Windows-VM-Konsolenneustart ist für später zugesagt, erst nach - ausdrücklicher Zeitabstimmung. Kein Remote-Reboot, kein RMM-Reboottest und kein - daraus erfundener Rebootjob-Erfolgsnachweis. Der Notebookhost bleibt reiner - Entwicklungsrechner. - -Diese Userfreigaben sind dokumentierte Entscheidungen, keine Ausführungs- oder -Implementierungsnachweise. Die RemoteSigned-Vertragserweiterung ist zunächst -ein Entwurf; laufende qualifizierte Quellbindungen werden dafür nicht verändert. -Clock-, Boot-, Genehmigungs- und native Capabilitygates bleiben geschlossen, -solange ihr jeweiliger tatsächlicher Nachweis fehlt. - -## Nachgewiesener Nichtstart vor SYSTEM-Delegation (Version1.17) - -Der Source-Review der vorbereiteten SCM-Runtime zeigte, dass vorzeitiger lokaler -Verbrauch ohne Helperzeile den strengen gemeinsamen Sync dauerhaft sperren würde. -Der Fix erhält sämtliche Missing-Row-Grenzen: dauerhafter Intent vor Socket, -atomarer Dispatchmarker, deny-only Abandon nur bei belegter Nichtübergabe und -vollständiger authentisierter Snapshotabgleich vor Network-Ledgerspiegelung. -Abandon erhält den Originalgrant und darf ausschließlich unter geprüfter -Signatur/Identität/Clock/Boot/Helper-Lineage einen Nichtstart-Tombstone anlegen; -nie bestehende Outcomes/Unknown überschreiben oder eine OS-Aktion ausführen. -Mehrdeutige Übergaben bleiben Unknown, kein Execute-Retry und keine neue -Genehmigung durch Policy oder Abandon. Historische Signaturprüfung ist keine -Live-Ausführungsberechtigung. Dies ist ein Implementierungsvertrag, noch keine -ausgeführte Abnahme; [Details](windows-system-abandon.md). - -## Getrennte Windows-SYSTEM-Identität (Version1.16) - -Technische Präzisierung der beauftragten Windows-Helpertrennung: -`execution_identity=system` benötigt eigenes `system:execute`; Linux-Rootrechte -enthalten dieses Recht nicht. Die erste enge Aktionsstrecke betrifft nur eigene -Fixturedienste und `running|stopped`. Zentrale konkrete Geräte-/Principal-/ -Helperhashpolicy und unabhängig prüfender lokaler SYSTEM-Helper begrenzen beide; -keine Policy genehmigt einen Job. Alle bisherigen Plan-/WebUI-/Signatur-/Clock-/ -Journal-/Einmalwirkungsgrenzen bleiben erhalten, einschließlich beider aktuellen -Akteursrechte bei Genehmigung/Zustellung/Start. Kein Start ohne tatsächlichen -Helperjournalbezug und bestätigten Sync. Standard ist deaktiviert; keine -Windowscapability aus Linux-Units, Crossbuild oder Bootstrap ableiten. -Dies ist keine ausgeführte Windowsaktion oder zusätzliche Scopeerteilung. -[Implementierung und tatsächliche Nachweise](windows-system-policy.md). - -## Rechtzeitiger Rebootkontakt und spätere frische Verifikation (Version1.14) - -Die feste180s-MVP-Frist wird nicht verändert. Ein rechtzeitig gespeicherter -Originalbeleg wird bei späterer Erstverifikation zusammen mit einem zweiten, -frischen Beleg derselben aktuellen Boot-ID und dem tatsächlichen aktuellen -authentisierten Gerätekontext geprüft. Signiertes Ergebnis bindet Original- -`inventory_message_id`/`inventory_received_at` und zusätzliche -`verification_inventory_message_id`/`verification_inventory_received_at`; -Audit bindet Job/Versuch/Grant/Boot/Generation und beide Datenbankbelege. -Verspäteter Originalkontakt, falscher Boot/Kunde/Agent/Generation oder fehlende -aktuelle Verifikation bleiben verweigert. Grundlage: tatsächlicher rechtzeitiger -Rebootkontakt bei zunächst clock-bedingt ausgefallenem Helper, keine neue -Rebootfreigabe oder erfundene rückwirkende Fristeinhaltung. Details: -[Rebootabnahme](reboot-acceptance.md). - -## Gebundene Paket- und Rebootnachbedingungen (Version1.13) - -`no_reboot` verbietet einen ungeplanten Neustart, kein wahrheitsgemäßes -`reboot_required=true` bei vollständig verifiziertem Paket. Die harmlosen -APT-Fixturen müssen das Hostflag vor/nach der Wirkung unverändert nachweisen; -Sandbox-/Hostbeobachtung sind getrennt. Alte fehlende Vorhermessungen bleiben -fehlend, keine rückwirkende erfolgreiche Acceptance oder Markerbereinigung. - -Die zentrale Rebootfrist beginnt konservativ an der dauerhaften -Startreservierung. Erfolg benötigt unabhängig empfangenes neues Bootinventar -innerhalb dieser Frist; Unknown bleibt bei fehlendem/verspätetem Nachweis. -Späterer signierter Sync verwendet ausschließlich den ursprünglichen -rechtzeitigen Erfolgsbeleg. Quelle: Spezifikation0 und -[Rebootvertrag samt tatsächlichen lokalen Prüfungen](reboot-acceptance.md). -Diese Präzisierung ist keine native Paket-/Rebootabnahme. - -## Einzelner signierter APT-Wiederaufnahmeversuch (2026-11-13) - -Die ausdrücklich beauftragte Fortsetzung des bekannten Pre-Hook-Fehlers erhält -keinen Markerreset. Ein neuer UI-genehmigter Plan bindet im Manifestschema 3 -ursprünglichen Grant/Versuch und Markerhash. Helper prüft die ursprüngliche -Signatur und eindeutigen Fehlschlag im gleichen Ledger, unveränderte Transaktion -und Baseline. Genau ein eigener dauerhafter Retrymarker; bei Unknown, Hook, -geändertem Zustand oder bestehendem Retry keine Wirkung. Schema 2 bleibt -bytekompatibel. Vertrag und reale Nachweise separat in Spezifikation 0.1 und -`implementation-status.md`; keine implizite Produktions-/MVP-Freigabe. - -## Windows parallel auf ausdrücklichen Userwunsch (2026-11-13) - -- Windows 11 darf jetzt parallel entwickelt/nativ getestet werden, obwohl die - Linux-MVP-Abnahme noch offen ist. Dies überstimmt ausschließlich die frühere - Wartepflicht; Linux-Abnahme bleibt eigenständig und wird nicht vorgetäuscht. -- Windows-Gast auf dem Notebook ist ein eigenes Testgerät. Notebook-Host bleibt - Entwicklungsrechner ohne RMM-Agenten. Endgültiger Server bleibt unverändert. -- User wünscht ein PowerShell-Bootstrap-Skript mit Reverse-Tunnel zum Cloudserver. - Eng begrenzter separater Tunnelzugang, nur Loopbacklistener, eigener temporärer - Schlüssel; keine Weitergabe des Notebook-Hauptschlüssels. SSH-Hostprüfung gilt - auch für den neuen Windows-Gast. Installation/Ausführung noch nicht nachgewiesen. -- RMM-Jobs auf Windows weiterhin nur nach festem WebUI-genehmigtem Plan. - -## Serverumzug auf ausdrücklichen Userwunsch (2026-11-13) - -- Dieses Notebook ausschließlich zur Entwicklung nutzen: weder RMM-Server noch - installierter/enrollter RMM-Client. Ausdrückliche Userkorrektur nach der - vorübergehenden Clientinstallation, die gestoppt/deinstalliert und widerrufen wurde. -- Aktueller Testaufbau: Cloud-Test-VM als Client, endgültiger Cloudserver - `discovery.ease-technologies.de` als Server. Backend, PostgreSQL und TLS dort; - Cloud-VM und später beauftragte weitere Geräte verbinden sich direkt ausgehend. -- Frühere lokale Docker-/Reverse-SSH-Topologie ist historisch überstimmt. - Dockerports bleiben Loopback; Datenbank nicht veröffentlichen. Separater - öffentlicher TLS-Ingress, keine öffentliche Dev-Anmeldung. Verwaltung zunächst - nur über SSH-Tunnel, bis Domain/öffentliche Anmeldung sicher eingerichtet sind. -- Root ausschließlich Bootstrap, unprivilegierter Anwendungsdienst. Keine - Ausnahme von TLS/mTLS, Mandantengrenzen oder WebUI-Jobgenehmigung. -- Der User hat die Neuerzeugung des nicht verfügbaren alten lokalen Serverstands - erlaubt. Neuer Testbestand ist keine Wiederherstellung alter Historie oder - Vertrauenskontinuität; vorhandene VM-Identitäten/Journale bleiben erhalten. -- Details, Konfigurationslücken und reale Nachweise: [server-deployment.md](server-deployment.md). - -## Produkt und Ausbaustufen - -- **Linux-first für ALLE Features:** Zuerst tatsächliche Ausführung und Nachweis auf der Linux-Test-VM, nicht nur PC-/Containerlauf, Simulator oder Cross-Build. -- **Erstes Phasenziel Linux-MVP (M0–M5):** Eigenständiger Linux-Agent x86-64, WebUI, MCP und autorisierte dauerhafte Jobs. Windows-x86-64-Implementierung und native Abnahmen folgen erst nach dokumentierter Linux-MVP-Abnahme. Physische Geräte und beliebige VMs sind gleichberechtigt; ein Gast mit unbekanntem Host/Hypervisor ist vollständig verwaltbar. Kein PVE-Agent, Proxmox-Host oder Hypervisorzugang erforderlich. -- **Noch später:** M6a: Monitoringausbau und ARM64 mit nativen Tests. M6b: Proxmox-Modul/-Client auf demselben Linux-Agenten, Cluster und Backupbeobachtung samt Abnahmen; PBS optional. Keine vorgezogene PVE-Implementierung/-Abnahme als Teil des Linux-MVP oder vor der Windows-Phase. -- **Weitere Betriebsreife (M7):** Terminal, signierte Agentupdates, Restoreverfahren, Lasttests und belastbarer Betrieb. M8 bewahrt optionale Geschäftsleistungen und zusätzliche Provider. -- Keine eigene grafische Fernsteuerung; RustDesk bleibt eine getrennte Anwendung mit eigener Infrastruktur. -- **Neuer Useroverride 2026-11-12:** „rustdesk musst du nicht machen ... das lasse aus“. RustDesk entfällt vollständig aus dieser Umsetzung: keine Installation, Profile/Provisionierung oder externe Desktopabnahme. M4 bleibt allgemeine Linux-Paketverwaltung; M5 prüft die drei übrigen Referenzabläufe ohne RustDesk. Bestehende RustDesk-Architekturtexte sind nur spätere optionale Integrationsverträge, keine MVP-Pflicht oder Abnahmeblocker. Keine eigene Desktop-Engine als Ersatz. - -## WebUI-Genehmigung für alle Jobs - -Die folgenden Produktregeln bleiben unverändert. Ausschließlich für diese Entwicklungsabnahme gilt die danach dokumentierte Bedienungsausnahme; kein Job darf die UI-Genehmigung überspringen. - -- Jeder zur Ausführung eingestellte Job aus Menschen/UI, MCP oder Automatik benötigt vorher explizite Genehmigung eines berechtigten Menschen in der WebUI. Das gilt bereits für Hello World und ebenso für Live-Diagnosen, Reboot-Folgejobs und Retry/neue Versuche. -- `operations.plan` speichert einen unveränderlichen Plan. `operations.submit` speichert ausschließlich einen dauerhaften Antrag `pending_approval` mit `operation_id`, noch keine ausführbaren Jobs oder Outbox. `jobs.get(operation_id)` zeigt diesen Antrag auch ohne Jobs. -- Die WebUI zeigt alle festen Einzeljobs/Versuche, Zielanzahl und Zielgeräte, Inhalte und Skript-/Paketbyteshash, Fristen und Auswirkungen. Explizite Sammelgenehmigung dieses festen Pakets ist möglich; Dauer-/Wildcardfreigaben nicht. Erst Genehmigung erzeugt atomar Nachweis, Ausführung, Jobs und Outbox. JobOffer und Startgrant sind vorher verboten. -- Policies dürfen nur begrenzen oder verweigern. MCP darf vorbereiten und beantragen, niemals genehmigen. MCP-/Automatisierungstokens sind selbst mit Approver-Rolle nicht freigabefähig; Freigabe verlangt authentisierten interaktiven WebUI-Kontext. -- Geänderte Ziele, Bytes, Parameter, Fristen oder neue Versuche erfordern einen neuen menschlich genehmigten Plan. Redelivery desselben Versuchs erfordert keine neue Genehmigung, erlaubt aber keine zweite Wirkung. Technischer Grant-Ersatz nur bei nachgewiesenem Nichtstart und gültiger ursprünglicher Genehmigung. -- Passive Standardtelemetrie/Heartbeat und Lesen bereits gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Neue Live-Erhebung darf nicht als passive Telemetrie umgangen werden. Gebundene Nachprüfungen gehören zum genehmigten Job. - -### Explizite Userentscheidung zur Entwicklungsabnahme (2026-11-12) - -Der User hat neu ausdrücklich angeordnet: „Setz Linux MVP vollständig um und simuliere die menschlichen Aktionen. Du kannst Server auch neustarten“. - -- Ausschließlich im **expliziten dev/test-Profil** darf Browserautomatisierung tatsächliche WebUI-Interaktionen einschließlich Genehmigung des angezeigten unveränderlichen Plans durchführen. Der Testprincipal muss deutlich sichtbar als **simulierter Testprincipal** gekennzeichnet sein; keine tatsächliche menschliche Identität vortäuschen. -- Dies ist die einzige erlaubte simulierte Freigabe/Testausnahme, keine Dev-Autofreigabe, Testpolicy oder Code-Abkürzung. Jeder Job bleibt bis zur interaktiven UI-Genehmigung `pending_approval`; vorher keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Planbindung, Rechte-, Tenant- und Policyprüfungen bleiben erhalten. -- Audit muss `approval_origin` als browsergesteuerte dev/test-Simulation und `testsimulation` als wahr kennzeichnen und Testprincipal, Profil, Zeitpunkt und Planbezug nachvollziehbar zuordnen. Das sind Umsetzungsanforderungen, keine Behauptung bereits vorhandener Auditfelder oder bestandener Tests. Simulation und tatsächliche menschliche Genehmigung getrennt nachweisen; **kein Produktions-Freigabenachweis**. -- KI/MCP dürfen weiterhin **keine direkten API-/DB-Freigaben** vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Normale, über die WebUI ausgelöste Browserrequests bleiben an deren interaktiven Kontext gebunden. Produktionsverhalten und tatsächliche menschliche WebUI-Genehmigung in Produktion bleiben unverändert; die Simulation darf dort nicht verfügbar sein. -- Lokale Serverneustarts sind ausdrücklich erlaubt. Keine impliziten VM-Reboots, Updates oder destruktiven Zieltests; Zieltestumfang weiterhin gesondert ausdrücklich abstimmen. RMM-Jobs behalten ihren festen WebUI-genehmigten Plan. - -Die frühere absolute Aussage „keine simulierte Freigabe und keine Testausnahme“ wird ausschließlich für diese browsergesteuerte dev/test-Bedienung präzisiert. Spezifikation 1.5 Kapitel 0.1 ordnet diese Ausnahme den fortbestehenden Produktregeln zu. Linux-first, reale VM-Nachweise, TLS und Credentialregeln bleiben unverändert. Dokumentierte Erlaubnis ist keine ausgeführte Simulation oder Linux-MVP-Abnahme. - -## Verständliche Startdefaults - -| Bereich | Startwert / Bedeutung | -| --- | --- | -| Architektur | Modularer Rust-Monolith, getrennt startbare API/Gateway/Worker; React/TypeScript-WebUI, PostgreSQL, kein obligatorischer Broker | -| Verbindung | Nur vom Agenten ausgehend: WSS über TLS 443, HTTPS Long Polling als Alternative; mTLS nach Enrollment | -| Kontakt | Heartbeat alle 30 s mit Jitter; nach 90 s `stale`, nach 180 s `unreachable` – kein Beweis, dass das Gerät ausgeschaltet ist | -| Daten | Systemmetriken alle 60 s; Vollinventar bei Start und täglich; Quelle und Datenalter immer sichtbar | -| Genehmigung | Immer erforderlich für Ausführungsjobs, nicht abschaltbar; keine erlaubende Defaultpolicy | -| Fristen | Planfrist ausdrücklich je Plan, UI-Vorschlag 24 h; Startgrant 60 s, nur für festen Versuch, kein neuer Offline-Start | -| Enrollment | Nachweis einmalig, 15 min; Gerätezertifikat 30 Tage, Rotation spätestens nach 20 Tagen beginnen | -| Rollout | Ein Rebootziel gleichzeitig je Abhängigkeitsgruppe; mehr Parallelität nur im menschlich genehmigten Plan innerhalb begrenzender Policies | -| Fehlende Konfiguration | `not_configured`; nur betroffene Integration sperren, keine Werte oder Erfolge erfinden | - -Die vollständigen Limits und Plattformabnahmen stehen in der Spezifikation. ARM64 ist bis zur nativen Abnahme geplant, kein MVP-Supportversprechen. Lokale Testidentitäten sind ausschließlich im expliziten Entwicklungsprofil erlaubt, niemals im Produktionsprofil. - -## Repository, Infrastruktur und Zugänge - -- Repository: -- SSH: `ssh://git@gitea.incoso.eu:2222/kevin_janssen/rust-discovery.git` -- Bekannte RustDesk-Serveradresse: `rust.ease-technologies.de`. **Edition, Ports, öffentlicher Serverschlüssel und Version sind noch unbekannt.** Kein angenommenes Standardport-/443-/WSS-Profil und keine erfundene Version; vor Bereitstellung konkrete Konfiguration prüfen. -- Lokaler Zugangspfad: `credentials/` im Projekt, durch `.gitignore` ausgeschlossen und niemals committen. Hier wird nur der Pfad dokumentiert; Secrets werden dafür nicht gelesen. Dateien nur als Daten behandeln, niemals mit `source` oder `eval` ausführen. Keine Secrets in normalen Logs, Jobausgaben oder MCP-/LLM-Kontexte übernehmen. -- Benötigte Entwicklungs-/Testtools dürfen ausdrücklich installiert werden. Daraus folgt keine Genehmigung von Änderungen oder Neustarts auf Kundensystemen. Plattformjobs in Entwicklungsumgebungen behalten die WebUI-Genehmigungspflicht; nur die oben dokumentierte dev/test-Browsersimulation darf die tatsächliche menschliche Bedienung ersetzen. Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt. - -## Verbindlicher lokaler Entwicklungsweg - -**Historisch seit 2026-11-13:** Die folgende PC-Servertopologie wurde durch den -oben dokumentierten ausdrücklichen Serverumzug ersetzt. Credential-, TLS- und -Genehmigungsregeln gelten weiterhin. - -- Regeln für alle AIs: `AGENTS.md`; geplanter, nicht getesteter Ablauf und Nachweisgates: `docs/development.md`. -- Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Ports ausschließlich Loopback, insbesondere `127.0.0.1:18443`. PC initiiert SSH zur VM mit `-N -T -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -R 127.0.0.1:18443:127.0.0.1:18443`. SSH-Hostschlüssel vorher verifizieren, keine öffentliche Forward-Bindung. -- VM-Agent verbindet sich ausgehend über VM-Loopback. TLS bleibt Ende-zu-Ende mit DNS SAN `rmm-dev.internal`; auf der VM `/etc/hosts`: `127.0.0.1 rmm-dev.internal`, alternativ getesteter Connect-Override unter Erhalt von SNI/Namensprüfung. Dev-CA vertrauen, niemals ungültige Zertifikate akzeptieren. SSH nur Dev/bootstrap, kein Ersatz für Enrollment/mTLS, RMM-Autorisierung oder Genehmigung. -- VM-Daten: `credentials/linux-vm.conf`, Verzeichnis durch `.gitignore` ausgeschlossen, Modus 700 für `credentials/`, 600 für die Datei. Strikt als Daten parsen, kein `source`/`eval`; keine Secrets lesen/loggen/committen oder in LLM-Kontexte übernehmen. -- Auch Linux-Dev hat keine Jobfreigabeabkürzung: erst `pending_approval`, dann WebUI-Genehmigung durch einen berechtigten Menschen oder ausschließlich die oben dokumentierte dev/test-Browsersimulation. Passives Standardinventar ist kein Job. Keine impliziten Reboots, Updates oder destruktiven Tests auf dem Ziel; ausdrücklich gesondert abstimmen, RMM-Jobs zusätzlich über ihren festen Plan in der WebUI genehmigen. -- Kein Erfolg ohne realen Nachweis. Geplante Befehle und nicht ausgeführte Tests ausdrücklich so kennzeichnen; fehlende VM-Abnahme bleibt offen. - -## Eng begrenzte Reparatur eines ungesendeten Kontrollrequests - -Spezifikation 1.10 konkretisiert den existierenden Unknown-/Sync-Abgleich: -Root-Bootstrap ausschließlich im Entwicklungsprofil, vollständige originale -Zeugen, unabhängige lokale Signatur-/Inventarprüfung und separate kurzlebige -Kontrollquittung. Nur vorhandene wirkungslose signierte Ablehnung als gemeinsamer -monotoner Head; Faults und Quittung append-only archivieren. Keine Jobfreigabe, -Bereit-Lease, Änderung von Outcome oder Verbrauch, keine Journalrücksetzung. -Native Prüfung und Grenzen: `implementation-status.md`. Direkte API-/DB- -Jobfreigaben bleiben verboten; anschließende Paketwirkung benötigt neuen festen -WebUI-genehmigten Plan. - -## Gebundene Configure-only-Wiederherstellung - -Spezifikation1.11 präzisiert einen notwendigen neuen Ausführungsplan nach dem -abgeschlossenen APT-Teilwirkungsnachweis: Manifestschema4/native_recovery mit -Originalgrant/-versuch/Partial-Proof, Transaktionsschema2 ausschließlich -configure_only/Fixture1.0. Separate authentisierte Teilzustandsplanung; -normale Baselines bleiben strikt. Eigene Recoverymarker, kein Überschreiben -früherer Testmarker oder falsche Freshinstall-Acceptance. Jede Paketwirkung, -anschließendes Upgrade und beide Noops erhalten eigene tatsächliche WebUI- -Plangenehmigungen. Runtimeprobe allein ist kein Ausführungsnachweis. - -## Endliches Journalbudget nach tatsächlichem Kapazitätsbefund - -Spezifikation1.15 erhöht das weiterhin feste Budget pro Agentjournal/Agent- -oder Helperledger auf1GiB bei validierter4KiB-Seitengröße (262144Seiten). -Nach der früheren64→256MiB-Korrektur erreichte die vollständig erhaltene -Cloud-Sync-Historie auch256MiB während des Original-Rebootabschlusses. -Agenttransport wurde vor weiteren Diagnosezyklen angehalten. Qualifikation -verlangt Kopiereproduktion des alten Limits und versionierte Installation -mit erhaltenen DBinodes, sämtlichen alten Verbrauchs-/Signatur-/Historydaten -und genau demselben offenen Rebootversuch. Keine neue Wirkung/kein neuer Grant, -keine History-/Marker-Löschung und keine Fail-closed-Ausnahme. Native Prüfstände -stehen getrennt im [Journalbericht](journal-capacity.md); die Entscheidung -selbst behauptet keine bereits ausgeführte Installation. Kompaktierung bleibt -nach dem MVP. - - -## Dauerhafter Entwicklungszugang zur Windows-Test-VM - -Der Betreiber verlangt ausdrücklich, den vorhandenen SSH-Rückkanal dieser -reinen Entwicklungstestmaschine dauerhaft zu betreiben. Die frühere Befristung -des Wartungstransports gilt dafür nicht mehr. Gleiche Schlüssel, bestätigte -Hostpins und ausschließlich Loopback gebundene Weiterleitung bleiben Pflicht. -Dies ist keine Job-, Root-/SYSTEM- oder dauerhafte WebUI-Planfreigabe. Der -MVP-Produktvertrag und die Historie der RMM-Agenten bleiben unverändert. -[Einrichtung, Nachweise und aktueller Übergabestatus](windows-development-access.md). - - -## Zwei ausdrückliche Windows-Testneustarts in der laufenden MVP-Wartung - -Der Betreiber hat den [konkreten Zweineustartplan](windows-msvc-reboot-maintenance-plan.md) -ausdrücklich freigegeben: einmal nach bestandener SYSTEM-Skriptabnahme vor der -wegen CBS/WU blockierten echten MSVC-Installation, später einmal als eigenen -MCP-/WebUI-genehmigten RMM-Reboottest. Nur Windowsgast, je null offene -Jobs/Installer, keine Force-Option und vorherige Ankündigung. Kein weiterer -Windows-Updatelauf, kein Host-/Server-/Linuxneustart und keine weiteren -Neustarts sind daraus abzuleiten. Bislang ist keiner davon ausgeführt. - - -## Freigegebener Abschluss des ersten SYSTEM-Testfalls221 (Spezifikation1.29) - -Der Betreiber hat den [konkreten Vorschlag](windows-system-script-nonstart-221-proposal.md) -ausdrücklich freigegeben: Originaljob94047873…/Grant97e705b8… historienerhaltend -abschließen und danach ausschließlich die SYSTEM-PowerShell-Abnahme mit einem -neuen WebUI-genehmigten MCP-Auftrag durchführen. Die originale Unknownhistorie -bleibt erhalten; ein separater geprüfter Nichtstartabschluss und der konkrete -Kontrollspalt221 benötigen einen eigenen administrativen Beleg mit tatsächlicher -sichtbar simulierter WebUI-Bestätigung. Keine neue Ausführung durch diesen Beleg, -keine alte Lease, kein Erfolg aus dem Fehlversuch und kein Grantretry. -Der einzeilige Sharingfix, unabhängige normale Zeit-/Syncbereitschaft beider -Rollen und ein eigener neuer Jobplan bleiben Voraussetzung der neuen Abnahme. -Die damalige Arbeitspause endete mit der neuen Priorisierung in Version 1.33. Die frühere205-Ausnahme wird nicht -zu einem allgemeinen Reparatur- oder Unknown-Resetmodus erweitert. diff --git a/docs/public-access.md b/docs/public-access.md index 3a9a13b..6f3f9d9 100644 --- a/docs/public-access.md +++ b/docs/public-access.md @@ -1,90 +1,63 @@ -# Öffentlicher Zugang ohne OAuth +# WebUI und MCP bedienen -Die WebUI ist unter https://discovery.ease-technologies.de:8443/ erreichbar. Der MCP-Endpunkt lautet https://discovery.ease-technologies.de:8443/mcp. Beide verwenden die öffentliche TLS-Zertifikatskette des bestehenden HTTPS-Ingresses. Der Gerätekanal auf Port 443 verwendet weiterhin seine eigene Geräte-PKI. +Die öffentliche WebUI verwendet ein lokales Benutzerkonto mit Passwort und einem sechsstelligen TOTP-Code. Ein MCP-Client verbindet sich per HTTPS mit seinem eigenen Bearer-Token. Die Anmeldung und die Genehmigung eines konkreten Auftrags sind getrennte Schritte. [WebUI](https://discovery.ease-technologies.de:8443/) · [MCP-Endpunkt](https://discovery.ease-technologies.de:8443/mcp) -## Neustart und Administratorausführung +## Geräte und Kunden -Unter **Aufträge → Neuer Auftrag** das Gerät wählen und **Neustartskript auswählen** verwenden. Bei gemischten Plattformen pro Betriebssystem einen Auftrag anlegen. Die Vorschau zeigt den vollständigen Inhalt und den Ausführungskontext. Nach der Entscheidung unter **Genehmigungen** steht die Ausgabe im Auftrag. „Neustart in einer Minute eingeplant“ bestätigt die Annahme durch das Betriebssystem. Der Wiederanlauf ist nach einem neuen Bootbezug, frischem Agentkontakt und erfolgreichem Folgeauftrag belegt. +**Geräte** zeigt bestätigte Online- und Offline-Geräte der berechtigten Kunden mit Hostname, Betriebssystem, Status, freiem und gesamtem Speicherplatz, RAM, CPU und Kunde. Die Historie enthält unter anderem archivierte und widerrufene Installationen. Ein Klick auf den Hostnamen öffnet das Inventar und die letzten Aufträge. Der Kundenname in der Kopfzeile zeigt, in welchem Kunden die nächste Änderung erfolgt. -Die letzte Meldung im Gerätedetail zeigt, ob der Client Skripte mit dem Dienstkonto und mit Administratorrechten unterstützt. Die tatsächliche Freigabe für einen Nutzer hängt zusätzlich von Kunde, Gerät und den zentralen Ausführungsrechten ab. +Berechtigte Benutzer können Kunden anlegen und umbenennen. Zur Aufnahme den Zielkunden wählen und unter **Verwaltung → Geräteaufnahme** einen Einmalcode erzeugen. Der Code gilt für diesen Kunden und verfällt bei erfolgreicher Aufnahme oder nach 15 Minuten. Die WebUI zeigt für die veröffentlichten Plattformen Download und Installationsbefehl. Auf dem neuen Gerät das HTTPS-Skript mit Administratorrechten aufrufen und den Code am Prompt eingeben. Für lokale Administrator-Skripte die dafür angebotene Installationsoption wählen. Der Windows-Kanal ist `x86_64-pc-windows-gnu`. [Linux-Installer](https://discovery.ease-technologies.de:8443/install/linux.sh) · [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) -## WebUI +### Alte Gerätekopplung endgültig löschen -Die Anmeldung benötigt den lokalen Benutzernamen, das Passwort und einen sechsstelligen TOTP-Code aus einer Authenticator-App. TOTP verwendet SHA-1, 30 Sekunden und sechs Stellen. Für die Ersteinrichtung liegt auf dem Entwicklungs-PC die private Datei `credentials/public-webui-login.json` mit Benutzername, Passwort, Base32-Schlüssel und `otpauth_uri`. Die Datei hat Modus 0600 und ist gitignoriert. Sie dient der Übernahme des Passworts in den Passwortmanager und der Einrichtung der Authenticator-App. +Archivieren und Zurückholen steuern die Sichtbarkeit. Ein Widerruf sperrt die registrierte Identität. Für einen Kundenwechsel das Gerät im Zielkunden neu aufnehmen. Die bisherige Historie gehört zur Installation im ursprünglichen Kunden. -Der Server speichert den Passwortprüfwert als Scrypt mit zufälligem Salt und 128 MiB Arbeitsspeicher. Bereits benutzte TOTP-Zeitschritte werden atomar in PostgreSQL gesperrt. Passwortprüfungen sind parallel begrenzt. Anmeldung und Sitzung nutzen HTTPS, Loginbegrenzung, `Secure`-/`HttpOnly`-/`SameSite=Strict`-Cookies sowie Origin- und CSRF-Prüfungen für Änderungen. Eine Sitzung gilt eine Stunde. Das öffentliche Produktionsprofil bietet den lokalen Login. Die simulierte Entwicklungsanmeldung ist nur am internen API-Dienst verfügbar. +Das Verwalten und Löschen einer Kopplung erfordert `devices:revoke` im betreffenden Kunden. Das Gerät öffnen und unter **Gerät verwalten** widerrufen. Die widerrufene Installation steht unter **Geräte → Historie**. Dort **Kopplung löschen** wählen, Hostname, Kunde und Kopplungs-ID vergleichen und **Endgültig löschen** bestätigen. Noch gültige offene Genehmigungsanträge und nicht abgeschlossene Jobs dieser Installation sperren das Löschen. Das gilt auch für Jobs mit ungeklärter Wirkung (`unknown`). Gelöscht werden diese Installation, ihr Inventar und ihre eigenen Auftragsergebnisse. Gemeinsame signierte Mehrgerätepläne und Auditdaten bleiben nachvollziehbar. -Die Kontokonfiguration liegt auf dem Server unter `/opt/rust-discovery/devstate/public-auth/users.json`, Besitzer 10001, Modus 0600, im Container schreibgeschützt. Änderung von Passwort, TOTP oder `disabled` erfordert den Neustart von öffentlicher API und Gateway. Ein Membership-Widerruf wirkt auch auf bestehende Sitzungen beim nächsten Zugriff. Der vorhandene SSH-Zugang ermöglicht die administrative Wiederherstellung eines verlorenen Authenticator-Zugangs. +## Skript bis zum Ergebnis + +1. Unter **Skripte** Shell- oder PowerShell-Code mit einem Namen veröffentlichen. Eine Änderung ergibt eine neue Version. Name und Plattform lassen sich filtern. +2. Unter **Aufträge → Neuer Auftrag** Geräte eines Kunden auswählen. Die Geräteauswahl lässt sich auch aus dem Bestand übernehmen. Eine feste Bibliotheksversion oder **Einmaliges Skript** wählen. Ausführungskonto, Startfrist, Laufzeit und Ausgabelimit prüfen. +3. In der Zusammenfassung **Zur Genehmigung einreichen** wählen. Unter **Genehmigungen** prüft eine berechtigte Person die gebundenen Geräte, Skriptbytes, Rechte und Fristen und entscheidet ausdrücklich. Die Ansicht zeigt offene Anträge und frühere Entscheidungen samt Person und Zeitpunkt. +4. Unter **Aufträge** nach Anlass, Gerät, Status oder Datum filtern. Im Auftrag stehen der gebundene **Skriptinhalt** und je Ausführung Status, Exitcode und Ausgabe. Bei mehreren Geräten führt **Ergebnis anzeigen** zur betreffenden Ausführung. Vom Gerätedetail führt **Ergebnis öffnen** zum selben Job. + +Ein Neustart verwendet die passende Bibliotheksversion mit Administratorrechten. Der Exitcode des Skripts belegt die Annahme des Neustartbefehls durch das Betriebssystem. Einen tatsächlich erfolgten Neustart anhand des geänderten Bootbezugs, eines frischen authentisierten Kontakts derselben Installation und eines erfolgreichen Folgeauftrags prüfen. + +Unter **Verwaltung → Erweitert** können Berechtigte Paketrezepte, Windows-MSI-Rezepte und öffentliche Artefakte für den gewählten Kunden pflegen. Ein Import mit `catalog:write` hinterlegt die Katalogdaten. Neue Geräteaufträge werden unter **Aufträge** als Skript eingereicht. ## MCP-Tokens +Unter **Verwaltung → MCP-Tokens** Namen, Kundenkreis, Rechte und Ablaufdatum festlegen. Ein Token kann auf ausgewählte Kunden oder ausdrücklich auf alle aktuellen und künftigen Kunden berechtigt werden. Den einmal angezeigten Tokenwert im privaten Zugangsspeicher des MCP-Clients als HTTP-Header hinterlegen. + +```http +Authorization: Bearer +``` + +Wirksam sind die erteilten Scopes innerhalb der aktuellen Kundenrechte. Der Widerruf greift bei der nächsten Prüfung auch in einer bestehenden MCP-Sitzung. Die Tokenverwaltung erfordert eine persönliche WebUI-Sitzung mit `tokens:manage`. Folgende Werkzeuge veröffentlicht der Server. [Werkzeugdefinitionen](../crates/server/src/mcp.rs) + +| Werkzeug | Funktion und Rechte im Zielkunden | +| --- | --- | +| `tenants.list` | Kunden auflisten, in denen der Token wirksames `inventory:read` besitzt. | +| `inventory.list_devices`, `inventory.get_device`, `monitoring.get_health` | Bestand, Gerätedetail und gespeicherte Statusmeldungen mit `inventory:read`. Die Bestandsliste unterstützt `view=history`. | +| `scripts.list`, `updates.list_releases` | Skriptversionen samt Inhalt bzw. veröffentlichte Agent-Releases mit `operations:read` lesen. | +| `scripts.publish` | Mit `operations:plan` und `scripts:execute` eine unveränderliche Version veröffentlichen. Für einen neuen Namen `expected_version` auf `0` setzen, für eine weitere Version die bisherige Versionsnummer übergeben. | +| `scripts.plan`, `operations.plan` | Eine Bibliotheksrevision bzw. ein einmaliges Skript mit `operations:plan` und `scripts:execute` an konkrete Geräte binden. Für Administratoren gilt zusätzlich das Plattformrecht. | +| `operations.submit` | Den Plan über `plan_id` und einen stabilen `idempotency_key` einreichen. Erfordert `operations:submit`, `operations:read` und die Ausführungsrechte. Der Zustand lautet zunächst `pending_approval`. | +| `jobs.get` | Mit `operations:read` über `operation_id` den Antrag und seine Jobs abfragen. Eine anschließende Abfrage mit genau einer `job_id` liefert das einzelne Ergebnis. | +| `jobs.cancel` | Mit `jobs:cancel` und Begründung einen Abbruch anfordern. Mit `operations:read` die Antwort und den tatsächlichen Endzustand lesen. | +| `logs.query` | Bereits gespeicherte Protokolle mit `logs:read` abfragen. Sensible Protokolle benötigen zusätzlich `logs:read_sensitive`. | + ### Administrator-Skripte anfordern -Für einen vollständigen Skriptauftrag braucht ein Token im Zielkunden `operations:plan`, `operations:submit`, `operations:read` und `scripts:execute`. Hinzu kommt für Administratoraufträge je Plattform `root:execute` oder `system:execute`. Zum Veröffentlichen einer Skriptversion benötigt das Token `operations:plan` und `scripts:execute`. +Ein Administratorauftrag braucht auf Linux `root:execute`, auf Windows `system:execute`, zusätzlich zu den Skript- und Auftragsrechten. Für ein einmaliges Administrator-Skript das Profil `full_maintenance_v1` angeben. Bei Auswahl aus der Bibliothek setzt der Server das Profil passend zur gewählten Identität. Für Windows kann die PowerShell-Variante `powershell_51_remote_signed` an den Prozess binden. Die vollständigen MCP-Eingaben liefert `tools/list`. -Auf einem Gerät mit installiertem, signiertem Administrator-Helper kann der Betreiber die vorhandene Geräteregel einmal für diese Tokenrechte öffnen. Der folgende Befehl zeigt den Zustand für genau die gewählte Regel. Die Werte in Großbuchstaben sind durch die Kennungen der Installation und der bestehenden Regel zu ersetzen. +Der installierte signierte Helper muss auf die Geräteidentität gebunden sein. Die zentrale Richtlinie liegt auf dem Server in `/opt/rust-discovery/devstate/managed-scripts/policy.json`. API und Gateway lesen sie über `RMM_MANAGED_SCRIPT_POLICY_FILE`. Für verifizierte Agent-/Helper-Paarwechsel kann `release_anchors` die ursprüngliche Release-ID, Geräteinstallation, Binärhashes und die kanonischen lokalen Richtlinienbytes binden. Der Server vergleicht die daraus für das signierte Folgepaket berechneten Prüfdaten mit den Geräteangaben. [Mounts](../deploy/server.managed-scripts.compose.yaml) · [Serverprüfung](../crates/server/src/managed_scripts.rs) + +Der folgende Operator prüft eine vorhandene Geräteregel. Platzhalter durch die tatsächlichen Kennungen der Installation und ihrer bestehenden Regel ersetzen. ```sh python3 tools/dev_mcp_script_scope.py check --platform linux \ --tenant TENANT_ID --asset ASSET_ID --agent AGENT_ID --evidence ACCEPTANCE_EVIDENCE_ID ``` -Mit `enable` wird der Eintrag `mcp:scoped` dieser Regel hinzugefügt, mit `disable` wieder entfernt. Für Windows lautet die Plattform `windows`. Der Server wertet die Regel bei der nächsten Rechteprüfung aus. Bereits separat an einzelne Tokens vergebene Rechte lassen sich durch Widerruf des Tokens entziehen. Ein freies Skript über `operations.plan` oder eine Bibliotheksversion über `scripts.plan` planen und über `operations.submit` einreichen. Die persönliche Entscheidung erfolgt in der WebUI. `jobs.get` liefert über die Auftragskennung den Stand und über die Jobkennung das Ausführungsergebnis. - -### Token ausstellen - -Nach der WebUI-Anmeldung unter **Verwaltung → MCP-Tokens** einen Namen, den Kundenkreis, die benötigten Rechte und ein Ablaufdatum wählen. Ein einzelner Kunde ist vorausgewählt. Weitere Kunden lassen sich einzeln ergänzen. „Alle aktuellen und zukünftigen Kunden“ ist eine eigene Option für Kundenadministratoren. Standard sind gespeichertes Inventar, Protokolle und Aufträge/Ergebnisse lesen. Der Tokenwert wird einmal angezeigt. Er kann anschließend im MCP-Client als HTTP-Header hinterlegt werden. - -```http -Authorization: Bearer -``` - -Ein Token besteht aus einem Präfix und 32 zufälligen Bytes. Der Server speichert ausschließlich dessen SHA-256-Prüfwert. Jedes Token besitzt einen eigenen Principal, einen Ausgabekunden, einen Kundenkreis, feste Scopes, Ablauf und Widerruf. Jede Anfrage wird erneut geprüft. Die wirksamen Rechte sind die Schnittmenge aus Scopes und aktiver Membership. Der Widerruf greift auch bei einer bereits geöffneten MCP-Sitzung. Tokens können mit entsprechenden Rechten Anträge planen und einreichen. Die Jobgenehmigung erfolgt durch die Person in der WebUI. Tokenverwaltung verlangt eine echte interaktive Sitzung mit `tokens:manage` und CSRF-Schutz. - -Der verwendete MCP-Client muss einen manuell konfigurierbaren Bearer-Header unterstützen. Die standardisierte automatische MCP-HTTP-Autorisierung beschreibt einen OAuth-Ablauf. Die hier eingerichtete statische Tokenanmeldung verwendet den vorhandenen HTTP-Transport mit selbst verwalteten Zugangsdaten. [MCP-Autorisierung](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization) - -## Geräte und Kunden bedienen - -**Geräte → Bestand** zeigt die bestätigten Online- und Offline-Geräte. Über **Historie** sind frühere Installationen erreichbar. Der Hostname öffnet das Inventar mit Laufwerken, Erhebungszeit und den letzten Aufträgen. In der Detailansicht erlaubt **Gerät verwalten** das Archivieren und Zurückholen. Archivieren steuert die Sichtbarkeit, ein Widerruf sperrt die Identität. - -**Kunden** erlaubt berechtigten Personen das Anlegen und Umbenennen. Bei **Gerät aufnehmen** zuerst den Kunden im Kopfbereich wählen und anschließend den Einmalcode ausstellen. Für einen Kundenwechsel die bisherige Identität widerrufen und das Gerät beim Zielkunden neu aufnehmen. Frühere Ergebnisse bleiben beim ursprünglichen Kunden. - -Der Entwicklungsoperator kann dem bereits eingerichteten lokalen Betreiberkonto über `python3 tools/dev_public_access.py grant-customer-admin` die Kundenadministration zuweisen. Ein signierter Release lässt sich mit `python3 tools/dev_customer_starters.py --tenant UUID --platform PLATTFORM --release RELEASE_UUID` als Installationspaket für leere Kundenkataloge bereitstellen. Das Werkzeug prüft die Objektprüfsummen. Bei der ersten Codeausgabe übernimmt der Server das Paket in den Katalog des Zielkunden. Bereits befüllte Kataloge pflegt der Betreiber je Kunde über den regulären Releaseweg. - -## Skriptauftrag bearbeiten - -1. Unter **Skripte → Neues Skript** ein Skript veröffentlichen. Spätere Änderungen als neue Version speichern. -2. Unter **Aufträge → Neuer Auftrag** die Geräte eines Kunden wählen. Eine Auswahl aus dem Gerätebestand lässt sich mit **Auftrag erstellen** übernehmen. Bibliotheksskript samt Version auswählen oder **Einmaliges Skript** eingeben. -3. Die Zusammenfassung prüfen und **Zur Genehmigung einreichen** wählen. Nach einer unterbrochenen Einreichung im selben Browsertab den Auftragsdialog erneut öffnen. Er liest den gespeicherten Plan und, falls bereits vorhanden, den zugehörigen Antrag. -4. Unter **Genehmigungen → Offen** den Antrag öffnen, Skript, Zielgeräte, Rechte und Zeitfenster prüfen und genehmigen oder ablehnen. Der Verlauf zeigt die entschiedenen und abgelaufenen Anträge. -5. Unter **Aufträge** den Eintrag öffnen. Der Bereich **Skriptinhalt** zeigt den beim Einreichen gespeicherten Code samt Version oder Kennzeichnung als einmaliges Skript. Bei einem einzelnen Gerät erscheint die Ausgabe sofort. Bei mehreren Geräten öffnet **Ergebnis anzeigen** die Ausgabe direkt beim gewählten Gerät. - -Die Standarddiagnosen stehen unter **Skripte** mit getrennten Versionen für Linux und Windows bereit. Die Windows-Updatesuche verwendet `SYSTEM` und benötigt die lokale und zentrale Freigabe für dieses Administratorskript. Auf Linux hängt die Logabfrage von den Journalrechten des Agent-Dienstkontos ab. - -Unter **Aufträge** können Name oder Anlass, Hostname oder Geräte-ID, Status und Erstellungsdatum kombiniert werden. Das Enddatum zählt in der Ortszeit des Browsers vollständig mit. Unter **Geräte → Letzte Aufträge** öffnet **Ergebnis öffnen** die zu diesem Gerät gehörende Ausführung. Im Genehmigungsverlauf stehen Person und Zeitpunkt bei der belegten Entscheidung. - -## Entwicklung und Deployment - -Der öffentliche API-Dienst `public-api` läuft unprivilegiert auf `127.0.0.1:18445`, im Produktionsprofil mit lokalem Passwort/TOTP und ohne Entwicklungszugänge. Der private Entwicklungsdienst bleibt auf `127.0.0.1:18443`. PostgreSQL hat keinen veröffentlichten Port. Der Reverseproxy verifiziert das TLS-Zertifikat des jeweiligen internen Dienstes. Öffentliche Anmeldung und MCP gehen an `public-api`, die vorhandenen Bootstrapdownloads an das Gerätegateway. - -Die erstmalig ausgeführten Befehle sind wiederverwendbar. - -```sh -python3 tools/dev_public_access.py prepare -python3 tools/dev_public_access.py activate -python3 tools/dev_public_access.py publish -``` - -`prepare` erzeugt das private Bootstrapkonto und seine echte Human-Membership. `activate` startet die zusätzliche API intern und prüft die angebotenen Anmeldemodi. `publish` validiert die Nginx-Konfiguration und stellt den TLS-Ingress um. Bei einem Aktivierungsfehler wird die vorherige Ingresskonfiguration wiederhergestellt. Wiederholtes `prepare` verwendet die vorhandene private Kontokonfiguration. Abweichende bestehende Daten verlangen einen bewussten administrativen Abgleich. - -Weitere Serverupdates verwenden `tools/build.py server-arm64 --ssh --ref REVISION` und `tools/dev_deploy_server.py --ref REVISION`. Der Deploymentrunner übernimmt die aktive Compose-Dateikette des öffentlichen Dienstes und aktiviert auch `public-api`. Reine WebUI-Änderungen verwenden `--web-only`. - -## Abnahme am 17. November 2026 - -76 WebUI-Tests, drei Browser-Bedientests der Tokenverwaltung sowie fünf Backendtests gegen isoliertes PostgreSQL bestanden. Alle 27 Migrationen wurden mit einem eingeschränkten Migrationsbenutzer geprüft. Die öffentliche HTTPS-Abnahme bestätigte 25 Fälle einschließlich Passwort/TOTP, Replay, CSRF, Tenantgrenze, beschränktem Lesetoken und Widerruf in derselben MCP-Sitzung. Alle während der Abnahme erstellten Testtokens sind widerrufen; die Abschlusskontrolle fand null aktive Tokens. [Öffentlicher Nachweis](evidence/public-access-20261117.json) - -Die verwendeten Schutzmaßnahmen orientieren sich an den OWASP-Hinweisen zu Anmeldung, Passwortspeicherung und Sitzungen. [Authentifizierung](https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html) · [Passwortspeicherung](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html) · [Sitzungen](https://cheatsheetseries.owasp.org/cheatsheets/Session_Management_Cheat_Sheet.html) - -### Alte Gerätekopplung endgültig löschen - -Unter **Geräte → Historie** die betreffende Installation öffnen. Unter **Gerät verwalten** zuerst die Identität widerrufen und anschließend **Kopplung löschen** wählen. Die Bestätigung nennt Hostname, Kunde und Kopplungs-ID. Offene Genehmigungen oder laufende beziehungsweise ungeklärte Aufträge sperren das Löschen. Nach der Bestätigung entfallen die Geräteidentität, ihr Inventar und ihre eigenen Auftragsergebnisse. Eine weitere Installation desselben Geräts und deren Historie bleiben erhalten. Gemeinsame signierte Mehrgerätepläne und der Auditnachweis bleiben nachvollziehbar. +Mit `enable` lässt der Betreiber für diese Regel entsprechend berechtigte Tokens über den Selektor `mcp:scoped` zu. `disable` entfernt diesen Eintrag. Für Windows lautet die Plattform `windows`. Bereits einzeln vergebene Principal-Berechtigungen und vorhandene Skriptbeschränkungen gelten weiterhin. Der Server prüft die Rechte bei Planung, Freigabe und Start. Ein persönlicher Freigabeklick erfolgt unter **Genehmigungen**. Für einen direkten Freigabelink wird die `plan_id` verwendet, für den Ergebnislink die `operation_id`. [Geräteregel](../tools/dev_mcp_script_scope.py) · [Abnahme auf beiden Plattformen](mvp-completion-plan.md) diff --git a/docs/reboot-acceptance.md b/docs/reboot-acceptance.md deleted file mode 100644 index 78a5210..0000000 --- a/docs/reboot-acceptance.md +++ /dev/null @@ -1,203 +0,0 @@ -# Letzte Linux-Cloud-VM-Rebootabnahme - -## Tatsächliche Originalabnahme und Schließung bestanden - -Originaljob8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa jetzt **succeeded/revision3**, -genau ursprünglicher Grant25a4bf3f-772c-487d-825d-73bcbbc418fd. Neuer Boot -45aba743-be1d-4ae5-ba00-139fb9363bfe unabhängig nachgewiesen; ursprünglicher -Inventarbeleg1cf6146c-15fb-491f-a35a-8c4a0bb8f679 tatsächlich20:28:40.877951UTC, -innerhalb unveränderter180Sekunden ab20:26:12.430245UTC. Separater frischer -Sameboot-Belegc8214203-04e8-4c75-9aa3-7a786bf64692 empfangen21:11:02.272955UTC. -Genau ein tatsächliches `reboot_postcondition_verified`-Audit bindet beide IDs/ -Zeiten und gleichen Job/Versuch/Grant/Boot/Generation. Normaler signierter -Sync Generation103 von Agent UND Helper angewandt, beide ready, restore_blockedfalse. -Root18/0offen/0Faults, keine sonstigen offenen Agentversuche, alle17alten -Verbrauchszeilen und drei DBinodes erhalten. Einmalige tatsächliche simulierte -WebUI-Genehmigung, proJob1/1/1, keine zweite Wirkung. - -Danach zentrale Rebootpolicy deny-only geschlossen und **exakt ursprüngliche** -General-Konfigurations-/Pinbytes mitallow_rebootfalse wiederhergestellt. -Private `result.json` und `closed.json` jeweils verifiedtrue. Altebefore.json, -Checkpoint und ursprüngliche Artefaktpins blieben unverändert; separater -hashgebundener capacity-upgrade.json qualifiziert lediglich den erhaltenden -storage-onlyArtefaktaustausch auf9e9f/d6fb. [Kapazitätsnachweis](journal-capacity.md). - -Der ursprüngliche BootfehlerCLOCK_UNTRUSTED/Restart=no bleibt realer Befund. -Danach enge Konfigurationskorrektur nativ bestanden: nur Restart=no durch -Restart=on-failure/RestartSec=5 ersetzt. Kontrollierte fehlende Konfigurationsdatei -ließ Helper vor Ledgeröffnung mitExit1 scheitern, tatsächlichesNRestarts1 -belegt. Exakter temporärer Override entfernt; **ohne zweiten Start-/Restart- -befehl** lief derselbe Helper automatisch stabil (NRestarts2/active). Agent -während dieser Bootstrapprobe gestoppt; alleRoot18-Verbrauchszeilen/DBinodes/ -RootDBbytes, Identitäten, Schlüssel, Policies und Binärdateien erhalten. Keine -Job-/Paketwirkung, keinOSreboot; eigenesRollbacktimer entfernt nur exakten -Probeoverride und wurde nach Erfolg gestoppt. Private startup-retry-{intent, -preflight,apply-intent,result}.json, Ergebniscompleted/automatic_recovery/ -state_preservedtrue. Tatsächliche GeneralUnitSHA jetzt -104a7d6f01ec79aa2d6730f098e433418ce3bd04fc180fc4847dc94d873bb5a7. -Dies belegt automatische Retry-/Recoverywirkung nach Startfehler; kein weiterer -OSboottest nach Unitkorrektur wurde ausgeführt. Noch APT-Messungsrequalifikation, -MCP-Endbericht und Endaudit erforderlich. - -## Historischer Zwischenstand vor endgültigem Abschluss - -Der einzelne feste WebUI-Job8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa mit -Grant25a4bf3f-772c-487d-825d-73bcbbc418fd wurde tatsächlich einmal ausgeführt. -Neue Boot-ID45aba743-be1d-4ae5-ba00-139fb9363bfe statt -603e9280-801d-403e-bbfe-7340784e000a, zentrale Reservierung20:26:12.430245UTC, -Originalfrist20:29:12.430245UTC. Tatsächliche neue Bootinventare -6f5bd8a6-a33b-4e45-a102-63d43e12c23d um20:27:40.878097UTC und -1cf6146c-15fb-491f-a35a-8c4a0bb8f679 um20:28:40.877951UTC sind rechtzeitig. -Kein zweiter Neustart ist autorisiert oder vorgesehen. - -Noch **unknown**, nicht abgenommen: General scheiterte beim Boot an -CLOCK_UNTRUSTED/Restart=no. Nach realer Uhrbereitschaft derselbe Helper -operativ gestartet. Spec1.14/Zwei-Beleg-Serverfix unter Candidate7be1f330 -nativ erhaltend deployt, drei isolierte PostgreSQL-Tests/Clippy/Format bestanden. -Originalfrist, alte Daten/Grants/DBinodes und UI blieben erhalten. Erneuter -Finishleselauf konnte noch keinen signierten Erfolg belegen. Seitdem -Rootjournal268414976Bytes nahe256MiB, keine neuen Helpercaptures/Agentrequests. -Agent für begrenzte Kopiediagnose angehalten; keine Ledgerbereinigung. -MVP bleibt offen. Private Belege im unten genannten festen Fallordner, -zusätzlich proof-upgrade-{before,deployed,resumed}.json und -reconcile-diagnostic-quiesced.json. - -Die folgenden Vorbereitungsabschnitte und Formulierungen „noch nicht ausgeführt“ -sind historische Vorstufen, kein aktueller Wirkungsstand. - -Vor dem tatsächlichen Reboot neun bereits verifizierte frühere Gates an feste -JSON-/SHA-Referenzen gebunden. Root17/0offen/faultfrei, Zentrale29/29/25/0, -Agent/General aktiv+enabled, APTinactive/disabled und Endpunkt entfernt. -Zusätzliche tatsächliche Bootprüfung fand den **inaktiven, aber enabled** -historischen`rmm-helper-dev-test.service`, der denselben Root-StateDirectory -verwendet. Vor dem Reboot ausschließlich dessen Autostart deaktiviert, kein -Dienststart/-stop/-restart. Tatsächliche Root-ownedUnit/Binärpfad/Shared-State- -Metadaten zuerst geprüft; bestehende Anpassung`SystemCallFilter=adjtimex` -erklärt Abweichung vom Repo-UnitSHA. CAS mit unabhängig gelesenen tatsächlichen -Unitbytes, keine Änderung dieser Unit oder ihrer Konfiguration. Vor/nach -Disable gleicher Boot, aktuelle PIDs, drei DBinodes und Root-Verbrauchszeilen. -Private Belege unter`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/` -mit`pre-reboot-unit-state.json`, `legacy-unit-metadata.json` und -`legacy-autostart-disabled.json`. Noch keine OS-Rebootwirkung durch diese -administrativen Vorbereitungen. - -**Vorbereitet, noch kein nativer Reboot ausgeführt.** Dieser Schritt darf erst -nach den APT-, Offline-, Crash-/Redelivery-, Transportfallback- und MCP-Gates -folgen. Die frühere Autorisierung des einzelnen Test-VM-Reboots ersetzt keine -Genehmigung des neuen festen Jobs in der tatsächlichen WebUI. - -## Verbindliche Bedeutung der Wiederverbindungsfrist - -Der feste Reboot-Plan nennt `reconnect_timeout_seconds`. Seine zentrale Frist -beginnt bei `execution_permits.created_at`, der dauerhaft gespeicherten -serverseitigen Startreservierung des **gleichen Jobs, Versuchs und Grants**. -Dieser Zeitpunkt liegt vor dem tatsächlichen Helperstart. Die Verwendung ist -bewusst konservativ: Ein späterer lokaler Start oder lokal gespeicherter -`reconnect_deadline` verlängert die zentrale Frist nicht. Gerätezeitstempel, -neue Verbindungsversuche und neue Inventare verlängern sie ebenfalls nicht. - -Erstmaliger Erfolg braucht einen tatsächlich gespeicherten Inventarbeleg -derselben Identität und des aktuellen neuen Boot-IDs. Dessen serverseitige -Empfangszeit muss **nach** der Startreservierung und **spätestens zur Frist** -liegen. Bei später als fünf Minuten erfolgender Erstverifikation braucht der -unveränderliche rechtzeitige Originalbeleg einen zusätzlichen, unabhängig -empfangenen aktuellen Sameboot-Beleg jünger als fünf Minuten und den aktuellen -authentisierten Geräte-/Generationskontext. Beide tatsächlichen IDs und -Empfangszeiten werden im signierten Ergebnis und Audit gebunden. Ein erst -verspätet empfangener Originalbeleg bleibt verweigert. Die alte Boot-ID muss aus dem zum gleichen Grant gehörenden -`start_reserved`-Audit stammen und vom neuen Boot abweichen. Fehlende oder zu -späte Belege bleiben `unknown`; daraus entsteht weder ein geratenes `failed` -noch eine Wiederholungserlaubnis. - -Ein bereits autoritativ bestätigter Erfolg behält seinen **ursprünglichen -konkreten Inventarbeleg**. Späterer RootSync darf dessen rechtzeitige, dauerhaft -gespeicherte Empfangszeit erneut prüfen, auch wenn die aktuelle Uhrzeit inzwischen -hinter der Frist liegt. Ein jüngeres, verspätetes Inventar darf diesen Beleg nicht -ersetzen. Neue Boot-ID und tatsächliche aktuelle Identität müssen weiter passen. -Exakte Nachrichtenwiederholung verwendet die bestehende Quittung. - -Auch ein eingehendes Reboot-Erfolgsergebnis muss denselben unabhängigen -Grant-/Boot-/Inventar-/Fristnachweis besitzen. Vom Client gelieferte Zeitangaben -oder eine behauptete Inventar-ID reichen nicht. Die Ergebnisfelder -`reboot_reserved_at`, `reconnect_deadline` und `inventory_received_at` müssen zu -den tatsächlichen Datenbankzeitpunkten passen. Der unveränderte Helper prüft -weiter den signierten Abgleich und den tatsächlich neuen lokalen Boot-ID. - -## Tatsächlich ausgeführte lokale Prüfung - -Die gezielte Serverprüfung verwendete einen eigenen PostgreSQL-Container ohne -Netzwerkfreigabe, Migrationen 1–13 und die nicht privilegierte Anwendungsrolle -mit RLS. **Drei Tests bestanden**, keine ausgelassen: - -- Frist ausschließlich aus gültigem festem Plan und vorhandener Reservierung; - fehlende Reservierung, ungültiger Timeout und Zeitüberlauf werden verweigert. -- Tatsächliche SQL-Auswahl: Grenze einschließlich akzeptiert, eine Mikrosekunde - zu spät verweigert; falscher Mandant/Agent/Boot, Belege vor Reservierung, - Zukunft und veraltete Erstabnahme verweigert. Der ursprüngliche rechtzeitige - Erfolgsbeleg bleibt später wiederverwendbar. -- Tatsächlicher Ergebnis-Ingress mit ausschließlich synthetischen isolierten - Datenbankzeilen: verspätete behauptete Erfolgsnachricht und erfundene Frist - zurückgewiesen, Job bleibt `unknown`, keine Quittung. Rechtzeitiger unabhängiger - Beleg akzeptiert; exakte Wiederholung erzeugt keine zweite Quittung. - -Dies ist ein lokaler Server-/Datenbanknachweis und **keine native Rebootabnahme**. -Helper-/Providerartefakte, VM-/Serverlaufzeit und Systemuhren wurden für diese -Prüfung nicht verändert. Die einmalige echte positive Rebootabnahme folgt erst -nach den vorherigen MVP-Gates und ihrer eigenen WebUI-Genehmigung. - -## Vorbereiteter Cloud-Runner, noch nicht ausgeführt - -`deploy/cloud_reboot_acceptance.py` und -`deploy/browser/cloud_reboot_acceptance.cjs` bilden ausschließlich den letzten -einzelnen Reboot ab. Vorher müssen APT-Abnahme und beide 1.1-Noops, die drei -aktiven Offlinefälle, Crash-/Redelivery, tatsächlicher Transportfallback und -MCP-Isolation nativ bestanden sein. Ein geschütztes Manifest enthält -`schema_version:1`, den festen `target` und `checks` für `apt_native_update`, -`ensure_package`, `apply_updates`, `offline_wait`, `expired_offline`, -`revoked_before_start`, `agent_crash`, `transport_fallback`, `mcp`. Jeder Eintrag -bindet einen geschützten tatsächlich verifizierten Ergebnisbericht über `path` -und `sha256`. Fixture 1.1 wird aus den früher genehmigten gespeicherten -APT-Ergebnissen geprüft; keine neue SSH-Paketabfrage wird als Nachweis ausgegeben. - -Vor der Vorbereitung müssen die dauerhaften Agent-/General-Helperdienste bereits -aktiv und dauerhaft `enabled` sein. Der Runner aktiviert keinen Autostart -stillschweigend. Der APT-Endpunkt muss nach dessen Abnahme wieder entfernt und -sein Dienst gestoppt sein. Die vorhandene General-Unit bleibt unverändert: -`systemctl reboot` verwendet den vorhandenen D-Bus-Provider, direkte -Reboot-Syscalls bleiben gesperrt. Diese Quellcodeprüfung ist noch kein nativer -Rebootnachweis. - -Bootstrap ändert lediglich `allow_reboot` von false auf true und den zugehörigen -gemessenen General-Pin, unter gestoppten Diensten und Executor-Lock. Originale -werden versioniert; Identitäten, Journale, DB-Inodes, alte Grants und APT-Historie -bleiben vor Neustart bytegleich. Zentral gilt nur eine maximal 30 Minuten gültige -Scope für Reboot; Skripte, Dienste, APT und zusätzliche Logrechte sind verboten. -Bootstrap selbst ruft keinen Reboot auf. - -**Geplant, nicht ausgeführt:** - -```sh -python3 deploy/cloud_reboot_acceptance.py enable --prerequisites devstate/cloud-reboot/prerequisites.json -python3 deploy/cloud_reboot_acceptance.py accept --id -python3 deploy/cloud_reboot_acceptance.py close --id -``` - -`accept` erstellt und beantragt genau einen festen Root-Job über die tatsächliche -WebUI, beweist `pending_approval` mit **0/0/0** und öffnet erst danach eine eigene -WebUI-Genehmigungssitzung. Der Job nennt den ausdrücklichen Grund, Gruppe -`single-test-vm`, Parallelität 1, Laufzeit 240 s und Wiederverbindungsfrist 180 s -ab zentraler Startreservierung. Alte Boot-ID und unveränderlicher Plan werden -vor Genehmigung gespeichert. Kein SSH-Reboot oder direkter Freigabeaufruf existiert. - -Erst tatsächliche ausgehende Wiederanmeldung, neuer Boot-ID, rechtzeitig -gespeichertes Inventar, angewandter signierter RootSync und terminaler Erfolg -bestätigen den gleichen Grant. Alte Ledgerzeilen und DB-Inodes müssen erhalten -sein; genau ein neuer Rootverbrauch sowie **1 Job / 1 Outbox / 1 Grant** sind -erforderlich. Unterbrochenes Warten darf ausschließlich `finish --id` für diesen -gleichen Versuch fortsetzen. Unknown oder Timeout erlauben keinen zweiten Reboot. - -Nach normal bestätigter Rückkehr schließt `close` zuerst die zentrale Scope und -stellt dann die ursprünglichen Config-/Pinbytes mit `allow_reboot:false` wieder -her. Diese operative Rücknahme startet Agent und General-Helper neu, führt aber -keinen zweiten Reboot aus. Tatsächliche Durchführung bleibt bis zur Freigabe des -abschließenden Schritts ausdrücklich offen. diff --git a/docs/script-console-bootstrap-results.md b/docs/script-console-bootstrap-results.md deleted file mode 100644 index c73f25d..0000000 --- a/docs/script-console-bootstrap-results.md +++ /dev/null @@ -1,110 +0,0 @@ -# Tatsächliche Linux-Bereitstellung der Skriptkonsole - -Stand 2026-11-14, Spezifikation 1.20. Ausschließlich die Cloud-Linux-Test-VM -wurde als Client verwendet. Der Entwicklungsrechner erhielt keinen RMM-Dienst. -Sämtliche Zielaufrufe führte der übergeordnete Entwickleragent nach unabhängiger -Quellprüfung aus. Diese Bootstrapnachweise ersetzen keine WebUI-Jobgenehmigung. - -Der korrigierte Quellpack mit 158 unveränderten Eingaben ist Manifest -`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`. -Auf der Cloud-VM bestanden tatsächlich 84 Units; fünf Datenbankfälle blieben -ausdrücklich ausgelassen. Dieselben fünf waren bereits im isolierten lokalen -PostgreSQL-Lauf mit allen 45 Servertests bestanden. Der native Beleg des Falls -`7b61ce46-7913-492b-9c6b-414a0c2b6ffc` hat SHA256 -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`. -Kein RMM-Job, keine Genehmigung oder Produktzustandsänderung gehörte zum Unitlauf. - -Der getrennte lesende Vorher-CAS band bestehende Boot-/Geräteidentität, -tatsächliche alte Prozessimages, General-/APT-Kontrollen und drei -Datenbankinodes. Für die Bereitstellung wurden sämtliche aktiven Leser des -gemeinsamen Root-Ledgers auf die neue decoderfähige Generation gebracht; -[Begründung und APT-Grenze](script-console-helper-generations.md) bleiben bindend. - -## Originalinstallation und erhaltene Fehlerbelege - -Der Originalfall `2e27c312-58cc-444d-92a6-863a11ac6ffd` verwendete -`deploy/script_console_install.py`, SHA256 -`667b56f7e5f085db249f27a7094919c7c0e6055dabc9f0600cb261c34760cd26`. -Nach frischem geschlossenem Servergate wurden Agent und General angehalten, -die alten Dateien erhalten und die qualifizierten neuen Images eingesetzt. -Generalunit, Sandbox, Konfiguration und bestehende Pins blieben unverändert. -Fullkonfiguration, geschützter Binär-/Policypin, eigene Unit und Agentdropin -wurden additiv angelegt. Alle ursprünglichen SQL-Zeilen und Dateimetadaten -einschließlich PKI blieben vor dem Wiederstart erhalten; insbesondere drei -Datenbankinodes und die ursprünglichen 18 abgeschlossenen Rootverbräuche mit -Originalrequest-/Grant-/Start-/Outcomebytes. Es gab keinen Ledgerreset. - -Die Installation hielt danach vor `restart-intent` an: Der ursprüngliche -Unitguard erwartete leere Filterwerte, tatsächlich lieferte systemd bei -`SystemCallFilter` und `RestrictAddressFamilies` jeweils `~`, also eine leere -Ausschlussliste. Die übrigen Fullunitwerte entsprachen der beabsichtigten vollen -Hostautorität. Der unmittelbare Readback zeigte alle drei Dienste inaktiv mit -PID 0. Der Originalbericht bleibt ein fehlgeschlagener Installationsbericht; -er wurde nach späterer Fortsetzung nicht als erfolgreicher Bericht überschrieben. - -Die separate Fortsetzung `43dae370-6862-4cf4-a83c-0b2612af6c79` verwendete -`deploy/script_console_continue.py`, SHA256 -`c0c0ecf1e1bcb2d2f9ce0bcf6973aa430e9e28ba86823ca5ad0954744a589238`. -Sie ließ ausschließlich die beiden exakten leeren Filterdarstellungen `''` -und `'~'` zu, prüfte alle bestehenden Kontrollen und SQL-/PKI-Zeugen frisch -und schrieb vor dem erstmaligen Start einen dauerhaften eigenen Startintent. -Der Generalstart wurde ausgeführt; seine sofortige Prozessprüfung verweigerte -jedoch die Fortsetzung. Full und Agent wurden noch nicht gestartet. Der -Bericht enthält deshalb `started:[]`; daraus folgt ausdrücklich nicht, dass -kein Startbefehl ausgeführt wurde. Ein zusätzlicher frischer Readback belegte -den tatsächlich laufenden richtigen Generalprozess. Eine Beobachtung vor -abgeschlossenem `exec` bei `Type=simple` ist eine plausible Erklärung, wurde -aber nicht als bewiesene Ursache ausgegeben. - -## Einmalige verbleibende Starts und aktueller Beleg - -Ein neuer getrennter Fall `66a537bb-e676-421e-80dc-f653b069738a` verwendete -`deploy/script_console_finish_start.py`, SHA256 -`ebe6170d489689ad0ffaf23eeba60db7979dd243d386d3a5c33885212f5c086b`. -Er erhielt beide vorherigen Quellen, Intents, Berichte und Startmarker unverändert. -Der bereits laufende General wurde frisch an PID, Prozessgeburt, Image und -Konten gebunden und weder gestartet, gestoppt noch neu gestartet. Vor jedem -verbleibenden Full-/Agentstart wurde ein eigener dauerhafter Einmalintent -geschrieben. Prozessbeobachtung führte keinen weiteren Start aus. - -Der Poll verwendet eine fünfsekündige Beobachtungsdeadline und verlangt zwei -übereinstimmende korrekte Prozessbeobachtungen; der erste positive PID-/Geburtsbezug -darf nicht wechseln. **Grenze:** Einzelne geerbte `systemctl`-Abfragen haben -weiterhin 25 Sekunden Timeout. Es gibt deshalb keine harte Zusage von fünf -Sekunden Gesamtzeit. Diese Grenze betrifft den Bootstrapbeobachter, nicht die -Laufzeit genehmigter Skriptjobs. Die bereits verwendete Quelle bleibt unverändert. - -Tatsächliches Ergebnis: erfolgreiche verbleibende Starts und zusätzlicher -rein lesender Readback aller drei aktiven Dienste, gleicher Boot und korrekte -Konten/Images: - -| Dienst | PID / Startticks | UID / GID | -| --- | --- | --- | -| General | `65562 / 7308498` unverändert | `0 / 984` | -| Full | `66122 / 7344457` | `0 / 984` | -| Agent | `66132 / 7344482` | `993 / 984` | - -Helperimage SHA256 -`79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf`, -Agentimage -`0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f`. -Der tatsächliche Ergebnisbeleg liegt privat unter -`devstate/script-console-finish-start/66a537bb-e676-421e-80dc-f653b069738a/finish-reply.json`, -SHA256 `85c98d39d666ce05abc7c3747cd58978496fc059b1f833997ed4d6eff5229153`. -Der zusätzliche Readback hat SHA256 -`5d94f79b29c7be6310fbbeec4178c0dadb849566506239b01b8db3d48c622316`. -Erster General-Startintent: `2026-11-14T16:44:24.389303+00:00`; -Intent für die verbleibenden Starts: `2026-11-14T16:50:23.921400+00:00`. - -APT blieb disabled/inactive, ohne Agentendpoint und bereits zuvor nicht aktuell -qualifiziert. Keine Paketwirkung, kein Reboot, kein neuer Rootverbrauch und kein -RMM-Job oder Approval wurden durch diese Bootstrapquellen angefordert. Normale -Dienstaktivität nach dem Start ist separat zu attestieren; der Startbeleg setzt -deshalb `signed_sync_verified:false` und `full_job_accepted:false`. - -**Noch offen:** Frischer signierter Abgleich mit kryptografisch geprüfter -Erhaltung der ursprünglichen Root-/Agenthistorie, aktuelle passive Meldung an -den festgelegten Server und danach der tatsächlich über die WebUI genehmigte -begrenzte FullMaintenance-Skriptauftrag. Dienststart, Unitprüfung und bestehende -Policy sind keine Jobgenehmigung. Fehlende oder unklare Ergebnisse dürfen weder -automatisch wiederholt noch durch Journal-/Datenbankänderungen repariert werden. diff --git a/docs/script-console-browser-acceptance.md b/docs/script-console-browser-acceptance.md deleted file mode 100644 index e497403..0000000 --- a/docs/script-console-browser-acceptance.md +++ /dev/null @@ -1,332 +0,0 @@ -# Geplante Browserabnahme der Linux-Full-Skriptkonsole - -Stand: **Opsvorbereitung, keine ausgeführte Browser-/Jobabnahme**. Der Subagent -hat weder Browser, SSH, MCP, Anmeldung, Job noch Policyänderung ausgeführt und -keine Zugangsdaten gelesen. Deployment-v2 und Frozen158 bleiben unverändert. -Neue Playwright-Testdateien oder ein weiteres Testframework wurden nicht angelegt. - -Die Vorlagen liegen geschützt unter -`devstate/output/playwright-private/console-full-v1/`: - -| Datei | Zweck | -| --- | --- | -| `browser-cli.config.template.json` | CLI-Konfiguration mit echten TLS-Prüfungen und privatem Profil | -| `launch-chromium.sh.template` | ausschließlich Browser-Namespace, kein HOME-Override | -| `linux-full-script.sh` | exakte geplante benigne Jobbytes, nicht lokal ausführen | -| `mcp-plan-input.template.json` | einzelner fester Linux-Antrag, Ziel/Zeiten noch einzutragen | -| `acceptance-required.json` | erwartete Pending-, Audit-, Identitäts- und Ausgabewerte | -| `root-policy.template.json` | nicht ausführbare Schema2-Vorlage mit ungelösten Pflichtpins | -| `root-policy-change.review.json` | einmaliger Policy-CAS-/History-/Schließungsplan; kein Mutator | -| `prepared.json` | Einzelhashes und ausdrücklicher Vorbereitungsstatus | - -## Voraussetzungen und Vertrauensbindung - -Zuerst müssen der neue Serverbuild, Migration14 und Web49 tatsächlich gesund -bereitgestellt sein. Die zentrale Rootpolicy ist dabei noch die exakt bekannte -abgelaufene `cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`. -Ein Serverbuild allein qualifiziert weder Agent noch Fullprofil. - -Die Cloud-Linux-VM muss separat die neue laufende Agent-/Helpergeneration, -Fullhelper-Readiness, tatsächlichen gehaltenen Helpercodehash, lokale Fullpolicy, -unveränderte Geräteidentität, vertrauenswürdige Uhr und signierten Sync belegen. -Gespeicherte Capabilities müssen insbesondere `script.full_maintenance/1`, den -konkreten `helper.policy.sha256:` und -`helper.binary.sha256:` enthalten. Aus Source, UI-Auswahl oder -Buildartefakten werden keine tatsächlichen Capabilities abgeleitet. Notebook und -Windows-VM sind kein Ziel dieses ersten Abnahmeschritts. - -Vor Browserstart wird die Authkonfiguration ausschließlich lesend über den -geprüften privaten API-TLS-Weg kontrolliert: development/dev/test, Devlogin -aktiviert und Produktions-OIDC ehrlich nicht konfiguriert. Für API18443 ist -**`devstate/api-pki/ca.pem`** die richtige Vertrauensquelle; ein vorhandenes -öffentliches `credentials/server-ca.pem` darf nur bei unabhängig festgestellter -Byte-/Fingerprintgleichheit benutzt werden. Alte HTTP-Helfer wie -`cloud_mvp_acceptance.server(kind=http)` hardcoden noch `pki/ca.pem` und sind -hierfür nicht ungeprüft wiederzuverwenden. Keine Zertifikats-/Namensausnahme. - -Der bestehende strikt geprüfte SSH-Tunnel bindet nur -`127.0.0.1:18443 → Server 127.0.0.1:18443`. Die Browserorigin bleibt exakt -`https://localhost:18443`, passend zum dokumentierten SAN und zur CSRF-Origin. -Ein Tunnel ist weder lokaler RMM-Server noch Enrollment des Notebooks. - -## CLI und Browser ohne Änderung von HOME oder globalem Trust - -Der [Playwright-Skill](/home/kevin/.codex/skills/playwright/SKILL.md) wurde gelesen. -`npx` ist vorhanden. Die lokal gecachte CLI0.1.24 mit Playwright1.66-Alpha wurde -anhand ihrer installierten Quellen geprüft: Config, `userDataDir`, eigener -`executablePath`, `downloadsPath` und redigierte Secret-Namen werden unterstützt. -Der tatsächliche Browser ist der vorhandene Chromium141.0.7390.37 unter -`/home/kevin/Schreibtisch/Coding/rust-discovery/web/node_modules/.cache/playwright-browsers/chromium-1194/chrome-linux/chrome`. -Die Kombination ist noch nicht durch einen Browserstart qualifiziert. - -Runtimeartefakte gehören unter ein neues privates -`output/playwright//`, Modus0700. Dieses Verzeichnis und -`/.playwright-cli/` sind ausgeschlossen. Vorlagen mit `@CASE_DIR@` sind noch nicht -startfähig; Root materialisiert sie auf genau dieses absolute Caseverzeichnis. -Der CLI-Skillwrapper wird **mit `bash`** aufgerufen, nicht ausführbar gemacht. - -Die konfigurierte Browser-Executable ist dieser eigene private Wrapper: - -```bash -#!/usr/bin/env bash -set -euo pipefail -rmm_browser_rw='@CASE_DIR@/browser-rw' -rmm_chromium='/home/kevin/Schreibtisch/Coding/rust-discovery/web/node_modules/.cache/playwright-browsers/chromium-1194/chrome-linux/chrome' -exec /usr/bin/bwrap --die-with-parent --new-session --ro-bind / / \ - --bind "$rmm_browser_rw/nss-root" /home/kevin/.pki \ - --bind "$rmm_browser_rw" "$rmm_browser_rw" \ - --tmpfs /tmp --dev /dev -- "$rmm_chromium" "$@" -``` - -`HOME` bleibt unverändert `/home/kevin`. Nur im Browser-Mountnamespace verdeckt -der private NSS-Baum den bereits vorhandenen Pfad `/home/kevin/.pki`. -Globale Trustdaten werden nicht geöffnet oder verändert. Der einzige zusätzliche -Schreibbind ist `browser-rw`; Rootprofil, Downloads und CLI-Cache liegen darin. -Ein expliziter `userDataDir` und `downloadsPath` vermeiden, dass der Browser -Ausgaben in einem nur für ihn sichtbaren `/tmp` ablegt, auf die der CLI-Treiber -anschließend nicht zugreifen könnte. Netzwerk bleibt für den lokalen Tunnel -erreichbar. Die Konfiguration setzt `ignoreHTTPSErrors:false` und -`chromiumSandbox:true`; bei einem tatsächlichen Startproblem keine stillen -TLS-/Sandboxausnahmen ergänzen. - -Für die spätere lokale Materialisierung sind die erforderlichen Verzeichnisse -`browser-rw/{profile,downloads,cache,nss-root/nssdb}` und `evidence` privat -anzulegen. Konfiguration und Wrapper werden aus den Vorlagen mit dem festen -Casepfad erzeugt; nur der neu erzeugte Browserwrapper erhält0700. Der öffentliche -**API-CA-Beleg** wird per bestehendem geprüften Transport beschafft und unter -`trust/api-ca.pem` abgelegt; dieser Schritt wurde hier nicht ausgeführt. - -Geplante NSS-Einrichtung, noch nicht ausgeführt: - -```bash -rmm_certutil='/home/kevin/Schreibtisch/Coding/rust-discovery/web/node_modules/.cache/nss-tools/root/usr/bin/certutil' -"$rmm_certutil" -N -d "sql:$rmm_case/browser-rw/nss-root/nssdb" --empty-password -"$rmm_certutil" -A -d "sql:$rmm_case/browser-rw/nss-root/nssdb" -n 'RMM fixed API CA' -t 'C,,' -i "$rmm_case/trust/api-ca.pem" -"$rmm_certutil" -V -d "sql:$rmm_case/browser-rw/nss-root/nssdb" -n 'RMM fixed API CA' -u L -``` - -Vor Anmeldung müssen eine leere separate NSS-Fixture die untrusted-CA-Verbindung -und die vertrauende Fixture einen falschen TLS-Namen verweigern. Der positive -Aufruf zu `https://localhost:18443` muss ohne Zertifikatsfehler funktionieren. -Keine Warnseite wegklicken, kein `ignore-certificate-errors`, kein SPKI-Bypass. - -Der bestehende geschützte Login wird erst durch Root zur tatsächlichen Anmeldung -lokal verarbeitet. Die CLI unterstützt `PLAYWRIGHT_MCP_SECRETS_FILE` als private -Dotenv-Datei mit den Namen `RMM_LOGIN_USER` und `RMM_LOGIN_PASSWORD`. Root erzeugt -sie ausschließlich aus dem geprüften bestehenden Login-JSON, ohne Werte zu -loggen oder als CLI-Argumente zu übergeben. Hier wurde sie nicht erzeugt. -CLI-Fill erhält nur den Secret-Namen; die installierte CLI löst und redigiert ihn. -Session-/Cookie-/CSRF-Daten dürfen nicht als ganze Dumps ausgegeben werden. - -Geplante CLI-Funktion, noch nicht ausgeführt; `rmm_case` und `rmm_session` sind -die vorher explizit gesetzten Aufgabenvariablen: - -```bash -rmm_cli() { - env npm_config_offline=true \ - XDG_CACHE_HOME="$rmm_case/browser-rw/cache" \ - PLAYWRIGHT_MCP_SECRETS_FILE="$rmm_case/login.env" \ - bash /home/kevin/.codex/skills/playwright/scripts/playwright_cli.sh \ - --session "$rmm_session" --config "$rmm_case/cli.json" "$@" -} -rmm_cli open https://localhost:18443/ -rmm_cli snapshot -``` - -Keine Zuweisung an `HOME`, `home` oder `CODEX_HOME`. Traces, Videos und vollständige -Netzwerk-/Credentialaufzeichnungen bleiben aus. Artefakte sind private Belege. - -## Fester Antrag über MCP, Genehmigung ausschließlich durch UI-Klick - -Geplante Jobbytes, **nicht lokal ausführen**: - -```sh -set -eu -/usr/bin/id -u -/usr/bin/sleep 12 -printf '%s\n' 'RMM_FULL_CONSOLE_LINUX_V1' -printf '%s\n' 'RMM_FULL_CONSOLE_STDERR_V1' >&2 -``` - -Das sind130UTF-8-Bytes ohne BOM mit SHA256 -`c878ba5b5c37fa3f1b9485c6994d6c57f6f37d01d99d4239c64d264d4ed95336`. -Der begrenzte12-Sekunden-Warteaufruf lässt Zeit, den gespeicherten Runningstatus -über das bestehende4-Sekunden-Polling zu beobachten. Keine Installation, -Dateischreibwirkung, Dienständerung, Downloads oder Neustarts sind enthalten. - -Die Vorlage bindet ausschließlich das bestätigte Cloud-Linux-Asset, -`execution_identity:root`, `privileged_script_profile:full_maintenance_v1`, -`posix_sh`, `arguments:[]`,30Sekunden Laufzeit,4096Ausgabebytes, Parallelität1 und -Stopp nach1Fehler. UTC-Start/Frist werden kurz vor Planung festgelegt und müssen -innerhalb der konkret geprüften Policygültigkeit liegen. Erwartete stdout- -Nachbedingung ist exakt `0\nRMM_FULL_CONSOLE_LINUX_V1\n`; stderr wird anschließend -separat auf `RMM_FULL_CONSOLE_STDERR_V1\n` geprüft. Kein erfundenes -`expected_stderr`-Wirefeld wird hinzugefügt. - -Nach sichtbarer simulierter Anmeldung und separat geprüftem temporärem -Policy-Opt-in ruft Root über die vorhandene autorisierte MCP-Automation nur -`operations.plan(tenant_id,input)` und -`operations.submit(tenant_id,plan_id,idempotency_key)` auf. Einmaliger privater -Checkpoint erhält tatsächliche Planbytes, SHA256, alle Job-/Versuchs-/Ziel-IDs, -Skriptbytes, Zeitfenster und die Submitantwort. Kein Approvaltool oder Browser- -Token darf der MCP-Automation bereitgestellt werden. - -**Vor dem Klick:** `pending_approval`, `job_count:0`, `execution_state:null` sowie -für genau dieses neue Job-/Versuchspaar Jobs0, Outbox0, Permits0 und -Authorizations0 unabhängig lesend nachweisen. Alte Gesamtzähler sind kein -Ersatz. Eine Plan-Zielpreview ist kein bereits ausführbarer Job. Kein Retry. - -## Konkreter UI-Ref-Ablauf - -Alle folgenden `e…` sind ausdrücklich **Platzhalter aus dem unmittelbar vorher -gelesenen Snapshot**, keine erfundenen tatsächlichen Refs. Nach Navigation oder -geändertem DOM erneut `snapshot` und aktuelle Refs benutzen. - -1. Bei frischem Snapshot Benutzername/Passwort-Felder nach ihren tatsächlichen - Labels identifizieren. `rmm_cli fill eUSER RMM_LOGIN_USER`, - `rmm_cli fill ePASSWORD RMM_LOGIN_PASSWORD`, dann tatsächlichen Button - „Anmelden“ klicken. Danach neuer Snapshot: `SIMULIERT`, - `simulated-testprincipal-a` und „kein menschlicher Produktions-Freigabenachweis“ - müssen sichtbar sein. Richtigen Mandanten bestätigen. Kein Loginscreenshot - mit gefüllten Feldern, keine Session-/CSRF-Geheimnisse ausgeben. -2. Nach MCP-Submit und unabhängigem Pending0-Nachweis die **exakte neue - Operation-ID** in „Anträge und Ausführungen“ klicken. Neuer Snapshot: - „Antrag: pending_approval“, Jobanzahl0 und kein Ausführungszustand. Dann - „Unveränderlichen Plan zur Prüfung öffnen“ klicken; erneut Snapshot. -3. Alle festen Ziel-/Agent-/Job-/Versuchs-IDs, `root`, Interpreter, Fullprofil, - Script-/Job-/Planhashes, komplettes Skript, stdout-Nachbedingung, Budgets und - Fristen mit dem MCP-Checkpoint vergleichen. Vollwartungswarnung muss explizit - volle Hostautorität einschließlich Agent/PKI/Rebootmöglichkeiten erklären. - Keine Sandbox- oder No-Reboot-Zusage daraus ableiten. -4. Den tatsächlichen gespeicherten JSON-Block - `pre[aria-label^="Alle festen Zielpreviews"]` verwenden, **nicht `pre.first()`**: - die Konsole enthält zusätzliche Skript-`pre`. Falls der Snapshot dafür keine - Ref liefert, ist ein ausschließlich lesendes - `run-code "async page => ({plan: JSON.parse(await page.locator('pre[aria-label^=\"Alle festen Zielpreviews\"]').innerText())})"` - möglich. Kein `fetch`, `page.request`, Routing, Datenmutation oder künstliches - DOM-/React-State-Umschalten. Exakte zurückgelesene Planbytes unabhängig hashen - und byteweise mit dem MCP-Checkpoint vergleichen; Script- und Jobhash ebenfalls. -5. Der Button **„SIMULIERT: Diesen festen Plan ausdrücklich genehmigen“** muss - zunächst deaktiviert sein. Erst nach den bytegenauen Prüfungen die echte - Checkbox „Ich habe sämtliche festen Ziele, Aktionen, Bytes/Hashes … geprüft“ - per `rmm_cli check eCONFIRM` setzen. Neuer Snapshot, dann exakt diesen jetzt - freigegebenen Button einmal per `rmm_cli click eAPPROVE` klicken. Keine direkte - POST-/DB-Genehmigung, keine erneute Wirkung bei verlorener Antwort. -6. Sofort Operation und „Job “ öffnen. Neuer Snapshot soll während - der begrenzten Wartezeit den tatsächlichen gespeicherten Runningstatus zeigen. - Danach über normale Snapshots/Polling bis zum endgültigen Ergebnis beobachten. - Ein verpasster Running-Snapshot wird ehrlich als nicht beobachtet dokumentiert; - er wird nicht durch einen neuen Job nur für ein Bild ersetzt. -7. „Konsolenergebnis“ muss Zustand, feste Attempt-ID, Revision, Exitcode0, - Trunkierungfalse und getrennte stdout-/stderr-Textansichten zeigen. Es gibt - keinen Live-Ausgabestream. Die vollständigen Originaldaten bleiben darunter. - Optional können die beiden echten Rohbyte-Downloadbuttons mit der vorbereiteten - privaten Downloadablage geprüft und deren Hashes mit dem Checkpoint verglichen - werden. Der endgültige Erfolgsbeleg umfasst immer die gespeicherten Rohbytes. -8. Über den tatsächlichen Button „Abmelden“ ausloggen und nur die eigene - CLI-Session schließen. Keine Browser-/Server-/Agentenprozesse pauschal stoppen. - -## Ergebnis-, Audit- und Schließungsbelege - -Read-only-MCP `jobs.get` muss genau das ursprüngliche Job-/Versuchspaar melden: -`succeeded`, Exit0, keine Trunkierung, `postconditions_passed:true`, -`execution_uid:0`, `privileged_script_profile:full_maintenance_v1` und exakt den -Skripthash. stdout und stderr müssen bytegenau stimmen. Zustände `unknown`, -Timeout, Cancel/Fence oder fehlende Ausgabe sind kein Erfolg und kein Retrygrund. -Die Helper-/Agentjournale müssen denselben genehmigten Versuch und genau eine -Consumption/Wirkung belegen; bestehende History und Identitäten bleiben erhalten. - -Die unabhängige lesende Auditprobe verlangt genau eine passende Authorization, -`approval_origin:dev_test_browser_simulation`, `testsimulation:true`, -`principal:simulated-testprincipal-a` und den exakten Planhash. Für dieses -Job-/Versuchspaar werden Jobs1, Outbox1 und Permits1 erwartet. Der UI-Klick ist ein -Entwicklungsnachweis und keine menschliche Produktionsgenehmigung. Belegstage -„geplant“, „pending“, „UI-simuliert genehmigt“, „native Wirkung“ und -„Ergebnis/Audit geprüft“ getrennt dokumentieren und nach dem Abnahmeschritt pushen. - -Der vorbereitete Policyplan verlangt exakt alten `cf15…`-CAS, unverändertes -Rootflag, ein neues Create-once-Historyverzeichnis, feste Kandidatbytes/hash, -maximal15Minuten, genau ein Cloudziel/Generationen, Fullpolicy- und laufenden -Helpercodehash und ausschließlich den simulierten Principal. Servicesliste leer, -Rebootfalse, keine separaten typisierten APT-/Logfreigaben. Diese Parameter -begrenzen typisierte Aktionen; ein ausdrücklich genehmigtes Fullskript behält -die in der UI angekündigte volle Hostautorität. Originalbytes werden vor der einen atomaren -Ersetzung erhalten; Antwortverlust erlaubt nur Readback desselben Cases. Die -geschützte Policy erhält weiterhin Eigentümer10001/0600. Keine Rollen-/Flag-/ -Ingressänderung, kein Service-Neustart, kein SQL- oder API-Approval ist Teil dieses -Scopewechsels. Das später separat beauftragte MCP-Actor-Provisioning ergänzt -höchstens dessen Root-Planungsrecht; siehe den getrennten Opsvertrag unten. -Nach eindeutig geschlossenem Ergebnis wird über einen separat geprüften -Kandidathash-CAS genau die ursprüngliche abgelaufene `cf15…`-Policy wiederhergestellt -und die Schließung belegt. Bis dahin begrenzt die feste Ablaufzeit neue Starts; -niemals still verlängern. Die Vorlage wurde inzwischen als getrenntes -[Policy-/Actor-Opswerkzeug](script-console-policy-scope.md) umgesetzt, vor jeglicher -Zielaktion vom Hauptagenten zu prüfen. Dadurch wird weder eine tatsächlich -geöffnete Policy noch ein MCP-/UI-Aufruf oder Jobnachweis behauptet. - -## Quellenprüfung und nach dem MVP vorgemerkte Grenze - -Das feste `Action::RunScript.privileged_script_profile` ist Teil der gehashten -Job-/Planbytes. Ein Entfernen/Umdeuten verändert den genehmigten Plan. Policy- und -Codehash sind zusätzliche Qualifikations-/Startgates, keine erfundenen weiteren -Jobpayloadfelder. `agent/src/helper_sync.rs` wählt mit -`general(binding,job.action.full_maintenance())` ausschließlich den richtigen -Fullpin/Profilweg; `agent/src/apt.rs::socket_for` und `invoke_with_control` -erzwingen den Fullsocket und die erneute Fullprobe ohne General-/APT-Fallback. -`privileged-helper/src/control.rs::general_probe` bindet Schema2, Identität, -Policysha, Profil und Binarysha. Der Helper verweigert Fulljobs auf General sowie -nicht passende Jobs auf Full; die gehaltene tatsächliche Codeidentität wird vor -Consume erneut geprüft. Beim Lesen dieser Quellen wurde keine konkrete Umgehung -der Job-/Helperpinbindung festgestellt; das ersetzt keinen nativen Nachweis. - -Die zentrale `RootScope::permits`-Semantik ist derzeit additiv: ein Schema2-Scope -mit `allowed_script_profiles:[full_maintenance_v1]` ermöglicht Full, schließt bei -`allow_root_scripts:true` aber nicht automatisch jedes begrenzte Legacy-Rootskript -aus. Daher keine allgemeine Full-only-Ausschlusszusage. Der konkrete genehmigte -Testplan ist ausdrücklich Full; General und APT bleiben lokal unverändert -gesperrt/gebunden. Strengere zentrale Profil-Ausschlusssemantik ist transparent -für nach dem MVP vorgemerkt; die eingefrorenen158Dateien werden dafür jetzt nicht -verändert. Falls eine tatsächliche Job-/Helperpinumgehung entdeckt wird, ist sie -als Blocker gesondert zu behandeln. - -## Tatsächlich lokal geprüft - -`bwrap --ro-bind / / -- /usr/bin/true` sowie eine separate öffentliche -Marker-/Pipefixture liefen erfolgreich. Der nur im Namespace gebundene private -NSS-Pfad funktioniert, `HOME` bleibt `/home/kevin`, geerbte Pipe-FDs bleiben offen -und die globalen `.pki`-Verzeichnismetadaten bleiben identisch. Dafür wurde kein -Browser gestartet und kein tatsächlicher Trust-/Login-/Serverinhalt gelesen. -Config-, Wrapper- und JSONsyntax sowie die geplanten Script-/Ausgabebytes werden -lokal geprüft. Browserkompatibilität, NSS-/TLS-Verhalten im echten Chromium, -Authentifizierung, Ref-Klick, Fulljob, Audit und Schließung sind **noch offen**. - -### Anschließender tatsächlicher Harnessbefund des Hauptagenten - -Der Hauptagent hat später den privaten Browsercase -`output/playwright/51c274c9-9ddc-42db-8684-5fec7877977d` vorbereitet. Er meldete -tatsächlichen geprüften öffentlichen API-CA-Bezug, Devlogintrue/OIDCfalse, -NSS-Erfolg und den privaten Loopback-SSH-Tunnel. Es wurden keine Secrets ausgegeben. -Diese Befunde stammen vom Hauptagenten, nicht aus einem Browserlauf des -vorbereitenden Subagenten. - -Erster Chromiumstart: Crashpad scheiterte vor Datenbank-/RMM-Wirkung. Ein privates -zusätzliches `XDG_CONFIG_HOME` im bereits vorbereiteten `browser-rw`-Schreibbaum -behebt dessen fehlenden Schreibpfad, ohne HOME zu ändern. - -Zweiter Start: Die Chromium-Sandbox verweigerte verschachtelte Usernamespaces. -Der tatsächliche Grund war `/proc/self/uid_map: Read-only file system` im -Bubblewrap-Namespace; außerhalb funktionierte die schmale `unshare -Ur true`- -Probe. Der Hauptagent ergänzte im **eigenen materialisierten Casewrapper** -`--unshare-pid --proc /proc`. Die entsprechende verschachtelte Namespaceprobe -bestand danach. Der dritte Browserstart wurde mit aktiviertem Chromium-Sandbox- -und TLS-Verifikationsschutz begonnen; daraus folgt noch kein Login-, -Genehmigungs- oder Joberfolg. - -Die vorbereiteten Vorlagendateien wurden während dieses laufenden Root-Cases -bewusst nicht verändert oder nachträglich als dessen tatsächlich verwendete -Wrapperbytes ausgegeben. Dessen konkrete Config-/Wrapperhashes und Ergebnisse -sind im tatsächlichen Case separat zu erhalten. Bei einem neuen Harnesscase ist -die eng belegte `/proc`-/private-XDG-Korrektur ausdrücklich einzubeziehen. Keine -Zertifikats-, Browser-Sandbox-, Root-/Job- oder Helpergrenze wurde dafür -abgeschaltet. Bis zu diesem gemeldeten Harnessstand war keine Policy geöffnet -und kein RMM-Job ausgeführt. diff --git a/docs/script-console-cloud-upgrade-v1.md b/docs/script-console-cloud-upgrade-v1.md deleted file mode 100644 index f0ded51..0000000 --- a/docs/script-console-cloud-upgrade-v1.md +++ /dev/null @@ -1,230 +0,0 @@ -# Begrenzter Cloudserver-Nachfolger für Skriptkonsole 1.20 - -`deploy/cloud_script_console_upgrade_v1.py` ist eine neue, einmalige -Bereitstellungsquelle für den festgelegten ARM64-Cloudserver. Bestehende Runner, -Compose, Dockerfile, Ingress, Policies und Produktquellen werden nicht verändert. -Die Quelle ist lokal geprüft; ein echter Servercase, SSH-Aufruf, ARM64-Build, -Migrationslauf und eine Bereitstellung wurden damit noch **nicht ausgeführt**. - -## Feste Quellen und Ausgangslage - -- Frozen `run-29461892-343f-42f4-b469-88703535425e`, Manifest-SHA256 - `ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`: - alle 158 nachgewiesenen Compiler-/Vertragsdateien, einschließlich des - Full-Helper-Binarypins und Migration `0014_windows_msi_catalog.sql`. -- Zusätzlich separat gepinnte `deploy/Dockerfile`, `.dockerignore` und - `deploy/server.compose.yaml`: insgesamt **161 Dateien** in einem eigenen - ausgewählten Quellarchiv. Kein Live-Checkout als Buildkontext und kein - Überschreiben von `/opt/rust-discovery/crates` oder alten Quellen. -- Dockerfile-COPYs und produktive Includes sind enthalten: Cargo-Manifeste und - Lockfile, sämtliche Crates einschließlich OIDC-SQL, Migrationen, APT-Python, - Hook und eingebettete APT-Unit. Der bestehende `.dockerignore` filtert den - Kontext zusätzlich. Credentials, Devstate, Git, Target und Node-Module gelangen - nicht in diesen Kontext. Der ARM64-Build verwendet den unveränderten Dockerfile; - lokale x86-64-Binärdateien werden nicht als Serverruntime eingesetzt. -- Genau drei Dateien des bereits lokal geprüften Web49-Bundles. Index-SHA256 - `95d6f9058cc713c6af36fbd22ccc60678f081765a853b53d19ac6f0d219804f8`, - JS-SHA256 `f611662042eb4cc44f25c7d5ddc0d2d0562e32be267d3d5fb1db31b0d310f879`, - CSS-SHA256 `916e8870d4e9a9553de452b3ff6c71671bb6a7a22355de0aff432db516a9f3e7`. - Der Nachfolger baut die UI nicht erneut. -- Erwartetes bisheriges Runtimeimage - `sha256:25697f948325a11f755893e16ec5be2da138c3333c8e60f75a18f973d6ac26e2` - aus dem dokumentierten 31278be-/9058f6a3-Stand. Dies ersetzt keine frische - Read-only-Baseline; ein anderer tatsächlicher Stand wird verweigert. - -Das lokale Manifest bindet außerdem Runner, vollständige erzeugte Workerquelle, -beide SSH-Supportquellen, Quellarchiv, Webarchiv, alle Einzeldateien und die -SHA384-Checksummen der SQLx-Migrationen. Der bestehende geprüfte SSH-Key-/Hostkeyweg -wird wiederverwendet. `--access-root` bezeichnet nur den vorhandenen Hauptcheckout -mit geschützter `credentials/server.conf`; dessen Quellen werden nicht gebaut. -Ziel ist ausschließlich Root-Bootstrap auf discovery.ease-technologies.de bzw. dessen festem Namen. - -TLS verwendet dieselbe getrennte Vertrauenszuordnung wie die bestehenden -Compose-Mounts: API18443 mit Name `localhost` und -`devstate/api-pki/ca.pem`; Gateway18444 mit Name `localhost` sowie öffentlicher -Gateway443 mit Name `discovery.ease-technologies.de` und jeweils -`devstate/pki/ca.pem`. Der dokumentierte Server-SAN und die bestehende -Renewalquelle enthalten beide Namen. Keine CA wird kopiert, ersetzt oder -rekonfiguriert, und keine Zertifikats-/Namensprüfung wird abgeschaltet. Fehlendes -CA-Material verweigert den jeweiligen TLS-Aufruf; Status weist den Teilfehler aus -und erhält die übrigen Readbackdaten. `inspect` ist ausschließlich die beschriebene -Metadaten-/Datenbankbaseline und behauptet keinen TLS-Healthnachweis. - -## Ablauf und Nachweise - -`inspect` liest ohne Zielveränderung eine aktuelle Baseline. Sie enthält die -Runtimeimage-ID, alte API-/Gateway-/PG-Container, nur erlaubte nicht geheime -Rolleneinstellungen, Loopbackports, Mounts, den tatsächlichen PG-Volume-Pfad samt -Inode/Device und den alten UI-Indexhash. Compose/Dockerfile/Dockerignore und -Ingressunits werden gehasht. Für `.env`, PKI und Jobschlüssel werden nur -Dateimetadaten aufgenommen; private Inhalte werden nicht geöffnet. Für die -nicht geheime Rootpolicy werden zusätzlich der unten beschriebene feste Hash, -das Schema und die bereits abgelaufene Deny-all-Grenze geprüft. Die -Docker-Templateauswahl gibt nur ausdrücklich benannte nicht geheime Einstellungen -aus. Keine vollständige Containerumgebung gelangt in Python oder einen Bericht. - -Die Datenbankprobe läuft als feste Read-only-Abfrage in einem konsistenten -Snapshot. Aus allen dauerhaften Plan-, Genehmigungs-, Job-, Outbox-, Permit-, -Receipt-, Audit-, Rollen- und Katalogtabellen verlassen nur Anzahl und -SHA256-Zeilenfingerprints PostgreSQL. Stabile Geräte-/Zertifikatsidentitäten und -die vollständige bestehende SQLx-Ledger 1–13 werden gebunden. Passive -Kontakt-/Synczähler und Beobachtungen dürfen fortschreiten. Bereits offene, -unbekannte oder laufende Jobs verweigern diesen Nachfolger. - -`prepare` arbeitet ausschließlich lokal aus dem geprüften Archiv und der explizit -angegebenen Baseline. Ein neues privates Caseverzeichnis wird genau einmal -angelegt. Der Offline-Paketcheck ersetzt keine reale Linux-Abnahme. - -`build` legt zuerst einen lokalen einmaligen Aufrufintent an. Auf dem Server -prüft der Runner erneut die vollständige Baseline, Migrationchecksummen und -unveränderte Deploymentkontrollen. Erst dann legt er den privaten Zielcase an, -schreibt Intent und Artefakte und startet einen festen systemd-Worker. Dieser -baut nativ für `linux/arm64` in seinem eigenen Kontext und einem neuen -`rust-discovery-server:script-v1-`-Tag. Er verändert weder Runtime-Tag, -Services, Datenbank noch UI. Nach dem Build müssen Quellen und Baseline erneut -übereinstimmen; erst dann entsteht ein erfolgreicher Buildbeleg. Ein -prozessübergreifender Lock serialisiert die Worker dieses Nachfolgers; er ersetzt -keine Koordination mit älteren Deploymenttools. - -`deploy` hat einen eigenen lokalen und entfernten Create-once-Intent. Der Worker -prüft alle Ausgangswerte und das tatsächliche erfolgreiche Candidateimage erneut. -Er hält API und Gateway kurz an; PostgreSQL und öffentlicher TCP-Ingress laufen -weiter. Nach dem Stop werden Historie, Container, PG-Volume und Index nochmals -gegen die Baseline geprüft; weitere Datenbank-Clientverbindungen sind unzulässig. -Dadurch können während der Migration keine normalen UI-/MCP-Schreibvorgänge oder -Agent-Jobstarts stattfinden. Ein rootprivates `pg_dump` und der alte Index werden -vor der Migration erhalten. Backupinhalte werden nicht zurückgegeben. - -Die feste Reihenfolge ist: - -1. Vollständiges Webarchiv vor jedem Publish prüfen; neue Hashassets create-only - ablegen. Existierende gleiche Hashdateien müssen exakt dieselben Bytes haben. - Alter Index, alte Assets und der bindgemountete Dist-Verzeichnisinode bleiben. -2. Runtime-Tag einmal auf die feste Candidateimage-ID setzen. Genau einen - Migrationscontainer mit festem Case-Namen starten und erhalten, auch bei - Fehlern. Keine automatische Entfernung oder zweite Migration. -3. SQLx-Zeilen 1–13 müssen vollständig unverändert sein; ausschließlich Version14 - mit erwarteter SHA384 darf hinzukommen. Sämtliche ursprünglichen - Historienfingerprints und Identitäten müssen unverändert bleiben. Der neue - MSI-Katalog ist leer, FORCE-RLS-geschützt, für `rmm_app` nur SELECT/INSERT und - mit aktivem Immutable-Trigger versehen. -4. Nur API und Gateway aus dem festen neuen Image starten. Verifizierte TLS- - Healthchecks und ehrliche private Authkonfiguration prüfen. Öffentlicher - Gateway liefert für UI, Login, Session, MCP und Verwaltungsrouten weiterhin404; - der Signierschlüssel verlangt weiterhin ein authentifiziertes Gerät. UID, - Ports, Mounts und geschlossene Root-/SYSTEM-/Faultgates müssen erhalten sein. -5. Erst nach diesen Backendnachweisen den bisherigen Indexhash abschließend - vergleichen und den neuen Index atomar veröffentlichen. Alle drei tatsächlich - privat über TLS ausgelieferten Dateien müssen ihre festen Bundlehashes haben. - Datenbank, geschützte Metadaten, PG-Volume und Rollen nochmals prüfen. - -Nachweise werden als einzelne fsync-gesicherte, unveränderliche Phasenbelege -erhalten. `passed` entsteht ausschließlich nach den Prüfungen. Die Quelle erzeugt -keine Jobs, Genehmigungen, neuen Versuche, Katalogrezepte oder Policyfreigaben. -WebUI-Login/CSRF/Plangenehmigung bleiben normale Produktpfade; kein Login- oder -Approvaltoken wird für diesen Ablauf gelesen oder erzeugt. Die spätere native -Skriptabnahme braucht weiterhin MCP → pending ohne Ausführungsartefakte → echte -simulierte Dev/Test-UI-Interaktion → Ergebnis, zuerst auf der Cloud-Linux-VM. - -## Geplante Bedienung, nicht ausgeführt - -Nach Rootreview, aktuellem Frozen-/Linuxnachweis und gesicherter Ausgangslage: - -```text -python3 deploy/cloud_script_console_upgrade_v1.py inspect --access-root /pfad/zum/hauptcheckout -python3 deploy/cloud_script_console_upgrade_v1.py prepare --baseline /pfad/zur/gespeicherten/baseline.json -python3 deploy/cloud_script_console_upgrade_v1.py build --id CASE --access-root /pfad/zum/hauptcheckout --execute-cloud-build -python3 deploy/cloud_script_console_upgrade_v1.py status --id CASE --access-root /pfad/zum/hauptcheckout -python3 deploy/cloud_script_console_upgrade_v1.py deploy --id CASE --access-root /pfad/zum/hauptcheckout --execute-cloud-deploy -python3 deploy/cloud_script_console_upgrade_v1.py status --id CASE --access-root /pfad/zum/hauptcheckout -``` - -Ein Aufruffehler oder verlorene Antwort erlaubt **nur `status` desselben Cases**. -Nicht `build`/`deploy` wiederholen, keinen neuen Case als Reparatur anlegen, keinen -Migrationscontainer entfernen und nicht pauschal auf das alte Image zurückrollen. -Readback funktioniert auch bei fehlendem oder nur teilweise hochgeladenem Case; -es erzeugt keine Zielpfade und startet keine Prozesse mit Wirkung. Neben den -erhaltenen Belegen liest es tatsächlich aktuelles Image, Historie, Container, -Kontrollmetadaten und privat ausgelieferte UI-Hashes. Einzelne Lesefehler werden -als solche ausgewiesen. Es repariert keinen Zustand. - -Ein Fehler nach dem Service-Stop kann beide Rollen angehalten lassen. Ein Fehler -nach dem Tag-/Migrationswechsel kann bereits Schema14 bedeuten. Das ist ein -bewusst erhaltener unvollständiger Case für eine konkret geprüfte manuelle -Fortsetzung, keine automatische Wiederholung oder Datenbankrücksetzung. Ein -späterer Rollback muss insbesondere neu gespeicherte 1.20-Pläne berücksichtigen. - -Die alten Quellen unter `/opt/rust-discovery` bleiben historisch erhalten. Der -neue Runtimebezug ist der Casekontext mit seinen Hashes, nicht die Behauptung, -dass dieser alte Checkout nun die laufenden Produktbytes darstellt. Ein späterer -Deploymentlauf muss diese tatsächliche Runtimebasis berücksichtigen. - -## Tatsächliche lokale Prüfung und Grenzen - -Python-Syntax und die erzeugte vollständige Workerquelle sind kompilierbar. -Ein ausschließlich temporäres, danach verworfenes Paket mit ausdrücklich -synthetischer Baseline enthielt exakt158Frozen+3Deploymentdateien sowie die drei -richtigen Webdateien. Alle Einzelhashes stimmen. Create-once verweigert den -zweiten Schreibversuch. Die tatsächliche CAS-Funktion verweigert unabhängig -veränderte Runtimeimage-, PG-Volume-, Migrations-, Jobhistorien-, Index-, Kontroll- -und Containerwerte. Die tatsächliche `status`-Funktion auf einem fehlenden Case -legt nichts an und startet keinen Unterprozess. Frozen158 blieb unverändert. -Beleg: `devstate/script-console-cloud-upgrade-v1-local-review/guards.json`. - -Die vorhandene Compose-CLI-Hilfe wurde tatsächlich lokal gelesen; insbesondere -wird das dort bei `run` nicht vorhandene `--no-build` nicht verwendet. Es wurden -keine SQL-Abfragen gegen eine echte Datenbank und keine Cloudaktionen durch den -Ersteller dieses Nachfolgers ausgeführt. Die SQL-, ARM64-, Stillstands-, Backup-, -Migrations-, Ingress- und tatsächlichen UI-Nachweise sind **noch offen** und -werden erst durch den echten Case belegt. Produktions-OIDC, Clientinstallation, -Fullprofileaktivierung und eine native Skriptwirkung sind keine Ergebnisse eines -Serverbuilds oder dieser Bereitstellung. - -### Tatsächlicher Inspect-Befund und erhaltene Rootschließung - -Beim ersten durch den Hauptagenten ausgeführten **rein lesenden** Serverinspect -verweigerte der erste Guard die tatsächliche bestehende Konfiguration: -`RMM_DEV_ROOT_ENABLED=true` gilt unverändert seit der MVP-Abnahme für API und -Gateway. Root ist durch die abgelaufene Policy geschlossen, nicht durch ein -falsches Flag. Dieser Guardfehler war kein Build-, Deployment-, Tag- oder -Migrationserfolg; es wurde kein Cloud-Buildcase erzeugt. - -Die korrigierte Quelle verlangt genau diesen belegten Bestand: Rootflag `true`, -Rootpolicydatei `/root-policy/policy.json` im bereits bestehenden schreibgeschützten -Bindmount, SYSTEM-Flag und SYSTEM-/Faultdateieinstellungen nicht vorhanden, -DeliveryFaults exakt `false`. Zusätzlich liest sie ausschließlich die bekannte -nicht geheime Policy und verlangt SHA256 -`cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`, -übereinstimmend mit dem Main-MVP-Closeout und dem aktuellen System-Readback des -Hauptagenten. Geschützter Eigentümer10001, reguläre Datei0600, Einzelhardlink, -Höchstgröße64KiB und der sichere Elternpfad werden geprüft. Schema1, -Developmentprofil, feste oberste Felder, Scope-Liste und ein expliziter -Zeitzonenbezug der Ablaufzeit sind erforderlich; die Ablaufzeit muss bereits -vergangen sein. Damit verweigern sowohl bisherige als auch neue Serverversion -sämtliche Rootscopes. Der volle feste Hash bindet auch alle historischen -Scopeinhalte; die Quelle akzeptiert keine beliebige abgelaufene Ersatzpolicy. - -Flag, Policy und Mount werden weder verändert noch neu angelegt. Die gleichen -Prüfungen gelten für neue Baseline, Build-CAS, Deploy-CAS und Nachbelege. Bei -Readback werden Policy-Lesefehler als Teilfehler erhalten. Ein neuer Inspect nach -dem korrigierten Sourcefreeze sowie alle tatsächlichen Cloud-Build-/Deployment- -Nachweise stehen weiter aus. Die frühere allgemeine Aussage „keine Cloudaktion -durch den Ersteller“ bezeichnet weiterhin diese Subagentenarbeit; der hier -dokumentierte Read-only-Inspect wurde vom Hauptagenten ausgeführt. - -Der zusätzliche lokale Guard prüfte die tatsächlichen Funktionen mit synthetischen -Dateimetadaten und nicht geheimen Umgebungswerten: unbekannter Policyhash, -unbewiesenes Rootflag, geänderte Flags/Mountbindung sowie zwölf Schema-, Zeit- und -Metadatenabweichungen werden verweigert. Um die nachgelagerten Schema-/Zeitguards -isoliert zu erreichen, wurde ausschließlich in diesen Fixturefällen die -Digestfunktion ersetzt; dies ist kein Nachweis über tatsächliche Serverpolicybytes. -Die echte Hashprüfung wurde separat mit unverändertem SHA256 ausgeführt und -verweigerte die fremden Fixturebytes. Beide bestehenden Rollen benötigen den -geschlossenen Policybeleg. Syntax/Workerquelle und Frozen158 blieben gültig. -Beleg: `devstate/script-console-cloud-upgrade-v1-local-review/closed-policy-guard.json`. - -Der gezielte TLS-Guard ruft die tatsächliche HTTPS-Hilfsfunktion mit gemockten -Verbindungsobjekten für alle drei festen Endpunkte auf: jeweils richtige CA, -TCP-Loopbackziel und unverändertes SNI, keine echte Verbindung. Fehlende API-CA -wirft einen Lesefehler ohne Fallback auf die Gateway-CA; falsche Port-/Namenspaare -werden verweigert. Dieser lokale Guard ersetzt keine echte TLS-Abnahme. diff --git a/docs/script-console-cloud-upgrade-v2.md b/docs/script-console-cloud-upgrade-v2.md deleted file mode 100644 index 9ea4c5a..0000000 --- a/docs/script-console-cloud-upgrade-v2.md +++ /dev/null @@ -1,131 +0,0 @@ -# Cloudserver-Nachfolger v2: kanonische Docker-Mountreihenfolge - -`deploy/cloud_script_console_upgrade_v2.py` ist ein neuer, getrennter Nachfolger. -Der bisherige v1-Runner mit SHA256 -`e88b3d841bac70ebb0bf0d9696bab745c84a17aee9a947a99ff48a60dc18565e` -und Case `499e13fb-7433-405d-9a98-0c27ca864246` bleiben unverändert erhalten. -Die Bereitstellungsgrenzen, Quellen, TLS-CA-Zuordnung, Rootpolicybindung und -Vor-/Nachbelege aus [v1](script-console-cloud-upgrade-v1.md) gelten weiterhin. -Es gibt keine allgemeine CAS-Lockerung und keinen automatischen Wiederholpfad. - -## Tatsächlicher Fehler des ersten Cases - -Der Hauptagent hat den v1-Buildworker einmal gestartet. Das erhaltene -`build-failure.json` meldet `RuntimeError`, Workerzeile402 → -`before_guard`208 → `require`5. Zeile208 vergleicht vollständige -Containerobjekte einschließlich der unsortierten Mountlisten. Docker lieferte -dieselben Mountobjekte bei späterem Inspect in einer anderen Reihenfolge. - -Der lokale, rein lesende Vergleich der Originalbaseline und des tatsächlichen -Status ergab: - -- API vorher: `/root-policy`, `/web`, `/pki`, `/jobs`; nachher: `/jobs`, - `/root-policy`, `/web`, `/pki`. -- Gateway vorher: `/pki`, `/jobs`, `/root-policy`; nachher: `/jobs`, `/root-policy`, - `/pki`. -- Nach Sortieren sind **sämtliche vollständigen Mountobjekte identisch**. - Container-IDs, Images, Einstellungen und alle übrigen Containerattribute sind - identisch; PostgreSQL wurde auch in seiner Listenreihenfolge nicht verändert. - Controls, Datenbank und alter Index stimmen mit der Baseline überein. -- `build_log_bytes` ist `null`. Der Worker scheiterte am vorgeschalteten CAS, - bevor `build.log` geöffnet und `docker build` aufgerufen wurden. Es gibt weder - einen erfolgreichen Candidatebuild noch Deploy-, Tag- oder Migrationswirkung. - -Erhaltene Originalbezüge: - -| Beleg | SHA256 | -| --- | --- | -| Case-Manifest | `305de92d11b90184589210fd2b0f301ecaf5d9a75467bff5e81c8518588ad416` | -| Originalworker | `6d056e6385ba67c00414de3dc626a51b4f022947bee6381d92908acce3a2b4a9` | -| Tatsächlicher Status | `ed2fcd82cdca7692d9c5d122e4cccc1b5aa5a5dc6fec4ac9035ecef647b8e8ef` | - -Diese Bezüge werden auch im v2-Manifest als `supersedes_failed_case` gebunden. -Der alte Case bleibt ausschließlich lesbar und wird nicht fortgesetzt oder -erneut gestartet. - -## Enger Fix - -`canonical_mounts` verlangt eine Liste vollständiger Objekte mit absolutem -`Destination` und Zeichenketten für `Type` und `Source`. Doppelte -Zieldestinationen werden verweigert. Anschließend wird ausschließlich die -Reihenfolge anhand `(Destination, Type, Source)` stabilisiert. Alle Objekte und -Attribute einschließlich `RW`, `Mode`, `Propagation`, `Driver` und `Name` bleiben -vollständig in der Darstellung und damit im strikten CAS enthalten. - -Die Kanonisierung erfolgt direkt nach dem Docker-Read in `container()`. Sie gilt -somit für den ersten Inspect, jeden Worker-/Deploy-Snapshot, Nachbelege und den -Status. `before_guard` und `after_guard` behalten ihre vollständigen -Objektvergleiche. Eine geänderte Quelle, ein Schreibrecht, Volume, Mounttyp oder -beliebiges weiteres Attribut wird weiterhin verweigert. - -Nur neue lokale/entfernte v2-Cases und Candidate-Tags werden verwendet. Der -prozessübergreifende Workerlock bleibt mit v1 geteilt. Frozen29461892 mit158 -Dateien, drei separate Deploymentdateien, Web49 mit drei Dateien, unverändertes -Dockerfile, Compose, Ingress und Rootpolicy bleiben erhalten. Es werden weder -RMM-Jobs noch Genehmigungen oder Client-/Policyänderungen vorbereitet. - -## Geplante Fortsetzung, nicht ausgeführt - -Nach unabhängigem Rootreview ist zuerst ein **frischer Read-only-Inspect mit v2** -erforderlich. Keine alte Baseline umschreiben und keinen v1-Case umdeuten. Erst -mit dem neuen Baselinebeleg darf ein neuer v2-Case offline vorbereitet und nach -gesonderter konkreter Prüfung einmal gestartet werden: - -```text -python3 deploy/cloud_script_console_upgrade_v2.py inspect --access-root /pfad/zum/hauptcheckout -python3 deploy/cloud_script_console_upgrade_v2.py prepare --baseline /pfad/zur/neuen/v2-baseline.json -python3 deploy/cloud_script_console_upgrade_v2.py build --id NEUER_CASE --access-root /pfad/zum/hauptcheckout --execute-cloud-build -python3 deploy/cloud_script_console_upgrade_v2.py status --id NEUER_CASE --access-root /pfad/zum/hauptcheckout -``` - -Ein Build- oder Deployaufruf nach Antwortverlust bleibt verboten; ausschließlich -Status desselben Cases. Der historische v1-Case wird weiterhin ausschließlich -mit dem eingefrorenen v1-Runner gelesen. Dieser neue v2-Quellstand hat durch den -Subagenten weder einen SSH-Aufruf noch einen neuen Cloudcase, Build, Tagwechsel, -Migrationslauf oder Deployment ausgeführt. - -## Tatsächliche lokale Prüfgrenzen - -Der gezielte Guard nutzt die erhaltenen echten Originalbaseline-/Statusbytes: -alle Containervergleiche stimmen nach der Kanonisierung überein; alle möglichen -Reihenfolgen der bestehenden Mountlisten liefern dieselbe vollständige Liste. -Geänderte Source-, RW-, Mode-, Propagation-, Type-, Driver- und Namewerte bleiben -abweichend und werden durch den tatsächlichen CAS verweigert. Duplikate und -falsche Typen werden vor dem Vergleich verweigert. Python und erzeugte -Workerquelle sind kompilierbar; Originalrunner, Originalcase und Frozen158 bleiben -unverändert. Der lokale temporäre Paketcheck bindet weiterhin exakt161Quell- und -drei Webdateien sowie den Originalfehlerbezug. Dies ersetzt keine neuen nativen -Servernachweise. - - -## Tatsächlich gestarteter neuer Fall - -Nach Rootreview wurde ein neuer Remote-Readonly-Inspect ausgeführt, -Baseline-SHA256 -`ad4e0ee543cb4f9d995f57696829ab868422be7d57aba6a404f0a49a5cbd4d4a`. -Danach separater neuer Fall `14dcc27d-e3ba-4089-9a43-74fd63a9382d`, -Manifest-SHA256 -`43d4af86a81578ccd4ab46c99a50c6e4e4030178a1379784cbcacb55d52c3717`. -Root startete dessen Buildworker einmal; tatsächlicher Status bestätigt -Buildlog und unveränderte161 Eingaben. Build noch ohne Erfolgsbeleg; bestehendes -Serverimage unverändert, kein Deploy-/Migrationsaufruf. Weitere Beobachtung -verwendet ausschließlich `status` dieses Cases. - - -Getrennter tatsächlicher Status desselben Falls bestätigt nun **Build bestanden**: -ARM64-Candidateimage -`sha256:6f8383f7c762ac77ed1013c94eeafa2b76838c00aec358a375f5847645ea87ec`. -Alle161Quelldateien unverändert, laufendes Image weiterhin25697f94, -keine Migration und keine Jobs/Genehmigungen. Der Buildbeleg ist kein -Deployment- oder WebUI-/Client-Abnahmenachweis. - - -Die anschließende einmalige Bereitstellung wurde separat gestartet und ihr -Status zurückgelesen: **Deployment bestanden**. API/Gateway laufen mit dem -oben genannten ARM64-Image als UID10001 und weiterhin ausschließlich an den -privaten Loopbackports. Datenbankbackup bleibt privat; Migration14 ist angewandt, -Checksummen1–13 sowie ursprüngliche Ledger-/Job-/Audit-/Identitätsgeschichte -identisch. Alle drei Webdateien sind per geprüftem TLS bytegleich ausgeliefert; -Index wurde zuletzt atomar veröffentlicht. Öffentliche Verwaltungsrouten bleiben -geschlossen. Keine Jobs, Freigaben oder Root-/SYSTEM-Policyöffnung entstanden. -Das qualifiziert die Bereitstellung, noch keinen nativen Skriptauftrag. diff --git a/docs/script-console-contract-proposal.md b/docs/script-console-contract-proposal.md deleted file mode 100644 index b0ffe06..0000000 --- a/docs/script-console-contract-proposal.md +++ /dev/null @@ -1,277 +0,0 @@ -# Skriptkonsole: Root-/SYSTEM-Vertrag1.20 und tatsächliche Nachweise - -> **Aktualisierung1.20, 2026-11-14:** Der User und Rootreview haben den nun in -> Spezifikation0.1, project-decisions und development dokumentierten Vollwartungs- -> vertrag beschlossen. Der folgende ursprüngliche Entwurf ist als historische -> Herleitung zu lesen: Insbesondere „kein neues Wirefeld“ und die Beibehaltung -> des beschränkten Generalprofils als Wartungsruntime sind überstimmt. Aktuell -> gilt das additive `privileged_script_profile="full_maintenance_v1"`, getrennte -> explizite Policyversionen und eine eigene Linux-Helperroute. Kein stilles -> Erweitern von General/APT/SCM/MSI. Quelle/Build/Unit/Native weiterhin getrennt. - - -**Ursprünglicher Entwurfsstand**, Basis `287a784`: Damals noch nicht -beschlossen oder implementiert. Der aktuelle beschlossene Vertrag und die -späteren tatsächlichen Quellen-/Prüfnachweise stehen oben und am Dateiende. -Dieser neue Fokus ersetzt die EXE-Priorität; der EXE-Normpatch bleibt ein -unbeschlossener separater Archivstand. Vollständige Pflichtdokumente wurden -gelesen; Spec1.19/PD/Dev sind bytegleich zum zuvor vollständig gelesenen Stand. -Hier werden nur vorhandene Pfade auditiert und konkrete Änderungen vorgeschlagen. -Kein Produkt-/Norm-/APIcode, Build, VMkontakt oder Ausführungsjob geändert. - -## Bereits vorhanden und tatsächliche Lücken - -`web/src/main.tsx`75–90 hat bereits vollständigen UTF-8-Editor, Linux/Windows- -Plattformwahl, feste Interpreter, erwartete stdout-Nachbedingung und explizite -Identitätsauswahl. Planansicht/Recheck/Submit/Approval bestehen. Operations- und -Jobdetails152–165 pollen tatsächlich Zustand/Ergebnis und bieten Abbruch an. -Ausgabe erscheint bisher nur im allgemeinen JSON, nicht als lesbare Konsole. -SYSTEM ist für RunScript in UI, Domain, Backendpolicy und Helper bewusst gesperrt. - -Linux-Rootskripte existieren: zentral `root_policy.rs` mit `allow_root_scripts`, -`root:execute` und den allgemeinen Skriptrechten; lokal unabhängiges -`allow_root_scripts`, NativeClock/RootSync und atomarer Originalgrantverbrauch. -`privileged-helper::script` nutzt den vorhandenen Linux-Adapter. Dessen -`process::run` hat Prozessgruppe, feste Umgebung, Timeout und beschränkte Pipes, -aber **keine laufende Cancel-/Fenceabfrage**. Ein Timeout oder unbelegtes Ende -wird Unknown; ein Kill beweist keine rückgängig gemachten Wirkungen. - -Windows hat einen sicheren PowerShell-Datei-/JobObject-Pfad in `actions.rs` und -`process.rs`, ist aber ausdrücklich LocalService/SID19. Ein Umbenennen der -Identität wäre falsch. SYSTEM muss unter dem tatsächlich authentisierten -SYSTEM-Helper/SID18 starten und dessen privaten Arbeitsbereich verwenden. -Intent/Abandon/RawMirror sind vorhanden; WindowsClock bleibt ohne echten -TrustedClock-Nachweis geschlossen. Linuxbelege ersetzen diesen nicht. - -Der aktuelle Protobufvertrag hat nur `JobResult.stdout/stderr`; keinen -JobOutputChunk und keinen implementierten JobProgress-Outputstream. Kleinster -vollständiger Batch-Skriptkonsolenpfad: während Ausführung echte Statusanzeige, -Laufzeit und Cancel-Anforderung; begrenzte stdout/stderr mit Rohbytes nach -dauerhaftem Ergebnis. **Keine behauptete Liveausgabe oder interaktive PTY.** -Falls Root/User Ausgabe bereits während der Ausführung verlangt, ist dafür ein -separat zu prüfender begrenzter dauerhafter Chunkvertrag erforderlich; kein -UI-Polling von flüchtigen Helperdateien oder vorgetäuschtes Streaming. - -## Enger Funktions- und Autoritätsvertrag - -Weiterhin genau `RunScript`, kein neues Actionformat, universeller Execute- -Endpoint oder Terminalserver. Default bleibt `agent_service`; Root/SYSTEM nur -ausdrücklich gewählt. Die kompletten eingegebenen UTF-8-Bytes, Interpreter, -Argumente, Ausgabe-/Zeitlimit, Identität, Plattformvariante und gegebenenfalls -vorhandenes PowerShell-RemoteSigned-Profil werden **vor** Hash/Planbindung -festgeschrieben. Kein BOM-/Zeilenenden-/Prolognachrüsten nach Genehmigung. -Nicht-ASCII-PowerShell braucht das bestehende explizite BOM im Editorinhalt. -UI darf Argumente zunächst als feste leere Liste halten; keine freien -Executablepfade, URLs oder `-Command`-/EncodedCommand-Launcherparameter. -Linux verwendet `/bin/sh -- ` oder nachgewiesenes `/bin/bash`; -Windows fest WindowsPowerShell5.1 mit `-NoLogo -NoProfile -NonInteractive`, -optional genehmigtem prozessbezogenen RemoteSigned und `-File `. -Kein pwsh-Fallback oder ExecutionPolicy-Abschalten, GPO bleibt vorrangig. - -Jeder Auftrag bleibt pending_approval ohne Jobs/Outbox/Offers/Grants bis zum -tatsächlichen WebUI-Klick. Ersteller **und** Freigeber benötigen ihre aktuellen -Operationsrechte und `scripts:execute`, zusätzlich `root:execute` bzw. -`system:execute`. Keine neuen allgemeinen Rechtebezeichner, kein Autoapprove. -Zentrale geräte-/principal-/generations-/helperhashgebundene Policy und lokale -Helperpolicy müssen privilegierte Skripte zusätzlich ausdrücklich zulassen. -Linux verwendet das bestehende Opt-in; Windows erhält ein versioniertes -`allow_system_scripts`-Opt-in, alte SCM/MSI-Settings verweigern weiter Skripte. -Interpreter und Maximalbudget sind feste überprüfbare Grenzen, keine -Befehlsblockliste. Erforderlich bleiben bisherige Plattform-/Interpretercaps, -Helperpins und signedSync; SYSTEM braucht zusätzlich die enge -`system:run_script`-Capability. Nichts davon aus Build oder Bootstrap publizieren. - -Kleinste erste Grenzen: Skript1–32768Bytes, insgesamt höchstens65536Bytes -stdout+stderr, Laufzeit1–300s für Linux-Root wie der vorhandene zentrale Deckel; -SYSTEM zunächst1–120s wie die vorhandene Helper-Lane. UI validiert diese -tatsächlichen Grenzen vor Planung. Größere Budgets sind keine stillen Defaults. -Keine Wire-/JobPayload-/Grantcodecänderung nötig; Linux- und bisherige -agent_service-/PowerShell-RemoteSigned-Goldens bleiben erhalten. - -## Tatsächliche Privilegien, Sandbox und Reboot - -**Ein genehmigtes allgemeines Root-/SYSTEM-Skript ist bewusste Volladministration -im tatsächlich gestarteten Dienstkontext, keine sichere Standardaktion.** -Es kann Dateien/PKI/Journale, Konten, Dienste, Paketmanager, Egress und gegebenenfalls -den OS-Neustart beeinflussen oder andere Programme nachladen. Der gebundene -Skripttext pinnt nicht automatisch alle später von ihm gelesenen Programme und -Netzbytes. Keine Befehlsblockliste kann das zu einem harmlosen Profil machen. -Ein Angreifer mit genehmigtem Rootcode ist außerhalb der Integritätsgarantie -dieses lokalen Helpers; Benutzer mit diesem Recht müssen als Hostadministratoren -vertrauenswürdig sein. Die Freigabe ist niemals eine KI-Dauerberechtigung. - -Der aktuelle Linux-Generalhelper ist tatsächlich UID0, hat aber unter anderem -PrivateNetwork, ProtectSystem, begrenzte Capabilities und Seccomp. Diese Grenzen -bleiben im ersten Integrationsslice **unverändert**; manche Skripte werden damit -ehrlich fehlschlagen. Sie sind kein zugesicherter Sandboxschutz gegen allgemeinen -Rootcode, insbesondere nicht gegen Delegation an vorhandene privilegierte -Betriebssystemdienste. UI muss UID0/SID18 und den konkreten qualifizierten -Runtime-/Policykontext zeigen, nicht „uneingeschränkte Hostrechte“ erfinden. -Falls uneingeschränkter Hostkontext benötigt wird, braucht er einen gesonderten -explizit geprüften und gepinnten Bootstrapprofilwechsel; keine stille Entgrenzung -der vorhandenen Helper-/APT-/MSI-Dienste im Skriptslice. - -Eine Skriptgenehmigung erlaubt die sichtbaren Skriptbytes und deren mögliche -administrative Wirkung, **keinen zusätzlichen RMM-Reboot-/Paketjob**. Skript- -Exit0 beweist nur Prozess-/gebundene stdout-Nachbedingung, keine Paketabnahme. -Ein vom Skript ausgelöster Neustart ist kein erfolgreicher typisierter Rebootjob: -ohne dessen eigenen unabhängigen Vorher-/Nachher-/Fristbeleg bleibt der -Skriptversuch bei fehlendem Ergebnis Unknown. Keine implizite OS-Rebootabnahme, -kein nochmaliges Ausführen nach Reconnect und keine aus einem Warntext abgeleitete -allgemeine Erlaubnis, tatsächliche Testreboots/Updates durchzuführen. - -## Dauerhaftigkeit, Abbruch und lesbare Ausgabe - -Dieselbe OriginalRequest-/Plan-/Grantprüfung, ein einziger atomarer Start, -Outcome zuerst dauerhaft, dann Jobjournal/Ergebnis und normaler SignedSync. -Windows verwendet genau den vorhandenen Intent→MayHaveDispatched→Helper-/ -RawFullTupleMirror-Pfad. Abandon ausschließlich bei belegtem Nichtdispatch, -ohne Script-/Temporärdateiwirkung; Originalgrant nie leeren, Unknown/Missing- -Guards nie lockern. Keine zweite Zustandsmaschine oder Ausführungswiederholung. - -Linuxprozess erhält einen tatsächlichen kooperativen Cancel-/Fencecallback -innerhalb der bestehenden Poll-/Pipe-Schleife. Windows nutzt den vorhandenen -JobObject-Prozessbaum mit tatsächlichem SYSTEM-Token und entsprechender -Fence-/Cancelprüfung. Nur der eigene beobachtete Prozessbaum darf begrenzt -beendet werden; kein globales Kill. Abbruch/Timeout nach möglicher Wirkung -bleibt Unknown. Kernelbestätigtes Prozessende ist kein NoEffect-/Rollbackbeweis. -Ein durch Root/SYSTEM abgespalteter Dienst/Task kann außerhalb des beobachteten -Baums weiterwirken; keine vollständige Prozesskonfinierung behaupten. Wenn -Beendigung nicht bestätigt ist, behält der Helper eigene Child-/Handlebindung -und die Ressourcensperre; kein neuer Start aus bloßem Pipe-/Channelclose. - -UI zeigt getrennte stdout/stderr, Exitcode, Trunkierung, tatsächliche Identität, -Zustand/Unknown und Cancelstatus. Rohbytes bleiben unverändert gespeichert; -Textdarstellung bekommt explizite Decoder-/Encodingangabe und optional Byteansicht, -keine stillen Ersatzzeichen als Originaloutput ausgeben. Nur Reacttext, kein -HTML/ANSI-Scriptinterpretieren oder zustandsändernde Aktion aus Logtext. -Anzeigenaliase und später mutierte APIobjekte müssen gegen gespeicherte -Planpayloadbytes geprüft werden, auch für Linuxroot und WindowsSYSTEM. - -## Reihenfolge und kleinste Dateigrenzen nach Rootreview - -1. Root beschließt den Skriptvertrag1.20; EXE1.20 wird nicht übernommen. -2. UI-Konsole/Rootpfad und Cancel-/Outcomeownership lokal qualifizieren; - danach tatsächlicher Cloud-Linux-RunScript mit WebUI-Genehmigung, stdout/stderr, - Rootidentität, einmaligem Grant und verlorenem Reply/Abbruch korrekt nachweisen. -3. SYSTEMpfad sourceimplementieren, portable Guards Linux-first→Windows; - erst nach echter Clock-/Peer-/Helper-/PERSISTqualifikation Windows-Skriptjobs - per WebUI. Keine Windowsfähigkeit aus dem Linuxnachweis ableiten. - -| Scope | Engste Änderungen nach Freigabe | -| --- | --- | -| Norm | Root: Spec1.20/PD/Dev für Skripte statt EXE; explizite Administrator-/Rebootgrenzen | -| Web | bestehende main/api/safety+betroffene Tests: vorhandenen Editor behalten, SYSTEM-Option für RunScript, verifiedScriptProjection, lesbare Ausgabe/Cancelstatus | -| Linux | agent-linux actions/process; privileged-helper script/main/control und Agenthelper-Routing nur soweit Cancel/gebundene Ownership nötig; keine stille Unitlockerung | -| Windows | actions/process um explizite getrennte LocalService-/SYSTEM-Einstiege; helper_system/helper_runtime/runtime um RunScript unter bestehenden Intent-/Mirrorgrenzen; private gehaltene SYSTEM-Skriptdatei | -| Domain/Backend | jobs.available_for/valid_helper_denial_shape; windows_policy und vorhandene DTO-/Gateprüfungen, bisheriger Rootpfad erhalten; neue lokale bool-Settings nur versioniert und None-omit | -| Core/Protocol/SQL | keine neue Zustandsmaschine oder Job-/Grantfelder geplant; bestehende Codecs/Unlocks unverändert, Chunktransport ausdrücklich nicht Bestandteil des ersten Batchpfads | - -Alle Angaben oberhalb sind Sourceaudit und Entwurf. Tatsächliche privilegierte -Skript-/Abbruch-/Runtimeabnahmen bleiben offen, bis Root sie getrennt ausführt. - -## Implementierungsstand des genehmigten1.20-Schnitts - -Lokal implementiert: additives strikt nichtnull Profil am Ende der RunScript- -Action, Identitäts-/Capability-/Laufzeit-/Outputgrenzen und unveränderte Legacy- -Bytes; drei echte Rust-Codecplanfamilien in `tests/script_console/codec-golden.json`. -Zentrale Rootversion2 und SYSTEMversion3 erfordern zusätzliche explizite -`allowed_script_profiles`; beide Akteure benötigen aktuelle Skript- und jeweilige -Privilegrechte. Eigene Linuxroute `RMM_FULL_MAINTENANCE_HELPER_SOCKET` mit -`RMM_FULL_MAINTENANCE_POLICY_FILE`, lokalem FullMaintenanceprofil und unverändertem -Sharedledger; bestehende General-/APT-Dienste werden nicht geändert. - -`deploy/linux/rmm-full-maintenance-helper.service` ist ein reviewbarer, noch -nicht installierter vollständiger Hostkontext ohne die General-Sandbox. Vor -Zieländerung sind tatsächliche zusammengesetzte Unit, Gruppen-/Socket-/Pinpfade, -Rootbesitz, Journale und Inodes zu prüfen. Der eigene Socket und Pin müssen -explizit auf das FullMaintenanceprofil zeigen; kein Fallback auf General/APT. -Eine passende Bootstrapkonfiguration enthält `profile=full_maintenance_v1`, -`allow_root_scripts=true`, `allowed_script_profiles=["full_maintenance_v1"]`, -leere allowed_services, allow_reboot=false und keinen apt_provider. Das letzte -Flag begrenzt nur die typisierte Helperaction, nicht den genehmigten Rootcode. - -Laufender Linuxabbruch benutzt ausschließlich EOF/Halbschließen des vorhandenen -originalrequestgebundenen, beidseitig peergeprüften Unixstreams. Der Agent -beobachtet konkreten Attempt-Cancel, aktuelle Kanalgeneration und lokale Clock; -der Helper beobachtet Peer/EOF/Clock. Ein abgelaufenes Startticket beendet keinen -bereits gültig begonnenen Prozess. Eigene Prozessgruppe wird beendet und unter -beibehaltener lokaler Effektlock bis zum belegten Ende lebender Mitglieder -beobachtet. Zombieeinträge werden anhand ihres tatsächlichen /proc-Status von -lebender Wirkung unterschieden, bei unklarer Beobachtung bleibt die Lock erhalten. - -Windows besitzt einen gesonderten SYSTEM-Skriptpfad nach atomarem Verbrauch, -mit privater gehaltenem Skriptdateihandle, exakt erhaltenen Bytes, festem -PowerShell5.1-argv und JobObject. Clock/Peer/Intent/STOP bleiben beobachtet, -Originalgrant wird unmittelbar vor Prozessstart frisch geprüft. Nach Start -bleibt seine Startfrist eine Startfrist. Unklare Prozessbereinigung behält -JobObject/Prozesshandles und Helperlane bis zum belegten Ende. SID18 und Profil- -/Skripthash werden im Ergebnis gebunden; LocalService-Admission bleibt separat. -Keine neue Windowscapability ist durch diese Quellen öffentlich aktiviert. - -Tatsächliche Zwischenprüfung:22 Domain-Tests lokal im unveränderten Offline- -Builder9a76ad37… bestanden, einschließlich alter Bytegoldens und neuer Profile. -Weitere Prüfungen und native Cloud-Linux-/Windows-Abnahmen sind noch offen; -kein neues RMM-Zielprofil installiert, kein Job gestartet oder genehmigt. - -## Eingefrorene lokale Qualifikation1.20 - -Der abschließende lokale Lauf ist vollständig:157 Compiler-/Include-/Fixture-/ -Deploymentinputs unverändert vor/nach; Manifest -`60a50262f9f8d85c11eb58e1a9e0f6e03be6cd5db7a59bc1745fb7d9dc8a6f65`. -Linuxfmt/Workspace-Alltargets-Clippy mit -Dwarnings bestanden;284 lokale Tests -bestanden und zunächst5DB-Fälle ausgelassen, anschließend sämtliche45Servertests -inklusive dieser5 in frischem internem PostgreSQL bestanden (0ignored). WindowsGNU -Default/Systemhelper-Alltargets-Clippy bestanden; keine native Windowsprüfung. -Release-Linux-Unitlisten und Agent-/Helper-/Serverbinaries sind gebunden gebaut, -noch nicht auf Zielen ausgeführt oder installiert. Vorherige unvollständige -Packvorbereitungen sind separat protokolliert, keine bestandenen Qualifikationen. - -Der separate Create-once-Linuxrunner ist vorbereitet, noch nicht ausgeführt; -kein Compilerinput wurde dafür verändert. Konkrete lokale Belege, geplante -Befehle, Erwartung83PASS/5expliziteDBignored auf Cloud-Linux und die noch nötige -Erhaltungs-/Bootstrap-/WebUI-Abnahme stehen in -[deploy/linux/full-maintenance-README.md](../deploy/linux/full-maintenance-README.md). - - -## Separater Reviewblocker nach der ersten Qualifikation - -Ein unabhängiger Review fand nach Packde34 die fehlende tatsächliche laufende -Linux-Fullhelperbinarybindung. Dieser Pack bleibt unverändert früherer Beleg -und berechtigt keine Fullaktivierung. Ein enger separater Corefix bindet -`helper_binary_sha256` ausschließlich im neuen Fullschema/Pin/Policy/Probe und -zentralen Scope; Root hält/prüft sein echtes laufendes Image, Agent993 benötigt -keinen fremden Root-/proc-Zugriff. General/APT lassen die neuen None-Felder -vollständig aus. Core-Review erfolgt vor neuem Build; neue tatsächliche -Quellen-/Unit-/VM-Belege werden separat ergänzt, nicht vom alten Pack abgeleitet. -Der Native-Runner ist vorbereitet und lokal geparst, noch nicht ausgeführt. - - -## Neue tatsächliche lokale Qualifikation nach Binärpinfix - -Der neue Pack29461892 ist ein eigener Beleg; de34 und der ursprüngliche Reviewdiff -bleiben erhalten. Manifest -`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd`, -158 Inputs unverändert vor/nach. Format und Linux-/beide Windows-GNU-Clippyprofile -mit-Dwarnings bestanden;285 lokale Tests bestanden, anschließend alle45Servertests -mit tatsächlichem isoliertem PostgreSQL einschließlich vorheriger5DBignored -bestanden (0ignored). Der neue Rootimage-Test prüft in jedem Eigentümerpfad -Sicherheitsassertions, kein stilles Skip. Native Linuxlisten22/16/6/45 gebaut, -auf der Cloud-VM noch nicht ausgeführt; neue Erwartung84PASS/5expliziteDBignored. -Der Native-Runner ist separat ausdrücklich auf diesen neuen Pack gebunden und -lokal geparst; seine Supportquellen/Scopetatsachen sind in Intent und Readback -streng geprüft. Bisher keine SSH-, VM-, Enrollment-, Dienst-, Policy-, Job- oder -Capabilityänderung durch diesen Strang. Aktueller Primärstand und noch geplante -Bootstrap-/WebUI-Abnahmen: `deploy/linux/full-maintenance-README.md`. - -## Tatsächlich nativ auf Cloud-Linux geprüft - -Der korrigierte158-Input-Pack29461892/ddd1a78d wurde durch Root nach beiden -Source-Reviews auf der tatsächlichen Cloud-Linux-Test-VM ausgeführt. Fall -`7b61ce46-7913-492b-9c6b-414a0c2b6ffc`: Domain22, Linuxruntime16, -Helperpolicy6, Serververträge40PASS plus5explizite DBignored; insgesamt84PASS. -Alle vollständigen Listen wurden zuerst geprüft. Die fünf DBfälle sind nur -im separaten isolierten45er-PostgreSQL-Lauf nachgewiesen. NativeproofSHA256 -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`. -Keine Zielruntime bereitgestellt oder Job-/Capability-/Policyfreigabe. Die -tatsächliche WebUI-genehmigte volle Wartung bleibt ein eigener offener Schritt. diff --git a/docs/script-console-helper-generations.md b/docs/script-console-helper-generations.md deleted file mode 100644 index 460febb..0000000 --- a/docs/script-console-helper-generations.md +++ /dev/null @@ -1,83 +0,0 @@ -# Gemeinsames Root-Ledger und Helpergenerationen - -Entscheidung2026-11-14, Spezifikation1.20. Dieser Nachtrag erklärt eine im -Bootstrapreview gefundene Voraussetzung der neuen Skriptkonsole. Dieser -Entscheidungstext ersetzt keinen Ausführungsbeleg und ändert keinen eingefrorenen -Compilerinput. Der inzwischen tatsächlich erhaltend ausgeführte Paarwechsel mit -unveränderten ursprünglichen Fehlerberichten und getrennten Erststartfortsetzungen -ist in den [Bootstrap-Ergebnissen](script-console-bootstrap-results.md) belegt. -Agent, General und Full laufen; signierter Folgeabgleich und WebUI-genehmigter -Fulljob sind dadurch noch nicht abgenommen. - -`consumed` ist kein bloßer Pool opaker Hashes: `execution_evidence.start` enthält -den vollständigen Originalrequest mit exakten Jobbytes, Grantbytes und Signatur. -`helper_reconcile::load_rows` prüft bei jedem Snapshot sämtliche gespeicherten -Versuche über `Binding::verify_with` und `Binding::job`. Dabei wird die Action -mit `deny_unknown_fields` dekodiert. Ein alter Helper kennt -`privileged_script_profile` nicht und verweigert deshalb auch eine vollständig -abgeschlossene neue FullMaintenancezeile. Ein solcher Snapshotfehler kann einen -sticky Journalfault schreiben. Ein eigener neuer Fullhelper neben einem alten -weiterbenutzten Generalhelper ist daher keine kompatible Lösung. Dasselbe gilt -für einen später wieder gestarteten alten APT-Helper am gemeinsamen Ledger. - -Beschlossener enger MVP-Weg: Neuer Agent und alle **aktiven** Root-Ledger- -Teilnehmer General und Full verwenden die neue, decoderfähige qualifizierte -Codegeneration. Bestehende Generalunit, Sandbox, Konfiguration und Policy-/Pinbytes -bleiben erhalten; daraus entstehen keine neuen Generalrechte. Native Units -beweisen noch keinen laufenden Generationswechsel. Erforderlich bleiben frischer -Vorher-CAS, kontrollierter erhaltender Austausch, tatsächliche neue Prozessimages, -Erhalt aller drei Datenbankinodes und ursprünglichen18 Rootverbräuche samt -Request-/Grant-/Signatur-/Start-/Outcomebytes, danach normaler signierter Abgleich. -Keine Historyreparatur, kein Ledgerreset oder manuelles Löschen einer Sperre. - -APT bleibt ausdrücklich disabled/inactive, ohne Agentendpoint und mit geschlossenen -Scopes. Der vorhandene private Runtimeindex bestätigt, dass die aktuelle APT- -Generation **bereits vor diesem Vorhaben** nicht mehr als qualifiziert galt. -Hier wird kein neuer Statusverlust einer aktuell bereit gemeldeten APT-Fähigkeit -behauptet. Die alten Abnahmebelege und der bekannte Acceptance-Aliaszweilinkfall -bleiben unveränderte historische Nachweise. - -Der APT-Provider bindet in `runtime_identity()` auch den tatsächlichen globalen -Helperbinaryhash, neben Provider/Hook, OS/Kernel, Pakettools, Konfiguration und -Unit. Ein neuer globaler Helper bedeutet eine andere Runtime. Vor jeder späteren -APT-Wiedereröffnung ist daher ein eigener versionierter Runtime-/Stackpinupgrade -mit tatsächlicher Generationqualifikation erforderlich; alte Accepted-Belege -werden nicht als aktuelle Startberechtigung ausgegeben. Ein alter Decoder darf -nicht versehentlich wieder gegen das nun erweiterte Ledger starten. - -Bootstrapvorbereitung verwendet den tatsächlich belegten aktuellen Runtimeindex -und einen zusätzlichen frischen lesenden VM-CAS; ein alter lokaler Index allein -ist kein aktueller Zielbeleg. Die neue Fullkonfiguration, der geprüfte Schema2- -Code-/Policypin, eigener Socket und Agentdropin werden als konkrete neue Dateien -reviewt. Kein Fulljob vor tatsächlicher WebUI-Bereitstellung und Genehmigung. -Paketwirkungen, Updates oder Reboots gehören nicht zu dieser Bootstrapabnahme. - -Nach dem MVP vormerken: explizite unterstützte Leser-/Schreibergenerationsmatrix -und geregelte Capability-/Aktionsmigrationen für geteilte Journale. Historische -Originalbytes dürfen für ältere Leser nicht still umgeschrieben oder ungeprüft -als undurchsichtige Daten akzeptiert werden. - - -## Tatsächlicher Bootstrapzwischenstand - -Root hat Snapshotde2452d0 lesend geprüft (SHA97c9f50f) und den eigenen -Installfall `2e27c312-58cc-444d-92a6-863a11ac6ffd` mit unverändertem Runner -`667b56f7…` genau einmal ausgeführt. Staging und Austausch der neuen -Agent-/Helpergeneration0a7ad6ee/79442727 sowie Generalpin und neuer Fullpin -wurden tatsächlich geprüft. Alle ursprünglichen SQL-/Datei-/PKIzeugen waren -vor Neustart identisch. Kein Job oder Reboot. - -Der ursprüngliche Installbericht bleibt **fehlgeschlagen**: SHA256 -`f752258c02e30e268d6a76d1e9fa98ec56e287ca75d3c8a8314a9034d6109544`. -Vor `restart-intent` stoppte die effektive Full-unit-Prüfung. Ein separater -lesender `systemctl show` bestätigt sämtliche erwarteten Konten/no-Werte und -leere RootDirectory/RootImage; ausschließlich SystemCallFilter und -RestrictAddressFamilies zeigen `~`. Das bezeichnet eine leere Denyliste; -[systemd dokumentiert die Tilde als Denylistenmodus](https://freedesktop.org/software/systemd/man/latest/systemd.exec.html). -Der Installer verlangte dort einen leeren String. - -Unabhängiges Readback bestätigt Agent, General und Full inaktiv/PID0, -`restart-intent` und alle drei Startmarker abwesend, aktuelle und erhaltene alte -Binärhashes korrekt, APT weiterdisabled. Eine eng begrenzte erste Startfortsetzung -wird separat geprüft. Der ursprüngliche Installaufruf wird nicht wiederholt; -SignedSync-/Heartbeat-/Inventory- und Fulljob-Abnahme sind weiterhin offen. diff --git a/docs/script-console-job-acceptance-v2.md b/docs/script-console-job-acceptance-v2.md deleted file mode 100644 index 9d0d198..0000000 --- a/docs/script-console-job-acceptance-v2.md +++ /dev/null @@ -1,53 +0,0 @@ -# MCP-Abnahmerunner V2: leeres SSE-Initialframe - -Der erste tatsächliche Planmodus mit der bisherigen Quelle `dcccd789c2eab18…` -im Fall `b8a4ea33-ab19-45a0-b838-c5dd6cf6d75a` hielt während MCP-Initialize mit -`JSONDecodeError` an. Der separate strikt lesende Lookup belegte null gespeicherte -Pläne und Anträge, `plan-entered:true`, `submit-entered:false`. Der Fall wird nicht -für einen erneuten Plan-/Submitversuch verwendet; ursprüngliche Intents, -Marker, Zeiten und Inputbytes bleiben unverändert. - -Die danach tatsächlich durch Root ausgeführte Initialize-only-Diagnose belegt: -HTTP 200, `text/event-stream`, vorhandener Sessionheader, zuerst eine leere -Datazeile mit sieben Byte, zwei Eventmetadatenzeilen und ein Frameabschluss; -anschließend eine gültige JSON-Datazeile mit 307 Byte. Es wurde kein Toolcall -gesendet. Beleg `initialize-frame-shape-readonly.json`, SHA256 -`40790d612b840c6073684a5ea2ee308b0dba5c42beea29c0d43922a8f7e0c3b8`. -Der alte Parser übergab das vollständige leere Datenframe an `json.loads(b'')`. -Das ist ein Fehler des Bootstrap-SSE-Parsers, kein Produktjobfehler. - -Die neue separate Quelle ist `deploy/script_console_job_acceptance_v2.py`, SHA256 -`c7f42df0a7e89274b7e255ac728ec4198a02278926348113c5b7e363e8983757`. -Die ursprüngliche Datei bleibt unverändert als ausführbarer Reader für ihren -Originalfall erhalten. Zusätzlich wurden Quelle und alle neun damaligen -B8-Belege create-only unter -`devstate/source-history/job-ops-dccc-sse-dcc82959-51cd-424e-84ab-6dd56de36689/` -archiviert; Manifest-SHA256 -`c9a1dee9e3ca71539c94b59433297dfd3be5e1687a212ad030226eb09765280d`. - -Die einzige geänderte Funktionsfamilie ist SSE-Framing: Erst ein vollständig -abgeschlossenes Datenframe bilden, den Puffer zurücksetzen und ausschließlich -die leere Bytefolge `b''` vor dem JSON-Parse überspringen. Nach `data:` wird nur -die eine im SSE-Format optionale Trennspace entfernt; weitere Whitespacebytes -bleiben erhalten. Dadurch werden nichtleere Whitespaceframes und anderes -ungültiges JSON weiterhin als Fehler verweigert. Mehrzeilige gültige JSON- -Datenframes funktionieren weiterhin. Byte-/Zeilenlimits bleiben unverändert. - -HTTP/TLS/CA/SNI, Tokenbehandlung, MCP-Initialize-/Session-/ID-Prüfungen, -Actor-/Rechte-/Policyguards, Ganzzahl-Nanosekunden, kurze SQLite-Reads, -Originalplan-/Job-/Grantbindungen und Wiederholungssperren sind unverändert. -Es gibt weiterhin keinen Approval-, Browserautomations-, Rechte-, Policy-, -Cancel- oder Retrypfad; der [Grundvertrag](script-console-job-acceptance.md) -bleibt bestehen. Insbesondere wird der fehlgeschlagene B8-Fall nicht umetikettiert. - -Tatsächlich lokal geprüft: Python-Syntax; der genaue neue Parser-AST mit einem -Frameverlauf entsprechend dem tatsächlichen Rootbeleg; anschließend gültiges -Initialize-JSON. Nichtleeres `not-json`, `{invalid}` und ein Frame aus drei -Whitespacebytes wurden jeweils als JSON-Fehler verweigert. Mehrzeiliges gültiges -JSON bestand. Kein Zielaufruf und kein neuer Fall wurden dabei angelegt. - -**Danach tatsächlich ausgeführt:** Root prüfte Quelle und Nichtwirkungsbeleg -des alten Falls, schloss dessen temporären Scope und erzeugte unter einem -frischen Scope den separaten V2-Fall `ced97b4d…`. MCP-Plan/Submit, WebUI-Grenze -und genau ein Rootlauf sind [nativ bestanden](script-console-linux-full-results.md). -Kein alter Planaufruf wurde wiederholt oder dessen Deadline geändert. diff --git a/docs/script-console-job-acceptance.md b/docs/script-console-job-acceptance.md deleted file mode 100644 index d398f62..0000000 --- a/docs/script-console-job-acceptance.md +++ /dev/null @@ -1,181 +0,0 @@ -# Vorbereiteter MCP-Abnahmerunner für das Linux-Rootskript - -Stand: Grundvertrag des engen Jobrunners. Der erste tatsächliche Aufruf im -Planmodus hielt bei MCP-Initialize an; der strikt lesende Lookup belegt null -persistierte Pläne/Anträge und keinen Job. Die separate Initialize-Diagnose -und der eng korrigierte V2-Parser sind im [V2-Nachtrag](script-console-job-acceptance-v2.md) -belegt. Der ursprüngliche Reader und Fall bleiben unverändert. Kein Approval -oder Browseraufruf gehört zu diesem Runner. -Die 158 eingefrorenen Produktinputs und alle bisherigen Opsquellen bleiben -unverändert. Der neue Runner ist `deploy/script_console_job_acceptance.py`. - -Er verwendet ausschließlich die tatsächliche Cloud-Linux-Geräteidentität aus -dem unveränderten Installationsfall `2e27c312-58cc-444d-92a6-863a11ac6ffd`. -Notebook und Windows-VM sind keine Ziele. Die private Inputvorlage ist -`devstate/output/playwright-private/console-full-v1/mcp-plan-input.template.json`, -SHA256 `66f684ab9c5c31be6583fe04f090ba9d7b8724d6e6c920dd9c67c484a339245e`. -Die Skriptbytes bleiben exakt 130 Byte, SHA256 -`c878ba5b5c37fa3f1b9485c6994d6c57f6f37d01d99d4239c64d264d4ed95336`: - -```sh -set -eu -/usr/bin/id -u -/usr/bin/sleep 12 -printf '%s\n' 'RMM_FULL_CONSOLE_LINUX_V1' -printf '%s\n' 'RMM_FULL_CONSOLE_STDERR_V1' >&2 -``` - -Diese Darstellung ist keine Aufforderung zur lokalen Ausführung. Der genaue -ursprüngliche UTF-8-Inhalt einschließlich abschließender Zeile wird gehasht. -Fest gebunden sind `posix_sh`, Root, `full_maintenance_v1`, keine Argumente, -30 Sekunden Laufzeit, 4096 Byte Gesamtausgabe, ein Job mit genau einem Versuch, -`max_parallel:1` und `halt_after_failures:1`. Erwartete rohe Ausgabe ist -`0\nRMM_FULL_CONSOLE_LINUX_V1\n` auf stdout und -`RMM_FULL_CONSOLE_STDERR_V1\n` auf stderr. Der harmlose Warteabschnitt von zwölf Sekunden -ermöglicht die Beobachtung des tatsächlichen laufenden Jobs in der WebUI. - -## Voraussetzungen und Grenze - -Der verantwortliche Rootagent prüft vor der tatsächlichen Benutzung getrennt -den erhaltenden Runtime-/Serverwechsel, frischen signierten Sync und Fullhelper- -Nachweis, Browservertrauen und die konkrete neue Rootpolicy. Vorlagen oder -dieser Runner ersetzen diese Abnahmen nicht. Eine ausdrücklich angegebene -Policy-SHA256 und ein fester künftiger UTC-Startzeitraum werden im unveränderlichen -Intent gebunden; die Deadline muss innerhalb der überprüften Policygültigkeit -liegen. Der Runner öffnet oder schließt selbst keine Policy. - -Vor jedem `operations.plan` und `operations.submit` liest der Runner die -tatsächlichen aktuellen Mitgliedschaften ausschließlich auf dem Server. -Der bestehende Creator ist -`automation:11111111-1111-4111-8111-111111111111`, Art `automation`; -der Testfreigeber ist `simulated-testprincipal-a`, Art `test_human`. -Beide dürfen nicht widerrufen sein. Automation muss exakt die vorhandenen sieben -Rechte plus `root:execute` haben; `plans:approve` ist dort ausdrücklich verboten. -Der Simulator benötigt seine bestehenden Planfreigabe-, Skript- und Rootrechte. -Fehlende Rechte verweigern den Aufruf **vor** jeder MCP-Mutation. Das gesondert -reviewte Provisionieren des zusätzlichen Automation-Rootrechts gehört nicht -zu diesem Runner. Er verändert weder Rechte noch Actorart. - -Die zentrale Policy muss genau einen Scope für dieses Gerät, diese Generation, -beide Akteure, den tatsächlichen Fullpolicyhash und den qualifizierten Helpercode -enthalten. Nur Fullskripte, keine Service-, APT- oder typisierte Rebootfreigabe. -Das Profil gibt genehmigtem Rootcode volle Hostautorität; daraus wird keine -Sandbox- oder generelle No-Reboot-Zusage abgeleitet. - -Serverzugang nutzt ausschließlich den vorhandenen gepinnten SSH-Bootstrapweg. -Der Token `/opt/rust-discovery/devstate/operator-a.token` wird ausschließlich auf -dem Server für dessen eigene HTTPS-Anfrage gelesen. Er gelangt weder zum -Entwicklungsrechner noch in Logs oder Ergebnisse. Der HTTP-Endpunkt ist fest -`127.0.0.1:18443`, TLS-Name/SNI `localhost`, Vertrauen ausschließlich über -`/opt/rust-discovery/devstate/api-pki/ca.pem`. MCP-Initialize, Initialisierungs- -Notification, Sessionbindung und begrenzte JSON-/SSE-Antworten folgen dem -bestehenden Cloud-MVP-Muster; dessen veralteter privater API-CA-Pfad wird hier -gezielt nicht übernommen. - -## Bedienweg und getrennte tatsächliche Abnahme - -Die folgende Tabelle beschreibt die Modi. Mit dem separat korrigierten -V2-Runner wurde anschließend genau ein [nativer Rootlauf bestanden](script-console-linux-full-results.md). -Der ursprüngliche Fehlversuch bleibt erhalten; die Modusquelle selbst -enthält weiterhin keinen Genehmigungsweg. - -| Modus | Einzige zugelassene Wirkung | -| --- | --- | -| `prepare-local` | Neuer privater lokaler Intent samt unveränderlichem vollständigem Hashzeugen; explizite Policy-SHA und UTC-Zeiten erforderlich | -| `plan --case ` | Einmalig MCP `operations.plan`, erst nach lokalem und serverseitigem dauerhaften Startmarker | -| `submit --case ` | Einmalig MCP `operations.submit` mit festem Idempotenzschlüssel; danach lesender Pending-0/0/0/0-Nachweis | -| `pending --case ` | Bestehende Anfrage und native Nichtverbräuche lesen; niemals einreichen oder genehmigen | -| `read --case ` | Originalfälle, eindeutige Plan-/Idempotenzlookupdaten und vorhandene Resultate lesen | -| `verify-result --case ` | Vorhandenes Endergebnis, tatsächlichen UI-Audit, native Originalbytes und betroffene MCP-Mandantengrenze lesen und prüfen | - -`prepare-local` setzt nur Asset- und Zeitplatzhalter ein. An den Grund wird eine -eindeutige `acceptance_case=`-Kennung angehängt, damit ein verlorener -Planreply rein lesend eindeutig gefunden werden kann. Skript, Identität, -Interpreter, Argumente und Limits werden nicht verändert. Sämtliche Vorlagen-, -Quell- und vollständigen Intentbindungen werden vor jedem Aufruf und Readback -geprüft. Bestehende Pläne, Versuche und Intents werden nicht überschrieben. - -Die einzigen mutierenden MCP-Methoden sind Plan und Submit. Es existiert kein -Approval-API-, Browserautomations-, Cancel-, Retry- oder SQL-Schreibpfad. Auf dem -Server entstehen nur eigene private Bootstrapintents und Einmalmarker sowie die -durch MCP selbst erzeugten Pläne/Anträge. Alle direkten SQL-Abfragen laufen in -`BEGIN READ ONLY`; der Operation-Getter wird bewusst nicht aufgerufen, weil -dieser beim Lesen einen abgelaufenen Pendingantrag aktualisieren kann. - -Nach Submit müssen die gespeicherte Anfrage `pending_approval`, null Jobs, -Outboxeinträge, Grants und Autorisierungen sowie null native Verbräuche des -neuen Versuchs belegt sein. Der lokale `pending-checkpoint.json` enthält die -tatsächlichen ursprünglichen Planbytes, Plan-/Job-/Skripthashes, Job-/Versuch- und -Operation-IDs, Ziel, Rechteprofil und Grenzen für die separate Browserprüfung. -Seine zusätzliche Operationsansicht ist als aus lesendem SQL abgeleitet -gekennzeichnet. **Erst danach darf der separat berechtigte Akteur den exakten -gespeicherten Plan tatsächlich in der WebUI genehmigen.** - -Bei verlorenem Reply niemals denselben Plan-/Submitaufruf erneut starten. -Nur `read` verwenden: Originalcase und eindeutige gespeicherte Reason-/ -Idempotenzbindung werden gelesen. Ein gefundener Originalplan darf als genau -dieser Plan erhalten werden; es wird kein Ersatzplan erzeugt. Ein fehlender oder -mehrdeutiger Nachweis bleibt unklar und sperrt Wiederholung. - -## Geplanter Ergebnisnachweis und seine Grenzen - -Der Endnachweis verlangt genau einen Job, Outboxeintrag, Grant und eine -Autorisierung. Er prüft tatsächlichen `dev_test_browser_simulation`-Audit mit -Simulatorprincipal, `testsimulation:true`, Developmentprofil sowie unveränderten -Plan-/Operationbindungen. Das ist ausdrücklich kein Produktionsnachweis einer -echten menschlichen Identität. Erfolgreicher Zustand, Exit 0, ungekürzte rohe -stdout-/stderr-Bytes, Root-UID, Fullprofil und Skripthash müssen übereinstimmen. - -Die native Abfrage öffnet ausschließlich das vorhandene Root-Ledger lesend, -prüft Inode und alle ursprünglichen 18 Verbrauchszeilen bytegebunden und erlaubt -genau einen neuen abgeschlossenen Verbrauch für genau diesen Job/Versuch. -Sie materialisiert ausschließlich diese 18 bekannten IDs und den neuen Versuch -sowie die beiden Verbrauchszähler. Der Leseabschnitt wird vor BLOB-Hashing und -Dekodierung vollständig zurückgerollt/geschlossen. SQLite-Busy-Timeout ist -250 Millisekunden, das kooperative Fortschrittsbudget eine Sekunde; längere -gemessene Transaktionen werden als Nachweis verweigert. Dies ist keine harte -OS-/I/O-Echtzeitgarantie. Es läuft kein vollständiger Integritätsscan. -Originalstart, Jobbytes, Grantbytes, Signaturbytes, Autorisierung, Boot und -Ausführungsausgabe werden mit den gespeicherten Serverdaten verglichen. -Skriptbytes werden direkt aus den ursprünglichen Planbytes ausgeschnitten, -nicht aus einer API-Ansicht neu serialisiert. Die primäre Ed25519-Prüfung bleibt -beim qualifizierten Produkthelper; dieser enge Opsrunner ist kein zweiter -unabhängiger Signaturverifizierer und behauptet dies nicht. - -Zeitvergleiche verwenden einen strikten RFC3339-Parser mit ganzzahligen -Epoch-Nanosekunden: null bis neun Nachkommastellen werden exakt auf neun Stellen -aufgefüllt, Z- und numerische UTC-Offsets korrekt verrechnet. Es gibt weder -Gleitkommazahlen noch Rundung/Abschneiden. Ungültige Kalender-/Offsetwerte, -fehlende Zone, mehr als neun Nachkommastellen und die hier nicht unterstützte -Schaltsekunden-Schreibweise werden verweigert. Eingabe und Policy dürfen weiter -Mikrosekunden verwenden; die ursprünglichen Produktbytes bleiben unverändert. -Grant-/Native-Start-/Deadlinegrenzen werden bis zur letzten Nanosekunde verglichen. - -Zusätzlich muss derselbe bestehende Automation-A-Token den bereits gespeicherten -eigenen Job über den tatsächlichen MCP/HTTPS-Weg vollständig lesen können; -Ergebnis und rohe Ausgabe müssen zu SQL und nativen Originalen passen. -Mit dem ausschließlich serverseitigen bestehenden `operator-b.token` werden -danach genau zwei lesende MCP-Abfragen ausgeführt: der neue A-Job und dessen -gespeichertes A-Assetinventar. Gültige Authentisierung/Initialize und tatsächliche -strukturierte `FORBIDDEN`-/`NOT_FOUND`-Toolantworten ohne Daten/Details sind Pflicht. -Eine ungültige B-Anmeldung gilt nicht als Mandantennachweis. Dafür entstehen -weder neue Jobs noch weitere Scopes. Der frühere Datenbank-RLS-Beleg ersetzt -diesen ausdrücklich geplanten HTTP-/MCP-Authnachweis nicht. - -Tatsächlich lokal geprüft: Python-Syntax und Help; sämtliche eingefrorenen -Quell-/Templatebindungen; exakte Jobbyteausschnitte aus allen drei tatsächlichen -Rust-Goldenplänen; synthetischer zulässiger Plan und Verweigerung geänderter -Skriptbytes, Limits, Creatoridentität und mehrerer Versuche. Kein Test wurde als -nativer Job- oder Browsernachweis ausgegeben. Der danach tatsächlich vorbereitete -ursprüngliche Fall hielt während MCP-Initialize vor dem Plan-Toolcall an; -sein Nichtwirkungsbeleg und die separate V2-Korrektur stehen im V2-Nachtrag. - -Der ursprüngliche unbenutzte Runner `c958db665…` bleibt create-only archiviert. -Unabhängiger Review fand dort den zu langen Leseabschnitt über einen vollständigen -SQLite-Integritätsscan und Python-3.10-inkompatible beziehungsweise für Rust- -Nanosekunden ungeeignete `fromisoformat`-Vergleiche. Beide wurden vor jeder -Jobvorbereitung eng korrigiert. Tatsächliche gezielte lokale Prüfungen bestanden: -Z, null bis neun Nachkommastellen, positive/negative Offsets, Zeitpunkt eine -Nanosekunde vor Epoch und die echte Grantgrenzbedingung mit Ein-Nanosekunden- -Abständen. Ein separater temporärer SQLite-Zeuge konnte einen unabhängigen -Schreiber vor jedem Rowhash erwerben; kein Produkt-/VM-Ledger wurde dafür benutzt. diff --git a/docs/script-console-linux-full-results.md b/docs/script-console-linux-full-results.md deleted file mode 100644 index 064430f..0000000 --- a/docs/script-console-linux-full-results.md +++ /dev/null @@ -1,89 +0,0 @@ -# Tatsächliche Linux-Abnahme der vollständigen Skriptkonsole - -2026-11-14, ausschließlich Cloud-Linux gegen `discovery.ease-technologies.de`. -Fall `ced97b4d-c352-4f0c-b34f-59e4d69ca192`, Runner-V2 -`c7f42df0a7e89274b7e255ac728ec4198a02278926348113c5b7e363e8983757`. -**Die einzelne vollständige MCP → WebUI → Rootskript → Ergebnisstrecke ist -nativ bestanden.** Dies schließt weder Windows noch den Selbstupdater ab. - -Voraussetzung war der tatsächlich bestandene dreiteilige passive -Linux-Nachbeleg `4c425416…`, SHA256 -`594fdf94261aa882df7ea771dda3f04779533dfdac768cf4a63c83448e1f27d7`. -Die zuvor geöffnete Policy `71660e4c…` wurde ohne neuen Job geschlossen. -Ein neuer, unveränderlicher 15-Minuten-Scope `992a6639…` band ausschließlich -das tatsächlich qualifizierte Cloudgerät, beide berechtigten Akteure, -Fullpolicy `8101afd1…` und Helpercode `79442727…`. Er erteilte keine -Plangenehmigung. SYSTEM, Dienst-, APT- und typisierte Rebootfreigaben wurden -nicht hinzugefügt. Volle Rootautorität des genehmigten Skripts bleibt ausdrücklich -ohne Sandbox- oder generelle No-Reboot-Zusage. - -## Tatsächlich durchlaufene Grenze - -1. Der bestehende Automation-Akteur legte den festen Plan einmal über MCP an - und reichte ihn einmal ein. Plan `259ff8f7-9b91-4707-8c3c-678573576ce3`, - Planhash `070ed2a5aa98acb461719492590b85574e0450739d7ea7a715d2dc3d5ec4966f`. - Antrag `25af50d7-b1fe-46f7-991f-23a4f186b46f` war dauerhaft - `pending_approval`: null Jobs, Outboxeinträge, Grants, Autorisierungen - und native Verbräuche dieses Versuchs. -2. In der echten WebUI wurde genau dieser Antrag geöffnet und dessen - unveränderlicher Plan angezeigt. DOM-Auslesung der vollständigen - Zielpreviews und lokaler Vergleich bestätigten sämtliche originalen - Planbytes, Ziel-/Job-/Versuchs-IDs, Skript- und Jobhashes, Root/ - `full_maintenance_v1`, Argumente, Zeitfenster und Limits. Vor dem - angehakten Prüfkästchen war der Freigabebutton deaktiviert. -3. Ein tatsächlicher Klick auf **„SIMULIERT: Diesen festen Plan ausdrücklich - genehmigen“** erzeugte die Freigabe. Gespeicherte Autorisierung und Audit - binden `simulated-testprincipal-a`, `dev_test_browser_simulation`, - `testsimulation:true`, Entwicklungsprofil und denselben Plan/Antrag. - Dies ist kein Freigabenachweis eines menschlichen Produktionsbenutzers. -4. Genau Job `b014fb7a-c23e-440f-8bb6-8212c3af2b1f`, Versuch - `cc56ea51-a548-4bde-93a5-ef49a31d110d`, wurde erfolgreich abgeschlossen. - Je genau ein Job, Outboxeintrag, Grant und Autorisierungsdatensatz sind - belegt. Der Rootledger enthält die unveränderten ursprünglichen18 Zeilen - plus genau einen abgeschlossenen Verbrauch:19 verbraucht,0 ungeklärt. - -Das [feste harmlose Skript](script-console-job-acceptance.md) umfasst130 -UTF-8-Bytes, SHA256 `c878ba5b5c37fa3f1b9485c6994d6c57f6f37d01d99d4239c64d264d4ed95336`. -Es liest die UID, wartet zwölf Sekunden und schreibt feste Markierungen. -Belegt: UID0, Exit0, erwartetes Fullprofil, bestandene stdout-Nachbedingung, -keine Trunkierung und kein angeforderter Reboot; Limits30s/4096Byte. - -| Unveränderte Ausgabe | Bytes | SHA256 des tatsächlichen WebUI-Downloads | -| --- | ---: | --- | -| stdout: `0\nRMM_FULL_CONSOLE_LINUX_V1\n` | 28 | `056c51deff395a12541cc977f62ad20dad80ccf2dff9f81c2ad8a2bdf09c3c7a` | -| stderr: `RMM_FULL_CONSOLE_STDERR_V1\n` | 27 | `4b810603627a8d0836bc820087c6d566a503a6c1ca5bd06fff7e6f8910fa3311` | - -Die Ergebnisse wurden tatsächlich in der WebUI geöffnet; beide Rohbytebuttons -wurden angeklickt und die heruntergeladenen Dateien bytegenau verglichen. -Der tatsächliche MCP-Getter liefert dasselbe vollständige Ergebnis. -Zwei authentisierte MCP-Abfragen mit dem bestehenden anderen Mandanten -(`jobs.get`, `inventory.get_device`) ergaben jeweils `NOT_FOUND`, leere -Details, HTTP200 mit MCP-Fehler. Dafür wurde kein weiterer Job erzeugt. - -## Abschluss und Grenzen - -Der Scope wurde nach Erfolg geschlossen. Ein separater lesender Readback -bestätigt wieder die originalen abgelaufenen Policybytes -`cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`, -Eigentümer10001:10001, Modus0600 und ursprüngliche mtime. Die atomare -Wiederherstellung hat einen neuen Inode; der historische Inode bleibt im -Originalbeleg erhalten. Keine dauerhafte zentrale Fullfreigabe bleibt offen. - -Privater Endbeleg `passed.json`, SHA256 -`89dcb583fb62d8af6cb87e9a386e973451016be6bd7077ac1a8e5f8db3fa2128`. -Browserbelege liegen unter `output/playwright/51c274c9…/evidence/`; -Rohdaten, Zugangsdaten und Browserzustand bleiben gitignoriert. - -Im Browser tatsächlich beobachtet wurden `pending_approval`, `queued` und -`succeeded`; der laufende Zwischenzustand wurde trotz des Warteabschnitts -verpasst. Kein zweiter Lauf wurde dafür erzeugt. Der Nachbeleg bindet die -Originalgrant-/Signatur-/Request-/Outcomebytes; er enthält keine zweite -unabhängige Ed25519-Verifikation und keinen separat erfassten Kindprozess- -Startzeitpunkt. Die feste Frist ist anhand der nativen Startreservierung -belegt. Timeout, Abbruch, Offlinebetrieb und eine fremde Linux-Prozessgruppe -sind durch diesen erfolgreichen Einzelfall nicht zusätzlich nativ abgenommen. -Der ältere SSE-Fehlversuch bleibt [fehlgeschlagen und unverändert](script-console-job-acceptance-v2.md). - -Weiter offen: Windowsclock und native PowerShell-/SYSTEM-Abnahme, -Selbstupdater-Runtime und deren Linux-/Windows-Applynachweise sowie -abschließende Integration und konsistente aktuelle Runtimeindizes. diff --git a/docs/script-console-policy-scope.md b/docs/script-console-policy-scope.md deleted file mode 100644 index 17af62f..0000000 --- a/docs/script-console-policy-scope.md +++ /dev/null @@ -1,256 +0,0 @@ -# Begrenzter Policy- und MCP-Root-Bootstrap für die Linux-Skriptkonsole - -`deploy/script_console_policy_scope.py` ist eine getrennte Opsquelle. Sie verändert -keine158Frozen-Produktdateien, Migrationen, Agenten, Units, Serverflags, Images, -Tokens oder Sitzungen. **Aktueller korrigierter Quellstand lokal geprüft, noch -nicht auf dem Server ausgeführt; früherer Vorwirkungsabbruch unten dokumentiert.** -Kein tatsächlicher Scope oder Actor wurde durch den Subagenten -geändert; Native-Attestation und Zielbelege werden nicht erfunden. - -## Konkrete Autorisierungsentscheidung - -Der User hat AI/MCP-Skriptplanung mit ausdrücklich erlaubten Rootrechten und -separater menschlicher WebUI-Genehmigung beauftragt. Der Hauptagent stellte -öffentlich und rein lesend fest: Der bestehende Actor -`automation:11111111-1111-4111-8111-111111111111` besitzt sieben Standardrechte, -jedoch kein `root:execute`. Der simulierte UI-Actor besitzt Root- und -Genehmigungsrechte. `jobs::plan` verlangt Rootberechtigung und passenden Rootscope -bereits vom Planersteller; spätere Prüfungen beziehen sowohl ursprünglichen -Planersteller als auch UI-Genehmiger ein. Ein ausschließlich auf den simulierten -Principal begrenzter Scope kann deshalb den beauftragten MCP-Rootablauf nicht -tragen. - -Der Hauptagent hat auf Grundlage dieses Userauftrags den separaten, konkreten -Bootstrap zur Ergänzung ausschließlich `root:execute` für genau diesen bestehenden -Dev/Test-Automation-Actor angeordnet. Dies ist MVP-Konfiguration und keine -Jobgenehmigung. Kein allgemeines Rollenupdate und kein Defaultwechsel anderer -Tenants wird implementiert. Der Token bleibt derselbe; `plans:approve`, -`plans:revoke`, `system:execute`, Sessions und Tokens werden nicht hinzugefügt. -Die interaktive Genehmigungsgrenze bleibt auch bei vorhandener Root-Planungs- -berechtigung bestehen. - -## Zwei bewusst getrennte Vorgänge - -1. `prepare-mcp-root-local` und `provision-mcp-root`: einmalige Ergänzung genau - eines Rechts, ausschließlich bei geschlossenem bekannten Rootpolicybestand. - Kein automatisches Öffnen eines Scopes. -2. `prepare-local`, `open`, `read`, `close`: separat geprüftes15-Minuten-Fenster - für genau ein tatsächlich qualifiziertes Cloud-Linuxziel, beide bestehenden - Actor-IDs und exakt den Fullpolicy-/Helpercodepin. `open` verändert keine - Memberships. `close` restauriert ausschließlich die eigenen gesicherten alten - Policybytes. - -Jeder Vorgang hat eigenen unveränderlichen lokalen/entfernten Intent, UUID, -Source-/Supporthashes, lokalen Aufrufmarker vor SSH und entfernte Einmalmarker -vor Wirkung. Antwortverlust oder Fehler nach einem Aufruf erlaubt ausschließlich -`read` desselben Cases, keine Wiederholung, keine neue Frist und keinen neuen -Case als automatische Reparatur. - -## Separates MCP-Recht: genaue Transaktion - -Die feste Vorbedingung ist exakt der vorhandene Actor mit Kind `automation`, -`revoked_at:null` und dieser unveränderten geordneten Rechtefolge: - -```text -inventory:read, logs:read, operations:read, operations:plan, -operations:submit, jobs:cancel, scripts:execute -``` - -Der Bootstrap verlangt das explizit von Root überprüfte tatsächliche Runtimeimage -auf beiden Rollen, Development-/Devlogin-Konfiguration, unveränderte Rootflags -und das bekannte Read-only-Policymount. `/auth/config` wird privat über korrekt -verifiziertes API-TLS mit `api-pki/ca.pem` und Name `localhost` gelesen. Die -Rootpolicy muss exakt Hash -`cf15cbb68b590475df6def28e7dcffb7d88e0ca2d2555a06174fb654eeff05f4`, -Schema1/Development und bereits abgelaufen sein. Der Tenant hat genau30Jobs, -30Outboxzeilen,26Permits und keinen offenen/unklaren Job. - -Ein neues rootprivates Historyverzeichnis erhält Intent und vollständigen -öffentlichen Vorherbeleg. Der entfernte `provision-entered`-Marker wird vor SQL -fsync-gesichert. Danach läuft genau eine feste Transaktion: - -- `BEGIN ISOLATION LEVEL SERIALIZABLE`, expliziter Tenantkontext. -- `UPDATE memberships SET permissions=array_append(permissions,'root:execute')` - ausschließlich mit festem Tenant/Actor, Kind, Revocation-NULL und exaktem - Array-CAS sowie erneutem30/30/26-/Closed-Prädikat im Statement. -- `RETURNING` liefert nur öffentliche Actorfelder. Ein Count0 führt über den - tatsächlichen Countassert zu einem Transaktionsfehler vor `COMMIT`; - `ON_ERROR_STOP` beendet psql, die Verbindung rollt zurück. Genau eine Zeile ist - aufgrund des vorhandenen Tenant-/Principal-Primärschlüssels möglich. -- Nach Commit müssen ausschließlich die fest erwarteten acht Actorrechte - vorliegen. Alle anderen Membershipzeilen werden über einen konsistenten - SHA256-Fingerprint verglichen; Job-/Outbox-/Permitzähler und geschlossene - Policybytes/Inode sowie Rollen/Flags bleiben erhalten. - -SQL-/Vorher-/Nachher-/Ergebnisbelege sind privat und create-once. Eine verlorene -Commitantwort wird niemals als fehlender Commit interpretiert; `read` zeigt -tatsächlichen Actorzustand und erhaltene Marker. Es gibt keinen Schreibpfad zu -Authorizations, Jobs, Outbox, Grants oder Auditgenehmigungen. - -## Temporärer Fullscope und seine Belege - -`prepare-local` verlangt den Pfad zu einer tatsächlichen `attested.json` und den -vom Hauptagenten ausdrücklich akzeptierten vollständigen SHA256. Der Loader -verlangt die bestehende Post-Attestation-Form mit drei Originalsamples samt -Hashbindung, bestätigter Erhaltung, normalem signiertem Sync, zwei gespeicherten -Heartbeatfortschritten, Queuekonvergenz und Tenant-RLS-Verweigerung. Tatsächliche -Rootprozesse, Fullpin und Codehash in den Samples müssen zusammenpassen. Ohne -diesen fertigen akzeptierten Beleg entsteht kein lokaler Scopeintent. - -Die Policy hat genau einen Schema2-Scope: konkreter Tenant/Asset/Agent und -Generationen aus dem nativen Fullpin, die zwei festen Principal-IDs, tatsächlicher -Fullpolicyhash und laufender Helpercodehash, `allow_root_scripts:true`, -`allowed_script_profiles:[full_maintenance_v1]`, leere Servicesliste, -`allow_reboot:false`, keine APT-/Rootlogfelder. Die Frist wird bei lokaler -Vorbereitung unveränderlich auf900Sekunden festgelegt und beim Öffnen nochmals -gegen die Serverzeit geprüft. Vergangene, künftig beginnende oder längere -Freigaben sowie Scope0 werden verweigert. - -`open` verlangt zusätzlich frisch gespeicherte authentifizierte Online-/Sync- -Zustände, den gleichen Boot und passende Generationen, beide Fullcap-Pins, -Migrationen1–14 und keine ungeschlossenen Jobs. Beide tatsächlichen Memberships -werden erneut geprüft. Automation muss exakt die separat bereitgestellten acht -Rechte haben; der simulierte Genehmiger braucht seine bestehenden Plan-, Skript-, -Root- und UI-Genehmigungsrechte. Es werden keine Rechte erzeugt, wenn sie fehlen. - -Vor dem Öffnen wird der alte geschützte Policybestand erneut auf genauen -`cf15…`-Hash und abgelaufenes Schema1 verglichen. Rootprivate Originalbytes und -vollständige Dateimetadaten werden erhalten, anschließend der Einmalmarker -geschrieben. Die unveränderlichen Kandidatbytes werden mit Eigentümer10001 und -Modus0600 auf demselben Dateisystem vorbereitet; unmittelbar vor einer einzigen -atomaren Ersetzung werden alte Bytes und Inode nochmals verglichen. Danach -werden tatsächliche neue Bytes und unveränderte Rollen/Flags belegt. Keine -Dienstaktion und keine Datenbankschreiboperation ist Teil von `open`. - -`close` benötigt keinen noch online erreichbaren Client und keine frischen Caps: -eine Schließung darf auch nach Ablauf oder bei Offlinezustand erfolgen. Es -akzeptiert nur den eigenen unveränderten Remoteintent, den erhaltenen `open`- -Marker, exakte eigene aktuelle Kandidatbytes und den eigenen originalen -`cf15…`-Backupbestand. Fremde oder nachträglich geänderte Policies werden niemals -pauschal ersetzt. Der Close-Marker wird vor Wirkung gesichert; ein weiterer -Bytes-/Inode-CAS erfolgt vor der atomaren Restaurierung. Alte Policybytes, -Eigentümer, Gruppe, Modus und mtime werden wiederhergestellt und ihre abgelaufene -Grenze geprüft. Die atomare Ersatzdatei hat nachvollziehbar einen neuen Inode; -historische Inode-/ctimewerte bleiben im unveränderten Beleg, nicht als behauptete -Wiederherstellung. Alle Historydateien und Runtime-Tags bleiben erhalten. - -`read` erstellt weder Casepfad noch Lock und führt keine Reparatur aus. Auch ein -fehlender Case oder Policy-Lesefehler erlaubt Readback anderer erhaltener Felder. -Ein gleichnamiger fremder Intent wird verweigert. Die Worker dieser Quelle -serialisieren Policy-/Membership-Änderungen über einen geschützten Lock; parallele -ältere Root-Policyschreiber müssen durch den Hauptagenten ausgeschlossen werden. -Der Lock behauptet keine Kontrolle über andere Rootprogramme. - -## Geplante Bedienung, nicht ausgeführt - -Erst nach Rootreview der eingefrorenen Quelle und des konkreten Intents: - -```text -python3 deploy/script_console_policy_scope.py prepare-mcp-root-local --expected-server-image sha256:ROOT_REVIEWED_ACTUAL_IMAGE -python3 deploy/script_console_policy_scope.py provision-mcp-root --id ACTOR_CASE --execute-mcp-root-provision -python3 deploy/script_console_policy_scope.py read --id ACTOR_CASE - -python3 deploy/script_console_policy_scope.py prepare-local --attestation /path/to/actual/attested.json --accepted-attestation-sha ROOT_ACCEPTED_SHA256 --expected-server-image sha256:ROOT_REVIEWED_ACTUAL_IMAGE -python3 deploy/script_console_policy_scope.py open --id SCOPE_CASE --execute-policy-open -python3 deploy/script_console_policy_scope.py read --id SCOPE_CASE -# Danach separat: MCP-Antrag → pending0 → tatsächlicher UI-SIM-Klick → Ergebnis. -python3 deploy/script_console_policy_scope.py close --id SCOPE_CASE --execute-policy-close -python3 deploy/script_console_policy_scope.py read --id SCOPE_CASE -``` - -Platzhalter sind absichtlich nicht ausführbar. Der bestehende Hauptcheckout mit -geschützter `credentials/server.conf` ist der Standard-SSH-Zugangsroot; es gibt -keinen Linux-VM-Aufrufpfad. Ausschließlich der bereits unabhängig vertraute -Cloudserverdiscovery.ease-technologies.de bzw. dessen fester Name ist zulässig. SSH ist -Bootstraptransport, keine Job- oder Approvalautorität. - -## Semantikgrenzen - -Ein Scope begrenzt/verweigert, genehmigt aber niemals einen Job. Die zentrale -Profilzulassung bleibt additiv und wird nicht als allgemeiner Ausschluss aller -Legacy-Rootskripte dargestellt; dies ist nach dem MVP vorgemerkt. General/APT -bleiben lokal unverändert gebunden/gesperrt. Leere typisierte Service-/Reboot-/ -APT-Rechte sind keine Sandbox eines ausdrücklich genehmigten Fullskripts. Der -konkrete später genehmigte Plan bindet vollständige Skriptbytes, Fullprofil, -Identität, Ziel/Versuch, Budgets und Fristen. Root-/Helperpins, Uhr, Peer, -Consumption, Startgrant und WebUI-Genehmigung werden weiterhin unabhängig geprüft. - -## Tatsächliche lokale Prüfungen - -- Python-Syntax und beide getrennten Intentformen geprüft, nur temporäre - synthetische Attestationsfixtures. Unbekannter akzeptierter Hash und geänderte - Originalsamplebytes werden verweigert. Kein tatsächlicher Nativebeleg wurde - dadurch erzeugt oder als akzeptiert markiert. -- Acht Kandidatenabweichungen, vergangene/künftige/zu lange Öffnungsfenster, - fremde Close-Policy, Wiederholungsmarker und rein lesendes Verhalten bei - fehlendem Case geprüft. Frozen158 und Deployment-v2 bleiben byteidentisch. -- Die **tatsächliche aus der Quelle extrahierte** SQL-Transaktion wurde auf einer - frischen isolierten PostgreSQL-Fixture mit `--network none`, ohne Ports oder - reale Zugangsdaten ausgeführt: exakt ein7→8-Rechte-Commit erfolgreich; zweiter - Aufruf, abweichende Ausgangsrechte und offener Job abortieren vor Commit ohne - Überschreiben. Anderer Tenantactor unverändert. Die Fixture bildet nur das - benötigte Schemasubset ab und ist kein RLS-/Produktionsnachweis; der eigene - Testcontainer samt Testvolume wurde anschließend entfernt. - -Belege stehen unter `devstate/script-console-policy-scope-local-review/`. -Reale Native-Attestation, Serverrollen, Membership-CAS, Policyöffnung/-schließung, -UI-Genehmigung und Jobwirkung sind erst durch den Hauptagenten auszuführen und -getrennt nachzuweisen. Die lokalen Tests geben keine Serverfreigabe vorweg. - -### Tatsächlicher erster Provisionierungsversuch und Parserkorrektur - -Der Hauptagent führte den ersten expliziten Provisionierungsversuch -`6ba73b0b-b42f-42d6-966a-62d523315ee8` mit Source -`cb7f0984a0f98065018e8f190bedba1454bf53347c3280751e4d0ccf39a21624` -aus. Er brach vor entferntem Case und vor SQL ab. Der unabhängige Rootreadback -meldete Casefehlend, Actor weiterhin exakt sieben Rechte, Policy unverändert -`cf15…` mit Inode649002 und Zähler30/30/26/0; Rollenprobe meldete ValueError. -Allenfalls der eigene Serialisierungslock wurde angelegt. Keine Scopeöffnung, -Membership-, Policy-, Job- oder Kernelwirkung wird daraus behauptet. - -Die Ursache wurde anschließend lokal am unveränderten alten Parser reproduziert: -Docker fügt nach dem ausgewählten Go-Template eine zusätzliche Leerzeile hinzu. -Dies wurde tatsächlich mit demselben Template gegen ein öffentliches lokales -Toolimage ohne ausgewählte RMM-Werte beobachtet; keine Zielumgebung oder Secrets -wurden dafür gelesen. Der bisherige dict-Generator verweigerte diese Zeile mit -ValueError. - -Die enge Korrektur ignoriert ausschließlich leere Zeilen. Jede nichtleere Zeile -muss weiterhin ein Gleichheitszeichen, einen ausdrücklich erlaubten Schlüssel -und einen noch nicht vorhandenen Schlüssel enthalten; unbekannte, doppelte, -fehlformatierte und bloß aus Leerzeichen bestehende Zeilen werden verweigert. -Werte werden nicht getrimmt oder normalisiert. Alle Flags, Valuechecks, -Zählergates, Rechte-CAS und Mutationspfade bleiben unverändert. - -Vor der Änderung wurden alte Sourcebytes und sämtliche fünf vorhandenen lokalen -Case-Dateien create-only unter -`devstate/script-console-policy-scope-source-history/` erhalten. Der alte Case -wird nicht wiederholt oder mit dem neuen Sourcehash umgedeutet. Ein neuer Case -ist erst nach Rootreview zulässig. Bei Bedarf kann Root den unveränderten alten -Reader anhand des archivierten Hashes unter deploy rekonstruieren; ein -Readbackfehler wird nicht als fehlende oder erfolgreiche Mutation ausgelegt. - - -## Tatsächlich provisioniertes MCP-Planungsrecht - -Nach Rootreview der Quelle11b4450a wurde der separate neue Fall -`0daffbc0-64df-486c-8df1-8ae5e0a0215c` genau einmal ausgeführt und zusätzlich -lesend geprüft: der bestehende Automation-Testprincipal von DevelopmentA hat -nun genau seine bisherigen sieben Rechte plus `root:execute`. Andere -Mitgliedschaften blieben bytegleich; der Ausdruck erlaubt keine Genehmigung. -Keine Approval-/SYSTEM-/Token-/Sessionrechte wurden ergänzt, kein Job oder -Startgrant erzeugt. Zentrale Rootpolicy bleibt exaktcf15 und abgelaufen, -gleicher Inode; alle drei Zähler30/30/26 und ungeklärt0 blieben erhalten. - -Der frühere Fall6ba73b0b bleibt ein unveränderter Vorwirkungsfehler: tatsächliche -Docker-Ausgabe enthält nach den sieben ausgewählten öffentlichen Envzeilen eine -Leerzeile. Der alte dict-Parser verweigerte davor mitValueError; Remote-Case -fehlte, Actor hatte nachweislich weiterhin sieben Rechte. Die neue Quelle -überspringt ausschließlich leere Zeilen und verweigert unzulässige, doppelte oder -unbekannte nichtleere Felder. Kein Wiederholen des alten Mutationsfalls. - -Ein temporärer Full-Ausführungsscope wurde damit noch nicht geöffnet. Der erste -Root-MCP-Auftrag benötigt weiterhin den akzeptierten aktuellen Nativebeleg, -separate begrenzte Policyöffnung und die tatsächliche interaktive WebUI-Freigabe -seines unveränderlichen Plans. Der gesonderte Provisionierungsschritt folgt dem -expliziten Userauftrag für AI/MCP-Rootwartung und ist keine Jobgenehmigung. diff --git a/docs/script-console-post-attestation-v2.md b/docs/script-console-post-attestation-v2.md deleted file mode 100644 index 92073f6..0000000 --- a/docs/script-console-post-attestation-v2.md +++ /dev/null @@ -1,97 +0,0 @@ -# Enger lesender Observer für kurzlebige DELETE-Rollbackjournale - -Stand: lokale Opsvorbereitung, kein nativer V2-Aufruf und noch kein neuer -Abnahmeintent. `deploy/script_console_post_attestation_v2.py` ist eine getrennte -Quelle; die ursprüngliche Datei `script_console_post_attestation.py` bleibt -bytegleich SHA256 -`076e1c22c1849c20827317e3cbec7a3769f14f5fd9fc7691ab2e0f0cb80fa1dc`. -Alle ursprünglichen Belege des Falls -`3319e212-2188-4b00-bb82-e13173a3b6b2` bleiben unverändert. Zusätzlich wurden -Quelle und sämtliche 34 zu diesem Zeitpunkt vorhandenen Fallbelege create-only -unter `devstate/source-history/postattn-076-ff0606b7-4740-4dab-9a26-d7679e8d630d/` -archiviert; Manifest-SHA256 -`46d922abd242c56887752ad193343e717292eb4040013c8ca1c69fa4b9f60280`. - -Ein konkreter angereicherter Read-only-Fehlerbeleg identifiziert den verweigerten -Guard `no SQLite sidecars` im Pfad `vm → original_rows → database`: -`transport-88f45793-8bb2-4c31-9804-1efb740e8071.json`, SHA256 -`b7db1bfce80d6cb8ed3eea678c0f102b2f6b7d45e7e7cd97f95bb10343a906f5`. -Das belegt diese eine Sidecarverweigerung. Es belegt weder eine Runtime-/ -Historybeschädigung noch die Ursache sämtlicher früherer RuntimeErrors ohne -Guardnamen. Zwei zusätzliche ausdrücklich autorisierte lesende Diagnosen mit -unveränderter 076-VMfunktion bestanden, auch der vorhandene Server→Inventar→VM- -Pfad; sie wurden nicht zu Abnahmesamples oder einem finalen Attest hochgestuft. - -V2 verändert ausschließlich die Beobachtung der drei exakt bekannten -SQLite-DELETE-Datenbanken: Agentjournal, Agentverbrauchsledger und gemeinsames -Rootverbrauchsledger. Für genau deren drei `-journal`-Pfade beobachtet der -Observer höchstens 250 ms, ob ein reguläres, passend geschütztes Rollbackjournal -natürlich verschwindet. Während es vorhanden ist, öffnet dieser Wartepfad keine -Datenbank, führt keine SQL-Abfrage aus und verändert keine Datei. Der Observer -löscht, benennt, repariert oder recovered nichts. Ein länger vorhandenes Journal, -falscher Objekttyp oder fremder Eigentümer verweigert den Nachweis. WAL und SHM -werden weiterhin sofort verweigert, ebenso jeder unbekannte Suffixpfad. - -Im Zustandsverzeichnis dürfen ausschließlich diese drei transienten -Rollbackjournalpfade nach konkret beobachteter Abwesenheit aus dem Dateipfadzeugen -ausgelassen werden. Es gibt keine allgemeine Suffixausnahme. Alle ursprünglichen -PKI-/Zustandspfade, Metadaten, Inodes und Raw-Rowhashes bleiben unverändert -gefordert. Vor jedem DB-Open bleibt der ursprüngliche Sidecarguard aktiv; direkt -nach dem Read-only-Open wird vor jeder SQL-Anweisung nochmals geprüft. Eine -erneute Sidecarentstehung verweigert die Beobachtung, statt sie zu ignorieren. -Eine atomare Dateisystem-/Datenbankaufnahme wird nicht behauptet. - -`mode=ro`, `query_only`, tatsächlicher DELETE-Journalmodus, 250-ms-Busy-Timeout, -kooperatives einsekündiges Lesebudget und das Schließen jeder Leseperiode vor -Rowhashing/Signaturprüfung bleiben bestehen. Signed-Decision-, Server-, -Schema-/Rowhash- und abschließende Agent-/Helper-Metaguards werden nicht gelockert. -Der Sourcevergleich bestätigt unveränderte ASTs der bestehenden Funktionen -`signed`, `original_rows`, `row_hash`, `server`, `compare_samples` und -`parse_stored_time`. Es gibt weder `immutable=1`, unbegrenztes Busy-Warten, -Helper-IPC, Diensteingriff, Job, Approval, Rechte- noch Policyänderung. - -Auf Fehlern liefert der neue Formatter ausschließlich Fehlerklasse, einen im -Quelltext enthaltenen statischen RuntimeError-Guardnamen, Funktions-/Zeilenframes -und SQLite-Fehlercodes. Er exportiert weder Exceptionlocals noch SQL-stdout, -Token- oder Schlüsselwerte. Normale fehlgeschlagene Rohtransportbelege bleiben -erhalten. Ein solcher Fehler wird niemals als erfolgreicher Sample behandelt. - -Tatsächlich lokal geprüft, ausschließlich mit temporären Testdatenbanken und -den unveränderten echten V2-Helper-/Dateipfadwalk-Funktionen: Ein SQLitewriter -hielt sein Rollbackjournal kurz offen und schloss es selbst durch Commit; nach -rund 42 ms beobachtete der Observer das natürliche Verschwinden, danach war der -Read-only-Read zulässig. Ein persistierendes Journal wurde nach rund 250 ms -verweigert und blieb erhalten. WAL, SHM und ein unbekannter Journal-Suffixpfad -wurden verweigert und blieben erhalten. Der Observer führte keine Mutation aus. -Python-Syntax bestand; Produktinputs und alle archivierten Originalbelege blieben -unverändert. Das ist kein neuer nativer Drei-Sample-Nachweis. - -**Geplant, nicht ausgeführt:** Erst nach gesondertem Rootreview einen neuen -lokalen Intent mit dem V2-Quellhash erzeugen und drei neue tatsächliche -Beobachtungen samt abschließendem Vergleich durchführen. Die beiden ursprünglichen -076-Samples werden nicht umetikettiert oder mit einem V2-Sample zu einem neuen -Attest zusammengemischt. Die tatsächliche WebUI-Jobgenehmigung bleibt ein -getrennter späterer Schritt. - - -## Tatsächliche dreiteilige Cloud-Abnahme - -Root hat nach Quellreview einen neuen ausschließlich lesenden Fall -`4c425416-5a04-426a-a23a-f5801968f02d` vorbereitet und drei getrennte Beobachtungen -auf der tatsächlichen Cloud-Linux-VM und dem festgelegten Server ausgeführt. -Anschließender lokaler Vergleich: **bestanden**. Finaler geschützter Beleg -`attested.json`, SHA256 -`594fdf94261aa882df7ea771dda3f04779533dfdac768cf4a63c83448e1f27d7`. - -Erhaltung der ursprünglichen Geräte-/Boot-/PKI-/DB-Inodes/Root18-Rohbytes, -tatsächliche neue Agent-/General-/Fullimages und Konten sowie aktueller gemeinsam -angewandter kryptografisch geprüfter signierter Sync wurden nachgewiesen. -Zwei gespeicherte Kontakt-/Sequenzfortschritte, konkrete neue Inventar-ID mit -quellgebundenem Queueabschluss und RLS-Tenantverweigerung bestanden. Unveränderte -30Jobs/30Outbox/26Permits, ungeklärt0; keine neuen Jobs oder Freigaben. - -Die Aussage bleibt seitenweise Erhaltung über das Beobachtungsintervall mit -abschließendem SameDecision-/Effektzahlcheck, kein atomarer Gesamtsnapshot oder -neuer Vollintegritätsscan. Kein mitgeschnittener Wire-ACK und kein neuer -HTTP-Tenantnachweis; diese Grenzen sind im Ergebnis explizitfalse. Die Full- -Skriptwirkung bleibt separat WebUI-genehmigungspflichtig und noch offen. diff --git a/docs/script-console-post-attestation.md b/docs/script-console-post-attestation.md deleted file mode 100644 index 54d27f7..0000000 --- a/docs/script-console-post-attestation.md +++ /dev/null @@ -1,201 +0,0 @@ -# Lesender Nachweis nach dem ersten Skriptkonsolen-Dienststart - -Stand2026-11-14: neue reviewbare Quelle -`deploy/script_console_post_attestation.py`; durch ihren Ersteller **kein -Zielaufruf ausgeführt**. Keine Änderung der158 eingefrorenen Produktinputs. -Installationsfall `2e27c312-58cc-444d-92a6-863a11ac6ffd` und dessen ursprünglicher -Fehlerbericht bleiben unverändert. Die separate eng geprüfte Fortsetzung startet -die bereits ausgetauschten Dienste; dieser Nachweis darf das nicht übernehmen. - -## Feste Proben und Erhaltungsgrenzen - -Der VM-Reader öffnet ausschließlich vorhandene feste Kontroll-/Metadatendateien -und die drei ursprünglichen SQLite-Dateien im URI-Modus `mode=ro` mit -`query_only` und Lesetransaktion. Er erzeugt keine Zielpfade, keine temporären -Dateien und keine SQLite-Sidecars. Vorgefundene WAL/SHM/Journaldateien verweigern -die Probe; keine Bereinigung. systemctl wird ausschließlich mit `show` benutzt. -Die zusätzliche OpenSSL-Prüfung verwendet öffentliche Signaturdaten in anonymen -memfd-Dateideskriptoren, keine privaten Schlüssel. Kein Helper-IPC und keine -neue Clock-/Inventory-/Jobanforderung. - -Geprüft werden alle drei tatsächlichen Agent-/General-/Full-Prozessimages, -UID/GID, Startticks, unveränderte Boot-ID, installierte Codehashes und erhaltene -alte Binärinodes/-bytes. Alle General-/APT-/Paketkontrollen des ursprünglichen -Preflightzeugen bleiben exakt; APT und alte Dienste bleiben disabled/inactive. -Fullkonfiguration, ursprüngliche Inspector-Pinbytes, Unit und additives -Agentdropin müssen den geprüften ursprünglichen Bytes/Modes entsprechen. - -Alle ursprünglichen Zustandsobjekte bleiben vorhanden; private Schlüssel werden -nicht geöffnet. Nicht-DB-Dateien behalten vollständige Inode-/Besitz-/Mode-/ -Größen-/Zeitmetadaten. Für Datenbanken dürfen Inhalt und Größe fortschreiten; -ihre Inodes/Besitzer/Modes bleiben. Bei Zustandsverzeichnissen dürfen Größe und -Änderungszeit wegen normaler DELETE-SQLite-Journalerzeugung fortschreiten; -Identität/Besitz/Modes bleiben. Unbekannte neue persistente Zustandsobjekte -werden verweigert. - -`sql-before.json` enthält vollständige geordnete Rowhashlisten einschließlich -rowid. Die Quelle erhält jedes alte Schema und jeden alten Historienhash. -Neue Job-/Verbrauchs-/Wirkungs-/Outcomereihen sind ausgeschlossen. Nur feste -passive Sync-Ausnahmen gelten: Metazeilen, monotoner Sequenzzähler, eine zuvor -NULL gewesene und anschließend unabhängig signiert angewandte Antwort sowie -eine erneuerte Outcome-Entscheidungsreferenz. Letztere verlangt den vollständigen -alten Rowhash, erhaltene exakt gleiche Job-/Versuch-/Outcomebytes und beide -ursprünglich signierten, Agent-/Helper-gebundenen Entscheidungen mit monotoner -Lineage. Keine pauschale Freigabe veränderter Historientabellen. Alte Queuezeilen -müssen im Vorherzeugen fehlen; eine mehrdeutige alte Queue verweigert diese -Quelle. Der ursprüngliche Zähler wird aus seinem Hash in einem höchstens4096 -Sequenzschritte umfassenden Bereich bis zum aktuellen Wert rekonstruiert. Reicht -das nicht, fehlt der Nachweis; kein Quellenfallback und keine Zielreparatur. - -Alle18 ursprünglichen Rootrequests/-grants/-signaturen/-starts/-outcomes bleiben -exakt gleich. Aktuelle Agent-/Helper-Metadaten müssen faultfrei dieselbe -angewandte Entscheidung, Generation, Journalbindung und unveränderte öffentliche -Bindingidentität belegen. Die tatsächliche Ed25519-Signatur und die originalen -Request-/Protobufantwortbytes werden unabhängig geprüft. Die neue Entscheidung -muss innerhalb ihrer ursprünglichen höchstens60s-Lease liegen und eine -ursprüngliche vor dem Bootstrap erhaltene signierte Journal-Lineage fortsetzen. -Das belegt normale NativeClock-/Peer-/Applyprüfungen der gepinnten Runtime; -der Reader erzeugt keine neue Probe und erteilt keine Jobstartberechtigung. - -## Passive Serverkontakte und konkrete Nachweisgrenzen - -Der Serverreader führt ausschließlich gespeicherte Datenabfragen in -Read-only-Transaktionen aus. Er liest keine Anmeldetokens oder privaten -Umgebungs-/PKI-Dateien. Rootpolicyhash und geschlossener Ablauf bleiben gebunden; -30Jobs/30Outbox/26Permits/keine offenen Jobs bleiben erhalten. Die30 vollständigen -Jobzeilenfingerprints müssen über alle drei Beobachtungen gleich bleiben. -Die alte Jobsammlung ist zusätzlich durch die VM-Vorherhistorie gebunden; dieser -neue Reader rekonstruiert keinen früher nicht vorhandenen Server-Rowsnapshot. - -Jede Beobachtung bindet dieselbe tatsächlich gespeicherte signierte Entscheidung -an Server, Agent und Helper sowie die normal veröffentlichte Full-Policy-/ -Binärcapability. Ein RLS-Aufruf als `rmm_app` im anderen Testtenant muss für das -feste Gerät, dessen Inventar und Jobs jeweils null Zeilen liefern. Das ist ein -echter gespeicherter Datenbank-RLS-Nachweis, **keine neue HTTP-/MCP-Authabnahme**. - -Drei ausdrücklich getrennte `observe`-Aufrufe liefern Baseline und zwei danach -streng fortgeschrittene gespeicherte Heartbeatzeitpunkte samt Sequenz. Prozesse, -Boot und Verbindungsgeneration müssen über alle drei Reads gleich bleiben; -der aktuelle Kontakt darf beim Read höchstens45s alt sein. Frische Kontakte und -Inventar werden an den dauerhaften `first_start_not_before`-Zeitpunkt der -separaten `continuation-start-intent.json` gebunden. Kein Sleep, Agentneustart -oder angeforderter Refresh zur Erzeugung dieser Daten. - -Ein konkreter neuer `linux.base`-Inventar-Message-ID-/Boot-/Payloadbeleg muss -serverseitig vorliegen und denselben lokalen dauerhaften Queueeintrag beendet -haben. Die Quelle bezeichnet dies ausdrücklich als **quellgebundenen -Queueabschluss**, `wire_inventory_ack_captured=false`: Der bestehende Agent -speichert rohe ACKframes nicht dauerhaft. Aus dieser Probe darf kein angeblich -mitgeschnittener ACKframe entstehen. Der normale ACK-/signierte Sync-ACK-Pfad -der gepinnten Runtime entfernt den Eintrag; der Reader löscht nichts. - -## Geplante Bedienung, nicht ausgeführt - -Nach Rootreview und erfolgreicher separater erster Dienststartfortsetzung: - -```text -python3 deploy/script_console_post_attestation.py prepare-local -python3 deploy/script_console_post_attestation.py observe --id POSTCASE -python3 deploy/script_console_post_attestation.py observe --id POSTCASE -python3 deploy/script_console_post_attestation.py observe --id POSTCASE -python3 deploy/script_console_post_attestation.py finish --id POSTCASE -``` - -Die Beobachtungen zeitlich über zwei normale Heartbeats verteilen. Unveränderte -Kontakte oder unvollständige Signatur-/Queue-/Readinessbelege ergeben kein PASS. -`finish` liest ausschließlich die lokalen drei erhaltenen Belege; seine Aussage -betrifft diesen erhaltenden Runtime-/Sync-/Passivnachweis. Keine RMM-Jobs, -Genehmigungen, Paketwirkung oder Reboots. Der eigentliche FullMaintenancejob -bleibt ein separat unveränderlich beantragter und WebUI-genehmigter Plan. - -## Tatsächliche lokale Prüfung und offene Zielnachweise - -Python-AST der neuen Quelle ist geprüft. Die tatsächliche lokale Vergleichs- -funktion bestand zunächst eine ausdrücklich synthetische Dreierbaseline und -zwölf unabhängige Manipulationsverweigerungen; nach Ergänzung der ausdrücklichen -Serverbelegpflicht bestand dieselbe tatsächliche Funktion eine neue synthetische -Dreierbaseline und15 unabhängige Verweigerungen. Keine VM-Daten wurden hierfür -erzeugt. Die tatsächliche Serverreaderfunktion wurde zusätzlich mit gemockten -Datei-/Subprozessgrenzen auf genau zwei Read-only-Abfragen einschließlich -`rmm_app`-RLSkontext geprüft; kein echtes PostgreSQL wurde aufgerufen. -Das ist keine native Abnahme. -Ziel-SQL, SSH, OpenSSL auf der VM, reale Signatur-/Erhaltungs-/Heartbeat-/ -Inventar-/RLSbelege sind durch diesen Subagenten nicht ausgeführt. - -## Getrennter Transport-/Leselock-Nachfolger - -Root hat mit dem ursprünglichen Runner89121b42 im Fall77d0b7c1 tatsächlich einen -VM-Erhaltungs-/SignedSyncread bestanden; die anschließende Serververbindung -scheiterte an einem für den DNSnamen fehlenden SSH-Hosteintrag. Daraus entsteht -kein vollständiger Server-/Passivnachweis. Originalquelle und alle vier -ursprünglichen Case-/Transportdateien bleiben unverändert; die Quelle liegt -zusätzlich create-only in `devstate/script-console-post-attestation-source-history/`. -Der Nachfolger verwendet dieselbe bereits verifizierte Server-IP und dieselbe -strikte Hostprüfung wie die vorhandenen Deploymentwerkzeuge. Keine neuen -Hostschlüssel oder Änderungen an known_hosts. - -Der Review der ursprünglich14s dauernden VM-Probe fand einen vermeidbaren -Leselock: Rowhash-/Referenzsuche und externe Signaturprüfung lagen im äußeren -SQLite-Lesekontext. Der erste Nachfolger materialisierte die ursprünglichen -Zeugen innerhalb einer Lesetransaktion und schloss sie vor Hash-/Signaturarbeit. -Die echte nachfolgende Root-Probe mit Runner1e172625 und lokalem Fall5a53ced7 -verweigerte beim Materialisieren unter dem1s-Limit mit `OperationalError`; das -ist kein PASS. Auch diese Originalquelle und ihre sieben ursprünglichen -Casedateien bleiben create-only archiviert beziehungsweise am Originalort. - -Der zweite Nachfolger liest deshalb **höchstens16 ursprüngliche Zeilen pro -Lesetransaktion**, nach rowid geordnet. Jede Seite schließt vor Hash-, -Referenzsuche oder Signaturprüfung. Ursprüngliche Hashprefixe werden vollständig -geprüft; neu angehängte Sync-BLOBs werden nicht vollständig eingelesen. Nur die -ursprünglichen Entscheidungs-IDs werden zusätzlich als kleine Metadatenliste -gehalten. Anfangsanzahlen/Schema und abschließend feste Job-/Wirkungsanzahlen, -Root18-Originalbytes und frische gleiche Agent-/Helperentscheidung werden -separat geprüft. Dies ist ein seitenweiser Erhaltungsbeleg über das berichtete -Beobachtungsintervall, **kein tabellenübergreifender atomarer Snapshot**. -Ein neuer vollständiger SQLite-Integritätsscan wird nicht behauptet -(`sqlite_integrity_scan_performed=false`); Schema und alle ursprünglichen -Zeilenbytes werden unabhängig erhalten und die normale signierte Runtime- -Lineage bleibt zwingend. Keine pauschale Ausnahme für historische Tabellen. - -Zusätzliche einzelne Signaturreferenzabfragen haben eigene kurze Lesekontexte. -Ein kooperatives -SQLite-Progressbudget von1s und0,25s Busytimeout begrenzen die Abfragen; das ist -keine harte Echtzeitgarantie für blockierendes Betriebssystem-I/O. Ein Timeout -bricht den Nachweis ab und schließt/rollt ausschließlich die eigene Lesetransaktion -zurück; keine Produktzeile wird geändert oder ignoriert. - -Tatsächlich lokal mit der extrahierten neuen Lesekontextfunktion geprüft: -2000 synthetische Zeilen materialisiert, anschließend sofortiger Writercommit -in0,93ms; eine absichtlich lange reine SELECT-Rekursion wurde nach1000,13ms -unterbrochen, danach Writercommit erfolgreich. AST-Prüfung belegt keine -Rowhash-/Signatur-/Subprozessarbeit innerhalb eines `database`-Kontexts. Das -ist ein lokaler SQLite-Guard, kein neuer VM- oder Produktions-Locknachweis. - -Der tatsächliche zusätzliche lokale Pagingguard materialisierte50 ursprüngliche -Zeilen mit je64KiB über vier kurze Seiten, während zwischen den geschlossenen -Seiten zusätzliche passive Testzeilen angehängt wurden. Neue Anhänge wurden -nicht mitmaterialisiert; Writercommits zwischen den Seiten dauerten höchstens -0,94ms. Die SELECT-Budgetprobe unterbrach nach1000,10ms und ließ danach einen -weiteren Writercommit zu. Auch dies ist ausschließlich ein synthetischer lokaler -SQLite-Nachweis; kein weiterer Zielaufruf durch diesen Subagenten. - - -## Lokaler Zeitparser und aktueller Prüfzwischenstand - -Der erste Nachfolger2786c218 las nativ VM und Server, scheiterte anschließend -im lokalen Python3.10-Parser an einem gültigen PostgreSQL-RFC3339-Wert mit vier -Nachkommastellen. Eine lokale Korrektur akzeptiert SQL-Zeitstempel mit0–6 -Nachkommastellen und füllt ausschließlich fehlende Nullen auf; keine Rundung, -Trunkierung oder Änderung von VM-/Serverdaten. Ursprüngliche Quelle und Case8614 -wurden create-only erhalten. Quelle076e1c22 verwendet dieselben unveränderten -VM-/Serverreader und einen neuen rein lesenden Fall3319e212. - -Zwei vollständige zeitversetzte Beobachtungen dieses Falls sind tatsächlich -bestanden (Generation131, unveränderte18Rootverbräuche). Der dritte Beleg ist -noch offen. Zusätzliche Fehlerformatierung ließ alle Prüfbedingungen und -Ergebnisdaten unverändert und exportierte ausschließlich statischen Guardcode, -Frames und SQLitecode. Damit ist für eine konkrete Verweigerung -`no SQLite sidecars` nachgewiesen; welche Prüfbedingung die älteren generischen -RuntimeError-Belege auslöste, wird nicht nachträglich erfunden. Separate lesende -Kontrollaufrufe bestätigten weiterhin Erhaltung/SignedSync und konkrete -Inventar-Queuekonvergenz. Bisher kein dreiteiliger Gesamt-PASS und kein Job. diff --git a/docs/script-console-windows-link.md b/docs/script-console-windows-link.md deleted file mode 100644 index f94b62b..0000000 --- a/docs/script-console-windows-link.md +++ /dev/null @@ -1,124 +0,0 @@ -# Windows-Skriptkonsole: native Units bestanden, Runtimeabnahme offen - -Tatsächlicher Stand2026-11-14, Spezifikation1.20: Nach dem tatsächlichen -Linux-Unitnachweis mit84 bestandenen Tests und5 ausdrücklich ausgelassenen -Datenbankfällen wurden die Windows-Release-Unitprogramme und beide -Windows-Runtimeprogramme aus denselben unveränderten158 Compilerinputs -erfolgreich gelinkt. Der separate isolierte PostgreSQL-Lauf des Linuxpacks -hatte bereits alle45 Servertests einschließlich der5 Datenbankfälle bestanden. - -Das neue Linkmanifest liegt privat unter -`devstate/script-console-windows-link/run-d0b7c844-6770-4930-ac87-4380c87fbad7/manifest.json`, -SHA256 `4b31e6a997248f91db00cf56d7d6043a6feb840be237b9a5a5de5eb71ee4b80c`. -Es bindet das Quellmanifest -`ddd1a78d1cd289b02b1f98572f9652171ec00be84e01ce099fd722d689bcaacd` -und den tatsächlichen Linux-Nativbeleg -`a831a70a3cf76a3e8a9bf5820dcca7100d2ef9860dd9388539fe9c13f949f470`. -Der GNU-Crosslinker lief im unveränderlichen Offline-Dockerimage -`sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9` -für `x86_64-pc-windows-gnu`. Die ursprünglichen Linkbytes und die zur -Bereitstellung von Debugdaten bereinigten PE-Dateien werden getrennt erhalten. - -| Artefakt | SHA256 der Bereitstellungsdatei | -| --- | --- | -| `windows-lib-tests.exe` | `d4e37cbec44766d6d520e4d358a43f5f58779659261172084ad1746640a73993` | -| `windows-agent-tests.exe` | `eaa0cc0331d5e5a48090de7c8f904c13f27bfe4d1a029e6638f5d96573f262b8` | -| `rmm-helper-windows.exe` | `89482ed2914465ffbe06062fe828539edd6a3bed2c9491e6f75be9e538ce286d` | -| `rmm-agent-windows.exe` | `7e8c3cc0045584cf551ded7a71531b771bb34cde915bff5f5ab60f54f4365960` | - -Der PipeV2-Quellhash bleibt -`ce525dab23f2e4faa2c9816280c1a5a8b40e56d0e63a350256e83b2df1d9229d`. -Der Build verändert keine Dienste, Geräteidentitäten, Journale, Policies oder -Capabilities. Er verwendet keine Zugangsdaten und startet keine Windows- -Testprogramme oder RMM-Dienste auf der VM oder dem Entwicklungsnotebook. - -**Tatsächlich nativ bestanden:** Beide vollständigen Windows-Listen wurden vor -jedem Testlauf festgehalten; alle 36 Bibliotheks- und sieben Agenttests bestanden -ohne Fehler, Auslassung oder Filter. Frühere 23+7- oder 35+7-Abnahmen anderer -Quellstände werden nicht auf dieses Pack übertragen. Der Administrator-Unitlauf -ersetzt weder laufende LocalService-/SYSTEM-Dienstnachweise noch die native -Zeitfreigabe oder einen WebUI-genehmigten Skriptauftrag. Die neue Windowsruntime -wurde dadurch nicht bereitgestellt. Es wurden keine neuen Windows-Capabilities -aktiviert; die Runtime-Zeitfreigabe bleibt geschlossen. - -Der dafür vorbereitete separate Runner ist -`deploy/script_console_windows_acceptance.py`. Seine Python-Syntax, -vollständigen lokalen Herkunftsprüfungen und gezielten synthetischen -Listen-/Ergebnisvalidatorfälle wurden geprüft: beide positiven Fälle und sechs -Verweigerungsfälle für falsche Herkunft, doppelte beziehungsweise fehlende -Testnamen und ausgelassene Tests bestanden. Diese künstlichen Daten sind kein -Windows-Ausführungsbeleg. - -Der anschließende lesende Vergleich mit dem tatsächlich geprüften Harness aus -Commit `1136707` fand einen Fehler im neuen Bootstrapcode: fünf ungültige -`-cine`-Operatoren statt `-ine`. Python-Syntax- und JSON-Validatorprüfungen hatten -die eingebettete PowerShell-Syntax nicht geprüft. Der ursprüngliche Stand -`46f62b54fce5a0411b6ced1322bf20ebe315877df559185e6aa1714d62718659` -und sein unbenutzter lokaler Intent bleiben erhalten. Der vorhandene lokale -PowerShell-Parser wurde anschließend über seinen bestehenden Clock-Harnesspfad, -Dateieigentümer und Toolhashes gebunden; sämtliche Tooldateihashes blieben vor -und nach der Prüfung gleich. Tatsächliche PowerShell 7.7.0 `ParseFile` und -`ParseInput` meldeten für das ursprüngliche vollständige Skript jeweils 14 -Parserfehler, nach dem engen Operatorfix jeweils null. Es wurde ausschließlich -geparst, kein Inhalt des Skripts ausgeführt. - -Der korrigierte Stand -`8f0684053f998733607ec28bb0c5e17cb313e2209bd8a276589881783852b1f7` -wurde danach durch den übergeordneten Entwickleragenten tatsächlich bis zum -Bootstrap-Prepare auf der Windows-VM ausgeführt. Der erste SFTP-Upload scheiterte -vor der Übertragung: Dem Zielpfad fehlte der führende Slash, deshalb wurde er -relativ zum Benutzerverzeichnis aufgelöst. Der tatsächliche lesende Readback -des Falls `4e59cc83-df75-4a65-9679-c8c8b48a4e5a` bestätigte vorhandenen -Prepare-Fall, `list_entered:false`, `run_entered:false` und keine Teilberichte. -Das war ein Harnessfehler; kein Windows-Unittest wurde ausgeführt. Quellstand, -Intent und Readback bleiben unverändert erhalten. - -Aktueller Runner: -`41fc85342ec40fb48b075717ccf7a4c76f788296f1f69fb5c5bdc10ddb78a9c5`. -Die zusätzliche Korrektur setzt ausschließlich den absoluten SFTP-Zielpräfix -`/C:/ProgramData/...`; das PowerShell-Skript ist bytegleich zum Operatorfix. -Vollständiges Skript und tatsächlicher Transportwrapper bestanden erneut sowohl -`ParseFile` als auch `ParseInput` mit null Fehlern. Zunächst ausschließlich lokal -vorbereiteter und danach nativ verwendeter Fall: -`76bb47dd-9334-46ff-ab64-a6b173d95e24`, Intent-SHA256 -`e350c3eb46dea9107fc2478981a624f5767c1fbd3c171523dbbf7dfdbc18057c`. -Der übergeordnete Entwickleragent führte für diesen Fall anschließend die -Listenphase tatsächlich erfolgreich aus: 36 Bibliotheks- und sieben Agenttests, -beide vollständigen Listen vor jeder Testausführung. SHA256 der unveränderten -Original-Listenbytes: -`13288f7c50db7ed5a38b439cda17d9e00cdbe1355b584498e7a4ce8f0d8b58e9`. -Dies sind die tatsächlichen neuen Listen mit insgesamt 43 Fällen, keine -Umetikettierung der älteren 42 Fälle. Der separate einmalige Lauf gegen genau -diesen SHA bestand mit 36+7 Tests, jeweils null Fehlern, Auslassungen und -herausgefilterten Tests. Der anschließende Readback validierte denselben -unveränderten Ergebnisbeleg ohne Wiederholung. Privater Beleg: -`devstate/script-console-windows-native/76bb47dd-9334-46ff-ab64-a6b173d95e24/passed.json`, -SHA256 `6d0fea175d63a27eaf754ee4ab921b220e3b910a4d74c44f5e560518d6b7b512`. -Der ursprüngliche Run-Reply hat SHA256 -`e458af4b84d61809b9c614de73773c3b15ee47a0a37c0a5a88400285342e5ef7`. -Manifest-, Quell-, Linux- und Listenbindungen sowie sämtliche Scopeflags wurden -erneut geprüft. Keine Produktinstallation, Clock-/SYSTEM-Freigabe oder -RMM-Jobausführung folgte aus dieser Unitabnahme. - -`prepare-local` erstellt einen -privaten unveränderlichen Fall mit Quell-, Skript-, Unterstützungsquell-, -Artefakt- und Linux-Belegbindung. Im tatsächlichen Ablauf führte nach unabhängiger -Quellprüfung `list --case ` auf der Windows-VM ausschließlich beide -vollständigen `--list`-Aufrufe aus. Die tatsächlichen Listen wurden als -unveränderte Originalbytes mit SHA256 erhalten. Erst ein separater Aufruf -`run --case --lists-sha ` führte genau diese beiden -Unitprogramme jeweils einmal ohne Filter aus. Ein vorheriger dauerhafter -Startmarker verhindert Wiederholung. `read --case ` las allein die -ursprünglichen Teil-/Endbelege; eine verlorene Antwort löst keinen erneuten -Testlauf aus. Alle 158 Quellbindungen und sämtliche vier ursprünglichen und -bereitgestellten PE-Dateien werden auch vor jedem Readback geprüft. - -Das native Testenvironment ist geleert; `WINDIR` und `SystemRoot` werden gegen -das native OS-Systemverzeichnis geprüft und `SystemDrive` daraus abgeleitet und -mit einem gegebenen vorhandenen Wert verglichen. Die Unitprogramme verwenden -einen privaten temporären Fallpfad. Keine SQL-, Helper-, Dienst-, Zeitrichtlinien-, -Capability- oder RMM-Jobänderung gehört zu dieser Prüfung. Ein erfolgreicher -Administrator-Unitlauf ist kein LocalService-/SYSTEM-Runtimenachweis. -Die Flags zu unveränderten SQL-/Produktdaten beziehen sich auf bestehende -Produktdatenbanken und Journale; private temporäre Unitdatenbanken gehören zu -den Bootstrap-Testartefakten. diff --git a/docs/server-deployment.md b/docs/server-deployment.md index d7f692d..8a7973e 100644 --- a/docs/server-deployment.md +++ b/docs/server-deployment.md @@ -1,500 +1,40 @@ -# Dedizierter RMM-Server: aktuelle Verweise und historische Bereitstellung +# Aufbau des dedizierten Servers -## Öffentliche Verwaltung und Erstaufnahme, 17. November 2026 +Der ARM64-Server `discovery.ease-technologies.de` betreibt die WebUI, den MCP-Endpunkt, die Geräte-API und PostgreSQL. Unter `/opt/rust-discovery` liegen Deploymentkonfiguration, WebUI und der private Betriebszustand. Der externe Zugriff verteilt sich auf zwei TLS-Eingänge. -WebUI und MCP sind inzwischen ebenfalls auf dem öffentlichen TLS-Ingress erreichbar. Passwort/TOTP und eigenständige MCP-Tokens sind im [aktuellen Aufbau](public-access.md) beschrieben. Die folgenden Angaben zum engeren Installer-Ingress dokumentieren dessen frühere Freischaltung. - - -Die Geräte verwenden `discovery.ease-technologies.de:443` mit der Geräte-PKI. Auf Port 8443 liefert `rmm-install-ingress.service` den [Linux-Installer](https://discovery.ease-technologies.de:8443/install/linux.sh) und den [Windows-Installer](https://discovery.ease-technologies.de:8443/install/windows.ps1) über die öffentliche Zertifikatskette. Im Test antworteten beide Skripte mit HTTP 200, der Releaseabruf ohne Einmalcode mit 401 und die privaten Routen `/mcp` und `/auth/dev/login` mit 404. Die Konfiguration prüft das Gateway-Zertifikat auch intern. [Ingress-Konfiguration](../deploy/server-bootstrap-ingress.conf) - -Das gegenwärtige öffentliche Zertifikat läuft bis 11. Februar 2027. Der täglich aktivierte Timer `rmm-install-tls-renew.timer` prüft den Ablauf und beantragt unter 30 Tagen Restlaufzeit eine neue Kette über den vorhandenen ACME-Zugang. Der erste Lauf bestätigte die Restlaufzeit. Eine tatsächliche Neuausstellung mit diesem Runner steht aus. [Erneuerung](../deploy/renew_bootstrap_tls.py) - - -Die aktuelle Topologie besteht aus dem dedizierten ARM64-Server, seiner getrennten API- und Gatewayrolle und internem PostgreSQL. Verwaltung über den SSH-Tunnel, Geräte verbinden sich direkt ausgehend. Den geprüften Betriebsstand und die aktuelle Migration enthält die [Live-Nachlese vom 17. November](evidence/product-audit-20261117.json). Die laufenden Containerlabels bestimmen bei einer Entwicklungsausrollung die vollständige Compose-Dateikette. [Entwicklungsweg](development.md) · [Zugänge](operations-access.md) - -Nachfolgend **historische Bereitstellungschronik ab 13. November 2026** -(damals Spezifikation 1.13, Linux-MVP noch nicht abgenommen). Alte Zähler, -Images, Fristen, Windowszustände und Bootstrapdownloadlinks sind keine -heutigen Freigaben oder Startanweisungen. - -## Aktueller erhaltender Serverwechsel - -**Spätere notwendige VM-Bootstrapfinalisierung:** Der vorhandene geprüfte -General-Helper war aktiv, aber disabled. Nach geschlossenem Offline-Ablauffall -und0offenen Agent-/Rootwirkungen ausschließlich`systemctl enable` dieser festen -Unit ausgeführt; kein`--now`, Dienststart/-restart oder Reboot. Tatsächlicher -vorheriger Readonly-Preflight und nachheriger Check bestätigten identische -öffentliche Schlüssel-/Gerätepins, Unit-/Helperbytes, Boot/PIDs, drei DBinodes -und Root-Verbrauchszeilen. Genau der root-owned Multiuser-Wants-Link zur -bekannten Unit wurde hinzugefügt. Agent bereits enabled; APTinactive/Endpunkt -weiter geschlossen. Private Reports`devstate/general-autostart-{preflight,enabled}.json`. -Dies ist ein Setup-/Autostartnachweis, kein ausgeführter Reboot. - -Kandidat73aab983-fd45-4294-b812-03cb9823148b nativ auf ARM64 gebaut und explizit -deployed. Build bewegte den Runtimetag nicht; bewusstes Deployment verwendete -denselben qualifizierten Imagedigest. UI-Indexa3513f92 unverändert/CAS-geprüft, -Migrationen1–13 und bestehende Datenbank/PKI weiterverwendet. Enthält die lokal -mit drei isolierten PostgreSQL-Tests qualifizierte konservative Rebootfrist -und getrennte Inventar-Eingangsprüfung; **noch kein tatsächlicher Reboot**. - -Nach tatsächlichem Wechsel gespeicherten fehlgeschlagenen Noop unverändert -gelesen: gleicher Versuch/Grant/errorSTATUS_FINGERPRINT. Zentral22Jobs/22Outbox/ -20Grants/0offen, Root13/0offen/0Faults, Agentjournal integritätsgeprüft/faultfrei; -Agent und beide Helper aktiv. Kein neuer Auftrag/Grant durch Deployment. -Private Readbackdatei unter`devstate/server-upgrades/73aab983-fd45-4294-b812-03cb9823148b.native-readback.json`. -Native1.1-APT-Acceptance bestanden; beide Noops und übrigeMVP-Gates offen. -Ältere Meldungen unten beschreiben ihre jeweiligen historischen Zwischenstände. - -## Neuester APT-/Bootstrapstand - -**Abgeschlossene Windows-Passivstrecke:** Migration 13 auf Cloudserver angewendet, -Windows-11-Gast als LocalService mit mTLS/WSS, gespeichertem Inventar, zwei -Heartbeats, Tenant-B-Verweigerung und sieben nativen Tests bestätigt. Null -Windows-Jobs/Outbox/Grants. Exakte APT-Unknown-Evidenz und 13/13/12/1 beim -Serverwechsel erhalten. Rootpolicy geschlossen; Configure-Korrektur nur lokal, -kein neuer Paket-/Recoverylauf. Aktuelle Plattformmatrix: `platform-support.md`. -Die folgenden Meldungen sind vorherige Zwischenstände. - - -**Neuester Versuch:** Hook armed/APT 0, aber Fixture 1.0 laut gespeicherten Logs -nur unpacked, Nachprüfung `DPKG_INCONSISTENT`, Ergebnis **unknown**. Ledger9/1 -unresolved, zentrale13/13/12; Rootpolicy geschlossen, kein weiterer Paketversuch. -Windowsprobe bestanden, LocalService/mTLS/Heartbeat online, Inventar-SQL-Migration -offen. Aktuelle Details in `implementation-status.md`; folgende Zwischenstände -nicht als heutigen finalen Erfolg lesen. - - -**Fortsetzung:** Signierter einzelner Retryvertrag implementiert, neue -Helper-Sandboxreadiness auf Cloud-VM bestanden. Cloudserver und Linux-Agent -identitäts-/journalbewahrend aktualisiert, Linux online/sync-ready. APT-Endpunkt -wieder aktiv, befristete ausschließlich begrenzende APT-Testpolicy; noch kein -neuer Paketjob. Zähler unverändert 12/12/11. Windows-Inventarserverpfad bereit, -nativer Windows-Clientnachweis noch offen. Neueste Details: -[implementation-status.md](implementation-status.md). Die folgenden Angaben -sind der vorige abgeschlossene Snapshot. - -APT-Ursache und Sourcekorrektur nativ eingegrenzt/geprüft: `--no-download` -verhinderte die lokale Archivpfadauflösung, echter Hook meldete `**ERROR**`. -Lokale Acquisition erlaubt, echte IP-Socketsperre in Worker/Hook/Probe geprüft; -neuer Readiness-Probe auf Cloud-VM bestanden. Rootledger acht bekannte geschlossene -Versuche, ursprünglicher Fehlversuch/Marker erhalten; kein Paketretry/Acceptance. -Gesamt **12 Jobs / 12 Outbox / 11 Grants**, keine ungeklärten Jobs. -Root-Diagnosepolicy geschlossen, APT-Daemon gestoppt, Linux-Agent online/sync-ready. -Ausführliche Befehle/Tests/Hashes: [implementation-status.md](implementation-status.md). - -User erlaubt nun Windows parallel vor Linux-MVP-Abnahme. Eigenständiger Windows- -Gast auf Notebook per ausgehendem SSH-Bootstrap-Reversetunnel erreichbar; -Notebook-Host bleibt ohne Agent. Windows-SSH `127.0.0.1:22222`, Cloud-Reverseport -`127.0.0.1:22240`, extern nicht erreichbar; eigenes forwarding-only Konto mit -befristetem VM-generiertem Schlüssel. Windows-Adminzugang nativ bestätigt, -noch kein RMM-Windows-Agent/Enrollment. Details: [Windowszugang](../deploy/windows/README.md). - -Zusätzlich auf ausdrücklichen Userwunsch befristeter Public-only Bootstrap- -Download über **8443/TLS mit öffentlicher Let's-Encrypt-Kette**. Keine Änderung -an Projekt-TLS/mTLS auf 443, keine öffentliche Verwaltung. HTTP80 nur für ACME -benutzt und danach wieder geschlossen. Downloadfreigabe und Firewall8443 enden -per aktivem Ablauf-Timer am **2026-11-14 12:55:31 UTC**. Die untenstehenden -Port-/Hash-/Zählersnapshots sind ältere Zwischenstände. - -## Verbindlicher Auftrag - -Der User ersetzt die bisherige lokale Servertopologie durch den dedizierten -Internetserver **88.99.80.202**, Domain **discovery.ease-technologies.de**. -`root` ist ausschließlich SSH-Bootstrapzugang; -der RMM-Anwendungsdienst soll unprivilegiert laufen. **Endgültiger Entwicklungs- -und Testaufbau laut neuester Userkorrektur:** Cloud-Test-VM als Client, dieser -Cloudserver als Server, dieses Notebook ausschließlich zur Entwicklung. -Hier keinen RMM-Client installieren, enrollen oder betreiben. Die frühere Aussage -zum lokalen Notebook-Client ist überstimmt. Cloud-VM und später beauftragte -weitere Agenten verwenden diesen Server direkt ausgehend. Ein -PC→Linux-Test-VM-Reversetunnel gehört nicht mehr zum vorgesehenen RMM-Verbindungsweg. -Der oben genannte Windows→Cloud-Reversetunnel ist ausschließlich der neu -beauftragte SSH-Bootstraptransport. - -Die Maschine ist aus dem Internet erreichbar. Öffentlich nur ausdrücklich -eingerichtete Endpunkte anbieten: Agent-TLS mit geprüfter Serverkette und nach -Enrollment mTLS; keine öffentliche Dev-Anmeldung oder Datenbank. Dockerports -auch dort nur Loopback, PostgreSQL ohne Portveröffentlichung. Ein separater -öffentlicher TLS-Ingress darf nur die dafür vorgesehenen Agentfunktionen -erreichbar machen. Die Verwaltungsoberfläche bleibt zunächst über SSH-Tunnel -zugänglich, bis Domain und sichere öffentliche Anmeldung feststehen. - -TLS-Verifikation niemals abschalten. TCP-Connect-Overrides dürfen weder SNI noch -Zertifikatsnamensprüfung ändern. Root-SSH ersetzt keine Geräteidentität oder -Anwendungsauthentisierung. Jeder RMM-Job bleibt bis zur interaktiven WebUI- -Genehmigung seines unveränderlichen Plans `pending_approval`; die bekannte -dev/test-Browsersimulation ist keine öffentliche Produktionsanmeldung. - -## Konfiguration und Datenbestand - -- Server-SSH-Daten lokal in `credentials/server.conf`, Modus 0600 im - gitignorierten Verzeichnis `credentials/` mit Modus 0700. Keine Schlüssel oder - Tokens in Git, Chat, Kommandoargumenten oder Logs. -- Der alte Serverstand befindet sich auf einem nicht erreichbaren anderen PC. - Der User hat die Neuerzeugung ausdrücklich erlaubt. Neue CA, Zugangsdaten und - Datenbank bilden einen neuen Testbestand; dies stellt die alte Historie und - Vertrauenskette nicht wieder her. Bestehende VM-Identitäten/Journale erhalten. -- Domain vom User festgelegt: `discovery.ease-technologies.de`; DNS zeigte bei - der Prüfung auf den zugewiesenen Server. TLS mit eigener Projekt-CA ist - eingerichtet. Öffentliche WebUI/OIDC bleiben **not_configured**; die - dev/test-WebUI ist ausschließlich über SSH erreichbar. -- Lokale Entwicklungsartefakte können auf dem Notebook gebaut werden; dort - läuft nach dem Umzugsauftrag kein RMM-Server mehr. Neue private Schlüssel und - Daten dürfen ausschließlich geschützt zum vorgesehenen Server übertragen - werden. Agenten erhalten nur öffentliche CA, eigenes Enrollmentmaterial und - ihre eigene Geräteidentität, keine privaten zentralen Schlüssel. - -## Tatsächlich ausgeführt - -- Neuer lokaler Testbestand vor dem Umzugsauftrag erzeugt; Docker-Releasebuild, - Migrationen und CA-verifizierter Healthcheck erfolgreich. Kurzzeitig Server - ausschließlich auf `127.0.0.1:18443`, PostgreSQL ohne veröffentlichten Port. -- Nach dem Umzugsauftrag `python3 deploy/dev.py down` tatsächlich ausgeführt: - eigene lokalen Server-/Datenbankcontainer gestoppt und entfernt; Datenvolume, - CA und Schlüssel erhalten. Keine fremden Container verändert. -- SSH-Hostschlüssel vom User bestätigt und strikt gepinnt. Vorhandener - Notebook-Schlüssel war bereits freigeschaltet; separater Schlüssel-Login - erfolgreich. Keine Notwendigkeit, das bereitgestellte Einmalpasswort zu - hinterlegen oder eine weitere Root-Schlüsseldatei zu verteilen. -- Inventur: Ubuntu **26.04**, **aarch64**, anfänglich nur SSH öffentlich. - Docker und Compose installiert, keine Distribution aktualisiert, kein Reboot. - Backend nativ auf dem ARM64-Server aus gepinnter Rust-Toolchain/Lockfile gebaut. - Das ist Backendbetrieb auf ARM64, keine ARM64-Agentfreigabe. -- Eigene Dienstidentität `rmm-server` mit UID 10001, Container unprivilegiert, - Root-Dateisystem readonly, Capabilities entfernt, NoNewPrivileges aktiv. - PostgreSQL gesund, Migrationen 1–12 auf frischem Bestand angewendet. -- SSH-Passwort-/Keyboard-Interactive-Anmeldung deaktiviert; Key-Login danach - erneut erfolgreich. Hostfirewall aktiv, eingehend nur TCP **22/443** erlaubt. - Keine fremden Dienste oder bestehenden Firewallregeln zurückgesetzt. -- `deploy/server.compose.yaml`: privater API-Dienst auf **127.0.0.1:18443**, - separater Gateway auf **127.0.0.1:18444**, PostgreSQL ohne publizierten Port. - Kein privater CA-Signierschlüssel im API-Container; Gateway hält die für - Enrollment erforderliche CA. Beide nutzen denselben dauerhaften DB-/Jobbestand. -- Host-Units `rmm-server-ingress.socket/service` nehmen öffentlich TLS auf 443 - an und leiten TCP zum Gateway weiter. Keine TLS-Terminierung im Proxy; - Clientzertifikate gelangen unverändert zum Rust-Gateway. -- Extern tatsächlich geprüft: `/healthz` **200**; `/`, `/auth/config`, - `/auth/dev/login`, `/mcp`, `/api/v1/tenants` jeweils **404**; öffentlicher - Signierschlüssel ohne Gerätezertifikat **401**. Fremde CA und falscher TLS-Name - werden verweigert. Ports **18443/18444/5432** extern nicht erreichbar. -- Eigene CA mit Server-SANs `discovery.ease-technologies.de`, `localhost` und - historischem Testalias `rmm-dev.internal`. Kein globaler Truststore verändert. - Neue Clients erhalten die öffentliche CA gezielt. Leaf-Zertifikat 30 Tage; - `rmm-server-tls-renew.timer` prüft täglich, erneuert bei weniger als sieben - Tagen Restlaufzeit und startet nur die eigenen API-/Gatewaycontainer neu. - Native Prüfung des aktuellen Nicht-Erneuerungsfalls bestanden. Erzwungene - Erneuerung und CA-Rotation wurden **nicht** abgenommen; vor CA-Ablauf ist - gesonderte kontrollierte Rotation nötig. -- Private WebUI über SSH-Tunnel unter **https://localhost:18443** erreichbar; - Originbindung und Anmeldung mit Secure-/HttpOnly-Cookie tatsächlich geprüft. - Simulierter dev/test-Principal, keine Produktions-/OIDC-Abnahme. - -## Tatsächliche Clientumstellung - -Die tatsächliche Linux-x86-64-Test-VM ist mit einer neuen getrennten Testidentität -direkt gegen den Server verbunden. Vor der Userkorrektur wurde zusätzlich ein -Notebook-Client angelegt und getestet; dieser ist inzwischen **gestoppt, -deinstalliert und seine Identität über die WebUI widerrufen**. Historisch wurden -für beide serverseitig frische Heartbeats, passives Inventar, mTLS-WSS, -Signierschlüsselbezug über den mTLS-Gateway und erfolgreicher signierter -Journalabgleich (`sync_ready=true`, `restore_blocked=false`) nachgewiesen. -Im Bestand bleibt der widerrufene Notebook-Datensatz als Historie; ausschließlich -die Cloud-VM darf als aktiver Client verbleiben. Tenant B sieht keines. **0 Jobs, 0 Outbox, -0 Startgrants** im neuen Serverbestand; keine UI-Freigabe oder Paketwirkung. - -- VM: neue Unit `rmm-agent-remote.service` aktiviert und aktiv, Netzwerkprozess - weiterhin unprivilegiert als `rmm-agent`. Neuer Zustand - `/var/lib/rmm-agent-remote`, Konfiguration `/etc/rmm-remote`, separates Binary. - Die alten Units bleiben inactive, alte Geräteidentität/Journale bleiben unter - ihren bisherigen Pfaden erhalten: historisch ein Hello-World-Erfolg, - Rootledger weiterhin 0 Verbräuche. Kein Reverse-Listener auf der VM. -- Notebook: Userdienst `rmm-agent-remote.service` gestoppt und deaktiviert, - Unit und installiertes Binary entfernt, Usermanager neu geladen. Livezustand - `~/.local/share/rust-discovery/remote-agent` entfernt. Private Journalhistorie - ohne installiertes Binary unter `devstate/uninstalled-local-client/` archiviert; - keine erneute Inbetriebnahme. Widerruf mit tatsächlichen UI-Interaktionen im - gekennzeichneten dev/test-Profil, Bestätigungskennung und explizitem Klick - erfolgt. Kein API-/DB-Widerruf als Umgehung der interaktiven Verwaltungsgrenze. -- Beim ersten VM-Bootstrap verhinderte die restriktive Umask die Ausführung - des neuen Binaries (systemd Exit 203). Nur die eigenen, per SHA geprüften - neuen Dateimodi korrigiert; denselben erhaltenen Bootstrap fortgesetzt. - Keine Identität gelöscht, kein Journalreset oder erneutes Enrollment. - Regression für Dateimodi, Verweigerung vorhandener Identitäten und Ablehnung - der entfernten Notebook-Installationsoption: 3 Tests grün. - -Clientvertrag für weitere Installationen: - -```ini -RMM_SERVER_NAME=discovery.ease-technologies.de -RMM_CONNECT_ADDR=88.99.80.202:443 -RMM_CA_FILE=/geschuetzter/pfad/server-ca.pem -``` - -`RMM_SERVER_NAME` wird für URL, SNI und Zertifikatsprüfung verwendet; -`RMM_CONNECT_ADDR` bleibt ausschließlich TCP-Ziel. Gleiches Namensprofil für -Enrollment, WSS, HTTPS, Signierschlüssel und Zertifikatserneuerung. Falscher Name, -fremde CA, URL-/Port-/Benutzerinjektion im Servernamen werden verweigert. -Rezept für Systemdienste: `deploy/linux/rmm-agent-remote.service`. -Bestehende lokale Entwicklungsdefaults sind keine neue Serverempfehlung. - -Weitere Clients erhalten nur öffentliche CA, eigenes kurzlebiges Einmaltoken -und ihre fest provisionierte öffentliche Geräte-/Tenant-/Signierbindung. -Private Geräteschlüssel erzeugt der Client selbst. **Kein Server-SSH-Key, -zentrales CA-Geheimnis oder globaler Bearer gehört auf zusätzliche Clients.** -`deploy/remote_client_bootstrap.py` ist ein administratives Werkzeug des -Entwicklernotebooks, kein an Kunden zu verteilender Installer. -Es bietet ausschließlich den create-only-Modus `--provision-vm`; `--resume-vm` setzt nur -den passenden eigenen, erhaltenen Bootstrap mit gleicher CA/Binärbindung fort. -Die lokale Installationsfunktion und `--provision-local` wurden entfernt. - -## Verwaltung und private Nachweise - -Ein Loopback-Tunnel vom Notebook läuft bereits. Manuelle Wiederherstellung -des Verwaltungszugangs, **nur bei freiem lokalem Port und ohne zweiten Tunnel**: - -```sh -ssh -N -T -o StrictHostKeyChecking=yes -o ExitOnForwardFailure=yes \ - -o ServerAliveInterval=30 -o ServerAliveCountMax=3 \ - -i ~/.ssh/ease_key.pem \ - -L 127.0.0.1:18443:127.0.0.1:18443 root@discovery.ease-technologies.de -``` - -Danach `https://localhost:18443`, mit explizitem Vertrauen in die Projekt-CA. -Nicht die Zertifikatsprüfung wegklicken/abschalten. Öffentliche CA lokal: -`credentials/server-ca.pem`; privater dev/test-Login: -`credentials/server-browser-login.json` (0600). Keine Inhalte veröffentlichen. -Tunnelreferenz `devstate/server-admin-tunnel.json`; Clientnachweise -`devstate/remote-vm.json`; Notebook-Deinstallations-/Widerrufsnachweis in -`devstate/remote-local.json` und `devstate/notebook-removal-ui.json`. -Der Verwaltungs-SSH-Tunnel ist ein Entwicklungswerkzeug, kein RMM-Agent. - -Serverinstallation `/opt/rust-discovery`; private Konfiguration, PKI und -Browserzugang dort unter `devstate/` (0700/0600). Datenbank in eigenem -Docker-Volume. Rohe Source-/Artefaktlogs unter `/var/log/rmm-server-*.log`, -sanitisiertes Prüfergebnis `/opt/rust-discovery/deployment-verification.json`. -Buildgebundene Quellen mit Notebook-Checkout abgeglichen: -`d50c5e82746f9675d50a24c385a0ad74cb666ed546d8dc7c732153cf7a862c9e`. - -## Offene MVP-Gates - -### Neuer tatsächlicher Cloud-Abnahmelauf (2026-11-13) - -Server weiterhin ausschließlich `discovery.ease-technologies.de`, Client -ausschließlich die bestehende Cloud-VM; kein Notebook-Client gestartet/enrolled. -`deploy/cloud_mvp_acceptance.py` verwendet einen echten Streamable-HTTP-MCP-Client -mit initialisierter Sitzung. Der öffentliche Agentzugang bleibt unverändert; -MCP und WebUI laufen privat auf dem Server bzw. durch den Verwaltungs-SSH-Tunnel. -MCP-Bearer bleiben auf dem Server. Genehmigung ausschließlich über sichtbare -WebUI-Interaktionen mit dem gekennzeichneten simulierten Testprincipal. - -Tatsächlich nachgewiesen, jeweils ein neuer fester, separat UI-genehmigter Plan: - -| Fall | Ergebnis | Job / Outbox / Startgrant | +| Öffentlicher Zugang | Weiterleitung auf dem Server | Zweck | | --- | --- | --- | -| Hello World über WSS | Exit 0, exakte Ausgabe und Nachbedingung bestätigt | 1 / 1 / 1 | -| Hello World über HTTPS-Long-Polling | Exit 0, exakte Ausgabe und Nachbedingung bestätigt | 1 / 1 / 1 | -| Angeforderte Live-Inventur über HTTPS | Neuer Erhebungszeitpunkt nach gebundenem Planbeginn, Nachbedingung bestätigt | 1 / 1 / 1 | -| Genehmigter Hello-Auftrag mit künftigem Start, danach MCP-Abbruch | `cancelled`, kein Startgrant | 1 / 1 / 0 | +| TCP 443 | Socket-Proxy an `127.0.0.1:18444` | Gerätegateway. Registrierte Geräte authentisieren sich mit ihrem Clientzertifikat. | +| HTTPS 8443 | Nginx an `127.0.0.1:18445` | Öffentliche WebUI, lokale Anmeldung und MCP. | +| HTTPS 8443, Installer- und Bootstraprouten | Nginx an `127.0.0.1:18444` | Download der Installer und der freigegebenen Bootstrapdateien mit öffentlich vertrauenswürdiger TLS-Kette. | -Vor jeder Genehmigung `pending_approval`, keine Ausführung, für den festen Job -**0/0/0** gemessen. Alle vier Audits binden Principal, Planhash, -`approval_origin=dev_test_browser_simulation` und `testsimulation=true`. -Snapshot nach der Basisstrecke: **3 succeeded, 1 cancelled; 4 Jobs / 4 Outbox / 3 Grants**, -keine ungeklärten oder laufenden Jobs. Die weiter oben genannten 0/0/0-Werte -sind der historische Umzugssnapshot, kein aktueller Gesamtzähler. +Die private Entwicklungs-API lauscht auf `127.0.0.1:18443`. PostgreSQL ist nur im internen Netz erreichbar. Der HTTPS-Proxy prüft den Namen und die Zertifikatskette des jeweiligen Upstreams. Die öffentliche API verwendet das Produktionsprofil. [Gerätesocket](../deploy/server-ingress.socket) · [HTTPS-Ingress](../deploy/server-bootstrap-ingress.conf) · [Öffentliche API](../deploy/server.public-access.compose.yaml) -- MCP von Mandant B auf Gerät und Job von A verweigert. Wiederholtes Submit - derselben Pläne/Idempotenzschlüssel liefert dieselben Operationen, keine neue - Ausführung. Kein MCP-Genehmigungswerkzeug oder API-/DB-Genehmigungsaufruf. -- Gateway tatsächlich neu gestartet. HTTPS-Sitzung blieb mit erneuter Prüfung - pro HTTP-Anfrage gültig. Ein anfänglicher Test verlangte dafür fälschlich eine - höhere Verbindungsgeneration und lief in sein 100-Sekunden-Limit; daraus wird - kein Reconnect-Erfolg behauptet. Danach echter WSS-Reconnect separat geprüft: - höhere Generation, frischer Heartbeat, signierter Sync, unveränderte 4/4/3. - Cloud-VM wieder auf WSS; Identität und Journale unverändert erhalten. -- Die neue Auswertung musste leere SSE-Initialframes und Rust-RFC3339-Zeiten mit - Nanosekunden auf Python 3.10 berücksichtigen. Live-Inventur war schon erfolgreich; - ihr vorhandenes Ergebnis wurde nach Parserkorrektur rein lesend verifiziert. - Kein Wiederholen des Jobs, um die Auswertung grün zu machen. -- Lokale Prüfungen: **5 Cloud-Guards**, **28 bestehende MVP-Guards**, - **3 Bootstrap-Guards** bestanden; neue Browserdatei per Node-Syntaxprüfung. - Browservertrauen separat im privaten NSS-Profil unter - `web/node_modules/.cache/cloud-acceptance/home`, keine globale CA-Änderung. +## Laufenden Stand aktualisieren -Tatsächlich ausgeführte Abnahmebefehle: +Der Deploymentrunner liest die tatsächlichen Compose-Dateien aus den Labels der laufenden Container. Er übernimmt Volumes und Richtlinien, wendet die Migrationen an, vergleicht deren Prüfsummen mit der gewählten Git-Revision und aktiviert API, Gateway und die vorhandene öffentliche API. Abschließend prüft er die Binärhashes, die TLS-Healthchecks und die ausgelieferte Startseite. Für einen reinen Frontendwechsel genügt der WebUI-Modus. [Build- und Deploymentbefehle](development.md) + +## Signierte Zeitbelege + +Der Hostdienst `rmm-time-broker.service` stellt dem Gateway signierte Zeitbelege aus. Die Zeitquelle prüft die konfigurierte Chrony-Prozessgeneration. Ein Wechsel des Prozesses kann eine erneute Prüfung dieser Bindung erfordern. Das Gateway erreicht den Broker über den Unix-Socket `/run/rmm-time-source/broker.sock`. Das Compose-Overlay bindet sein Verzeichnis schreibgeschützt ein. [Gateway-Mount](../deploy/server.time-broker.compose.yaml) · [Zeitbroker](../crates/time-broker-linux/src/native.rs) + +Bei fehlendem Zeitbeleg auf dem Server zuerst Zustand und Startzeit beider Dienste sowie den Sockettyp lesen. Diese Abfrage benötigt keinen Zugriff auf private Schlüssel. ```sh -python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case hello -python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case hello --transport https -python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case refresh_inventory -python3 deploy/cloud_mvp_acceptance.py --execute-dev-test-ui --case cancel_queued +systemctl show rmm-time-broker.service chrony.service -p ActiveState -p MainPID -p ExecMainStartTimestamp +stat -c '%F %a %U:%G %n' /run/rmm-time-source/broker.sock ``` -Nicht blind erneut ausführen: diese Befehle erstellen neue genehmigungspflichtige -Pläne. Geschützte Einzelbelege und Checkpoints unter -`devstate/cloud-acceptance//checkpoint.json`, Wiederanlaufbeleg unter -`devstate/cloud-acceptance/reconnect.json`. Unklarer Ausgang bleibt ungeklärt; -keine automatische neue Wirkung oder neue Genehmigung als vermeintliche Redelivery. +Auf dem Windows-Testgerät ist die automatische Wiederherstellung der Bereitschaft nach einem Gatewaywechsel dokumentiert. [Gerätebeobachtung](evidence/windows-gateway-clock-recovery-20261117.json) -Der Serverumzug ist ausgeführt; das Linux-MVP ist weiterhin **nicht vollständig -abgenommen**. Die oben nachgewiesenen UI-genehmigten Basisfälle sind keine Root-/ -Paketabnahme. Produktions-OIDC und öffentliche Verwaltung sind nicht eingerichtet. -Native Rotations-/Recovery-/Replay-/Offline-Ablauf-Abnahmen bleiben gesonderte -Arbeitspakete. Der nachfolgende Root-/APT-Abschnitt aktualisiert deren Stand. +## Öffentlichen Zugang einrichten -## Root-/APT-Abnahmelauf 2026-11-13 - -Die Cloud-VM behält ihre bestehende Gerätebindung. Versionierte Bootstrap- -Werkzeuge `deploy/cloud_root_bootstrap.py` und `cloud_root_clock_upgrade.py` -erhalten beide Agentzustände/Journale, den bisherigen Rootledger-Inode sowie -Archive, Baselines, Vorprüfungen und sämtliche Fehlernachweise. Kein erneutes -Enrollment oder Ledgerreset. Rootdateien unter `/var/lib/rmm-bootstrap-history/` -werden exklusiv mit 0700/0600 aufbewahrt; Teilinstallationen werden nicht blind -erneut ausgeführt. - -Erster Readonly-APT-Probe auf der echten VM erfolgreich; anschließende Daemons -jedoch nicht stabil: glibc-Zeitabfrage über Syscall `clock_adjtime` wurde vom -Unitfilter blockiert (allgemeiner Helper SIGSYS, APT `CLOCK_UNTRUSTED`). Der alte -Bootstrap meldete nach Type=simple-Spawn verfrüht Erfolg; dieser Eintrag gilt -ausdrücklich nicht als stabile Bereitschaft. Enger Filterfix erlaubt zusätzlich -`clock_adjtime`, ohne CAP_SYS_TIME und ohne Änderung der vertrauenswürdigen -Zeitprüfung. Nach versioniertem Artefakt-/Profilwechsel tatsächlichen Probe -erneuert, beide Daemons zehnmal laufend/ohne Restart geprüft, gemeinsames Ledger -einmal an die bestehende Cloudidentität gebunden. Ein anfängliches `reset-failed` -auf nach Reload ungeladenen, inaktiven Units schlug fehl; Fortsetzung ausschließlich -des installierten Startschritts, ohne Paketjob oder Zustandslöschung. Bootstrap -wartet inzwischen auf stabilen Betrieb statt nur den Spawn zu bestätigen. - -Installiertes Clock-Fix-Helperartefakt: -`dba16402af1e8b8655ec69495cf370d019bc32b9f05e61be4147df29cd7bf176`. -Gemessene Runtime: -`0547c9886aae77775c373c81758166ad41aced236d428fdf299d8e7784751d10`. -Allgemeiner Policypin: -`e177ab083ba0c239103942eb67ea9e28e9dafc294f828592cf859535a8569fd8`; -APT-Stackpin: -`0b71b79a2f59c5019472e7366ede9f155850749afec7ec29ccff91f3226be56b`. -Pins über Rootinstallation und tatsächliche nonce-/Root-Peer-gebundene -Controlantworten als `rmm-agent` geprüft. Beide Helper teilen die exakt gleichen -Ledger-/Lock-Inodes. Vor erstem Rootjob 0 Verbrauchseinträge, 0 Syncfehler. -Dies ist Readiness, keine vorweggenommene Paket-Acceptance. - -`deploy/cloud_root_policy.py` installierte eine zweistündig befristete Policy -für genau diese Gerätegeneration/-zuordnung, beide gemessenen Helperpins und -ausschließlich `simulated-testprincipal-a`. Allgemein nur Rootskript und -`rmm-mvp-test.service`; APT nur die eingebauten Fixturemanifeste und exakten -Provider-/Hook-/Config-/Runtimehashes. Kein Reboot, keine MCP-Rechteerweiterung. -Compose bindet das private Policyverzeichnis readonly; Dateimodus 0600, -Eigentümer 10001, Verzeichnis 0700. Default ohne ausdrückliche Konfiguration: -`RMM_DEV_ROOT_ENABLED=false`. Policies begrenzen nur, sie genehmigen keine Jobs. - -`deploy/cloud_root_acceptance.py` verwendet zwei getrennte tatsächliche -WebUI-Sitzungen: Rootplan erstellen/beantragen, dann unveränderliche Bytes/ -Hashes/Ziele/Versuche prüfen und genehmigen. Dazwischen MCP-lesender Abgleich -und SQL-Nachweis 0 Jobs/Outbox/Startgrants. Bestehende Browserverträge werden mit -`deploy/browser/cloud-root.config.ts` über den privaten Cloud-SSH-Tunnel genutzt; -kein lokaler Server oder Client. Ein fehlerhafter exakter Interpreter-Labelselector -stoppte zuerst vor der Planung; auf die tatsächliche Combobox umgestellt. Nur -die Formularvorbereitung fortgesetzt, kein ausgeführter Job wiederholt. - -| Fall | Reales Ergebnis | Vorher → nach Genehmigung | -| --- | --- | --- | -| `service_setup` | Rootskript, exakte Ausgabe, `succeeded` | 0/0/0 → 1/1/1 | -| `service_start` | Dienst läuft, `succeeded` | 0/0/0 → 1/1/1 | -| `service_stop` | Dienst gestoppt, `succeeded` | 0/0/0 → 1/1/1 | -| `apt_native_install` | `failed / HOOK_NOT_HANDED_OFF`, keine Acceptance | 0/0/0 → 1/1/1 | - -Alle vier Authorizations rein lesend mit festem Planhash, sichtbarem Testprincipal, -`approval_origin=dev_test_browser_simulation`, `testsimulation=true` verifiziert. -Keine direkte API-/DB-Genehmigung. Kein Produktions-Freigabenachweis. - -Beim APT-Versuch sind `native-prechecks.json`, `sandbox-ready.json` und -`sandbox-result.json` tatsächlich vorhanden: private Namespaces, genaue -Cap-/NNP-/Seccomp-Sätze, readonly Controlmounts, ungültige Kontrollsyscalls EPERM -und echter Frontend-Lockkonflikt bestanden. Anschließend **APT Exit 100**, -kein `hook-armed.json`, keine native Acceptance. Elternprozess prüfte gesamten -Paketbaselinezustand unverändert; frisches passives gespeichertes Inventar -bestätigte unveränderte Baseline/Statusfingerprint, Fixture nicht installiert. -APT-stdout/stderr wurden bisher verworfen; konkrete Ursache von Exit 100 ist -offen. `--no-download`, Archive oder Hook dürfen nicht auf Verdacht gelockert -werden. Kein manuelles apt/dpkg auf dem Ziel, kein neuer Versuch/Rezeptalias. - -Der Rootledger enthält danach **4 abgeschlossene Verbrauchseinträge**, keine -unbekannte/offene Wirkung und keinen sticky Syncfehler; Integrität ok. Der -Create-once-Marker und `active/` bleiben unverändert. Install 1.0, Upgrade 1.1, -EnsurePackage und ApplyUpdates sind **nicht abgenommen**. Vor einer Fortsetzung -braucht es eine auditierbare, sichere Behandlung dieses erhaltenen Fehlversuchs; -Marker löschen, Ledgerreset, neue Identität oder eine alternative Rezeptkennung -als Wiederholungsabkürzung sind ausgeschlossen. Ein neuer ausführbarer Versuch -benötigt einen neuen festen, tatsächlich WebUI-genehmigten Plan. - -Codeprüfung nach dem Fehlversuch fand zusätzlich einen Cloudlayout-Fehler: die -bisherige Worker-Maskierung umfasste `/etc/rmm` und `/var/lib/rmm-agent`, aber noch -nicht `/etc/rmm-remote` und `/var/lib/rmm-agent-remote`. Quellcode korrigiert: -beide Layouts maskieren, sichtbare Inhalte oder Symlinks unabhängig vom konkreten -Schlüsseldateinamen verweigern. **58 Python-APT-Tests bestanden; dieser Fix ist -noch nicht auf der VM installiert oder nativ abgenommen.** Er verändert -Provider-/Helper-/Runtimehashes. Bisherige Readiness ist keine Abnahme dieses -neuen Codes; keine erneute create-only Installation über verbrauchten Zustand. - -Abschließend Rootpolicy explizit geschlossen (serverseitig abgelaufen), bisherige -Policy gesichert. APT-Helper gestoppt/deaktiviert und ausschließlich seine -eigenen Socket-/Proof-Variablen aus dem gesicherten Agentdrop-in entfernt -(`deploy/cloud_root_pause_apt.py`). Ledger-Inode und Versuchsmarkerhash dabei -unverändert. Cloud-Agent/allgemeiner Helper bleiben aktiv. Testdienst inactive. -Abschlussmessung: Agent `online`, signierter Sync `ready`, kein Restoreblock, -keine APT-Capabilities; APT-Daemon inactive/disabled; Policy tatsächlich abgelaufen, -weiterhin UID10001/0600. Beleg `devstate/cloud-root/closed-state-*.json`. -Notebook-Clientunit weiterhin `not-found/inactive`, keine laufenden RMM-Container -auf dem Notebook. Andere lokale Projekte wurden nicht verändert. Öffentliche -Routen `/`, `/auth/config`, `/mcp` nach Serverkonfigurationsänderung weiterhin 404 -über verifiziertes TLS. - -Gesamtsnapshot: **6 succeeded / 1 failed / 1 cancelled; 8 Jobs / 8 Outbox / -7 Startgrants; 0 ungeklärte/laufende Jobs**. Private Evidenz: -`devstate/cloud-root/{install-*,clock-*,health-*,peer-readiness-before-apt.json, -cases/*/checkpoint.json,apt-failure-*,final-*,policy-*,apt-paused-*}` und -Root-Backups auf der VM/im Server. Nichts davon committen oder veröffentlichen. - -Tatsächlich ausgeführt (keine Anleitung zum blinden Wiederholen): +Auf einem bereits mit interner API, Gateway und öffentlicher TLS-Kette eingerichteten Entwicklungsserver richtet `tools/dev_public_access.py` die öffentliche Verwaltung ein. `prepare` provisioniert das lokale Bootstrapkonto, `activate` startet die zusätzliche API und kontrolliert deren Anmeldemodi. `publish` prüft die Nginx-Konfiguration und aktiviert den Ingress. `prepare` im Checkout mit dem bestehenden privaten `credentials/` ausführen. Die Zugangsdaten verbleiben beim Betreiber. ```sh -python3 deploy/cloud_root_bootstrap.py --install-reviewed-helper -python3 deploy/cloud_root_acceptance.py --case service_setup -python3 deploy/cloud_root_acceptance.py --case service_setup --resume-prepared -python3 deploy/cloud_root_acceptance.py --case service_start -python3 deploy/cloud_root_acceptance.py --case service_stop -python3 deploy/cloud_root_acceptance.py --case apt_native_install -python3 deploy/cloud_root_policy.py --close-reviewed-test-scope -python3 deploy/cloud_root_pause_apt.py +python3 tools/dev_public_access.py prepare +python3 tools/dev_public_access.py activate +python3 tools/dev_public_access.py publish ``` -Clockupgrade und ausschließlich dessen installierter Startschritt wurden ebenfalls -ausgeführt; Zwischenfehler bleiben in geschützten Reports erhalten. Lokale Suites: -58 Python-APT / 8 Cloud-Guards / 28 MVP-Guards / 3 Bootstrap-Guards bestanden. -Helper nach Clockprofil und separat nach Cloud-Controlpfad-Fix: jeweils -25 Library / 3 Binary / 20 Sync bestanden. Keine -vollständige Frontend-/MVP-/APT-Abnahme aus lokalen Tests ableiten. - -## Nächste Schritte (geplant, nicht ausgeführt) - -1. Die weiteren Fehler-/Offline-/Replayfälle der WebUI/MCP-/Jobstrecke auf dem - neuen Server abnehmen; ausschließlich feste UI-genehmigte Pläne. -2. APT-100-Ursache durch begrenzte sichere Diagnose bestimmen; Cloudlayout- - Maskierungsfix kontrolliert mit erhaltenem Ledger/Marker installieren und - native Readiness erneuern. Sichere Behandlung des gespeicherten Fehlversuchs - vor weiterem Paketjob klären/implementieren; keine Guard- oder Genehmigungsabkürzung. -3. Gesonderte Daten-/Schlüsselbackup- und Restoreabnahme sowie CA-Rotation - vorbereiten. Zertifikatswartung ersetzt kein Backup oder Produktionsnachweis. - -### MVP-Verwaltung ausschließlich über SSH-Tunnel, 15. November 2026 - -Der Betreiber verlangt für den MVP keinen OIDC-Anbieter. WebUI und MCP -verwenden den bestehenden Entwicklungslogin auf dem Server-Loopback. -Die aktuelle Nachprüfung las für API `127.0.0.1:18443`, Gateway -`127.0.0.1:18444` und keine veröffentlichten PostgreSQL-Ports. -Eine externe HTTPS-Prüfung mit der vorhandenen vertrauenswürdigen -Projekt-CA ergab für `/`, `/mcp`, `/auth/config` und `/api/v1/tenants` -jeweils 404. Der öffentliche Ingress bietet diese Verwaltungspfade -nicht an. Der Zugriff auf WebUI und MCP erfolgt über einen SSH-Tunnel -auf den API-Port 18443. Öffentlich erforderliche Agentenverbindungen -bleiben getrennt von diesem Verwaltungszugang. +Der Server liest Benutzerkonten aus der geschützt eingebundenen `devstate/public-auth/users.json`. Änderungen dieser Kontokonfiguration werden beim Neustart von öffentlicher API und Gateway geladen. Das öffentliche Installerzertifikat und die internen Zertifikate haben getrennte Erneuerungsdienste. Ihre Zeitsteuerung ist in den Unit-Dateien hinterlegt. [Öffentliche TLS-Erneuerung](../deploy/server-bootstrap-tls-renew.timer) · [Interne TLS-Erneuerung](../deploy/server-tls-renew.timer) · [Zugänge](operations-access.md) diff --git a/docs/server-time-broker-bootstrap.md b/docs/server-time-broker-bootstrap.md deleted file mode 100644 index 06cce8d..0000000 --- a/docs/server-time-broker-bootstrap.md +++ /dev/null @@ -1,402 +0,0 @@ -# Getrennter Zeitschlüssel und demandgestützte Brokerinstallation - -`deploy/server_time_broker_bootstrap.py` liefert drei getrennte create-only -Root-Bootstrapphasen. Keine Phase startet oder aktiviert einen Dienst, lädt -Systemd neu oder erzeugt eine Zeitattestierung. Aus Sourcevorhandensein folgt -kein tatsächlicher Servernachweis; Root muss Quelle und Zielaktion jeweils -separat prüfen. RMM-Jobs behalten unverändert die WebUI-Genehmigungsgrenze. - -Der feste Originalfall ist `5b358997-3abc-43db-945f-f41855b4e3c0`. -Der unveränderte Pinbootstrap `fac85dd…` wird ausschließlich von -`/var/lib/rmm-time-source-operators//pin_bootstrap.py` geladen: -Root:Root0600, ein regulärer Link, geschützte Ancestry und exakter SHA256. -Seine tatsächlichen Original-Preflight-/Build-/Quellen-/Boot-/Runtimebelege -bleiben unverändert Pflicht. Nach dem ausdrücklich genehmigten Chronyneustart -werden die alte Prozessgeneration und ihr alter Pin ausschließlich historisch -geprüft; der neue gemeinsame Generationbeleg bindet den aktuellen Prozess und -den tatsächlich ersetzten öffentlichen Pin. Kein Aufruf oder Umgehen des alten -`pin.Original`-Konstruktors ist hierfür zulässig. Der Broker muss genau das erfolgreiche -ARM64-ELF1067136Bytes/SHA256 -`5d8d786925c060eb042f0a592453f11970c32c4287fa4c9464f6f6a6e38cb201` -sein. Alte gescheiterte Probe-/Bootstrapversuche werden nicht umgeschrieben. - -Vor jeder der drei Phasen ist zusätzlich ein tatsächlicher erfolgreicher -`probe-native-source-v1/result.json` im neuen Generationsfall -`c9a94f94-eecd-4c66-933d-c45c1a79c7a8` nötig, Profil -`rmm.server-time-source.native-generation-acceptance.v1`. Der gemeinsame, -Rootgeschützte und exakt hashgebundene `SharedGenerationProof` liest den -historischen5b-Build ausschließlich als erhaltende Quellen-/ELFprovenanz. Er -verlangt zusätzlich die tatsächlichen c9-Neustart-/Pin-CAS-Belege und hält den -aktuellen Prozess-/Socket-/Konfigurations-/Namespace-/Bootkontext unabhängig. -Sein strikter gemeinsamer Qualitätsdecoder prüft die neuen vollständigen -Result-/Witness-/Samplebelege. Frühere GROUP-/DAC-/ca89-Fehlschläge bleiben -unverändert fehlgeschlagen; keiner kann dieses neue Gate erfüllen. - -Der anfänglich geschlossene `QUALITY_RESULT_SHA=None`-Gate ist jetzt durch -ein enges Einzeilendelta ausschließlich an das tatsächlich erfolgreiche neue -Resultat `ab8a6511517c6e3c01db2351ccdc5c48c73f34112c9ac863d0ea64de46665933` -gebunden. Root hat Ausführung und einen separaten Original-Read nachgewiesen; -die genauen Belege stehen am Ende dieses Dokuments. Ein erfolgreicher Restart -oder CLI-Tracking allein hätte diesen Gate nicht erfüllt. Dies installiert -keinen Signer oder Broker und startet weder Dienst noch HTTP-Endpunkt. -Eine historische erfolgreiche Probe wird später nicht als aktuelle -Zeitautorität wiederverwendet: der laufende Broker misst vor jeder Signatur -selbst frisch. Schlüssel-/Gruppen-/Installationsphasen verbleiben create-only -im ursprünglichen5b-Fall und speichern die exakten c9-/Controller-/Qualitäts-/ -öffentlichen-Pinlinks zusätzlich in Intent und Resultat. - -Auf dem Server ausschließlich isoliert starten: - -```text -python3 -I /reviewter/absoluter/pfad/server_time_broker_bootstrap.py host-key -python3 -I /reviewter/absoluter/pfad/server_time_broker_bootstrap.py host-group -python3 -I /reviewter/absoluter/pfad/server_time_broker_bootstrap.py host-install -``` - -Jede Phase besitzt einen eigenen dauerhaften Intent im Originalfall. -Bestehende Phasen verweigern vor Getter, Entropieerhebung oder Zielaktion. -Vor jedem Zielwrite und jeder Berechtigungsänderung werden Sources, echte -Prozess-/Pin-/Runtime-/Bootzeugen und bekannte öffentliche Rollen erneut -geprüft. Jeder Fehler behält eigene Teilobjekte; kein Retry, Cleanup, Reset -oder Übernehmen vorhandener Objekte. Für verlorene Antworten ausschließlich -`host-read` aufrufen. Dieser liest nur öffentliche Phasenbelege und Metadaten; -keine Signerkonfiguration, Seeds, Tokens, TLS-Getter oder native Zeitabfrage. - -`host-key` erzeugt ausschließlich `/etc/rmm-time-source/signer.json` und -`time-public-key.json`, beide Root:Root0600 mit einem Link. Beide Namen müssen -vorher abwesend sein. Ein eigener 32-Byte-Seed entsteht ausschließlich durch -Host-CSPRNG. OpenSSL erhält die Ed25519-PKCS8-DER nur auf stdin und gibt -SPKI-Public-DER zurück; Seed und private DER erscheinen nie in argv, -Umgebung, Ausgaben oder Belegen. Coredumps sind deaktiviert. Die private -Konfiguration entspricht exakt dem bestehenden Broker-Serde-Schema: -Schema1, eigene Server-UUID, eigene Key-ID, Generation1, Seedhex nur in der -Rootdatei, tatsächliche Forbidden-Publickeys, UID/GID10001. Die öffentliche -Datei enthält ausschließlich Algorithmus, öffentlichen Key und diese -öffentlichen Kontextfelder. Ausgaben enthalten keine privaten Rohdaten oder -Hashes der privaten Konfiguration. - -Der tatsächliche Jobpublickey kommt ausschließlich vom vorhandenen öffentlichen -Getter über verifiziertes TLS: TCP127.0.0.1:18443, SNI `rmm-dev.internal`, -bestehende CA und notwendiges lokales Bearer-Reader-Token. Das Token wird nicht -zurückgegeben oder protokolliert. Die vier fest bekannten öffentlichen -Zertifikate `devstate/{pki,api-pki}/{ca.pem,server.pem}` werden ausschließlich -auf tatsächliche Ed25519-SPKIs geprüft und gegebenenfalls dedupliziert in die -Verbotsliste aufgenommen; andere Algorithmen ergeben keine Dummykeys. -Die Root-beobachtet abwesenden Update-/Healthrollenpfade müssen weiter -abwesend sein; neue Rollen benötigen eine gesonderte konkrete Kontextprüfung. -Private PEMs werden nicht gelesen und Credentials nicht durchsucht. - -`host-group` verlangt den unveränderten eigenen erfolgreichen Keyfall. Sowohl -NSS-Name `rmm-time-gateway` als auch GID10001 müssen vorab abwesend sein. -Nur das geschützte feste `/usr/sbin/groupadd --system --gid 10001 -rmm-time-gateway` darf die neue leere Gruppe anlegen. Die öffentliche -`/etc/group` muss danach bytegleich bis auf exakt die hinzugefügte Gruppenzeile -sein; bestehende Gruppen oder Mitgliedschaften werden nicht verändert oder -übernommen. Kein gshadow-Inhalt wird gelesen. Ein Fehler darf keine -Gruppenanlage wiederholen. - -`host-install` verlangt eigene unveränderte Key- und Gruppenbelege sowie echte -NSS-Auflösung der neuen leeren Gruppe und `_chrony`989. Es kopiert ausschließlich -das gebundene Original-ELF nach `/usr/local/libexec/rmm-time-broker`, Root0500, -und die feste demand-only Unit `rmm-time-broker.service`, Root0644. Vorhandene -Binary-/Unit-/Dropinpfade verweigern. Ein fehlendes `/usr/local/libexec` darf -unter gehaltenem geschütztem Rootparent create-only Root0755 entstehen; -ein vorhandener legitimer Parent wird lediglich geprüft, niemals gechmodet. -Die Unit hat keinen Installabschnitt, startet als Root mit Gruppe989 und der -neuen benannten Supplementary-Gruppe10001. NNP, ausschließlich -CAP_SYS_PTRACE und CAP_DAC_OVERRIDE, AF_UNIX-only/IP-denied, ProtectSystem=strict, ProtectHome, -PrivateDevices sowie der feste Debug-/ptrace-/process_vm-Syscallausschluss -bleiben gesetzt. Die expliziten ReadWritePaths sind auf den eigenen Runtimebereich begrenzt; -CAP_SYS_TIME wird nicht erteilt. Kein Enable, Start, Daemonreload oder HTTP- -Deployment wird durch diese Installation ausgelöst. - - -Tatsächlich notwendige DAC-Ausnahme: RootUID0 mit EGID989 und ausschließlich -CAP_SYS_PTRACE konnte laut Rootdiagnose nicht durch `/run/chrony`9890700 -traversieren oder den Socket9890755 verbinden (EACCES13). Mit zusätzlichem -CAP_DAC_OVERRIDE waren beide Zugriffe möglich. Diese Ausnahme steht deshalb -explizit im Unit-BoundingSet; Chronyverzeichnis und Socket werden nicht -gechmodet und sämtliche gehaltenen Identitäts-/Credentialprüfungen bleiben -bestehen. Root-ROFS, eigener Runtime-Schreibbereich, NNP, AF_UNIX, IP-Verbot -und Debug-/ptrace-Syscallausschluss bleiben unverändert; CAP_SYS_TIME wird -weiterhin nicht erteilt. Die Diagnose erzeugte weder Socketdatei noch Datagramm -und war selbst keine Sourcequalitätsabnahme. - -Die öffentlichen vier Zertifikate sind tatsächlich10001:100010600 unter -jeweils10001:100010700-eigenen festen PKI-Verzeichnissen. Der Reader erlaubt -nur genau diese vier öffentlichen Leafnamen, hält Rootancestry bis devstate -und PKI-/Leaf-FDs, prüft ihre Originalmetadaten vorher/nachher und bindet die -aktuellen API-/Gateway-Image-/UID-/Runtimemetadaten unabhängig davor/danach. -Das notwendige Reader-Token bleibt ausschließlich Root:Root0600. Keine -Root-Eigentümerschaft der öffentlichen PKI wird erfunden oder geändert. - - -Der damalige historische Installationsgate war ausschließlich an die DAC-Probe gebunden, -einschließlich ihrer fünf zusätzlichen Herkunftshashes. Das alte GROUP-Probe- -Resultat und Log werden weiterhin bytegleich gelesen und nie als erfolgreich -umgedeutet. Fehlender oder nicht erfolgreicher DAC-Nachweis verweigert bereits -vor Schlüssel-, Gruppen- oder Installationswirkungen. Der feste Groupadd- -SHA256 des tatsächlich beobachteten Root0755-Tools wird vor/nach Ausführung -zusätzlich gebunden. Die Existenz einer vorbereiteten Unit ist weder -Dienststart noch Qualitätsnachweis. - -Aktueller Sourcecheckpoint: Die neue DAC-Probe lief tatsächlich bis zum -Provider, endete jedoch ebenfalls mit Exit1 und qualifizierte keine Quelle. -Der Bootstrapgate auf diesen Beleg bleibt daher vollständig geschlossen. -Root bereitet weitere getrennte Diagnose vor. Erst ein separat reviewter, -tatsächlich erfolgreicher neuer nativer Nachweis darf durch ein konkretes -Gate-Delta gebunden werden. CLI-Trackingwerte ersetzen diesen Nachweis nicht. -Es wurden noch keine Brokerkeys, Gruppe10001, Brokerbinary oder Unit durch -diesen Sourcecheckpoint auf dem Server angelegt. - -Root bestätigte unabhängig beide Zertifikatsmounts als read-only: Gateway -`devstate/pki` und API `devstate/api-pki`, jeweils nach `/pki`; Receipt -`67083fd9d4d3ff90e93fb30957d916eb8c89e431993674333d158db6f03c0504`. -Der feste Parent bis devstate ist Rootgeschützt, die beiden PKI-Leaves gehören -der bereits gebundenen Serveridentität10001. Daraus folgt keine allgemeine -Ausnahme für beliebige fremde Verzeichnisse. - -Lokale Prüfung dieses Implementierungsschnitts: AST bestanden; drei kleine -isolierte Tmpfs-/Kryptoguardgruppen bestanden (RFC8032-Ableitung und private -Ausgabegrenze, Role-Reuse/vorhandene Ziele, tatsächliche10001-PKI-Metadaten mit -Gegenfällen). Reine Qualitygate-Fixtures prüften positive vollständige -Witnessbindung und Ablehnung geänderter Controller-, Origin-, Witnesshash- -und Samplegrenzen. NSS-Kollisionen verweigerten vor jedem Groupadd-Aufruf. -Die Autorität dieser Fixtures war ausdrücklich ersetzt: kein tatsächlicher -Token-/Zertifikats-/Serverzugriff, keine Root-Hostschlüsselgenerierung, -Gruppe oder Diensteinrichtung. Die PKI-Gegenprobe musste ihren eigenen fremd-eigenen Testfile vor chmod -zunächst zurückchownen, weil ihr bewusst CAP_FOWNER fehlte. Diese Korrektur -der Hilfsprüfung änderte keine Produktquelle und ergibt keinen Ziel- oder -Nativeerfolg. - -## Enger Reviewfix: vollständige feste Unitkomposition vor Installation - -Der ursprüngliche Controller8069 prüfte nur die exakte Unit und ihr `.d` -unter drei Rootpfaden. Das reichte für Systemd nicht: Control-/Attached-/ -Generatorpfade und geerbte Dash-Präfix-/typweite Drop-ins können andere -ExecStart- oder Capabilitywerte beitragen. Es wurde kein tatsächliches -Overlay auf dem Server nachgewiesen. Maßgeblich sind die dokumentierten -[System-Loadpaths und Drop-in-Regeln](https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html) -und der tatsächliche Manager-`UnitPath`; -[`systemd-analyze unit-paths` allein zeigt nur Compilerdefaults](https://www.freedesktop.org/software/systemd/man/latest/systemd-analyze.html). - -Der Installer prüft jetzt die zwölf festen System-Loadroots einschließlich -`system.control`, transient, attached, Generatoren und `/usr/local/lib`. -Die feste merged-usr-`/lib`-Verknüpfung wird unabhängig geprüft; ein geschütztes -reales `/lib` erhält einen zusätzlichen eigenen Scan. Der tatsächliche -Manager-Loadpath wird lesend vor/nach gebunden; unbekannte Pfade verweigern. -An jedem Root müssen exakte Unit, `rmm-time-broker.service.d`, -`rmm-time-.service.d`, `rmm-.service.d`, `service.d` sowie unit-eigene -`.wants`/`.requires`/`.upholds` fehlen. Verzeichnis-FDs und `O_NOFOLLOW` -verhindern eine stille Übernahme fremder Pfadobjekte. Ein begrenzter Scan -weist auch vorhandene direkte Aliase zum neuen Unitnamen ab, ohne deren -Konfigurationsinhalte zu lesen oder fremde Namen zu protokollieren. - -Diese Prüfung erfolgt vor dem ersten Installationswrite, jedem folgenden -Freshguard und dem Schlussbeleg. Ausschließlich die gerade per create-only -FD erzeugte eigene Unit darf anschließend mit demselben gehaltenen Inode, -Rootidentität, einem Link und exakt den festen Unitbytes vorhanden sein; -600→644 ist die einzige vorgesehene Modustransition. Fremde Unitpfade oder -frei wählbare Resume-/Skipflags gibt es nicht. - -Vor einem späteren tatsächlichen Start bleibt zusätzlich Roots unabhängige -Prüfung der effektiven Manager-Eigenschaften, Namen, Fragment-/Dropinpfade, -Exec-Befehle, Prozessimage, UID/GID und Capabilities zwingend. Die Source- -Kompositionsprüfung ist kein Startnachweis und kein Versprechen über zukünftige -vertrauenswürdige Rootänderungen. - -Lokaler Deltanachweis: Positive eigene FD-gebundene Unit, unbekannter -Managerpfad sowie negative Präfix-, typweite, Control- und Aliasfixtures -bestanden. Die negativen Fälle wurden direkt im Installationspfad vor jeglichem -Binary-/Unit-/libexec-Write abgewiesen. Systemd-/Originalautorität war dabei -ausdrücklich durch Fixtures ersetzt; alle Dateisystemzugriffe lagen im eigenen -lokalen Container-Tmpfs. Alte Controller8069- und f8cb-Originalbelege bleiben -unverändert. Der tatsächliche native Qualitätsgate bleibt weiterhin geschlossen; -keine Vorratsfreigabe oder Zielaktion folgt aus diesem Reviewfix. - - -## Historischer separater Peer-Qualifier: keine operative Freigabe - -Der vorbereitete Gate verwendet jetzt ausschließlich -`probe-peer-acceptance-v1/result.json`, Profil -`rmm.server-time-source.peer-acceptance.v1`, Controller -`ca89eac44d6b1e8bbbb14cca58ecabb02fd05d59292b77f703997fad0c29e3c8`. -Die alten GROUP-/DAC-Resultate bleiben fehlgeschlagen und ihre Originalbytes -und Herkunftshashes gebunden. Zusätzlich zu den bisherigen Bindings kommen -neun genaue Namespace-/DAC-Herkunftsfelder hinzu. Der tatsächliche -Namespacebootstrapcb166 mit Controller2f1, unverändertem Mainprofil214e und -lokaler Regel27e ist ausschließlich eine eng begrenzte ACL-/MAC-Voraussetzung, -keine native Sourcequalität. - -Der neue vollständige Witness bindet außerdem exakte Main-/Localmetadaten, -Parent-ACL und tatsächliches Chronyd-Enforceprofil. Vor jedem zukünftigen -Bootstrapwrite prüft ein privater read-only Guard erneut den fest gebundenen -Namespacecontroller, unveränderte Profile, exakt die benannte ACL ohne -Default-ACL sowie das tatsächliche Kernel-Enforceprofil zwischen unabhängigen -Originalprozess-/Bootprüfungen. Er führt keine ACL- oder MAC-Schreiboperation -aus. Die Unitkompositionsprüfung bleibt unverändert. - -`QUALITY_RESULT_SHA` bleibt ausdrücklich leer (`None`). Damit verweigern -sämtliche Key-/Group-/Installphasen, bevor ein unbekannter Qualifierbeleg auch -nur als Freigabe gelesen werden kann. Erst Root darf nach tatsächlichem, -separat geprüftem Peer-PASS den exakten Resultat-Hash in einem weiteren -reviewten Quellendelta binden. Weder vorbereiteter Controller, Namespace- -Voraussetzung noch eine Diagnose oder früherer fehlgeschlagener Lauf öffnet -diesen Gate. Aktuell wird kein erfolgreicher Peer-Lauf behauptet. - -Der reine lokale Deltaguard belegte die initiale geschlossene Sperre, positive -vollständige Peer-Fixture und Ablehnung anderer Controller-/Namespace-/ -Witnessbindungen. Separate read-only Guard-Fixtures wiesen geänderte ACL, -Profilmetadaten und verlorenen Enforcezustand ab. Originalautoritäten waren -in diesen Fixtures ersetzt; es gab keine Zielabfrage oder Einrichtung und -keine Wiederholung der früheren zehn Guardgruppen. - - -Nach dem vorbereiteten Quellendelta meldete Root auch den tatsächlichen -ca89-Peerprobe-Lauf mit Exit1 und `source_quality_qualified=false`. -Die gesonderte Nativefehlerdiagnose zeigte weiterhin TIME_CHRONY_CONNECT; -Kernel-Audit belegt einen AppArmor-Lesedenial am Tracking-Clientsockel. -Die erste Policyabfrage war wegen libapparmor-Pfadkürzung irreführend; -bytegleiche Kernelpolicy und korrigierte Abfrage erlauben den vollständigen -Pfad. Named-Connect bleibt verweigert. Die separate abstrakte Socketdiagnose -bestand im gleichen Profil, noch ohne Datagramm oder Sourcequalität; -[genaue Befunde](server-time-peer-diagnosis.md). Der notwendige neue -Providertransport und seine tatsächlichen Abnahmen bleiben separate Gates. -Dies ändert keinen alten Fehler in einen Erfolg. Der Brokergate bleibt -`QUALITY_RESULT_SHA=None`; weder Schlüssel noch Gruppe oder Installation -sind damit freigegeben. - - -## Historischer Quellencheckpoint: zunächst geschlossener Brokeradapter - -Root hat den vom User ausdrücklich erlaubten einmaligen Chronyneustart und -öffentlichen Pin-CAS tatsächlich nachgewiesen. Generationsresultat SHA256 -`d648daadc43de90cda977ce60615b8e47072b785aa9fbfaea37ef8b58be6c9d4` -ist ein Restart-/Identitätsbeleg, keine native Sourcequalität. Der neue aktuelle -Daemon ist PID2519215/Birth17718075, weiterhin UID/GID989 mit demselben geprüften -Image. Der neue öffentliche Pin umfasst195Bytes. Der alte Peerqualifier ca89 -bleibt `source_quality_qualified=false`. - -Der Brokeradapter lädt ausschließlich den separat eingefrorenen gemeinsamen -`new_generation_probe.py` aus seinem Content-addressed Root0600-Operatorpfad. -Kein `pin.Original()`-Aufruf, keine Änderung alter `expected`-Werte und kein -Fallback auf alte PIDs. `SharedGenerationProof` hält historische Originale und -aktuellen neuen Pin; vor jedem Write werden seine Originalrecords, aktuelle -Prozess-/Namespacezeugen und die gebundenen Qualitätsrecords erneut geprüft. -Die drei eigenen Verzeichnisse behalten dev/ino/uid/gid/mode und ACLs; spätere -legitime eigene Dateierzeugung wird nicht durch erfundene Verzeichnismtime- -Gleichheit verhindert. Fremde Objekte werden weiterhin nicht übernommen. -Alle gehaltenen Proof-FDs werden beim regulären Ende und Konstruktorfehler -explizit geschlossen. Schlüsseltrennung, feste Tools, Crypto-/Private-Ausgabe- -Grenzen, Unitkomposition und create-only Wirkungsphasen bleiben unverändert. - -Der Quelladapter und isolierte Deltaguards ersetzen sämtliche externe Autorität -durch Fixtures. Ihre Positivfälle sind kein tatsächlicher Qualitätsnachweis. -Es wurden durch diesen Adapter weder Zielzugriffe noch Schlüssel-/Gruppen-/ -Dienstwirkungen oder weitere Updateränderungen ausgeführt. - -Tatsächlich lokal ausgeführte Adapter-Deltaguards: drei Gruppen bestanden. -Der initiale `None`-Gate verweigerte vor jedem ersetzten externen Zugriff; -der gemeinsame Decoder erhielt exakt den verlangten Resulthash, fehlender -Resultpfad oder veränderte gespeicherte Bytes verweigerten; der Context prüfte -neuen Pin/Namespace erneut und schloss gehaltene Proofs auch nach Fehler im -Konstruktor. Alle externen Autoritäten/Getters waren ersetzt, ausschließlich -ein eigener temporärer Verzeichnis-FD wurde verwendet. Fünfzehn bestehende -Crypto-/Role-/Unitcomposition-/Create-only-/Readdefinitionen und sechs feste -Konstantenausdrücke wurden bytegleich gegen Controller31f2 nachgewiesen. -Der erste reine Vergleichshelfer versuchte `ast.literal_eval` auf -`bytes.fromhex(...)` und brach ab; der korrigierte AST-Ausdrucksvergleich -bestand, ohne Änderung der Produktquelle oder einer Prüfungsausnahme. - - -Gemeinsamer eingefrorener Generation-/Qualifiercontroller: SHA256 -`c15f4dad9aeb51270fbee7ba28a545cfe9f6a879d0bc226cf5ddda9036a5a2b6`, -36.967Bytes, fester Hostname `new_generation_probe.py` im gleichnamigen -SHA256-Elternpfad. Der Broker bindet genau diese Quelle; ihr gemeinsamer -Qualitätsdecoder hält vier Originalrecords (Resultat, Log, Vorher/Nachher). -Die separate Sourcequalifikation des Controllers ist kein tatsächlicher -Probe-PASS. Beim damaligen Quellenfreeze blieb `QUALITY_RESULT_SHA=None`; -der anschließende tatsächliche PASS und sein enges Hashdelta folgen unten. - - -## Tatsächlicher neuer Qualitätsnachweis und exakte Resultbindung - -Root führte die native Probe im c9-Generationsfall tatsächlich aus: -Originalaufruf `a8c61ad4-5ced-44dd-a120-1ef5cd2bb68b`, Receipt SHA256 -`1aab3af930648aed260c4c66a1c3ff068656cae016fcc301f052880926f99c93`. -Separater ausschließlich lesender Originalaufruf -`de6273d1-3ae5-4f02-b759-e13fbf8116e9`, Receipt SHA256 -`7005ef54759412cd0d95e558ceebbf524a55c04bf6641c8241161e0d5e81fbf3`. -Das exakte Resultat besitzt SHA256 -`ab8a6511517c6e3c01db2351ccdc5c48c73f34112c9ac863d0ea64de46665933`. -Exit0, `source_quality_qualified=true`, unveränderte Vorher-/Nachherzeugen, -Kernelstate0, tatsächlicher Gesamtfehler50.833.923ns und Syncalter43.596.197.206ns. -Diese Werte sind der einzelne gemessene Probenstand, keine fortdauernde -Qualitätszusage oder bereits signierte Zeitattestierung. - -Ausschließlich die eine Controllerzeile `QUALITY_RESULT_SHA` wurde von `None` -auf genau diesen Hash gesetzt; Sharedcontrollerc15f, Wirkungs-/Crypto-/Role-/ -Unitcompositionquellen und sämtliche Schutzbedingungen bleiben bytegleich. -Die drei alten GROUP-/DAC-/ca89-Fehler bleiben unverändert fehlgeschlagen. -Ein lokaler Decoder-Gegencheck verwendet die vier tatsächlich gespeicherten -Originalrecords Resultat/Log/Vorher/Nachher aus dem separaten Root-Read, -prüft ihre exakten Byteshashes und lässt sie durch die unveränderte gemeinsame -`SharedGenerationProof.quality_proof` laufen. Live-Prozess-/Datei-FDautorität -wird dabei ausdrücklich durch den gespeicherten Root-Read ersetzt: kein neuer -Zielzugriff und kein Ersatz der tatsächlichen Root-Ausführung oder Nachlese. - -Dieser Quellenschritt erzeugt keine Seeds, Schlüsseldateien, Gruppe10001, -Binary oder Unit und startet keinen Broker, HTTP oder Windows-Clockgate. -Root muss Host-key, Host-group und Host-install weiterhin getrennt reviewen -und selbst ausführen. Der spätere laufende Broker muss vor jeder Signatur eine -neue native Quelle messen; diese Probe ist kein wiederverwendbarer Zeitgrant. -WebUI-Jobs und sämtliche RMM-Genehmigungsgrenzen bleiben unverändert. - -## Tatsächlich eigener Zeitschlüssel auf dem Server provisioniert - -Nach tatsächlicher Sourcequalität und unabhängigem finalem Quellenreview wurde -ausschließlich `host-key` einmal ausgeführt. Rootreceipt -`10ae6e10ceda1d8aca8454f9e8fdf81eadb7f33822bb1b6c9545363a386ba04d`. -Der Host erzeugte seinen eigenen Ed25519-Seed; `seed_exported=false`. -Private Signerkonfiguration Root:Root0600/Singlelink, getrennt von tatsächlichen -Job-/bekannten TLSrollen; weder Seed noch private Konfigurationsbytes oder -deren Hash wurden ausgegeben. - -Öffentlicher Zeitpin-SHA256 -`c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`. -Separater ausschließlich lesender Rückabruf0e0b2469, Receipt -`25c690925fad06a7a065e483971bd9c23acd88190c33994c560c0f7166bc6357`, -bestätigt ursprüngliches Keyresult -`fa81bde18a68c7c367ae7facf3914711072ba5238f0d10b5eba29c320efa3d75` -und geschützte Metadaten. Ausschließlich der öffentliche Pin wurde zusätzlich -lokal geschützt abgelegt; keine Kopie des privaten Signers. Noch keine -Gruppe/Unit/Brokerstart/Signatur/HTTP- oder Windows-Clockfreigabe daraus. - -## Tatsächlich feste lokale Socketgruppe eingerichtet - -`host-group` einmal erfolgreich, Rootreceipt -`c2a03d00525a63f540a8b6dd069bbc783f797566d3e0f150c3417259af93a352`. -Die vorher abwesende Gruppe `rmm-time-gateway`/GID10001 existiert nun mit -exakt leerer Mitgliederliste. Vorhandene öffentliche Gruppenzeilen blieben -bytegleich; keine Benutzer wurden aufgenommen. Separater Originalread -f185b102 bestätigt Result -`1f987cbe7e7558ecb1e4dac9542bda69d6f09343a40098c5be4817ac9ebfca45`, -Receipt `97c68b346b4d83d9e1e61cc029ecaa02f6256991e2bdf7c2385e1717f78f1773`. -Noch keine Unitinstallation, Aktivierung oder Signatur durch diesen Schritt. - -## Tatsächlich Brokerbinary und Demand-Unit installiert - -`host-install` einmal erfolgreich, Rootreceipt -`5d99c54fb747737991d98ec65ee715fb7c1820af5814fd36f1dbe31ed833ed03`. -Unverändertes qualifiziertes AArch64-Binary5d8d7869/1067136Bytes unter -`/usr/local/libexec/rmm-time-broker`, Root:Root0500/Singlelink; Unit657Bytes, -Root:Root0644/Singlelink, SHA256 -`4792bfb65763f5a5146044d2ba152acd0a876b66c29d8cc66c16a5250214af2c`. -Geschlossene Manager-Unitpaths/Prefix-/Typewide-/Alias-Komposition geprüft. -Kein daemon-reload, Enable, Start oder Zeitsignieren durch diese Phase. - -Separater Originalread a293463f bestätigt Result -`b52aa57971fcad5a9ff3780765f4712d4029d078aab71f94eaec6d805a642f71`, -Receipt `0f1c2bcbe7ffca5cf8f40c40c84e836bf0659b67032e89bdfadd1ef1b9b4a03b`. -Effektive geladene Unit und tatsächlicher Prozess/Socket müssen vor dem -separaten einmaligen Demandstart unabhängig nachgewiesen werden. diff --git a/docs/server-time-broker-signature-acceptance.md b/docs/server-time-broker-signature-acceptance.md deleted file mode 100644 index 200f786..0000000 --- a/docs/server-time-broker-signature-acceptance.md +++ /dev/null @@ -1,63 +0,0 @@ -# Enge lokale Broker-/UDS-Signaturfixture - -Quelle `deploy/server_time_broker_signature_acceptance.py`, Stand2026-11-15. -Root startet allein die tatsächliche Abnahme nach unabhängigem Source-Review. -`host-preflight` prüft ausschließlich geschützte Originale und lebenden Broker, -endet vor Random, Phasenmkdir oder UDSrequest. `host-execute` ist create-only im -Originalfall5b unter `broker-signature-acceptance-v1`; bei Antwortverlust oder -Fehler ausschließlich `host-read`, keine Wiederholung oder Bereinigung. - -Gebunden sind Startcontrollere145, tatsächlich erfolgreicher Startresult8fc6, -öffentlicher Zeitpinc31 und das nativ qualifizierte Python-ARMimagee6f2 -(Rootreceipt6431222d). Vor/nach den Clients bleiben originale Prozess-/Socket- -und Source-/Runtime-/Chronygenerationszeugen Pflicht. Root verknüpft seine -getrennten Corehistory-Vorher-/Nachherreceipts; hier kein neuer SQLreader. - -Host-UID/GID10001 und eigener Container-UID/GID10001 erzeugen jeweils eine eigene -256-Bit-CSPRNGnonce und Verifierinkarnation. Der Container ist read-only, nonet, -nocaps, NNP und benutzt seinen Standard-PIDnamespace; Brokerpeer-PID0 wird -explizit erwartet. Der Hostclient muss den tatsächlichen Broker-PID sehen. -Zwischen beiden positiven Requests erhält RootUID0 keine signierten Bytes. -Root hat eigene CSPRNG-IDs und Schema-Testgenerationen ausdrücklich für diese -reinen Codec-/Namespacefixtures erlaubt: keine eingeschriebenen Geräte, -Windows-DBbindung, mTLS-, Clock-/Sync- oder Jobautorität wird behauptet. - -Requestreihenfolge entspricht exakt RustSerde, inklusive explizitem null für -helper_image_sha256. Der gesamte Requesthash, Serverinstance, Boot, Key-ID und -Generation sowie Qualitätsgrenzen werden geprüft. OpenSSL prüft mit ausschließlich -öffentlichem SPKI die Ed25519-Signatur über `RMM-TIME-ATTESTATION/v1\0` und die -exakten Payloadbytes. Private Signerbytes werden nicht gelesen. Der Controller -wird als `broker_signature_acceptance.py` Root0600 unter seinem Hashparent gehalten. - -Lokal AST und drei gezielte Guardgruppen bestanden: kanonische Requestbytes, -Bindungs-/Domain-/Publickeyprüfung mit ausdrücklich ersetzter Signaturautorität, -sowie feste Clientgrenzen und Vorprüfungs-/Intentreihenfolge. Keine tatsächliche -Signatur erzeugt oder Zielabfrage ausgeführt. Zwei reine Guardhelferfehler -(mkdir-Syntaxfragment und die frühere host-read-Intentreferenz) wurden in getrennten -Guardkopien korrigiert; Produktquelle und Originalfehlerlogs blieben unverändert. -Tatsächliche Signaturen und Namespace-/Root-Deny-Nachweise bleiben Rootaufgaben. - -## Tatsächlich nativ auf dem permanenten Server bestanden - -Source `a8afe8a2167f91e743e8c976b58d9f5227fa64914ad492ffc489b0dc98392585`. -Readonly Preflight Exit0, Receipt -`d5c06a881d4a7493323adb9c7dfdc3c566ee208a6681e7e07b547c8141515e6a`. -Einmalige Ausführung Exit0, Receipt -`35b35f4e48e9806a877f3e9f2ab53eaf2ac450b492295ad57e17677d6147767c`. -Beide unterschiedlichen CSPRNG-Challenges wurden tatsächlich signiert und mit -OpenSSL/öffentlichem Ed25519-Key verifiziert. HostpeerPID2576117, ContainerpeerPID0 -bei eigenem Standard-PIDnamespace; beide ClientsUID/GID10001. RootUID0 erhielt -EOF ohne signierte Bytes. Hostfehlergrenze295608676ns bei Syncalter320109975916ns, -Container295463150ns/320435768611ns; beide innerhalb der unveränderten Grenzen. - -Originalresultat -`38ed1a3079f20438fe07a57f1bfa5a37348bdec9fc7780d7822ca3d6967e5ea1`; -separate Originalnachlese Exit0 ohne failure, Receipt -`4b442a9022f1ee56f8e851e25ad323d630b220cf47aa8169b83b9c4412c50b8d`. -Externe Core-/Runtimezeugen vor/nach exakt gleich, beide -`616effee49e79ff10112bb84cda3212029e489d84faaf8d9ae0d8901fce2b01a`; -Windows0/0/0/0, Linux31/31/27/0, geschlossene Rootpolicy. Kein privater -Signerread, weiteres Dienststarten/Neustarten, HTTPdeployment oder Windowsjob. -Diese native Abnahme belegt Brokertransport/Namespaces/UID-Deny und zwei echte -Signaturen. mTLS-Gerätebindung und unabhängige Windows-Rollenzeit sind weiterhin -separate offene Abnahmen; Fixtureidentitäten sind ausdrücklich keine Geräte. diff --git a/docs/server-time-broker-start-acceptance.md b/docs/server-time-broker-start-acceptance.md deleted file mode 100644 index e14072e..0000000 --- a/docs/server-time-broker-start-acceptance.md +++ /dev/null @@ -1,147 +0,0 @@ -# Einmaliger Start des installierten lokalen Zeitbrokers - -Quellenstand2026-11-15, Spezifikation1.23. Tatsächlicher einmaliger Serverstart -und separate Nachlese bestanden; UDS-/Signaturabnahme bleibt separat offen. -`deploy/server_time_broker_start_acceptance.py` enthält ausschließlich den -Start-/Effektivkonfigurations-/Prozess-/Socketnachweis. Unixrequests und echte -Zeit-Signaturabnahme folgen separat durch Root. Keine RMM-Jobs, HTTPdeployment, -Windowsgateänderung oder Umgehung der WebUI-Genehmigungsgrenze. - -Root hat Schlüssel-, Gruppen- und Binary-/Unitinstallation bereits getrennt -nachgewiesen. Installationsresultat SHA256 -`b52aa57971fcad5a9ff3780765f4712d4029d078aab71f94eaec6d805a642f71`, -Installationsaufrufreceipt -`5d99c54fb747737991d98ec65ee715fb7c1820af5814fd36f1dbe31ed833ed03`, -separate Nachlese -`0f1c2bcbe7ffca5cf8f40c40c84e836bf0659b67032e89bdfadd1ef1b9b4a03b`. -Dabei blieben Reload, Start und Enable ausdrücklich false. Der Controller -bindet außerdem exakt die eigenen ursprünglichen Key-/Groupresultate. - -## Feste geschützte Eingänge - -Der bestehende Bootstrapcontroller2fdcbc95 wird ausschließlich aus seinem -Content-addressed Root0600-Pfad als `broker_bootstrap.py` geladen. Sein echter -Context erhält unverändert die c15-Generation-/Qualitätsbelege, aktuellen -Chronypin, Boot, Source, Konfiguration, Namespace und API-/Gatewayruntime. -Der neue Startcontroller muss ebenfalls Root0600, ein regulärer Link, feste -Datei `broker_start_acceptance.py` unter seinem eigenen vollständigen Hashparent -sein; sein FD wird gehalten und vor Effekten erneut geprüft. - -Ein eigener `InstalledProof` hält die originalen erfolgreichen Installations- -records, Unit, Binary und öffentlichen Zeitpin. Die private Signerkonfiguration -wird ausschließlich mit `O_PATH|O_NOFOLLOW` auf ihre originale Identität und -Metadaten geprüft: der Controller liest keinen Seed. Binary bleibt exakt -1067136Bytes/SHA256 `5d8d786925c060eb042f0a592453f11970c32c4287fa4c9464f6f6a6e38cb201`, -Unit657Bytes/SHA256 `4792bfb65763f5a5146044d2ba152acd0a876b66c29d8cc66c16a5250214af2c`. -Keine Übernahme fremder Objekte, keine Umgehung des `UnitComposition`- -Konstruktors: der separate qualifizierte InstalledProof erlaubt ausschließlich -den originalen eigenen Unitinode. Alle übrigen festen Control-/Attached-/ -Generator-/Prefix-/typweiten Drop-ins, Alias- und eigenen Dependencypfade -verweigern. Originaler Manager-UnitPath und merged-usr-Alias bleiben gebunden. - -## Geplant, nicht ausgeführt - -```text -python3 -I /var/lib/rmm-time-source-operators//broker_start_acceptance.py host-preflight -python3 -I /var/lib/rmm-time-source-operators//broker_start_acceptance.py host-start -python3 -I /var/lib/rmm-time-source-operators//broker_start_acceptance.py host-read -``` - -`host-preflight` ist ausschließlich lesend. Er darf die vorhandene Unit über -D-Bus zur Auskunft laden; weder Reload noch Start folgt daraus. Für die -wirkende Phase muss `5b358997-3abc-43db-945f-f41855b4e3c0/broker-start-acceptance-v1` -vorher fehlen. Vor Daemonreload entsteht der dauerhafte create-only Intent, -danach ein eigener Reloadintent. Genau ein `systemctl daemon-reload` und dessen -Exit werden gespeichert. Erst die vollständige erneute geladene Prüfung erlaubt -den eigenen Startintent und genau ein `systemctl start -- rmm-time-broker.service`. -Kein Enable, Restart, Stop, Cleanup, Adopt oder retry. Verlorene Antwort oder -Fehler erlaubt nur `host-read` des ursprünglichen Falls; eine spätere erfolgreiche -Beobachtung schreibt ein fehlendes oder gescheitertes Resultat nicht um. - -Vor Start werden echte typisierte D-Buswerte geprüft: exaktes Fragment ohne -Drop-ins, static/nicht enabled, kein pending Job, ausschließlich ein ExecStartEx -mit genau dem Binary und ohne Zusatzargument/Flag sowie sämtliche anderen -Exec- und ExecEx-Arrays leer. Root/_chrony, Supplementary10001, Typeexec, -Restartno, NRestarts0, Bounding524290/0x80002, Ambient0, NNP, ProtectSystemstrict, -ProtectHomeyes, PrivateTmp/Devices, AF_UNIX-only, IPv4/IPv6-Denyall/Allowleer, -exakte Debug-/ptrace-/process_vm-Denylist, fester eigener ReadWritePath, UMask0077 -und Corelimit0 bleiben erforderlich. Keine nicht vorhandene Eigenschaft wird -als Null erfunden. Die echten12 bereits unabhängig gelesenen ABIwerte stammen -von systemd259.5 Ubuntu, Rootreceipt -`77c98ef563837e36c487227142258490d57b630b56b2c2f8db6474a51263aa0d`. - -Die Typen und Execarrayverträge folgen den Primärquellen für -[Service](https://github.com/systemd/systemd/blob/main/src/core/dbus-service.c), -[Execution](https://github.com/systemd/systemd/blob/main/src/core/dbus-execute.c), -[Unit](https://github.com/systemd/systemd/blob/main/src/core/dbus-unit.c) und -[IP-Cgroupgrenzen](https://github.com/systemd/systemd/blob/v255/src/core/dbus-cgroup.c). -Der tatsächliche Root-ABIbeleg bindet die konkrete installierte Ausprägung, -keine Vermutung aus einem anderen lokalen Systemd. - -Nach Start werden tatsächliche PIDFD, Birth, InvocationID, gehaltenes -/proc/exe gegenüber originalem Binaryinode, UID0/GID989, Supplementarygruppen -nur aus0/989/10001 mit10001, Effective/Permitted/Bounding0x80002, Ambient0, -NoNewPrivileges1, Seccomp2, Hostuser-/PID-/Cgroupnamespaces, Rootmountread-only -und genau der eigene Cgroupprozess geprüft. Ein begrenztes lesendes Warten -auf den Socket ist keine Wiederholung des Starts. Der Listener muss Root:10001, -0660, Singlelink und ein tatsächlicher eindeutiger AF_UNIX-Streamlistener -sein, dessen Kernelinode ein FD genau dieses unveränderten Brokerprozesses hält. -Es wird keine Verbindung und keine Signatur angefordert. - -## Grenzen und tatsächliche lokale Prüfungen - -Der Sharedproof prüft Vorher/Nachher Runtime-/Pin-/Konfigurations-/Boot- und -Chronygeneration. Er behauptet keine SQL-Corehistorienprüfung. Root muss die -bereits vorhandene getrennte `server_closed(CaptureAccess(Main))`-Nachlese vor -und nach dem tatsächlichen Start verwenden und beide externen Receipts mit dem -Original-Startfall verbinden. Dieser Controller führt keinen neuen SQLreader -und keine Credentialsdatei ein. - -Lokal tatsächlich bestanden: Python-AST und drei gezielte Guardgruppen. Die -zwölf tatsächlichen Root-ABIwerte wurden benutzt; übriger geladener Zustand -war ausdrücklich Fixtureautorität. Änderungen von Drop-in, CAP_SYS_TIME, -Filter, argv oder zusätzlichem Exec wurden verweigert. Eigene Scratchfixtures -belegten den exakt erlaubten Unitinode sowie Prefix-/Dependency-Deny. Die -statische Reihenfolge belegte genau zwei Wirkkommandos und deren dauerhafte -Intents mit vollständiger Effektivprüfung dazwischen. Keine Targets, Seeds, -Schlüssel-, Gruppen- oder Dienstwirkungen. Der erste Guard las die zusätzliche -Root-RPC-Hülle falsch und brach vor Prüfungen ab; eine getrennte Guardkopie -prüft Exit/Stderr und dekodiert korrekt. Produktquelle und ursprüngliche -Fehlerlogs blieben unverändert. - -Die nativen Unit-/Prozess-/Socketprüfungen, tatsächlicher einmaliger Start, -separate Nachlese sowie positive und negative UDS-/Signaturfälle sind noch -offen. Ein Start-/Listenerbeleg allein qualifiziert keine Signatur oder -Windowsbereitschaft; der Broker muss vor jeder tatsächlichen Signatur erneut -eine aktuelle native Quelle messen. - -## Tatsächlich ausgeführt auf dem permanenten Server - -Controller `e1458cb3feecd3d3302f2fccaff4850cfc8c403ee3314563f5f641e7c8bdfc39`: -readonly Preflight bestanden, Receipt -`51995f5dfb0b6e668246f423843f4b7aa67b4ab0765b60a54cb7dd0c6f3db5ed`. -Vorheriger622-Preflight scheiterte vor Phasenanlage/Reload/Start an einer -unzutreffenden InvocationID-Annahme. Typisierte tatsächliche ABI-Nachlese -`201b306fab8efb4ebd4fa22e8c6925a735eaa2dea9651581596ae5c97436c410` -belegt `ay=[]` für den noch nie gestarteten Dienst. Die unabhängig geprüfte -Korrektur verlangt inaktiv exakt[] und laufend weiterhin16gültige, nicht -sämtlich nullwertige Bytes. Kein laufender Null-Fallback. - -Genau ein Daemonreload und ein Start, Exit0, Rootreceipt -`5177b5a32d13a053e21197513b029bc920c6e40ed4c2fc793e20d5d74e6eb87a`. -Originalresultat -`8fc6ed5193f9802b7686a93523730c7e805595415c8e887552ffcf4224968d4d`; -separate Originalnachlese -`731527c0e30aaaddf386f414ffcdd11333000b9897b856cb994da1eccd255d54` -bestätigt vollständige Records ohne failure. Tatsächlich PID2576117, -Birth18167723, UID0/GID989, Supplementary989/10001, Caps0x80002, NNP, -Seccomp2, Rootmountreadonly und genau ein eigener Cgroupprozess. Eigener -SocketRoot:10001/0660, Kernelinode8409245 und BrokerFD10 gebunden. - -Externe tatsächliche SQL-Core-/Runtimezeugen vor/nach exakt gleich, beide -SHA256 `616effee49e79ff10112bb84cda3212029e489d84faaf8d9ae0d8901fce2b01a`. -Windows0/0/0/0, Linux31/31/27/0, Rootpolicycf15 geschlossen. -Chronygeneration, Pins, Signermetadaten und RMM-Runtime erhalten. Kein Enable, -Restart, weiterer Chronyrestart, Unixrequest, Signieren oder HTTPdeploy; -Windowsjobgate unverändert geschlossen. Dieser Schritt belegt ausschließlich -Start/Effektivhärtung/Prozess/Listener, keine vollständige Windowsabnahme. diff --git a/docs/server-time-broker.md b/docs/server-time-broker.md deleted file mode 100644 index f9b600b..0000000 --- a/docs/server-time-broker.md +++ /dev/null @@ -1,166 +0,0 @@ -# Lokaler Linux-Zeitsignierbroker - -Dieser neue Quellpfad trennt den privilegierten, fest begrenzten Zeitprovider -und Zeitsignierschlüssel vom unprivilegierten HTTP-Server. Er ist kein Job- -executor und erteilt keine WebUI-Freigabe, Capability oder TrustedClock-Lease. -Noch kein realer Brokerstart, Schlüsselsetup, Bootstrap oder Zieltest wurde -durch diesen Implementierungsauftrag ausgeführt. Lokale Prüfungen und native -Abnahmen werden getrennt nach tatsächlichem Lauf dokumentiert. - -Das feste Executable akzeptiert keine Argumente. `run()` benötigt einen Root- -Prozess, eröffnet eine einzige fest gepinnte `NativeTimeSource` und verarbeitet -Verbindungen seriell am Unix-Streamsocket -`/run/rmm-time-source/broker.sock`, Listenbacklog4. Kein Internetlistener, -frei wählbarer Pfad/Befehl, IPC-Adminbefehl, dynamischer Interpreter, Jobgrant, -Zeitsetter oder automatisches Provisionieren. Cross-OS bleibt unsupported. - -## Geschütztes Provisionierungsprofil - -Voraussetzungen, **kein ausgeführter Bootstrap**: Geschützte root-eigene -Verzeichnisancestry ohne Symlinks und ohne Gruppen-/Fremdschreibrecht. -`/etc/rmm-time-source/signer.json` regulär root0600, ein Link, höchstens8KiB, -striktes JSON-Schema1 mit diesen Feldern: - -- `server_instance`: nichtleere UUID des festen Servers. -- `key_id` und `key_generation`: eigenes Zeitkey-IDprofil und positive Generation. -- `signing_key_hex`: genau32Bytes privater Ed25519-Zeitschlüssel als64kleine Hexzeichen. -- `forbidden_public_keys`:1–32 eindeutige konkrete öffentliche Fremdrollenschlüssel. -- `expected_server_uid` und `server_gid`: beide ausschließlich10001. - -Keine Schlüsselwerte in Chat, Logs, Receipts oder Git ablegen. Der Broker gibt -bei Prozessfehlern nur eine feste generische Fehlermeldung aus. Config und -Signer besitzen keine Debug-Ausgabe. Root muss den echten Jobsigner sowie -alle bekannten Update-/Health-/TLS-Ed25519-Rollen in die geschützte Verbotsliste -aufnehmen. Der Broker vergleicht dekodierte32Bytewerte mit seinem abgeleiteten -Timepublickey und verweigert jede Wiederverwendung. Eine nichtleere beliebige -Liste beweist allein nicht, dass der Operator alle tatsächlichen Fremdrollen -korrekt erfasst hat. Die Schlüsseldomäne des Codecs bleibt getrennt. - -Gehaltene Datei-/Verzeichnis-FDs, Device/Inode/Konto/Modus/Linkzahl sowie -Länge/mtime/ctime werden kontrolliert. Rootrotation verändert keine laufende -Instanz stillschweigend: sie braucht den gesonderten geschützten Betriebsweg, -Stop und eine neue Brokerinstanz. Kein automatisches Übernehmen neuer Pins. -Die tatsächlichen Prozess-/Image-/PIDpins der Chrony-Instanz gehören separat -zum [nativen Provider](server-time-source.md). Neustart/Boot/Daemonwechsel -brauchen eine neue unabhängig geprüfte Rootprovisionierung; der Broker erfindet -keine Qualität aus einem Autostart oder dem bloßen Vorhandensein der Datei. - -Der Runtimeparent muss für das Serverkonto traversierbar und root-write-only -sein. Der einmalig erzeugte Socket wird root:10001 mit Modus0660 gesetzt, seine gehaltene -Identität nachgeprüft und erst dann auf Listen geschaltet. `SO_PEERCRED` muss -kernelbestätigt PID>1 und UID/GID10001 liefern. Das entspricht dem tatsächlichen -Compose-Profil10001:10001; keine Fallbackidentität. Cleanup entfernt ausschließlich -den exakt selbst erzeugten Namen/Inode per `unlinkat` am gehaltenen Parent-FD. -Ein nach hartem Prozessabbruch verbliebener Socket blockiert den Neustart; -keine automatische Adoption, Entfernung oder Wiederholung auf unklarem Stand. - -Die Rootdiensthärtung ist ein eigenes Operatorarbeitspaket. Für den lesenden -Zugriff auf das Image einer Chrony-Instanz mit anderer UID kann auf dem realen -Server `CAP_SYS_PTRACE` nötig sein. Daraus folgen keine neuen Codepfade für -`ptrace`, `process_vm_*` oder beliebige Prozessdaten. `CAP_SYS_TIME` ist für die -verwendeten ausschließlich lesenden `adjtimex(modes=0)`-Abfragen nicht nötig. -Keine Dienstunit oder Capabilityänderung wurde hier ausgeführt. - -## Fester Draht- und Zeitvertrag - -Genau eine Anfrage pro Verbindung:4Byte Big-Endian-Länge und1–8192Bytes -kanonisches JSON des bestehenden `Request`-Codecs. Unbekannte/duplizierte -Felder, nichtkanonische Bytes, falscher Endpunkt/Rollen-/Bindingschemawert, -zusätzliche bereits angelieferte Bytes oder unvollständige Frames verweigern -vor dem Provider-/Signaturpfad. Danach genau eine analog gerahmte -`SignedAttestation`-Antwort und Verbindungsende. Ein fehlgeschlagener Versuch -wird nicht intern wiederholt. Gesamtes Lese-/Signier-/Schreibbudget250ms, -gemessen mit eigener Monoton- und BOOTTIME; IO arbeitet nonblocking mit verbleibender -Gesamtfrist, nicht mit verlängerbaren Einzelreadtimeouts. Suspend während -des Reads eröffnet nach Resume kein neues Restbudget. - -Vor **jeder** Signatur erfolgt `source.sample()`: tatsächliche gepinnte -Chrony-/Kernel-/Clockprüfung, keine gespeicherte Qualität. Der Payload enthält -nur den kanonischen AnfragesHA und geschützten Server-/Keykontext zusammen mit -dem tatsächlich privat konstruierten Sample. Nach der Probe liest der Broker -selbst REALTIME/MONOTONIC/BOOTTIME und Boot-ID; Rücksprung, Suspend-/Wallclock- -abweichung oder falscher Boot verweigern. Gemessene Erfassungsfenster sind keine -physikalische Timerkalibrierung. - -Das UTCcapture bleibt das ursprüngliche Sample. Die Restzeit bis zur festen -250ms-Gesamtfrist, die bereits seit Samplecapture vergangene Zeit und beide -höchstens10ms-Erfassungsfenster werden vor Signierung konservativ in Fehler- -und Quellaltersobergrenze reserviert. Über500ms Fehler oder1h Quellalter -verweigert. Nach Ed25519-Signierung folgen eigene neue Clock-/Boot-/Frist- -prüfung und erneute geschützte Configprüfung vor Antwort. Kein nachträgliches -Verlängern der Frist und keine kostenlose neue Anfrage/Nonce/Jobberechtigung. -Der unabhängige Empfänger muss weiterhin vollständigen RTT, eigene Capture- -unsicherheit und strikte Deadlinegrenzen prüfen. Es gibt kein Holdover. - -Der Broker authentisiert ausschließlich das lokale Serverkonto. Tenant, -Geräteidentität/mTLS, aktueller Connection-/Enrollment-/Assignmentkontext und -SQLautorisierung sind Pflichten der separaten Serverroute. Eine vom Server -weitergeleitete Helperrolle behauptet keine native Helperprozessattestierung -auf der Serverseite; deren unabhängiger Proof bleibt lokal beim Helper. - -## Tatsächlich lokal geprüft - -Im vorhandenen Offline-Buildimage -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`, -UID1000, Quellmount read-only, eigenes `devstate/broker-target`: - -- `cargo test --locked --offline -p rmm-time-broker-linux --all-targets`: - 3Guardtests bestanden,0fehlgeschlagen,0ignoriert,0gefiltert. Die Tests prüfen - synthetische Keyrollen, kanonische Frames und Frist-/Qualitätsüberläufe; - keine echten Schlüsseldateien, Root- oder Provideraufrufe. -- `cargo clippy --locked --offline -p rmm-time-broker-linux --all-targets -- -D warnings`: - bestanden nach Entfernung eines unnötigen `Ok(...?)`; keine Unterdrückung. -- Gezielte `rustfmt --edition2024 --check --config skip_children=true`-Prüfung - der drei eigenen Rustdateien: bestanden. - -Release-Link und ausführbares Brokerbinary werden getrennt mit ihren -exakten Hashes im privaten lokalen Qualifikationsfall festgehalten. Ein Build -oder synthetischer Guardtest ist kein echter IPC-/Signier-/Providerlauf. - -## Offene tatsächliche Gates - -Unabhängiger Quellenreview und native Prüfungen sind separat auszuweisen. Tatsächliche Providerqualität, sichere Schlüssel-/ -Pinprovisionierung, Diensthärtung, Rootbrokerstart auf Linux, mTLS-/SQLroute, -unabhängige Windows-Agent-/SYSTEM-Abnahme und Runtime-/Deadlineintegration -bleiben eigene Gates. Kein Notebook-RMM-Dienst, kein Zielreboot, keine neue -Freigabe- oder Ledgerstrecke folgt aus diesem Quellencheckpoint. - - -## Unabhängiger Review und Serverroute - -Brokerquelle unabhängig geprüft. Privater QualifikationsreceiptSHA256 -`0bc10b7e52ebfc06894eaf38fb070ac6dc14e973940e71c9e03faa9af6fdd409` -bindet13Inputs, tatsächliche lokale3/3Guardtests, Clippy/Fmt sowie -Release-Unitlink und ausführbares Brokerbinary. Keine echte Providerquery, -Schlüsselprovisionierung oder Brokerdienst durch diese Prüfungen. - -Die neue Gatewayroute `/agent/v1/time-attestation` erhält8KiB Größenlimit, -prüft gültiges Geräte-mTLS und die aktuelle gesperrte Tenantinstallationszeile: -Agent/Asset, Enrollment-/Assignment-/Connectiongeneration, Windowsboot und -Windowscapability. Ein bereits fertiger SignedSync wird nicht verlangt, um den -initialen Clock-/Synczyklus zu vermeiden. Die geteilte Installationssperre bleibt -während der begrenzten lokalen Brokeranfrage erhalten; keine Job-/Grant-/ -Outbox- oder Readyänderung. Nur Nonce-/Kontext-/Zeitmaterial wird zurückgegeben. - -Der Container authentisiert den Hostbroker über Kernel-UID0 und den festen -root-eigenen Socket/Inode. Eine Host-PID ist in der eigenen Container- -PIDnamespace nicht sichtbar und kann als0 erscheinen; die erste zusätzliche -PID>1-Prüfung hätte legitime Anfragen blockiert und wurde nach unabhängiger -Analyse entfernt. [Kernel-Credentialabbildung](https://github.com/torvalds/linux/blob/master/net/core/sock.c). -Kein pid:host, privilegierter Container oder UIDremap-Fallback. Unmapped UID/ -abweichender Dateibesitz bleibt deny. Der tatsächliche Namespace-/UIDbeleg ist -vor Deployment noch auszuführen; Endverifier prüfen weiterhin ihren separat -provisionierten Zeitschlüssel und die ganze Originalchallenge. - -Route unabhängig sourcegeprüft; lokales Servercheck und Alltargets-Clippy mit --Dwarnings nach Namespacekorrektur bestanden. Der erste UID1000-Compilerlauf -stoppte an einem nicht lesbaren bereits vorhandenen Registrycachefile(fnv); -getrennter privater Servertarget/UID0 im unveränderten read-only Offlinecontainer -bestand ohne Rechteaufweichung oder Änderung alter Artefakte. Keine neuen -Server-/DB-/mTLS-Integrationstests oder Produktionsbereitstellung behaupten. - -Die500ms betreffen die Issuefunktion einschließlich Auth-/DBphase; die -Axum-Bytesextraktion liegt davor und ist nur größenbegrenzt. Vier gleichzeitige -Anfragen werden nach der ersten Authquery begrenzt, der lokale Brokerteil auf -300ms. Keine globale TCP-Bodyfrist oder Obergrenze aller Authqueries behaupten. -Detaillierte öffentliche Endpunktlast-/Bodyzeitlimits bleiben späterer Betrieb. diff --git a/docs/server-time-gateway-build.md b/docs/server-time-gateway-build.md deleted file mode 100644 index 60bd3dc..0000000 --- a/docs/server-time-gateway-build.md +++ /dev/null @@ -1,34 +0,0 @@ -# Tatsächlicher ARM64-Build für den Zeit-Gatewaypfad - -Am2026-11-15 auf dem permanenten Cloudserver gebaut, noch nicht bereitgestellt. -Originalfall `d11a6fb7-cfdd-41b2-87c5-b48a2cfd2e27`. Eingabe ausschließlich -209 veröffentlichte Dateien aus Gitea-Quellencheckpoint -`2af5db16f12d0851fd76935df876e73433fdc1cf`; keine bewegten Worktreequellen, -Zugangsdaten oder privaten Zustandsdateien im Sourcearchiv. Archiv-SHA256 -`4419f229599d827a63b69ded3c57b3a3fe4066a10d431368f68a2e415f77b3da`. -Die tatsächliche Server-`.dockerignore` wurde vor dem Build mit dem bekannten -restriktiven Quellmuster verglichen. - -Der vorhandene Source-Upgradeweg sicherte frühere Quelldateien und startete -einen eigenen Builddienst mit separatem Imagetag. Rootreceipt -`57f02afc44b830b00f53a294a610dcf66d7f57eb180aebe94e94c2e1273498a1`. -Tatsächlicher Dockerbuild Exit0, Image -`sha256:422c2c28a91ac512e9317908f4d1fb22247eef857ca95d45e1b1880598b0d611`. -Buildresult-SHA256 -`b8c0f61d054548753767c378e29019bd60f997980c2d407f8fd6e7b763047fdc`, -Source-Record-SHA256 -`521bd003500e1dc51b5ec430900aa0c2e17f9ec050b7fc077f0cbbdf58ba7c0f`, -Buildlog-SHA256 -`f820345ef15268b47f2487222dcc2a80e9d8849ad9be005f7097fb7dd4232a8f`. - -Separater lesender Rückabruf bestätigte Originalresult und tatsächliche -Imageplattform `arm64 linux`, Receipt -`74effdb5efeefd869d9aa1ef9640e7e549623637e5280a8af5ce003e0af21ee6`. -Der laufende Runtime-Tag blieb6f8383f7. Keine Migration, kein Containerwechsel, -kein öffentlicher Listener, keine WebUI- oder Jobfreigabe und kein -Zeitbrokerstart wurden dadurch ausgeführt. - -Dieses Image enthält den konservativen Frischefix und die neue Gatewayroute -`/agent/v1/time-attestation`. Reale Providerqualität, Zeitkey/Broker, geschützter -Socketmount und mTLS-/Tenant-/Kontextabnahme bleiben Voraussetzung eines -späteren Deployments. Build ist kein Nachweis eines betriebenen Endpunkts. diff --git a/docs/server-time-gateway-deploy.md b/docs/server-time-gateway-deploy.md deleted file mode 100644 index 9768b65..0000000 --- a/docs/server-time-gateway-deploy.md +++ /dev/null @@ -1,146 +0,0 @@ -# Fixed time gateway deployment preparation - -Source-only, no deployment executed by this author. The operator uses only the -already qualified ARM64 image422c2c28 from stage -`d11a6fb7-cfdd-41b2-87c5-b48a2cfd2e27`, source2af. It performs no rebuild and -does not package, replace or delete existing WebUI files. The original seven -web files, their bytes and inodes, index95d6f905, compose d2044b0e, PKI/key -metadata, closed policycf15, PostgreSQL container/volume and Chrony generation -remain bound. Root independently captures immutable31/31/27 closed core history, -Windows0 and native-role evidence before/after; this controller does not claim -those external witnesses from container checks alone. - -`deploy/server.time-broker.compose.yaml` is the199-byte fixed optional overlay, -SHA256 `dbd08faea8f58c032562d822f4191c719f9a6828b00d6c368fc2596155a9a314`. -Only gateway receives the read-only `/run/rmm-time-source` bind, with -`create_host_path: false`. API receives no time mount. No port, environment, -authentication, TLS, policy or capability changes are added. - -`cloud_server_upgrade.deploy` automatically includes that exact Root0:0/0644 -single-link overlay whenever installed. Wrong bytes, owner, mode, hardlinks or -symlink/unsafe ancestry deny before UI/tag/migration effects, with repeat checks -before each backend effect. Absence retains the original compose invocation. -A stage reserved by the fixed operator cannot later be replayed through generic -deploy. The new reviewed public upgrade tool is installed with a retained old -copy, so future upgrades keep the mount. - -`deploy/server_time_gateway_deploy.py` has only `host-preflight`, one -`host-deploy`, and original `host-read`. Root stages `gateway_deploy.py` plus the -two fixed public files under the controller's content hash. It checks source209 -files and original build result, actual old6f API/GW containers and runtime tag, -UI CAS, PostgreSQL identity, and actual broker start8fc6/e145 proof. Live broker -checks retain the original process/birth/image/socket independently of the old -6f application IDs; no old InstalledProof freshness check is bypassed or reset. -The separate C31 public key is pinned. A missing actual signature-PASS result -and separate read hash hard-denies before deployment. - -The final source pins actual signature controllera8afe8a2 and result -`38ed1a3079f20438fe07a57f1bfa5a37348bdec9fc7780d7822ca3d6967e5ea1`, -with separate read receipt -`4b442a9022f1ee56f8e851e25ad323d630b220cf47aa8169b83b9c4412c50b8d`. -Both host and default-container UID/GID10001 signatures were verified in that -separate fixture. They do not attest mTLS, an enrolled Windows identity, sync -readiness or clock authority. The deploy operator sends no signature request. - -New case `fb87aa88-2b67-4cff-9c90-4cd713380889` writes intent before installing -the create-only overlay, persistent upgrade tool or moving the runtime tag. -Each tag, migration and API/GW recreate has its own intent and retained exit/log. -Migration uses the existing compiled image once; actual versions1–14 must become -1–15. Only API/GW are forcibly recreated, without dependencies or rebuilds. All -old role mounts remain equal, plus exactly the gateway-only read-only broker -mount. Broker, Chrony and PostgreSQL are not restarted. - -Failure/lost reply permits only the same case's `host-read`, with no retry, -automatic rollback, reset, enrollment, key generation, signature request or -API/DB approval. The existing WebUI approval boundary for every RMM job remains -unchanged. Readback performs no Docker/service/SQL/time action. - -## Tatsächlicher lesender Vorabcheck - -Controller `e14aeabfd7d3a8ab298985706dc26014e0ad540a1c3ef40cf57e1a65b77b7f3b` -mit unabhängigem QuellenreviewPASS. Auf dem permanenten Server wurde ausschließlich -`host-preflight` ausgeführt: Exit0, Rootreceipt -`9c08cce4f21da8a895eabeea80c4ff1e6068346fb5b46b4fe95b0ee2d30db1e9`. -Geschützte Sources/Buildresultate, bestehende6f-Runtime, alleUI-Dateien, PKI-, -Broker-/Signatur-/Pinbelege, PostgreSQL und Migrationsstand1..14 akzeptiert. -Noch kein Deploymentfall angelegt, Overlay installiert, Image getaggt, Migration -oder Recreate ausgeführt. Die Runtime bleibt6f;422 bleibt gebauter Kandidat. -Vor tatsächlichem `host-deploy` folgen die getrennten vollständigen SQL- -Historienzeugen, nachher deren Originalvergleich sowie Endpoint-/Windowsnachweise. - -## Erster Bereitstellungsversuch am 15. November - -Der Server installierte die schreibgeschützte Socket-Einbindung und das -Upgrade-Werkzeug. Vor dem Wechsel des Image-Tags brach der Vergleich der -Containerkonfiguration ab. Docker liefert die vorhandenen Mounts in wechselnder -Reihenfolge. Die getrennte Nachlese zeigte bei API und Gateway ausschließlich -eine andere Reihenfolge, PostgreSQL war identisch. Alle Mountattribute stimmten -nach Sortierung nach Zielpfad überein. - -Der ursprüngliche Versuch bleibt fehlgeschlagen. Es gab keinen Tag-, Migrations- -oder Containerneustartauftrag. Der Vorher-/Nachhervergleich über 18 Tabellen -und die Geräteidentitäten war identisch. Die Datenbank steht auf Migration 14. -Ausführung `7f11898cd87e312066cdbcf9909b72a867bf3e6c1b1ff6b905f81974fa4391e5`, -Nachlese `eafe1c067aa3f8bb8cfe1203636319a24fba705a18a7a2166b568c5f4c81cda6`, -Mountvergleich `a06256380d2febeddb506ffe17a614325b25c25464f45b4d022c82f644a0fc0f`. - -## Bereitstellung und Nachprüfung am 15. November 2026 - -Auf `discovery.ease-technologies.de` laufen API und Gateway mit dem geprüften -ARM64-Image `422c2c28`. Die Fortsetzung verglich alle Docker-Mountattribute nach -eindeutigem Zielpfad. Sie führte anschließend nur das Setzen des Image-Tags, -Migration 15 und den Austausch der zwei Anwendungscontainer aus. Alle drei -Befehle endeten mit Exit 0. PostgreSQL behielt seinen Container und sein -Volume. Nur das Gateway erhielt die schreibgeschützte Einbindung des -Zeitbroker-Sockets. Der ursprüngliche Abbruch ist separat erhalten. - -Beide internen TLS-Healthchecks lieferten 200 und `ok`. -Die private Anmeldung meldete das dev/test-Profil. Am öffentlichen Gateway -lieferten die sechs geprüften Verwaltungsrouten einschließlich WebUI und MCP 404. -Der Agentenschlüssel-Endpunkt erforderte weiterhin Geräteauthentifizierung (401). -Die Daten der 18 geprüften Historientabellen und die Geräteidentitäten stimmten -mit der Vorhermessung überein, offene Jobs 0. Migrationen 1 bis 15 erfolgreich. -Die Prüfung des signierten Zeitabrufs aus dem Windowsgast folgt separat. - -| Prüfung | SHA-256 des Belegs | -| --- | --- | -| Lesender Vorabcheck | `77d3d1011d5a6f7981306910edd535310e09d10cb161c3a30e79fe4b037802c1` | -| Bereitstellung | `06607548806d47ef8378ae3d569e5779943cb67519305975d2665cc872fc87a3` | -| Separat gelesenes Serverergebnis | `3017634f101ee8aff62988f195ccb3a7a8b9e03eaa48b8fb339af9ceb3ad2b4b` | -| Nachlese | `b8cc94a9f9ba4d1782e052ef0bf317b5229b9578c646bf393c24b33a9507fab4` | -| Historie nach Migration | `cb72a95afc94c9d96ae78a38495e62b59db4598b8ea16996b00d83e2cd6c08a7` | -| TLS und öffentliche Zugriffstrennung vor und nach Migration | `f381279d3e5ebbded79b0b3ad587dee09ebf7adbbbf47d9099584f00ddcd95d5` | - -### Wiederverbindung der beiden Geräte - -Nach dem Gatewaywechsel meldeten sich beide bestehenden Geräte selbständig -wieder über WSS. Die gespeicherten Daten des Entwicklungsmandanten zeigten am -15. November um 12:38 UTC für Linux einen 12 Sekunden alten Kontakt und einen -18 Sekunden alten Inventareingang. Für Windows betrugen die Werte 23 bzw. -146 Sekunden. Die Verbindungsgenerationen waren 153 und 91. Dafür war kein -Live-Auftrag erforderlich. Beleg der lesenden Abfrage -`9ce23669ff03a7ec5a08e10437a009a7ae617f472614d161ab082e17c02c2095`. - -Auch die normale MCP-Schnittstelle lieferte beide Geräte im selben Mandanten -über `inventory.list_devices`, `inventory.get_device` und -`monitoring.get_health`. Linux und Windows standen auf `online`, mit -29 bzw. 18 Sekunden seit dem letzten Kontakt. Die Liste enthält außerdem -zwei widerrufene Altinstallationen. Die erste Auswertung hatte fälschlich -genau zwei Listeneinträge insgesamt erwartet. Die korrigierte Prüfung glich -die beiden aktiven Gerätekennungen und den Widerrufsstatus separat ab. -Der mandantenweite Gesundheitswert lautete `unknown`. Das Inventar war -für beide aktiven Geräte abrufbar. MCP-Beleg -`f6fe5ab254c9ca3fad238271601b0f8df2029b6b6138c47ff000d55071ab70cf`. - -Migration 15 hat die beiden Tabellen für Agent-Releases und Updateartefakte -auf dem permanenten Server angelegt. Eine lesende Abfrage im PostgreSQL-Katalog -bestätigte für beide Tabellen erzwungene Row-Level Security, die Mandantenpolicy -und den aktiven Unveränderlichkeits-Trigger. Die Anwendungsrolle darf lesen -und einfügen. UPDATE und DELETE sind ihr entzogen. Beide Tabellen waren leer. -Beleg `623fe75484f337996e784b24dae0b0be29a4596f2a6842841c7636a99daaf754`. - -Ein zusätzlicher Abruf vom Entwicklungsrechner über den öffentlichen DNS-Namen -und Port 443 prüfte den externen Zugang ohne Geräteidentität. TLS wurde gegen -die öffentliche CA der Windows-Installation geprüft. POST an die Zeitroute -lieferte 401, GET an `/`, `/auth/config` und `/mcp` jeweils 404. -Beleg `346c2c60635e52cb758f3e6092f7187a9c35203d1fff3c8f18d1dbca73607607`. diff --git a/docs/server-time-peer-diagnosis.md b/docs/server-time-peer-diagnosis.md deleted file mode 100644 index 4f34519..0000000 --- a/docs/server-time-peer-diagnosis.md +++ /dev/null @@ -1,65 +0,0 @@ -# Chrony-Peerdiagnose auf dem permanenten Server - -Stand2026-11-15. Die ursprüngliche Named-Socket-Qualitätsprobe bleibt -fehlgeschlagen: Exit1, kein Sample, keine Zeitautorität. Die neue Diagnose -verändert weder diesen Beleg noch bestehende RMM-Jobs oder Freigaben. - -## Tatsächliche Ergebnisse - -- Die eigene neue Provider-Fehlerdiagnose3c1f0204 liefert weiterhin ausschließlich - `TIME_CHRONY_CONNECT`, Receipt - `f0a813baef86da1bacdd3cf5d0670158645665c3589d8540a8e01260b384264f`. - Originalprovider unverändert, keine Serverqualität oder Signatur. -- Ein neuer eigener gebundener Dateisocket scheitert ebenfalls mit EACCES13. - Nur der selbst angelegte Socket wurde inodegebunden entfernt. Der - Kernel-Auditlog belegt AppArmor `sendmsg`, Profil `/usr/sbin/chronyd`, - requested/denied `r` am Projektclientpfad. Auditreceipt - `03b70a0c2d9efceef5a6ba5472af7d173cf19d5f900a5818ebd0a119744bed65`. -- Das aktuelle Profil ist tatsächlich geladen: offline kompilierter - unkomprimierter Blob und exportierte Kernel-`raw_data` sind bytegleich, - 47441Bytes/SHA256 - `a0dd0b80f5e074b3cf0350a618ca98855a3076c7e869d2a80d209b57b3b220fa`. - Receipt - `913d737e99caf2931b2b8fd72c1638da5cc6b8caa1fdf24717fda1e85c740364`. - Kein weiterer Reload wurde daraus ausgeführt. Parser5.0.2, Rootunconfined, - Chronyenforce, Kernel7.0.0-30-generic. Parserconfig nur Kommentare. -- Die zuerst verwendete `aa_query_file_path`-Abfrage war irreführend: Die - untersuchte libapparmor-Implementation überträgt ein Pfadbyte zu wenig. - Vergleich mit explizitem `aa_query_file_path_len` und eingeschlossenem - NUL-Endpunkt bestätigt, dass die vollständigen Clientpfade in der aktuellen - Policy erlaubt sind; die normalen Abfragen verweigern dagegen wegen des - abgeschnittenen Suffixes. Receipt - `f8f0d3f3b37fcc10d18e510d4d3111c5c7ec20d2b96d55eb8b932b0a262d2502`. - Kein Wildcard-/Doppel-Slash- oder fehlender-Reload-Bug daraus behaupten. -- Eine einzelne native lesende `chronyc -n tracking`-Abfrage bestand, Receipt - `2ba123599a9d167ab757ce9ca611406a94b1975e0a17c410f83ad70fa417aa06`. - Sie ist kein gemeinsamer Providerqualitätsnachweis. Ein separater danach - gebundener Named-Socket-Connect bleibt EACCES13; kein Dienstneustart oder - Uhrsetter. -- Ein neuer ausschließlich selbst kernelgebundener abstrakter AF_UNIX-Socket - mit CSPRNG-Name, exklusivem Bind und SO_PASSCRED verbindet sich im exakt - gleichen Root989-/Zwei-Cap-/NNP-/AF_UNIX-/IP-Deny-Profil erfolgreich mit dem - festen Chrony-Socket. Rootcall8aea03d4, Receipt - `9bcdaa00b86346b85d73d5bb9d4e491ecd82ed108ca8ec8a0495f7ec19770d56`. - Kein Datagramm gesendet, keine Datei angelegt; eigener FD geschlossen, - Runtime-/Boot-/Chronyzeugen erhalten. Noch kein Trackingreply, Sample oder - Clockgate. Ein notwendiger Transportfix braucht eigene Quellen-/native - Linux-/ARM64-/Qualitätsnachweise; die alten Named-Artefakte bleiben erhalten. - -## Ursachenstand und spätere Entdeckungen - -Upstream7.0 reicht im Datagramm-Peergegencheck das am Socket gehaltene Label -direkt weiter. Das stützt die Erklärung einer älteren Policygeneration am -bereits vor dem Reload erzeugten Chrony-Socket. Gewöhnliches Unix-recvmsg -führt dort keinen garantierten Labelrefresh durch. Das ist Quelleninferenz, -kein nativer Pointer- oder vollständiger Ubuntu-Patchnachweis. Keine weitere -Capability, generisches Unix-Allow oder Änderung von Chronys bestehenden -Dateirechten ist durch diese Befunde begründet. - -Primärquellen: [Linux7.0 LSM](https://kernel.googlesource.com/pub/scm/linux/kernel/git/torvalds/linux/+/v7.0/security/apparmor/lsm.c), -[Unix-Peerprüfung](https://kernel.googlesource.com/pub/scm/linux/kernel/git/torvalds/linux/+/v7.0/security/apparmor/af_unix.c), -[libapparmor-Queryimplementation](https://gitlab.com/apparmor/apparmor/-/blob/master/libraries/libapparmor/src/kernel.c). - -Die libapparmor-Abfragelänge ist eine wichtige spätere Toolingentdeckung. -Während dieses MVPs wurde keine Systembibliothek gepatcht, kein Kernel oder -OSpaket aktualisiert und keine externe Fehlermeldung veröffentlicht. diff --git a/docs/server-time-source-abstract-client.md b/docs/server-time-source-abstract-client.md deleted file mode 100644 index f680b53..0000000 --- a/docs/server-time-source-abstract-client.md +++ /dev/null @@ -1,111 +0,0 @@ -# Native Chrony client transport: abstract AF_UNIX - -The native Linux source now binds one CSPRNG UUIDv4 name in the Linux abstract -AF_UNIX namespace. The leading NUL and exact sockaddr length select a kernel -name, without a trailing NUL or filesystem client socket. There is one bind -attempt. A collision fails the observation; the provider never adopts a name, -generates a replacement name after failure, or retries the request. - -The root-protected `/run/rmm-time-source/clients` directory remains mandatory, -with its existing exact root/group/mode checks, held directory descriptor, -exclusive nonblocking flock and empty-directory precondition. Historical named -socket leftovers therefore still block the instance. The provider never deletes -or adopts them. Its own abstract address is checked with getsockname. Successful -observation explicitly consumes and closes the socket descriptor once before -returning quality; a close or verification error cannot return a qualified -sample. Drop closes remaining owned descriptors without an unlink or a close -retry. The source remains poisoned after a failed observation. - -An abstract name grants no filesystem DAC authority. A different process could -reserve a guessed name first and deny bind, or cause denial of service. That -cannot create positive source quality: the kernel excludes a second bind, and -the source still connects only to the fixed protected Chrony pathname. The -pinned daemon PID, birth, image, UID/GID, held process identity, protected server -socket identity, exact single SCM_CREDENTIALS record, reply sequence and fixed -Tracking packet checks are unchanged. The monotonic/boottime/UTC brackets, -kernel-state, error, reference-age and signed-time contracts are unchanged. -The provider exposes no configurable endpoint, clock setter, signer, retry or -network transport. - -The original named-client provider SHA -`3fd9c7a969a583abf97e29165135a8c1044db5c951ad8bd4dbfee3ee77e7ccdc` -and the original 5b build/failed GROUP, DAC and peer probe records remain -historical evidence. They are not overwritten or reclassified. Root's separate -abstract-connect-only diagnosis, receipt -`9bcdaa00b86346b85d73d5bb9d4e491ecd82ed108ca8ec8a0495f7ec19770d56`, -proved connect under the same two-capability profile without sending a -datagram. It did not produce a native quality sample. This transport change -requires its own published source build and native qualification before any -broker quality gate may open. It changes no AppArmor rule, ACL, capability, -Chrony service, public pin, signer key or RMM job. - -Subsequent evidence blocks treating this implementation as a working Chrony -transport. Root's separate one-request diagnosis received no reply (receipt -`f82eef4fc7d8f7cab7971a835a68eef855f166c32cb2feaac191551188351881`). -The upstream Chrony 4.8/4.9 [socket.c](https://gitlab.com/chrony/chrony/-/raw/4.9/socket.c) -stores an AF_UNIX sender as `remote_addr.path`, then reconstructs the reply -address using `strlen` in `set_unix_sockaddr`. An abstract sender's leading NUL -therefore loses its random name. This source-level incompatibility explains the -observed connect/send success without a reply, subject to checking the installed -Chrony package's exact source. The local guards below prove kernel socket -semantics, not Chrony interoperability. No ARM quality acceptance or broker -installation may follow from these local results. - -The local six-test qualification uses a frozen three-crate workspace, the held -original offline 70-package lock/recipe and current codec807 source. Two new -guards verify exact abstract sockaddr encoding and actual exclusive kernel bind -with release on close while an unrelated name stays reserved. The existing -clock-bracket and Tracking-parser guards remain; the obsolete filesystem-client -cleanup fixture is replaced by the retained server-socket protection guard. -Local tests do not call NativeTimeSource.open/sample, contact Chrony, or prove -ARM64 or real-server source quality. The existing ecb prepare flow can package -the newly published source tip after review; no handmade original manifest is -used. - -Local qualification `945ec634-f787-4496-b019-28f03949f58f` actually passed six -default release lib tests (zero skipped/filtered), clippy with warnings denied, -rustfmt checking and the offline release operator-probe build. The release test -ELF is x86-64, 1,147,336 bytes, SHA256 -`de9591c30f71d5a46d38cdb799051a22cb17617f2089bce2f12b9864c395462d`. -Its frozen receipt is -`082666f3d9c07ebda4e935d5a67d16d6a5d7b62963044a6c638f17ae0bc93d09`; -the provider source is -`8d13ef64f1b7ce0991f3d52a8a42d7b096e9020a57d4ca21a16409a4492e3a39`. - -`deploy/time_source_abstract_linux_acceptance.py` provides only `prepare`, one -`execute`, and original-case `read`. It copies that exact frozen ELF and all -fourteen recipe/source inputs; it does not rebuild from a moving worktree. The -remote runner first requires the exact full six-test list, then runs the binary -without filters/skips. An intent precedes execution; local and remote case -creation reject repeats. Before/after witnesses bind the existing three RMM -service generations, protected controls, state-file identities and closed APT -service. Timeout cleanup targets only the held unreaped child group. It performs -no RMM job or native source query. After a lost reply, only the original `read` -is permitted. Local prepare of case -`b5e4e4cc-5bb7-441a-8c53-1fc2281e17e8` succeeded; target `execute` and `read` -remain unexecuted by this author and require Root's separate action. - -## Actual Cloud-Linux fixture result; production candidate rejected - -Root actually executed the six frozen guards in original case -`b5e4e4cc-5bb7-441a-8c53-1fc2281e17e8`:6PASS/0ignored/filtered, -receipt `fe989d8ec4d54d7416de2cb6301d6b87b897f4bfa33d1d03403e0968d83eec67`. -Separate original-case read receipt -`a7bdc39d3d448efbdf2711958ed2dea2aa74bb8b9ff0c7a8d970c414ad785a2a` -confirmed retained results and existing runtime witnesses. Independent source -review found no transport trust/lifecycle bypass. These are kernel fixture -results, not a successful Chrony integration. - -A separate fixed read-only Tracking request actually sent exactly one104Byte -request through an exclusive abstract socket and received no reply within its -bound. Receipt `f82eef4fc7d8f7cab7971a835a68eef855f166c32cb2feaac191551188351881`. -Chrony4.8/4.9 source reconstructs the return Unix address as a C string; an -abstract name starts with NUL and is lost. This proves that the candidate -cannot provide the required reply transport with this implementation. No -additional AppArmor denial was observed in the filtered kernel audit. - -The candidate is rejected for deployment. Its exact source and frozen six-test -proof are preserved as evaluation history. Production NativeTimeSource must -retain the prior named transport until a separately qualified compatible fix -is ready. No ARM64 build, signer, key, quality authority, client configuration -or RMM job was activated from this candidate. diff --git a/docs/server-time-source-bootstrap.md b/docs/server-time-source-bootstrap.md deleted file mode 100644 index b9cd059..0000000 --- a/docs/server-time-source-bootstrap.md +++ /dev/null @@ -1,393 +0,0 @@ -# Isoliertes ARM64-Quellenpaket für den Zeitprovider - -Dieser Schnitt liefert einen konkreten Paketbauer und begrenzte Operatorphasen -in `deploy/server_time_source_bootstrap.py`. Er installiert keinen Broker, -erzeugt keine Schlüssel oder Chrony-Pins und verändert keine RMM-Konfiguration. -Der öffentliche Quellencheckpoint ist -`2dfd791aa5703f42f0258d17bc9b5f6c9d71337f`. Native Serverabnahme, tatsächliche -Quellqualität, Socket-Namespaceprofil und HTTP-Inbetriebnahme bleiben getrennte -offene Schritte. Die WebUI-Genehmigungsgrenze für sämtliche RMM-Jobs bleibt erhalten. - -## Paket und Herkunft - -`prepare --commit ` arbeitet ausschließlich lokal. Der Commit -muss als bereits vorhandener `origin`-Branch-Tip belegt sein. Alle drei -Zeitcrates einschließlich ihrer Manifeste und Rustquellen werden bytegleich -gegen diesen Commit und den Arbeitsbaum verglichen. Andere Workspacecrates, -`credentials/`, `devstate/`, Konfigurationen und Schlüssel kommen nicht ins -Archiv. Originales Workspace-Manifest und Lockfile reisen als Herkunftsbelege mit. - -Das generierte Workspace-Manifest verkleinert nur die Member-/Dependencyliste; -Paketdaten und benutzte Dependencydefinitionen bleiben im Originalwortlaut. -Ein gesonderter lokaler, netzloser Rust-1.99.1-Container erzeugt tatsächlich das -Teil-Lockfile. Jede erzeugte Paketidentität aus Name, Version, Quelle und -Checksum muss im öffentlichen Original-Lock vorkommen; Versionsänderungen -verweigern. Der begrenzte Reader akzeptiert ausschließlich das aktuelle -kanonische Cargo-Lock-v4-Format und crates.io-Checksums. Neue Formate oder -Gitdependencies benötigen eine ausdrückliche Quelländerung. Anschließend -wird nur mit `--locked` gebaut. Das Repository-Lockfile wird nicht verändert. - -Nur im Paket kommt das feste Example `operator_probe.rs` hinzu. Es akzeptiert -keine Argumente, öffnet die echte `NativeTimeSource` und erfasst genau ein -Sample. Die Ausgabe enthält ausschließlich numerische Zeit-/Fehler-/Alterswerte, -Boot-ID und feste Kennzeichnungen `clock_authority=false` und -`signed_attestation=false`. Kein Signer, Schlüssel, frei wählbarer Context, -Grant, Clocksetter oder Jobpfad. Ein Fehler liefert nur die feste Meldung -`TIME_SOURCE_OPERATOR_PROBE_DENIED`. - -## Getrennte Operatorphasen - -Die folgenden Befehle sind Bedienung des implementierten Werkzeugs und **keine -Behauptung bereits ausgeführter Serveraktionen**. Das Werkzeug besitzt keine -SSH-Funktion. Der Rootoperator prüft seinen Transport, den Operatorhash und den -Archivhash separat. Ein neuer kanonischer UUIDv4-Fall liegt ausschließlich unter -`/var/lib/rmm-time-source-bootstrap/` mit Root0700; jede Phase erzeugt ein -eigenes Verzeichnis, einen create-only Intent und anschließend ein Ergebnis. -Vorhandene Verzeichnisse/Intents werden nie wiederverwendet. Nach verlorener -Antwort ausschließlich `python3 -I operator.py host-read --case ` benutzen, keine Wiederholung. - -1. Lokal: `python3 deploy/server_time_source_bootstrap.py prepare --commit - 2dfd791aa5703f42f0258d17bc9b5f6c9d71337f`. Das Ergebnis nennt den privaten - Fallpfad sowie Hash und Länge des Archivs. Auch ein fehlgeschlagener lokaler - Lockversuch bleibt als eigener Fall erhalten. -2. Auf dem Server separat: `host-preflight --case `. Dies erzeugt nur den - Operatorfall und liest begrenzte Metadaten. Danach lädt der Operator genau - dieses `operator.py` und `source.tar` create-only in diesen Fall. Keine - automatische Übertragung, kein Überschreiben bestehender Dateien. -3. `host-stage --case --sha256 ` prüft jede Länge und jeden - Hash vor eigener manueller Extraktion. Keine Tar-Symlinks, Hardlinks, - absoluten Pfade oder `..`; keine Extraktion unter `/opt/rust-discovery`. -4. `host-build --case ` benutzt ausschließlich das vorhandene ARM64-Image - `rust:1.99.1-bookworm`, dessen gespeicherte immutable Image-ID aus dem - ursprünglichen Preflight, und - `--pull=never --network none --locked --offline`. Der Quellmount ist lesend, - Targetmount ausschließlich dieser Fall. Keine OS-Pakete oder Installertools. - Ein eigener Containername, eine interne feste 850s-Deadline und ein äußerer - 900s-Wächter begrenzen den Entwicklungsbuild; das ist kein RMM-Serverstart. - Ein späterer Tag-/Architektur-/Bootwechsel verweigert vor Containerstart. - Der Builder erhält keine Host-Cargo-Konfiguration oder Credentials. Sein - vollständiges `CARGO_HOME=/cargo` liegt in einem eigenen begrenzten Tmpfs; - Cargo-/Rustup-Binaries bleiben im vertrauenswürdigen Image. Offline kann ein - lesender Registry-Symlink vorhandene Imagecaches benutzen; Cachelocks und - sonstige Cargo-Homedaten bleiben im eigenen beschreibbaren Home. -5. Erst nach separatem Review echter geschützter Chrony-Pins: - `host-probe --case --sha256 `. Ein demandgestarteter, - transienter Rootprozess läuft höchstens 3s unter eigener Unit; äußerer - Wächter 10s. Er darf nur AF_UNIX, keine IP-Verbindungen und schreibt lediglich - den eigenen temporären Chrony-Abfragesocket im festen Clientverzeichnis. - Keine Signatur oder Brokerinstanz entsteht. Keine Wiederholung einer - fehlgeschlagenen/unklaren Probe. -6. `host-read --case ` liest ausschließlich vorhandene begrenzte - Ergebnis-/Fehlerbelege und Intentpräsenz. Es startet keine Befehle oder - erneuten Proben. Vollständige Build-/Probeoriginale bleiben im privaten Fall. - -Eine unverifizierte Registrycache-Präsenz wird nie angenommen. Falls der erste -Offlinebuild wegen fehlender Dependencies scheitert, darf der Rootoperator in -einem **neuen** Fall ausdrücklich `host-build --registry-fetch` wählen. Dieser -Modus hat einen leeren begrenzten temporären vollständigen Cargo-Homemount und Netzwerkzugang -für den normalen Cargo-Registrydownload, weiterhin unveränderte Lockversionen -und geprüfte Checksums, keine OS-Updates. Das ist keine automatische -Fehlerwiederholung und auch kein eng auf bestimmte IPs beschränkter Egressfilter. - -## Lesender Preflight und Beweisgrenzen - -Der Host muss Root/Linux/aarch64 sein. Docker-Engineversion und vorhandenes -ARM64/Linux-Builderimage werden gelesen, kein Pull erfolgt. Für die festen -Composecontainer `rust-discovery-server-{gateway,api,postgres}-1` werden nur -Image-ID, Konto, Running/PID/Startzeit/RestartCount und Portbindungen gelesen. -API/Gateway müssen das bestehende Runtimeimage -`sha256:6f8383f7c762ac77ed1013c94eeafa2b76838c00aec358a375f5847645ea87ec` -und `10001:10001` verwenden. PostgreSQL darf keine publizierten Ports haben; -sonstige publizierte Dockerports müssen ausschließlich IPv4-Loopback sein. -Umgebungsvariablen, private Mountinhalte und Healthausgaben werden nicht gelesen. - -Der vorhandene `chrony.service` läuft hier als aktiver `Type=notify`-Dienst -mit einem Root-`/usr/bin/dash`-Wrapper als MainPID. Der Preflight bindet die -exakt drei tatsächlichen Prozesse seiner festen Cgroup -`/system.slice/chrony.service`: Wrapper, dessen Chronyd-Kind und dessen weiteres -Chronyd-Kind. Keine zusätzliche oder untergeordnete Cgroup wird übergangen. -Beide Chronyd-Prozesse müssen UID/GID989 und dieselben geschützten -`/usr/sbin/chronyd`-Originalbytes besitzen. Der Root:Root0644-single-link-Pidfile -`/run/chrony/chronyd.pid` bestimmt den Daemon; weil das Verzeichnis UID/GID989 und Modus0700 -besitzt, reicht diese Datei allein ausdrücklich nicht als Namensautorität. -Zusätzlich muss unter diesen drei Prozessen ausschließlich genau der gewählte -Daemon den tatsächlichen Kernelinode des festen Unix-Datagramsockets -`/run/chrony/chronyd.sock` halten. Diese begrenzte Beobachtung behauptet keine -globale Abwesenheit fremder FD-Kopien. Gehaltene pidfds, Proc-/Image-FDs, -Geburtszeiten, Elternbeziehungen, alle vier UID-/GID-Werte, Cgroupmitglieder, -Unitgeneration, Originaldateimetadaten und Socket-/Pidfileidentitäten werden -vorher/nachher verglichen. Unbekannte Topologien verweigern; kein Dienst wird -neugestartet oder automatisch neu übernommen. Boot-ID wird ebenfalls beobachtet. Dies ist eine begrenzte frische Beobachtung für spätere -Root-Pinprovisionierung, **keine** Sourcequalitätsabnahme. Der Provider prüft -später seine vollständigen gehaltenen Identitäten selbst. Das historische -Kernelresultat aus früheren Fällen ist kein frischer Qualitätsbeleg. - -Build und Probe vergleichen die genannten RMM-Containermetadaten und Boot-ID -vorher/nachher. Das belegt nur diese unveränderten Metadaten, keine vollständige -SQL-/PKI-/Dateninhaltsidentität oder auf Nanosekunden garantierte Schedulingzeit. -Aufbewahrte unveränderte Quellen sowie SHA256/Länge und ELF64/AArch64-Machine183 -beider Artefakte werden gesondert nachgewiesen. Ein lokaler x86-64-Build ersetzt -keinen ARM64-Lauf. Der Broker wird beim Build nicht gestartet. - -## Nächster Bootstrap-Schnitt: weiterhin nur ein Vorschlag - -Vor einer tatsächlichen Installation sind die nativen Linux-Brokerguards und -der Paket-/Artefaktreview abzuschließen. Folgende konkrete Änderungen gehören -in eine gesondert reviewte create-only Provisionierung; dieses Werkzeug führt -sie ausdrücklich noch nicht aus: - -- `/etc/rmm-time-source`: Root0700. `chrony-pin.json`: Root0600, ein Link, - strikt genau `schema_version`, `daemon_pid`, `daemon_birth_ticks`, - `daemon_uid`, `daemon_gid`, `daemon_image_sha256` aus derselben frischen - tatsächlichen Prozessbeobachtung. Boot-ID separat im Rootbeleg binden; kein - erfundenes zusätzliches Feld im strikt deserialisierten Providerpin. -- `signer.json`: Root0600, create-only; privater Ed25519-Zeitschlüssel aus - serverseitigem CSPRNG, niemals exportieren/loggen. Eigene Server-/Key-ID und - positive Generation. Tatsächlichen öffentlichen Jobkey über den vorhandenen - öffentlichen Getter und sämtliche bekannten Update-/Health-/TLS-Ed25519- - Rollen als dekodierte Verbotswerte aufnehmen; keine Dummywerte. Nur öffentlicher - Zeitpin/Hash darf zurückgegeben werden. Ein späterer Provisioner darf für den - öffentlichen Jobkey keine privaten PEM-Dateien lesen. -- `/run/rmm-time-source`: Root:10001 0710; `clients`: Root:frische-Chrony-GID - 0710. Geschützte Ancestry, keine automatische Übernahme fremder Objekte. - Boot-/Chronyneustart braucht erneute unabhängige Pinprüfung; kein stilles - Ersetzen oder Autostart mit veralteten Pins. -- `/usr/local/libexec/rmm-time-broker`: geprüfter ARM64-ELF-Hash, Root0500, - create-only. Keine Runtimeimageänderung, kein Compose-/RMM-Neustart. -- Demanddienst mit Rootkonto, primärer frischer Chrony-GID und ergänzender - Gruppe10001, `NoNewPrivileges=yes`, `CapabilityBoundingSet=CAP_SYS_PTRACE`, - keine `CAP_SYS_TIME`, AF_UNIX-only/IP-denied, `ProtectSystem=strict`, - `ProtectHome=yes`, `PrivateDevices=yes`, eigenem Runtime-Schreibverzeichnis - sowie `SystemCallFilter=~@debug ptrace process_vm_readv process_vm_writev`. - CAP_SYS_PTRACE dient ausschließlich dem gehaltenen `/proc//exe`- - Identitätszugriff bei anderer UID. Kein ptrace-/Speicherlesepfad entsteht. - `ProtectClock=yes` wird nicht blind gesetzt: dessen Seccompfilter kann auch - die ausschließlich lesende `adjtimex(modes=0)`-Probe sperren. - -Der Hostbroker erwartet echte UID/GID10001 und sichtbare Host-PID>1 des lokalen -Callers. Der Gatewaycontainer darf den Hostrootpeer dagegen namespacebedingt -als PID0 sehen; die bestehende Route verlangt dessen kernelbestätigte UID0, -geschützten festen Socketinode und unabhängige Zeitkeysignatur. Kein `pid:host`, -privilegierter Container oder Usernamespace-Mappingfallback. Dieses tatsächliche -Namespace-/UID-Profil bleibt vor späterem Gatewaydeploy nativ zu prüfen. - -Noch kein Zeitpin, signierter Zeitvergleich, Windows-Clockgate oder Jobfreigabe -wird allein durch einen erfolgreichen Provider-Sample aktiviert. Der Windows- -MVP ist mit diesem Teilschnitt weiterhin nicht abgeschlossen. - -## Tatsächlicher lokaler Nachweis, 2026-11-15 - -Der öffentliche Quellenabgleich und die netzlose Cargo-Lockgenerierung wurden -ausgeführt. Der generierte Lock enthält70 Pakete; alle Versionen/Quellen/ -Checksums stimmen mit dem öffentlichen Original überein. Ein anfänglicher -Versuch mit ausschließlich herausgeschnittenen Original-Lockblöcken wurde von -Cargo mit Exit101 wegen nötiger Graphnormalisierung verweigert; sein eigener -Fall `recipe-qualification-c69c3677-bf28-493d-855d-fdfa8ce12806` bleibt erhalten. -Er wurde durch die tatsächliche Offline-Lockgenerierung ersetzt. - -Der neue Fall `recipe-qualification-26b0527c-6b33-4229-8c09-b35563ed475e` baute -Broker und Probe mit `--locked --offline --release` erfolgreich, Exit0, lokal -auf x86-64. Broker1043088Bytes/SHA256 -`dc6f8946e38967aa8ab4c23a1bac83409eec5759dd0374dd0882f8ddb71dce99`, -Probe787128Bytes/SHA256 -`1b03957b8cc845086c9f88febd56bb2fd52270f10a75eae8f549bb1209bfcbb3`. -Die Compilerinputs sind bytegleich mit dem anschließend tatsächlich gegen den -öffentlichen Commit erzeugten Quellenpaket; Herkunftsbelege werden zusätzlich -mitgeführt und nicht kompiliert. - -Historischer privater Paketfall `80096c84-1187-4cc9-87c5-f54c9948b6b7`, Archiv225280Bytes, -SHA256 `aeee468480ece91caedc0e726be13de9d389eaf980221f4b1c8ecbaf1b01b35a`; -Historischer Operator-SHA256 -`0992a0ae4cf676634a2e515da9a3484101c7f4b938b2971252725ed3774688bc`. -ASTprüfung, vollständiger lokaler Archiv-/Hashroundtrip, Ablehnung eines -falschen Archivhashes, eines Archivsymlinks, einer geänderten Paketversion und -des x86-64-Artefakts als ARM64-Probe: PASS. Qualificationreceipt-SHA256 -`62f89e485ff3d2e503bae176ac6e22f86013cf677183a3a14d5498cecfb3b7bd`, -Capabilitymanifest-SHA256 -`4cbecde616df9bce8e5398fae909ba04d6b46c5cf62719b7b7bb237a1747f3fc`. -Die Originalreceipt dokumentiert die zu ihrem Prüfzeitpunkt vorhandene -Dokumentfassung; dieser nachträglich hinzugefügte Ergebnisabschnitt ändert -weder Operator, Paket noch Buildinputs. Keine SSH-/Serveraktion, ARM64-Ausführung, -Chronyprobe, Pin-/Signerprovisionierung oder Broker-/HTTP-Inbetriebnahme wurde -durch diesen lokalen Nachweis ausgeführt. - -## Reviewfix und tatsächlicher Deltanachweis, 2026-11-15 - -Ein unabhängiger Review fand vor irgendeiner Hostphase die erneute Auflösung -des Buildertags im Buildpfad. Der Pfad verlangt jetzt die unveränderte -Image-ID/Architektur/OS und Boot-ID aus dem ursprünglichen Preflight und baut -ausschließlich mit dieser gespeicherten Image-ID. Zusätzlich besitzt der -Container ein eigenes vollständiges Cargo-Home für Schreiblocks und Cachedateien; -der explizite Fetchmodus benötigt kein beschreibbares Imageroot. Keine Version -oder Zeitcrate wurde geändert. - -Build-/Probelogs werden während des Lesens auf8MiB begrenzt. Timeout/Überlauf -beendet ausschließlich die eigene noch nicht gereapte Prozessgruppe. Beim -Build wird zusätzlich der eigene Container anhand zurückbehaltener CID, -Originalimage, UUID-Name und UUID-Label geprüft, bevor genau diese CID beendet -werden darf. Kein globales oder allein namensbasiertes Docker-Kill. Bei fehlender -oder unklarer CID gibt es keinen Fallback; die unabhängige interne850s-Frist -bleibt erhalten und der Fall wird nicht wiederholt. Dies ist keine Garantie -für Reaktionszeiten bei blockiertem Kernel oder Dockerdaemon. - -Neuer privater Fall `d3be954b-518b-4232-bac4-5bf0a8f934cd`, Archiv225280Bytes, -SHA256 `25409193e431e19f04526998fcd28f5f75471995935c02f35e1fa9ba1a0eada9`, -Operator-SHA256 -`c97865ea83e35cc192aeb92c9c5684f2f33a937a01942ce3822c4305e3c3afd5`. -Der tatsächliche lokale x86-64-Offline-Releasebuild mit frischem vollständigem -Cargo-Home und lesendem Image-Registrycache bestand mit Exit0. Der lokale -Container nutzte für diesen Entwicklungsnachweis UID/GID1000; das geprüfte -Serverprofil bleibt Root. Keine ARM64-Ausführung wird daraus abgeleitet. - -Fünf gezielte Deltaprüfungen bestanden: Builderwechsel und Bootwechsel jeweils -vor Target-/Dockererzeugung verweigert, tatsächlicher9MiB-Ausgabestrom bei -exakt8MiB gestoppt samt Cancelhook, eigene Prozessdeadline samt Cancelhook und -ungültige CID vor Dockeraufruf verweigert. Die Image-/Bootprüfungen verwendeten -ausdrücklich lokale Fixtures; der Cancelhooktest belegt keinen tatsächlichen -Dockerdaemonabbruch auf dem Server. Deltabeleg-SHA256 -`54d0bc2372adafb0d222bb9a9f64b3120a8b59e40675467d58664adcb29f0889`. -Alter Paketfall und sämtliche Originalbelege bleiben unverändert. - -## Tatsächlicher erster Serverpreflight, 2026-11-15 - -Das öffentliche Operatorfile mit SHA256c97865ea wurde create-only in einem -eigenen Rootverzeichnis übertragen. Der erste Pythonaufruf scheiterte bereits -vor Moduleintritt: Der Dateiname `operator.py` überschattete das gleichnamige -Python-Standardmodul. Lesend bestätigt: derselbe `--help`-Aufruf scheitert ohne -Isolation, mit `python3 -I` gelingt er. Vor dem folgenden ersten tatsächlichen -Phaseneintritt war der native Fall nachweislich noch nicht vorhanden; es wurde -kein vorhandener Phasenintent wiederholt. Originaldiagnosereceipt-SHA256 -`928becb71d7db6f46d8a54e2ae9075d16eea4ee1cdbe82cbbf92d241ab39e15a`. -Hostaufrufe des archivierten Dateinamens müssen `python3 -I` verwenden. - -Der anschließende erste native Preflight im Originalfall d3be954b scheiterte -kontrolliert, ohne Stage/Build/Probe. Phasenreceipt-SHA256 -`e4b4909871dea35ed41a9a1df527fea0a262218d0a60030352ecc00b3ac73944`, -separater Originalfall-Readback -`c3d2cc60d9a65320b2874795f97ffba23be9699c67d2cebb6e8c46e36bb90cf2`. -Eine zusätzliche lesende Diagnose lokalisiert die nicht erfüllte Annahme: -Der MainPID von chrony.service gehört einem Shellwrapper, nicht dem tatsächlichen -chronyd-Executable. Die geschützte feste Datei ist vorhanden, der Dienstcgroup -enthält außerdem zwei echte chronyd-Prozesse. Eine blinde Auswahl nach Name -oder niedrigster PID wäre deshalb falsch. Herkunft und tatsächliche -Daemonrolle müssen im folgenden Quellenfix exakt gebunden werden. -Readonly-Cgroupreceipt-SHA256 -`c07d6e0c9a2d86cb042c8b83402aa548bf34294dddffd3f91a036280510b05fd`. - -Der vorhandene Builder ist tatsächlich ARM64/Linux, immutable Image-ID -`sha256:e6f2cff35d0f309acf8433b4f05878ed77092602c5065cc81801177da0bb3a9c`. -Dieser Metadatenbefund ersetzt keinen erfolgreichen vollständigen Preflight -oder ARM64-Build. Kein Chrony-/RMM-Neustart, kein Zeitsetter, Pin, Schlüssel, -Broker oder Serverdeploy wurde vorgenommen. Der fehlgeschlagene Fall bleibt -erhalten und wird nicht erneut ausgeführt. - - -## Enger Preflightkorrekturstand, 2026-11-15 - -Der tatsächliche erste Server-Preflight des Falls -`d3be954b-518b-4232-bac4-5bf0a8f934cd` verweigerte korrekt bei -`actual daemon fixed executable inode`: Systemds MainPID war der legitime -Dash-Wrapper, nicht Chronyd. Anschließende ausschließlich lesende Rootbefunde -belegten die oben beschriebene Drei-Prozess-Topologie und den alleinigen -Command-Sockethalter innerhalb dieser Dienst-Cgroup. Der alte Fehlerfall bleibt -unverändert und darf nicht wiederholt werden. Die korrigierte Operatorquelle -benötigt ein neues geprüftes Paket und einen neuen Fall; daraus folgt noch -keine erfolgreiche ARM64-Ausführung oder Sourcequalitätsabnahme. - -Hostbefehle müssen mit `python3 -I /absoluter/pfad/operator.py ...` gestartet -werden: der Dateiname `operator.py` darf keine gleichnamigen Python-Standardmodule -über den Skriptpfad überschatten. Kontrollierte Guardfehler werden als feste -`failure_reason` in create-only `failure.json` und einer begrenzten JSON-Antwort -gespeichert; unerwartete Fehler liefern nur `unexpected_operator_exception`, -keinen Exceptiontext oder Traceback. Verlorene Antworten erlauben ausschließlich -Lesen des ursprünglichen Falls, keine Phasenwiederholung oder Pinheilung. - - -Der nachfolgende tatsächliche Preflightfall -`053cfe86` verweigerte allein die zuvor fälschlich erwartete -Chronyverzeichnisberechtigung0755. Der lesende Originalbeleg -`22fa2aabdfdbbd0fe55957358f7f651f317ee647b20a46ab1f2613a365095d7f` -zeigt UID/GID9890700 für `/run/chrony`, Root:Root0644 mit einem Link für die -Pidfile und UID/GID9890755 mit einem Link für den Socket. Der Operator verlangt -jetzt exakt das beobachtete Verzeichnis0700. Der Provider akzeptiert am Socket -Lese-/Ausführungsbits, verweigert weiterhin Gruppen-/Fremdschreibrechte und -behält alle Identitäts-, Ancestry- und Kernelcredentialprüfungen bei. Es wurden -keine Chronyberechtigungen geändert. Beide fehlgeschlagenen Originalfälle bleiben -erhalten; diese Quelle benötigt erneut einen neuen Paket-/Abnahmefall. - -## Tatsächliche ARM64-Buildversuche und ABI-Korrektur - -2026-11-15: Neuer Originalfall20670a9a-74a2-4426-bbef-f930c9c5c2d9 mit -OperatorSHAecb72b7c bestand den echten Preflight und das geprüfte Staging. -Die reale Bindung identifiziert den Chrony-Daemon über PIDfile, gehaltene -Prozessgenerationen und tatsächlichen Command-Sockethalter; Wrapper und -Privsep-Kind werden nicht mit dem Daemon verwechselt. -Preflightreceipt-SHA256 -`4228a0f0e4a5d6ffdb6d9b64665dcc367b7e0c08acac410048ee9b720d29627f`, -Stagingreceipt -`01b1662e2c54eb0a628d3fe4ae97f2ccd5442c15072e0902bc925c1c58997824`. -Das Quellenarchiv225280Bytes mit SHA256 -`52bdeb3869e2d4147447b1f5146e7dbb37a401c680d2dcd64f523298a0d08731` -bindet den öffentlichen Commit2c0f07046efa08132f6ed584b4e686f5f88d46fd. - -Der Offlinebuild endete mit Cargo101: kein gecachtes anyhow/crates.io-Index. -Buildlog-SHA256 -`1a2c9a12ad054d56732255a6d0b4bd0b43b2378dcd347371bfac8434823eeb31`. -Originalfall und Readback bleiben erhalten. Keine Artefakte/Quellprobe. - -Der ausdrücklich getrennte neue Fall3564b4e7-5efd-412d-a8e1-e48c051f13fd -bestand erneut Preflight/Staging desselben Archivs. Der explizite Fetchmodus -lud tatsächlich die unveränderten gelockten Dependencies und begann die native -ARM64-Kompilierung. Cargo101 meldete dann zwei Typfehler im Provider: -`libc::stat.st_nlink` ist auf diesem ARM64 u32, die private Identity hatte u64 -vorausgesetzt. Der Broker besitzt dieselbe Annahme. Es wurden keine -Betriebssystempakete aktualisiert, RMM-Container-/Bootmetadaten sind erhalten. -Buildlog-SHA256 -`a4f7c31676cf5eb04d793f7320624d78dbd32f16c7b366b38db0a3cce23589ae`, -Originalbuildresult -`18481a3a0a5db6e9978ed641408c73a145eb817a0f2c58cc929b4a00f0364754`, -separater Readbackreceipt -`cb0f7bbe0b480cae758011fb3067810efa37dae0a260120bf36966184ee994da`. -Der Phasenwrapper hat Exit0 trotz dokumentiertem Cargo101; maßgeblich ist -ausdrücklich das gespeicherte Buildresult.exit_code, nicht der Wrapperexit. - -Der anschließende enge Quellenfix verwendet in beiden privaten -Identitystrukturen `libc::nlink_t`. Kein Linkcountvergleich, Inode, Permissionguard -oder Wire-/Pinschema wird geändert. Lokal bestanden: Alltargets-Clippy mit --Dwarnings für genau Provider und Broker, Qualificationff49332a-c16c-4821-8305-6c5abbccde91, -Receipt-SHA256 -`a02cdd1398ef0d6c8b2ce65f9a38edd9bbf8dcd4147bff3b17c060f625f4e8a3`. -Dies ist noch kein erfolgreicher ARM64-Build. Der korrigierte Stand benötigt -ein neues öffentlich gebundenes Archiv und einen eigenen tatsächlichen Buildfall; -keiner der beiden Cargo101-Fälle wird wiederholt oder erfolgreich umgedeutet. - -## Tatsächlich erfolgreich: korrigierter ARM64-Build - -2026-11-15: Neuer Originalfall `5b358997-3abc-43db-945f-f41855b4e3c0` -mit öffentlichem korrigiertem Quellencheckpoint09ee24c. Preflight und Staging -bestanden; Quellenarchiv225280Bytes/SHA256 -`0da5ed0d52d3e621ef6a23cbc065f9d7c93e5683547e0a02ae3c8da8a83884a5`, -Manifest-SHA256 -`bdf7839f832e2ea0cf230a0bd8a8fbff5d4a72d8fb7ba8208e0d252bad4b56ee`. -Der native Server-ARM64-Releasebuild mit explizitem Registryfetch und -unveränderten gelockten Versions-/Checksumwerten endete mit Cargo0. -Beide erzeugten Artefakte sind ELF64/AArch64-Machine183: - -- Providerprobe848632Bytes, SHA256 - `216b4d6a0f29ef47576f5ccc469954623141e55d7b43bd73175c1d956363bbbd`. -- Broker1067136Bytes, SHA256 - `5d8d786925c060eb042f0a592453f11970c32c4287fa4c9464f6f6a6e38cb201`. - -Buildlog-SHA256 -`17498779b91081133c4030f27fa91278c1b9fd2dd4e12e1e12ac1f9cdc39adf6`, -Operatorausführungsreceipt -`a0567ec749b97c3a0d8de1a747ad7ea334de6b9b8a1bbf4c00f1220a53d0568d`, -Original-Buildresult -`58eaf0118f8f8573debfa21a295019a224b916cfc5b1a88edda426ec06bed2b5`. -Separater rein lesender Originalfallabruf bestanden, Receipt -`e95a2bd068814dd1722ceac2ac637b4cc73221b5c8f58c59ebd771a4f23be068`. -Die tatsächlichen RMM-Containermetadaten und Boot-ID sind im Buildvergleich -unverändert. Kein Provider-/Brokerstart, Zeitsetter, Pin, Schlüssel, -Gatewaydeploy oder Windowsclock-/Jobgatewechsel wurde durch den Build -ausgeführt. Der getrennt implementierte [öffentliche Pinbootstrap](server-time-source-pin-bootstrap.md) -ist die Voraussetzung der anschließenden einmaligen nativen Qualitätsprobe. diff --git a/docs/server-time-source-chrony-generation-bootstrap.md b/docs/server-time-source-chrony-generation-bootstrap.md deleted file mode 100644 index 7489500..0000000 --- a/docs/server-time-source-chrony-generation-bootstrap.md +++ /dev/null @@ -1,161 +0,0 @@ -# Proposed one-time Chrony generation change - -Status: source-only preparation, not approved or executed. A separate explicit -user approval is required before the target restart. This is server bootstrap, -not an RMM job approval. No existing failed source acceptance becomes a PASS. - -The named-client source remains the intended transport. The rejected abstract -candidate is retained only in its private freeze: Chrony 4.8/4.9 reconstructs -reply paths with strlen and loses an abstract sender's random name. The loaded -AppArmor policy is already byte-bound to the newly compiled policy; the apparent -file-query denial was libapparmor's last-byte truncation and disappears with the -corrected query length. Upstream Linux 7.0's datagram peer check instead uses the -command socket's stored label directly, with no newest-generation resolution. -A new daemon/socket generation is the proposed remedy for that remaining -source-supported stale-label cause. No additional capability or AppArmor rule -change is proposed. - -The finite operation is: - -1. Read and bind the original 5b source/build/public-pin records, actual complete - daemon PID/birth/image/cgroup/socket holder, boot, builder, application runtime, - AppArmor main/local bytes and currently enforcing policy. Hold all three old - Chrony pidfds. Require no broker unit/binary, time signer seed or public time - key, and retain those absence conditions throughout. -2. Bind the exact loaded service definition and every actually included Chrony - configuration file. Read only bounded public configuration projections and - hashes, never private key contents. Require a normal leap state and small - measured tracking offset before the restart. Existing makestep, - initstepslew, leap/clock-control and command-socket options must be reviewed - explicitly; this operation changes none of them. A pre-restart small offset - alone does not prove a restart cannot trigger an existing step policy. -3. Create a new private generation case and intent before effects. Save the exact - old root:root 0600 single-link public pin bytes and metadata and fsync the - backup. Save a separate restart intent and invoke only - `/usr/bin/systemctl restart -- chrony.service` once, with a bounded transport - and owned-process watchdog. Do not retry after an error or lost reply. -4. Read the new actual complete daemon/socket binding. All old processes must be - dead; the new invocation, births and command-socket kernel inode must differ. - Daemon/wrapper executable bytes, UID/GID, unit/configuration bytes, boot, - builder and application runtime must remain equal. Require the original - AppArmor rules and enforce mode on the new daemon. Run only bounded tracking - and modes=0 kernel queries for at most a 25-second reacquisition budget. Each - round rechecks the same new PID/birth/socket, boot, configuration, namespace - and unchanged old pin before and after reading. Fixed create-only - `readiness-01.json` through `readiness-25.json` retain negative observations; - only actual normal tracking at an absolute offset of at most 5 ms and the - original kernel bounds permit the pin CAS. Command timeouts use the remaining - budget. These observations never restart/resync Chrony or qualify a native - source sample. Deadline or transport/guard failure leaves the old pin and - requires original readback, with no repeat of effects. -5. Derive the new six-field public pin solely from that actual binding. Before - changing the pin, recheck all guards and compare both original pin bytes and - full metadata. Write a fixed own create-only temporary root:root 0600 - single-link file, fsync it, then atomically replace the pin and fsync the held - protected directory. Save CAS intent before replace and read back the exact - new bytes/metadata. Old pin bytes remain in the new case. The old pin is - exactly 194 bytes, as verified by Root read receipt - `d1bf11677e5d85c411e25d4c37f9dd9f910177a111f19fb1329e5b28151a518e`; - the new canonical length can differ with PID/birth digit - counts and must be bounded rather than padded. -6. Preserve before/after evidence and a result explicitly stating no native - quality sample, signer, signature, broker or RMM job. Subsequent qualification - must use a new case and the new actual generation. Original 5b GROUP/DAC/peer - failures and their old pin remain unchanged historical records. - -`host-read` must only read the new original case and bounded target metadata. It -must not repeat restart, pin CAS, tracking command, native probe or configuration -write. A failure after restart can leave a running new Chrony generation and the -old pin; this is a closed/unknown state, not authority to restore the old pin, -restart again, adopt a new case or bypass a quality gate. There is no automatic -rollback, OS update, reboot, resync, makestep command, service enablement, broker -installation or key generation. - -The source binds Root's actual configuration/service proof -`7d5c7566a054ce353733155fbc2b98ef2a4d3f6d758bb85bd0e3ffd31bdeb22e`: -five exact public file hashes, the three closed include directories, loaded -service properties and a held protected starter script. Existing `makestep 1 3` -can step the clock during normal startup synchronization. It remains unchanged -and is explicitly part of the operation requiring user approval. There is no -approved or executed target restart from this source preparation alone. - -Root's additional read-only include proof -`ee557a17e7188dcf2211cde5df575ad3c101a6412f564eb53dc385a77262c22d` -fixes the actual closed sets: `conf.d` contains exactly `README` and -`ubuntu-nts.conf`; `sources.d` contains exactly `README` and -`ubuntu-ntp-pools.sources`. Each README is an ignored package document checked -only for protected regular-file metadata. The five configuration hashes remain -mandatory. `/run/chrony-dhcp` is absent. A held protected `/run` parent and -nofollow leaf lookup prove its absence before/after and during readiness; this -operation creates or adopts no DHCP directory. Any extra entry, symlink README -or appearing DHCP object denies the operation. - -Loaded command lists are read through five fixed native D-Bus properties, -using the ABI proven in Root receipt -`6ca943b071bb85c8c3f84ace00135e97acea48c6b0e0fcce3550b253aa67b092`. -All four `ExecStartPre`, `ExecStartPost`, `ExecStop` and `ExecStopPost` properties -must be typed `a(sasbttttuii)` with an actually empty array. The operation never -infers an empty list from omitted `systemctl show` output. `ExecStartEx` must -contain exactly the fixed starter path, `-n`, literal `$DAEMON_OPTS` and the -`no-setuid` flag corresponding to the existing unit's `!` prefix. Its typed -runtime timestamp/PID/status fields are validated and excluded from static -configuration equality; the actual process generation has its independent full -binding. The starter's SHA256 is fixed to -`48ae26b9a01b359ac6a743c074265e4b19a3ed99bbc4c46953850c75edde8e1c`. -The controller does not execute the starter or source `/etc/default/chrony`. -Only the unchanged systemd service definition executes that existing wrapper. - -Own guard failures may expose a bounded fixed tag matching `[a-z0-9_]+`. -Unexpected exceptions expose only `unexpected_generation_exception`, without -free exception text, paths or configuration contents. - -## Tatsächlich lesender finaler Preflight bestanden - -Am2026-11-15 lief ausschließlich `host-preflight` des unabhängig geprüften -Controllersd5d56b38 auf dem permanenten Server erfolgreich. Rootcallb7c05714, -Receipt `f89876d7f61b8c195ed65c8b935f88dac9eb0a4b6fd4d742f1c65b4c6f723a74`. -Aktuelle ursprüngliche Generation, Konfiguration, typisierte Unitkommandos, -Namespace, Altpin194Bytes/203f und Brokerabwesenheit sind geprüft. Tracking -meldet Stratum3/LeapNormal und0.122816ms absoluten Offset; modes0-Kernelquery -meldet state0/status0/maxerror13.957ms. Das ist kein gemeinsamer -NativeTimeSource-Qualitätsnachweis und keine Freigabe des Restarts. - -Frühere ausschließlich lesende Preflights verweigerten an zu enger -Include-Verzeichnisannahme bzw. ausgelassenen leeren systemctl-Kommandolisten. -Die tatsächlichen README-/DHCP-Abwesenheits- und D-Bus-Belege führten zu den -engen oben dokumentierten Quellenkorrekturen; kein früherer Misserfolg wird -umgeschrieben. Keine Restartphase angelegt, kein Service gestoppt oder -Publicpin ersetzt. `host-restart` wartet weiterhin auf ausdrückliche -Userfreigabe des konkreten Plans samt möglichem normalen Start-Sync-Effekt. - -## Freigegebener Restart und öffentlicher Pinwechsel tatsächlich bestanden - -Der User genehmigte ausdrücklich „Ja, einmaliger Zeitdienstneustart mit -Pinprüfung“. Danach genau ein `host-restart`, Originalfall -`c9a94f94-eecd-4c66-933d-c45c1a79c7a8`, tatsächlicher Exit0/abgeschlossen. -Rootreceipt -`1173ef78f9ca704afafbf4dbe92e8c654ec47d53f4e9f05fd99be2685991ce59`. -Vorhandene Konfiguration, tatsächliche Images, Boot und RMM-Runtime erhalten; -neue Chrony-Prozess-/Socketgeneration unabhängig geprüft und nach tatsächlicher -Readiness atomar gepinnt. Keine Konfiguration, Pakete oder RMM-Dienste geändert. - -Neuer öffentlicher Pin:195Bytes, Root:Root0600/Singlelink, SHA256 -`395f170aabf9fd01c24cd7d7939a313befdd147e98343ccd383bca861cbf2c4e`. -Alte194Bytes/203f und Metadaten bleiben im neuen Fall archiviert. Keine -Behauptung unveränderter Publicpin-Inode: dieser Wechsel ist ausdrücklich -genehmigt und als eigene CAS-Operation belegt. Die übrigen Identitäten bleiben -erhalten. - -Separater ausschließlich lesender Rückabruf df1fe7b1, Receipt -`58970ef8e89af86b68fdbbf2cb5119210bcb37cec603feb23b4f6030b0b36623`, -bestätigt ursprüngliches Result -`d648daadc43de90cda977ce60615b8e47072b785aa9fbfaea37ef8b58be6c9d4`, -neuen Pin und Erhaltungsflags. Keine Wiederholung des Restarts. - -`source_quality_qualified=false`: noch kein gemeinsamer NativeTimeSource- -Sample, Signer, Zeitkey, Broker oder Windows-Clockgate. Die historischen -5b-/GROUP-/DAC-/Peerfehler und ihre alte Generation bleiben erhalten. Ihr -altes `Original.fresh()` darf nach diesem absichtlichen Generationswechsel -nicht als aktuelle Authority verwendet oder durch erwartete-Werte-Tausch -„repariert“ werden. Neue reale Qualitätsprobe benötigt einen gesonderten -Originalbuild-/neue-Generationsnachweis. diff --git a/docs/server-time-source-error-probe.md b/docs/server-time-source-error-probe.md deleted file mode 100644 index a2bc70a..0000000 --- a/docs/server-time-source-error-probe.md +++ /dev/null @@ -1,152 +0,0 @@ -# Begrenzte Providerfehlerdiagnose ohne weitere Capabilityvermutung - -`deploy/server_time_source_error_probe.py prepare` ist ausschließlich ein lokaler -Sourcebuilder. Er erzeugt ein neues eigenständiges `operator_error_probe.rs` -und ein Manifest, keine Zielwirkung, keinen Build und keinen SSH-Aufruf. - -Die ursprüngliche Probe216/GROUP, die Group-ProbeExit1 und die tatsächliche -DAC-ProbeExit1 bleiben unverändert fehlgeschlagen. Die DAC-Ausführungsreceipt -`553bc8580deb0e78d780b43c569f3827715a54a7b8629c51c705cf4e9ded7c61` -belegt weiterhin fehlenden Sample; das generische Logf8064463 enthält keinen -bestimmten inneren Fehlernachweis. Diese Diagnose verändert keine Capability. -Chronyc-Normalstatus allein ersetzt die unabhängige NativeTimeSource-Prüfung nicht. - -## Geschlossene Diagnoseausgabe - -Das neue Example verwendet unverändert `NativeTimeSource::open()` und genau -einmal `sample()`. Native-/Trackingquellen und sämtliche Guards bleiben gleich. -Es gibt keine Argumente, frei gewählten Pfade, Clocksetter, PKI-/Key-/Signer-/ -Requestdaten oder geänderte Providerfehlerbehandlung. Ein Fehler erzeugt nur: - -- höchstens16 bekannte feste `TIME_…`-/`CHRONY_…`-Enumtags aus genau den - eingefrorenen Providerquellen, keine frei behaupteten Tags; -- höchstens8 tatsächliche `raw_os_error()`-Integer aus IO-Causes; -- höchstens16 ausgewertete Causes und ein ehrliches Trunkierungsflag. - -Die vollständige ausgegebene JSON-Form besitzt ausschließlich `schema_version=1`, -`profile="rmm.native-source-error.once.v1"`, `provider_call_succeeded`, -`known_error_tags`, `os_error_codes`, `cause_count`, `truncated`, -`clock_authority=false`, `source_quality_qualified=false`, -`signed_attestation=false`. Fehler liefern Exit1, überraschender Erfolg Exit0, -unerlaubte Argumente Exit2. Ein Erfolg wird nicht als neue Qualitätsabnahme oder -Clockbereitschaft ausgegeben; die Samplewerte werden hierfür nicht exportiert. - -Die Context-/Error-Displayfunktion wird ausschließlich in einen begrenzten -filternden fmt-Sink geschrieben: insgesamt höchstens4096 Eingabebytes, Token -höchstens96Byte. Es entsteht weder ein freier Fehlerstring noch freie Display-/ -Debugausgabe. Nur vollständige exakte Treffer in der bekannten Enumtabelle -gelangen ins JSON. Pfade, Configwerte, fremde ASCIIwörter und unbekannte Tags -werden verworfen. Die Ausgabe bleibt aus diesen festen Bounds unter4KiB. - -## Feste Herkunft - -Der Sourcebuilder liest ausschließlich das ursprüngliche5b-Archiv225280Bytes/ -SHA256`0da5ed0d52d3e621ef6a23cbc065f9d7c93e5683547e0a02ae3c8da8a83884a5`. -Manifestbdf7839f und sämtliche Paketdateien werden auf Originalhash/Länge -geprüft. Insbesondere Nativequelle -`3fd9c7a969a583abf97e29165135a8c1044db5c951ad8bd4dbfee3ee77e7ccdc` -und Trackingquelle -`7b042a24f38df53d3d553186d04bf6366c30fb77fe5c8ad66dfcf91290445297` -bleiben unverändert. Die feste Tagtabelle umfasst ausdrücklich auch -Trackingfehler wie `CHRONY_PACKET_LENGTH` und `CHRONY_REPLY_BINDING`. -Keine neue Dependency, kein Lockfilewechsel und kein geänderter Guard. - -## Konkreter Rootplan, noch nicht ausgeführt - -Root verwendet ausschließlich eine neue feste eigene Phase -`/var/lib/rmm-time-source-bootstrap/5b358997-3abc-43db-945f-f41855b4e3c0/provider-error-diagnostic-v1`. -Eine vorhandene Phase/Absicht wird nicht adoptiert oder wiederholt. Die lokale -Sourcebundle-UUID ist lediglich ein Herkunftsartefakt, keine neue Zielphase. - -1. Original5b/fac85/ecb-/Pin-/Artefakt-/Chrony-/Boot-/Runtimezeugen frisch prüfen; - fehlgeschlagene alte Ergebnisse/Logs auf ihre erhaltenen Originale binden. - Vor jeder tatsächlichen Phase create-only/fsync-Intent. Root kopiert den - geprüften ursprünglichen Workspace ausschließlich in ein neues eigenes - `workspace` unter dieser Diagnosephase; die Originalsource bleibt unverändert. -2. Genau die verifizierten neuen Examplebytes create-only nach - `crates/time-source-linux/examples/operator_error_probe.rs` im eigenen Copy - legen. Alle bisherigen Source-/Manifest-/Lockbytes gegen Original vergleichen; - nur dieses zusätzliche Example ist Compilerinput. Keine Host-Cargo-Konfiguration - oder Credentials in den Builder. -3. Eigenen begrenzten ARM64-Build mit der unabhängig gehaltenen Original- - Builderimage-ID, `--pull=never`, Rootfilesystemreadonly, CapDropALL/NNP, - Memory2GiB/CPU2/Pids256, Tmpfs/tmp256MiB und komplett eigenem CargoHome512MiB. - Eigener Targetmount, Sourcemountreadonly. Ein ausdrücklich beauftragter - Registryfetch darf nur mit ursprünglichem gelocktem70-Package-Lock und dessen - Checksums in dieses leere eigene CargoHome erfolgen; Bridge, kein Hostnetwork, - keine OS-Pakete/Updates. Fester Cargoaufruf: - `cargo build --manifest-path /src/Cargo.toml --locked --release -p rmm-time-source-linux --example operator_error_probe`. - Eigener Containername/CID/Case-/Imagebindung und begrenztes Log; derselbe - innere850s-/äußere900s-Wächter wie im vorhandenen Builder. Kein automatischer - zweiter Build oder Cache-/Konfigurationsübernahme. -4. Tatsächlich erzeugtes ELF64/AArch64-Machine183 ausschließlich in eigenes - `artifacts/operator_error_probe` mit Root500/Singlelink kopieren, Hash und - Bytes separat lesen und prüfen. Die ursprüngliche848632Byte-Probe bleibt - unangetastet. Buildnachweis ist keine Ausführung oder Fehlerdiagnose. -5. Erst nach Rootreview des neuen tatsächlichen Artefakts eigener Probeintent, - frische vollständige Guards und genau ein Exec. Eigenes Unitlabel; exakt - das zuvor tatsächlich verwendete DAC-Profil: Root/GID989, leere Zusatzgruppen, - BoundingSet CAP_SYS_PTRACE+CAP_DAC_OVERRIDE, NNP, ProtectSystem=strict, - ProtectHome, PrivateTmp/Devices, AF_UNIX-only/IP-deny, Debug-/ptrace-/process_vm- - Syscalldeny, RuntimeMaxSec3s/äußerer10s-Wächter, Schreiben nur in vorhandene - eigene Chronyclients. Keine weitere Härtungsänderung oder Capability. -6. Eigene rohe höchstens4KiB-Diagnosebytes/Exit dauerhaft vor Auswertung sichern, - Ausgabe strikt gegen Enum-/Zahlen-/Feldset prüfen, Originalzeugen danach erneut - vergleichen und per Hash verlinken. Nach Antwortverlust ausschließlich eigene - vorhandene Diagnosephase lesen; kein Build-/Probe-Resume und kein alter Retry. - -Rootstaging und dieser feste Build-/Probe-Wrapper bleiben ausdrücklich beim -Rootoperator. Dieser Sourcebuilder implementiert keine generische Deployment- -oder Resumefunktion. Signer, Broker-/HTTPbetrieb, Windowsclock und Jobgates -bleiben geschlossen; jeder RMM-Job benötigt weiterhin den WebUI-Plan. - -## Tatsächlich lokal erzeugt und geprüft - -Generator-SHA256 -`226abccc84d966d7f64b4355a96658fcc4c1fd2547561511e11ab3b361b30e4b`. -`prepare` wurde ausschließlich lokal ausgeführt. Neuer privater Sourcefall -`fe1cbcee-1d95-4229-823d-ca20b341b99e`: Example5990Bytes/SHA256 -`e924c0ee4f9f32855bac43d0dc34e415c792836fd16075142d50c6074050e7e4`. -Die Tabelle enthält88 bekannte Enumtags einschließlich beider ausdrücklich -genannten CHRONY-Parserfehler. Python-AST, tatsächlicher Originalarchiv-/ -Dateihashabgleich, Manifest-/Examplegleichheit und feste Ausgabesourceguards -bestanden. Kein Rustcompiler, Builder, SSH, Diagnoseexec oder anderer Zielaufruf -wurde ausgeführt. Rust-Compile-/Ausgabenachweis und Fehlerdiagnose bleiben offen. - -## Tatsächlich native Diagnose - -2026-11-15: Das neue Example5990Bytes/e924c0ee wurde im eigenen -Namespaceprovider-error-diagnostic-v1 aus dem unveränderten5b-Workspace -nativ ARM64 gebaut. Cargo0; ELF856728Bytes/Machine183, SHA256 -`8a94dac70ec408fb5cd918ff1e6044b8d1c5bac075595eb8deb9e93b4c1f4c21`, -Buildreceipt -`6b1ba105547c566e6536af215d1e16aa2f991e6c22907668c4bee0361d497efd`. -Der getrennte einmalige Run unter exakt dem Zwei-Capability-DAC-Profil -endete mit1, bekanntem Tag TIME_CHRONY_CONNECT, einer Cause und ohne -Trunkierung. Kein freier Fehlertext oder Sample exportiert. Receipt -`f0a813baef86da1bacdd3cf5d0670158645665c3589d8540a8e01260b384264f`, -Log-SHA256 -`09dff35152f06b5da5ab5ff0741b473f29b68b19cb65718989395ad9776c512e`. -Der bestehende Nativeguard hatte die innere connect-Errnonummer verworfen; -diese Diagnose konnte deshalb dafür keine IO-Cause rekonstruieren. - -Zusätzliche isolierte Verbindungsdiagnose unter gleichem Profil: ungebundener -Unixdatagramm-Connect erfolgreich, Receipt -`50afcaf5ab8681bab495c01b2b7f0f0fa3a7fc4114aab1c5ca548b49c8b675b1`. -Mit eigener bound Socketdatei unter dem neuen Projektclientpfad wurde -connect dagegen mit EACCES13 verweigert. Genau diese eigene Socketdatei -nach Dev/Inode/Ownervergleich wieder entfernt; kein Datagramm gesendet. -Receipt -`d7ce827257b0c30c78ede1b1d61f65f229d06f51fd1f013eb6fa3552e4cda51d`. - -Lesend tatsächlich belegt: ChronyUID989 kann wegen des Projektparents -Root:100010710 nicht zum client-Unterverzeichnis traversieren. Das geladene -Chrony-AppArmorprofil steht auf enforce und enthält bisher lediglich seine -üblichen /run/chrony-Regeln. Profil-/Pfadbefund -`07d2e0ba3a926489c3c0859f2cd047cbb9ec6138299c9d185c75cd192d43ac66`; -Root644-Singlelink-Leeroverride und bisher fehlende Parent-ACL im separaten -Metadatenbeleg -`d33e5a11cbc5ac779112762c58dc80b43217786f2570deaaf01eefdf730c180e`. -Dies begründet den folgenden eng begrenzten Namespacebootstrap; es ist -weiterhin kein erfolgreicher NativeTimeSource-/Signatur-/Clockgatebeleg. -Die vollständigen ursprünglichen RMM-/Source-/Bootbindungen blieben erhalten. diff --git a/docs/server-time-source-new-generation-probe.md b/docs/server-time-source-new-generation-probe.md deleted file mode 100644 index 4bec9e1..0000000 --- a/docs/server-time-source-new-generation-probe.md +++ /dev/null @@ -1,88 +0,0 @@ -# One native source sample for the proven c9 generation - -The user-approved Chrony generation change actually passed. Generation result -`d648daadc43de90cda977ce60615b8e47072b785aa9fbfaea37ef8b58be6c9d4` -and separate Root read receipt -`58970ef8e89af86b68fdbbf2cb5119210bcb37cec603feb23b4f6030b0b36623` -bind the new daemon and public pin. This is a non-quality bootstrap result. -No native source sample or signed time authority follows from it. - -`deploy/server_time_source_new_generation_probe.py` defines one new create-only -subphase `/var/lib/rmm-time-source-bootstrap/c9a94f94-eecd-4c66-933d-c45c1a79c7a8/probe-native-source-v1`. -It executes only the original root:root 0500 AArch64 probe from the 5b build: -848,632 bytes, SHA256 -`216b4d6a0f29ef47576f5ccc469954623141e55d7b43bd73175c1d956363bbbd`. -The named-client provider remains exactly source3fd. The fixed systemd-run -profile remains root:989 with empty supplementary groups, NoNewPrivileges, -CAP_SYS_PTRACE plus CAP_DAC_OVERRIDE, strict root filesystem protection, -AF_UNIX only, IPAddressDeny, private tmp/devices, the original syscall deny list, -3-second runtime limit and 10-second owned command watchdog. Only the unit/case -identity changes. There is one sample attempt and no automatic retry. - -Two proofs deliberately remain separate: - -- `QualifiedBuild` reads and holds the original preflight/stage/build records, - archive0da5, manifestbdf7, complete verified workspace and both original - root500 ELF artifacts. The build result is pinned to58eaf011. These records - describe the old generation historically. No old `pin.Original` constructor, - freshness check, monkeypatch, PID adoption or reset is used. -- `SharedGenerationProof(pin)` imports exactly the protected Root600 fac/ecb/d5 - source bytes. It retains original FDs for all17 actual c9 records with their - exact Root read hashes and metadata; the other21 fixed record names must stay - absent. It checks the195-byte current public pin395f and complete metadata - against the result, after/CAS/new-pin records and old194-byte backup. Fresh - complete ecb process/cgroup/socket/runtime/boot observations must match the - new after record. Public configuration, typed D-Bus commands and actual - AppArmor/ACL namespace must equal d5's recorded after state. - -The shared read-only API exports `CASE_ID`, `QUALITY_PHASE`, -`SharedGenerationProof(pin)`, `.operator`, `.operator_guard`, `.artifacts`, -`.source_sha`, `.manifest_sha`, `.expected`, `.public_pin_raw`, -`.public_pin_metadata`, `.target_directories`, and `.records` mapping Path to -original raw bytes/metadata. `.fresh()` returns the six actual new pin fields; -`.namespace_verify()` returns the checked namespace. `.close()` releases all -held FDs. Directory identities use dev/inode/UID/GID/mode and ACLs, permitting -incidental parent directory timestamps from later owned broker bootstrap files. -The shared proof never reads signer-key contents or assumes a broker must remain -absent. The one native-probe host action separately enforces no broker/time key. - -Intent, before witness and a separate start intent precede the only execution. -The raw log and actual exit are preserved before sample validation. The positive -schema is exactly the previous ca89 sample schema: same boot UUID, exact known -fields, integer time domains, total error at most500ms, reference age at most1h, -kernel state0..4, and explicit false clock/signature authority. Before/after -witnesses must be identical. Result, raw log and both witnesses are hash-linked. -`quality_proof(expected_result_sha256)` validates that same format read-only and -returns the four held records for a broker adapter. A caller must already pin a -real independently reviewed positive result hash; None cannot open this gate. - -`host-read` reads only the original fixed subphase and metadata. It runs no -preflight, service command, probe, time query or effect. A lost reply or partial -phase permits only that original read, never a new phase or replay. No command -changes clocks, Chrony service/configuration, public pin, capabilities, ACL/MAC, -signer keys, broker installation, RMM jobs or application runtime. - -Status: source/local qualification only. Root must separately review, stage -`new_generation_probe.py` as Root600 under its content hash, then execute one -`host-probe` and a separate `host-read`. Native quality remains unproven until -those actual records pass; all old5b failed probe cases remain unchanged. - -## Tatsächlich native Qualität auf dem permanenten Server bestanden - -Originalfallc9/`probe-native-source-v1`: genau eine Ausführung des -unveränderten AArch64-Probes216b/848632Bytes nach unabhängigem Review. -Tatsächlicher Exit0 und striktes Sample validiert. Kernelstate0, konservativer -Gesamtfehler50.833923ms, tatsächliches gutes Quellensync43.596197206s alt; -keine Werte aus Pollzeit oder bloßem Heartbeat abgeleitet. Before/After-Zeugen -identisch e72ce5f6; Runtime, Boot, neue Pin-/Chrony-/Configbindung erhalten. -Rootreceipt `1aab3af930648aed260c4c66a1c3ff068656cae016fcc301f052880926f99c93`. - -Separater ausschließlich lesender Originalrückabruf de6273d1 bestätigt Exit0, -Sample, identische Zeugen und Resultat-SHA256 -`ab8a6511517c6e3c01db2351ccdc5c48c73f34112c9ac863d0ea64de46665933`; -Readreceipt `7005ef54759412cd0d95e558ceebbf524a55c04bf6641c8241161e0d5e81fbf3`. -Dieser neue erfolgreiche Beleg ersetzt keinen früheren Fehler und ist keine -Signatur oder Jobgenehmigung. Kein Signer/Key/Broker/HTTPendpoint oder -Windowsclock wurde durch die Probe aktiviert. Erst dieser konkrete aktuelle -Nachweis darf den getrennten geschützten Signerbootstrap ermöglichen. Jeder -spätere Brokerbeleg benötigt trotzdem seine eigene neue NativeTimeSource-Probe. diff --git a/docs/server-time-source-peer-namespace-bootstrap.md b/docs/server-time-source-peer-namespace-bootstrap.md deleted file mode 100644 index df5ad15..0000000 --- a/docs/server-time-source-peer-namespace-bootstrap.md +++ /dev/null @@ -1,130 +0,0 @@ -# Enger Projekt-Namespace für den Chrony-Peersocket - -`deploy/server_time_source_peer_namespace_bootstrap.py` implementiert einen -einzigen neuen Root-Bootstrap im Originalfall -`5b358997-3abc-43db-945f-f41855b4e3c0`, Phase `peer-namespace-bootstrap-v1`. -Er erhebt keine reale Sourcequalität, startet keinen Broker, erzeugt keine -Schlüssel und führt keine RMM-Jobs aus. Alle alten fehlgeschlagenen Proben und -Diagnosen bleiben unverändert. Root führt diesen gesonderten Plan erst nach -unabhängigem Quellenreview aus; dieser Implementierungsschritt hat keinen -Zielaufruf ausgeführt. - -## Tatsächlicher Befund und Zweck beider Änderungen - -Die native Fehlerdiagnose meldete ausschließlich `TIME_CHRONY_CONNECT`. -Ein ungebundener Python-Unixsocket konnte im gleichen Root989-/2-Cap-Profil -verbinden; ein bereits im Projektclientverzeichnis gebundener Socket erhielt -EACCES13 und wurde anschließend ausschließlich selbst bereinigt. Keine -Datagramme wurden gesendet. Der getrennte Readonlybefund zeigte zwei Grenzen: - -1. Der Chronyprozess als UID/GID989 kann den Parent - `/run/rmm-time-source` Root:10001/0710 nicht durchlaufen. Ausschließlich - eine benannte Access-ACL `group:989:--x` mit ebenfalls `mask::--x` erlaubt - diese Suche. Kein Lesen, Schreiben oder Auflisten wird hinzugefügt; - Owner0, GID10001 und Modus0710 bleiben unverändert. Keine Default-ACL. -2. Das aktiv erzwungene Profil `/usr/sbin/chronyd` erlaubt seine bestehenden - `/run/chrony`-Pfade, nicht den gebundenen Projektpeer. Ausschließlich im - vorhandenen leeren Localoverride kommt die markierte Regel - `@{run}/rmm-time-source/clients/*.sock rw,` hinzu. Sie erlaubt den Peersocket - im bereits Root-geschützten Projektclientnamespace. Weder `/run/chrony` - noch dessen Socketrechte ändern sich. Kein Profil wird deaktiviert, kein - globaler Pfad oder Capabilitybereich freigegeben. - -Die feste Quellenprüfung bindet den tatsächlichen Readonlybeleg2087ff0f, -Receipt-SHA256 -`d33e5a11cbc5ac779112762c58dc80b43217786f2570deaaf01eefdf730c180e`: -Mainprofil Root:Root0644/Singlelink, SHA256 -`214e509af9ab9b713e89b09bf6440c4b4248e97c64d4b0d884d2f869d406e1e2`, -aktives `#include `, exakt leeres Localoverride ebenfalls -Root:Root0644/Singlelink und kein erweitertes Parent-ACL (ENODATA61). -Vorhandene andere ACLs, Localregeln oder abweichende Dateien werden nicht adoptiert. - -## Fester Ablauf und Fehlergrenze - -Der Controller lädt ausschließlich gehaltene, Root600-/Singlelink-/Hash-geprüfte -Bytes des bereits reviewten fac85-Pincontrollers. Dessen geschützter ecb72- -Originaloperator prüft weiter vollständige ursprüngliche Sources/Artefakte, -Chrony-PID/Birth/Image/Socket/Unit, Boot und RMM-Containermetadaten. Pinresultd0a9 -und tatsächlicher öffentlicher Pin203f63 bleiben unverändert gebunden. -Chronys Kernelprozesslabel und das geladene Profil müssen vor/nach auf -`/usr/sbin/chronyd (enforce)` stehen. Setfacl/Parserbytes werden gehalten und -vor den Schritten erneut auf Root0755/Singlelink/Unverändertheit geprüft. - -1. Existierende neue Phase verweigern. Aktuelle Originalzeugen, Mainprofil, - Leeroverride und Parent-Identität/ACL-Abwesenheit prüfen. Eigene Root700- - Phase, create-only/fsync-Intent und exakten privaten Altbackup erzeugen. -2. Eigener Local-Replace-Intent. Eine feste neue Root-Singlelink-Tempdatei mit - markiertem Regeltext schreiben und fsyncen; ausschließlich diese neue Datei - erhält0644. Nach erneuter Originalprüfung atomar über genau das alte leere - Localoverride ersetzen; Elternverzeichnis fsyncen. Kein Append/Overwrite - fremder Regeln und keine Änderung des Hauptprofils. -3. Eigener Offline-Intent und exakt - `/usr/sbin/apparmor_parser --skip-kernel-load --skip-cache /etc/apparmor.d/usr.sbin.chronyd`. - Exit0 ist Pflicht vor weiteren Freigaben. Es entsteht kein Kernelreload und - kein Cachewrite. Die Syntax ist durch tatsächlichen Root-Helpbeleg - `185c3e51b415b7d4847f0cc4f78034af409fe037d5ba839590a795ea433896e5` - bestätigt, nicht geraten. -4. Eigener ACL-Intent. Exakt - `/usr/bin/setfacl --no-mask --modify=group:989:--x,mask::--x -- /run/rmm-time-source`. - Der tatsächliche Linux-POSIX-ACL-v2-Xattr muss anschließend exakt Owner-rwx, - ursprüngliche Gruppe--x, benannte989--x, Mask--x und Other--- enthalten. - Mode/Owner/GID/Inode bleiben gleich; keine Default-ACL und keine weiteren ACEs. -5. Eigener Reload-Intent, unmittelbar zuvor frische Main-/Localhash- und - Originalprüfung. Ausschließlich - `/usr/sbin/apparmor_parser --replace --skip-cache /etc/apparmor.d/usr.sbin.chronyd`. - Das ist der autorisierte MAC-Profilreload, kein Dienstneustart und kein - NTP-/Uhrsetter. Beide Parserphasen und Setfacl haben eigene Logs/Exitbelege, - äußerer10s-Wächter, begrenzte Erfassung und keine automatische Wiederholung. -6. Erfolgsrecord erst nach tatsächlich beobachtetem Replace-Exit0 sowie erneut - erhaltenem Mainprofil, genau neuem Localhash, exakter Parent-ACL/Identität, - Enforcezustand und gleichem Chronyprozess/Boot/Runtime. Vorher-/Nachher- und - Unterphasenrecords werden per Hash verlinkt. - -Ein Fehler kann neuen Diskpolicytext oder eine teilweise Freigabe hinterlassen. -Das bleibt im eigenen Fall als fehlgeschlagen/unklar erhalten. Keine automatische -Rücknahme, kein blindes Reload-/ACL-Retry und kein Überschreiben alter Records. -Ein nur wieder sichtbares Enforcelabel beweist nicht nachträglich die Ausführung -eines verlorenen Replace-Aufrufs. `host-read` liest ausschließlich vorhandene -eigene Records/Logs und löst weder Prüfungskommandos noch einen Reload aus. - -Geplant, hier **nicht ausgeführt**: - -```text -python3 -I /reviewter/geschuetzter/pfad/peer_namespace_bootstrap.py host-apply -python3 -I /reviewter/geschuetzter/pfad/peer_namespace_bootstrap.py host-read -``` - -Keine reale Providerprobe/Signatur oder Clock-/Jobbereitschaft folgt allein aus -dieser Namespacefreigabe. Alle RMM-Jobs benötigen weiterhin ihren unveränderlichen -WebUI-Plan. Alte Source-/GROUP-/DAC-Proben bleiben fehlgeschlagen. - -## Tatsächlich lokaler Quellenstand - -Controller-SHA256 -`2f1dafece1e5cd1b9be11078edee5f67fbdaef013defa10c527367b42dce9265`. -Im privaten Fall `2b5751a9-e49c-453d-96fe-725c4813d9f7` bestanden AST und zwei -enge reine Fixturefälle: exakte44Byte-POSIX-ACL-v2 für named989--x/Mask--x, -ausschließlich ENODATA als ACL-Abwesenheit sowie exakt die zwei bestätigten -Parserargumentvektoren/skip-cache und eine einzige markierte Socketregel. -Fixture-Receipt-SHA256 -`177b4fa5a0042755d9d137c81ab94d3c31d13f3d5dd871aaf991dcf39dc87efd`. -Sie bindet die Dokumentfassung vor diesem Ergebnisnachtrag. Kein setfacl, -Parser, Kernelprofil-/NSS-/Zeitgetter, Build, SSH oder Zielaufruf wurde durch -diese Fixtures ausgeführt. Unabhängiger Review und tatsächlicher Bootstrap -sind noch keine hier erbrachten Nachweise. - -## Tatsächlich auf dem permanenten Cloud-Server ausgeführt - -Am 2026-11-15 wurde ausschließlich dieser Namespacebootstrap erfolgreich -ausgeführt. Rootreceipt -`1dc76b5a9673f9e08e59f91f05d586cb9335ffd0a33e697d5170823a6f053619`, -separater lesender Rückabruf -`129584f296b53614e10a9e5eac2bab0a1e70b1c51f7fd70eb31bdf907ce767b3`, -ursprüngliches Serverresult -`cb1665cb14086d3ba79089a2eb9e01a532dd779bdcf577eafca0e343b5cc6a8b`. -Offlineparser und tatsächlicher Profil-Replace meldeten Exit0. Exakte benannte -Such-ACL und Localprofilhash27e3708a sind nachgelesen; AppArmor bleibt Enforce. -Chronyprozess, Boot, bestehende RMM-Runtime und öffentlicher Pin sind erhalten. -Keine Quelle wurde dabei abgefragt, kein Dienst neu gestartet und kein -Signierschlüssel oder Broker erzeugt. Die separate reale Qualitätsprobe bleibt -der nächste Schritt; frühere fehlgeschlagene Proben bleiben fehlgeschlagen. diff --git a/docs/server-time-source-pin-bootstrap.md b/docs/server-time-source-pin-bootstrap.md deleted file mode 100644 index f14acc4..0000000 --- a/docs/server-time-source-pin-bootstrap.md +++ /dev/null @@ -1,174 +0,0 @@ -# Create-only Bootstrap für den öffentlichen Chrony-Pin - -`deploy/server_time_source_pin_bootstrap.py` implementiert ausschließlich den -öffentlichen sechs-Felder-Chrony-Pin und zwei eigene Runtimeverzeichnisse. -Signer, private Schlüssel, Broker, Systemd-Dienste, RMM-Dateien und -Chronyberechtigungen werden nicht verändert. Eine Zeitprobe oder Jobfreigabe -entsteht daraus nicht. Die Quelle ist vor einer tatsächlichen Ausführung -separat zu reviewen; Sourcevorhandensein ist keine Serverabnahme. - -Voraussetzung ist ein neuer, bereits erfolgreich geprüfter ARM64-Operatorfall -mit Preflight, Stage und Releasebuild. Das Werkzeug übernimmt dessen kanonische -UUIDv4 über `--case`, keinen frei wählbaren Pfad. Es verlangt den unveränderten -reviewten Operator -`ecb72b7cbcc1d036a0f4bd2f0a92a9b80339326068e49edd70d5627226833d61` -unter `/var/lib/rmm-time-source-operators//operator.py`: regulär, -Root:Root0600, ein Link, geschützte Rootancestry und exakte Originalbytes. -Diese geprüften Bytes werden direkt als Modul geladen, ohne einen erneuten -ungesicherten Importpfad. Der Providerquellpin ist -`3fd9c7a969a583abf97e29165135a8c1044db5c951ad8bd4dbfee3ee77e7ccdc`, -also der konkret qualifizierte Socketberechtigungsfix. - -Originale Preflight-/Stage-/Buildresultate, Quellenarchiv und Manifest werden -unabhängig gebunden. Die unveränderten Stagequellen, beide tatsächlich -AArch64-ELF183-Artefakte mit ursprünglichen Längen/Hashes und alle Original- -Zeugen vor/nach dem erfolgreichen Build bleiben Pflicht. Der aktuelle frische -Operatorpreflight muss dieselben Chrony-Prozesse, Unitgeneration, -Datei-/Socket-/Pidfileidentitäten, Boot-ID, Runtimecontainer und Buildermetadaten -belegen. Keine stille PIDübernahme, Reimage oder Neukonfiguration. - -Der Rootoperator startet ausschließlich mit isolierter Pythonumgebung: - -```text -python3 -I /reviewter/absoluter/pfad/server_time_source_pin_bootstrap.py host-pin --case -``` - -Der Pin-Schritt erhält die eigene create-only Phase `pin` im Originalfall. -Ein vorhandener Phasenpfad verweigert bereits vor einer neuen Beobachtung. -Vor der ersten Zieländerung liegen ein dauerhafter Intent und überprüfte -Originalbelege vor. Beide Topverzeichnisse müssen ursprünglich vollständig -abwesend sein, auch ein Symlink oder ein scheinbar passendes vorhandenes -Verzeichnis wird nicht übernommen: - -- `/etc/rmm-time-source`: Root:Root0700; darin ausschließlich der neue - `chrony-pin.json`, Root:Root0600, ein Link. Seine exakt sechs Felder sind - die tatsächlich erneut beobachteten Werte `schema_version`, `daemon_pid`, - `daemon_birth_ticks`, `daemon_uid`, `daemon_gid`, `daemon_image_sha256`. -- `/run/rmm-time-source`: Root:10001 0710; darin `clients`: Root:989 0710. - Kein Socket wird angelegt. Diese Pfade sind für die anschließend separat - genehmigte native Root-Providerprobe vorgesehen. - -Jede beabsichtigte Namespace-, Inhalts- oder Berechtigungsänderung wird vorher -mit einem neuen tatsächlichen Operatorpreflight gebunden. Die Verzeichnisse -entstehen zunächst Root0700; Chown und endgültiger Modus folgen jeweils nach -einer weiteren frischen Beobachtung. Gehaltene Parent-/Leaf-FDs, -`O_NOFOLLOW`, create-only Dateierzeugung, fsync und exakte Nachlese binden die -Originalobjekte. Die Schlussprüfung vergleicht den Pin bytegleich und die -vier erzeugten Objektidentitäten. Eine kleine ASCII-JSON-Receipt enthält -Hashes und öffentliche Metadaten, keine privaten Konfigurationen. - -Bei Fehlern bleiben ausschließlich die eigenen Teilobjekte und der -Fehlerbeleg erhalten. Es gibt keine automatische Bereinigung, Wiederholung, -Objektübernahme, Pinheilung oder Rücksetzung. Ein Fehler vor erfüllten -Vorbedingungen erzeugt keine Zielobjekte. Für jede verlorene oder unklare -Antwort ist ausschließlich folgender lesender Pfad vorgesehen: - -```text -python3 -I /reviewter/absoluter/pfad/server_time_source_pin_bootstrap.py host-read --case -``` - -Er liest nur vorhandene Intent-/Resultat-/Fehlerbelege und begrenzte -Zielmetadaten. Er startet keinen Operatorpreflight, Dockeraufruf, Dienst oder -Zeitsample. Nicht vertrauenswürdige Parentpfade werden geschlossen abgewiesen, -keine fremden Zielinhalte gelesen. Eine erfolgreich provisionierte Pin-Datei -ist noch kein Nachweis tatsächlicher Zeitqualität, keine Brokerinbetriebnahme -und keine Windows-Clockfreigabe. - -Lokale Quellenprüfung: AST und fünf reine Guardgruppen bestanden. Geprüft -wurden positive Originalbindung und geänderte Liveidentität, Artefakttamper / -fehlgeschlagener Build, geschlossene Quellenpfade und Providerbindung, -doppelte/nichtendliche JSON-Werte sowie create-only-/Symlink-/Längenfehler. -Ein netzloser, read-only lokaler Entwicklungscontainer prüfte zusätzlich den -vollständigen Schreibfluss auf einem eigenen Tmpfs: tatsächliche UID/GID-/ -Moduswerte, unveränderte vorhandene Objekte, Abbruch mit erhaltenem Teilzustand, -keine Wiederholung nach vorhandener Phase und kein Preflight im Lesepfad. -Die Originalautorität war dabei ausdrücklich durch eine Fixture ersetzt; -das ist kein tatsächlicher Server-, Chrony- oder ARM64-Abnahmenachweis. -Der private Quellen-/Guardfall ist -`8f2a634c-fe9e-4458-901b-aee334332baf`. Keine Zielaktion oder Gitänderung wurde -für diesen lokalen Nachweis ausgeführt. - - -ARM-Portierungsdelta: Der tatsächliche erste ARM64-Build des Rootfalls -`3564b4e7` verweigerte mit Compilerexit101, weil `libc::stat.st_nlink` dort -32 Bit besitzt. Die beiden privaten Identity-Typen in Provider und Broker -verwenden jetzt `libc::nlink_t`; Masken, Inodeprüfungen und Pinschema bleiben -unverändert. Der erwartete Providerhash dieses Bootstrapwerkzeugs ist deshalb -auf den oben genannten ARM-portablen Quellstand aktualisiert. Die zehn lokalen -Guardgruppen des Falls `8f2a634c-fe9e-4458-901b-aee334332baf` gehören weiterhin -zum vorherigen Bootstrapquellstand. Für den neuen Bootstrap wurde ausschließlich -der exakte Hashkonstantenwechsel samt AST und Quellendelta geprüft; kein neuer -ARM-Erfolg oder erneuter Zehner-Guardlauf wird daraus abgeleitet. Ursprünglicher -Compilerfehler und sämtliche alten Belege bleiben erhalten. Ein neues -Serverquellenpaket und ein neuer tatsächlicher ARM64-Build bleiben Voraussetzung. - - -JSON-Deltakorrektur vor Zielausführung: Die frische Operatorbeobachtung verwendet -bei `service_socket_fds` numerische PID-Schlüssel, gespeicherte JSON-Belege -verwenden Stringschlüssel. `observation_key` normalisiert beide Seiten jetzt -über denselben kanonischen JSON-Encoder und den strikten Parser. Kein Feld und -keine Identitätsmetadaten werden entfernt. Der kleine lokale Deltanachweis -akzeptiert die numerische/gespeicherte Darstellung desselben PID-/FD-Belegs, -verweigert weiterhin andere PID-, FD-, Inode- und Bootwerte und weist kollidierende -gemischte Schlüssel geschlossen zurück. Das Artefaktschema des unveränderten -Operators wurde direkt gegen seine AST geprüft: exakt `bytes`, `sha256`, -`elf_machine` mit AArch64-Machine183. Die bisherigen zehn Guardgruppen wurden -nicht erneut behauptet oder wiederholt; keine Zielaktion wurde ausgeführt. - - -Enges Verzeichniszeitstempeldelta: Der tatsächliche Pin-Transportversuch -`960240b4` scheiterte vor Pinphase und Zielmkdir an -`original_build_chrony_runtime_boot_stable`. Der ausschließlich lesende -Differenzbeleg -`e346cab3a8f964907e815856c682016c8a4ac312feeef4bbfa927a6fe3298f5a` -belegte als einzige Unterschiede `mtime_ns` und `ctime_ns` von -`chrony_binding.directory_metadata`. Gerät/Inode, UID/GID, Modus, Linkzahl, -Größe und sämtliche Socket-, Pidfile-, Prozess-, Dienst-, Runtime- und -Bootzeugen blieben gleich. Beide Zieltopverzeichnisse und die Pinphase waren -noch abwesend; es wurde kein Pin geschrieben und keine Zeitqualität erhoben. - -Die Vergleichsprojektion nimmt deshalb ausschließlich diese beiden -Verzeichniszeitstempel aus. Bei einem daemon-eigenen0700-Verzeichnis können -bereits temporär erstellte/entfernte Socketnamen solche Zeitstempel ändern; -die konkrete Ursache des beobachteten Unterschieds wurde nicht gemessen. -Der gehaltene Verzeichnisinode, alle übrigen Verzeichnisfelder, der tatsächliche -Sockelinode/-FD und die späteren Kernelcredentials bleiben Autorität. -Socket-/Executablezeitstempel werden ausdrücklich weiterhin verglichen. -Vollständige Original-JSON-Bytes und deren Dateibeweise werden weiterhin -unverändert gehalten und nachgelesen. Die Korrektur schwächt weder den -Provider-Socketguard noch das Pinschema ab. - -Ein kleiner lokaler Deltaguard akzeptiert nur Änderungen dieser beiden -Verzeichniszeitstempel; Inode-/Modus-/Eigentümer-/Link-/Größenänderungen sowie -Socket-/Imagezeit-, PID- und Bootwechsel bleiben ungleich. Fehlende -Zeitstempelzeugen verweigern. Die zehn früheren Guardgruppen wurden nicht -wiederholt. Ein neuer Controlleraufruf ist ein eigener Root-Abnahmeschritt, -weiterhin ausschließlich bei nachgewiesen abwesender Pinphase; der alte -Transportversuch bleibt fehlgeschlagen und wird nicht nachträglich geheilt. - -## Tatsächliche Serverprovisionierung - -2026-11-15: Controllerfac85dd0 wurde nach Quellen-/Projektionsreview im -Original-ARM64-Fall5b358997 ausgeführt. Vor Zieländerung waren eigenePinphase -und beideZielverzeichnisse weiterhin nachweislich abwesend. Der vorherige -Controllerc19862f2 war bereits vor Phasenanlage wegen abweichender inzidenteller -Verzeichniszeitstempel gescheitert; dessen Fehlerreceipt6e3bc2f9 bleibt -unverändert und wurde nicht in einen Erfolg umgeschrieben. - -Die neue create-only Provisionierung bestand. Öffentlicher Chrony-Pin-SHA256 -`203f63f150026d345614ca53e641f248397166fbdeb1f28318fc5d7763317e0a`, -Ausführungsreceipt -`5e94a5fd9529f15539ad55ac7f82c073e1d1df87e9c030bb8291393ce71d7974`. -Tatsächlich erstellt: /etc/rmm-time-source Root:Root0700, publicpin Root:Root0600 -Singlelink, /run/rmm-time-source Root:10001 0710 und clients Root:989 0710. -Frische Prozess-/Socket-/Dienst-/Boot-/Runtimebindungen blieben erhalten. -Keine Sourcequalitätsabfrage, Schlüsselgenerierung, Dienststeuerung oder -Signatur durch diesen Schritt. Kein RMM-Job, keine Clockbereitschaft. - -Separater vollständig lesender Originalfallabruf bestanden, Receipt -`3136edf1913672ca0e7f013874b74dccc2a424bcaef5ce9f9021accab97e4874`, -Original-Pinresult-SHA256 -`d0a9ac7b46bdf4247c420f01d959c41d6620f7081c40629016d6866828884c4b`. -Er bestätigt die genannten Owner/Modi/Singlelink und denselben Publicpinhash. -Die anschließende tatsächliche native Qualitätsprobe ist ein eigener noch -nicht durch diese Provisionierung erledigter Schritt. diff --git a/docs/server-time-source-probe-acceptance.md b/docs/server-time-source-probe-acceptance.md deleted file mode 100644 index 2a19491..0000000 --- a/docs/server-time-source-probe-acceptance.md +++ /dev/null @@ -1,142 +0,0 @@ -# Einmalige Qualitätsprobe nach dem nachgewiesenen GROUP-VorExecfehler - -`deploy/server_time_source_probe_acceptance.py` ist ein neuer enger Rootoperator -für genau den ursprünglichen ARM64-Fall -`5b358997-3abc-43db-945f-f41855b4e3c0`. Er wiederholt oder überschreibt nicht -dessen alte `probe`-Phase. Der tatsächliche rein lesende Journal-/NSS-Befund -f5ca944a, SHA256 -`4977876b935bed8903ce4c880a0d9c77c49cd2c7110551fbf854baeccbe64ea7`, -belegt `216/GROUP` und „Failed to determine supplementary groups“ vor ELFexec. -989 ist `_chrony`; 10001 fehlt. Das alte Ergebnis216 und das leere alte Log -bleiben unverändert erhalten. Dies ist kein nachträglicher Erfolg dieser Probe. - -Der neue Operator hat keine SSH-Funktion und akzeptiert keine frei wählbaren -Cases, Dateien, Hashes oder Programmargumente. Er lädt ausschließlich die -geprüften gehaltenen Root600-Bytes des Pincontrollersfac85dd0 unter -`/var/lib/rmm-time-source-operators/fac85dd0399009af36f625232daa5b67ab7fda391dbf95229d4237c307b142ca/pin_bootstrap.py`. -Dessen geschützter Import des Originaloperatorsecb72b7c und vollständige -Original-/Source-/Artefakt-/Chrony-/Boot-/Runtimeguards bleiben Pflicht. - -Verbindliches ELF ist die ursprüngliche Root500-/Singlelink-Providerprobe: -848632Bytes, ELF64/AArch64-Machine183, SHA256 -`216b4d6a0f29ef47576f5ccc469954623141e55d7b43bd73175c1d956363bbbd`. -Der originale Pinresult-SHA256d0a9ac7b und der öffentliche Pin -`203f63f150026d345614ca53e641f248397166fbdeb1f28318fc5d7763317e0a` -werden unabhängig nachgelesen. Der aktuelle Pin muss exakt zur frischen -Originalprojektion passen; Identität/Owner/Modus und Quelldaten bleiben erhalten. -Die bestehende Chronyprojektion schließt ausschließlich ihre bereits reviewten -inzidentellen Daemonverzeichnis-Zeitstempel aus. Für die eigenen Runtime- -verzeichnisse werden Dev/Inode/UID/GID/Modus verglichen; Eintragsgrößen und -Zeitstempel sind kein zusätzlicher Identitätsbeweis. Der vollständige originale -Pinresult bleibt daneben auf exakte Bytes und Metadaten gebunden. - -## Eigene endliche Phase - -Ein tatsächlicher Aufruf kann ausschließlich einmal die neue Phase -`/var/lib/rmm-time-source-bootstrap/5b358997-3abc-43db-945f-f41855b4e3c0/probe-group-acceptance-v1` -erzeugen. Vor Probeexec liegt ein eigener create-only/fsync-Intent vor. Danach -werden der alte GROUP-VorExecbefund im begrenzten Journal genau der Originalunit -und desselben Boots sowie die NSS-Gruppenbedingung erneut ausschließlich lesend -geprüft. Die Probe muss **vor** einer später separat genehmigten Anlage von -Gruppe10001 erfolgen; vorhandene10001 wird nicht adoptiert oder verändert. - -Genau eine neue demandgestartete Unit -`rmm-time-source-probe-group-acceptance-5b358997-3abc-43db-945f-f41855b4e3c0.service` -führt das unveränderte ELF aus. Gegenüber dem ursprünglichen Probeprofil ist -ausschließlich die unnötige Zusatzgruppe entfernt (`SupplementaryGroups=`). -Root/primäreGruppe989, NoNewPrivileges, CapabilityBoundingSet nurCAP_SYS_PTRACE, -ProtectSystem=strict, ProtectHome, PrivateTmp/Devices, AF_UNIX-only, IP-deny, -Debug-/ptrace-/process_vm-Syscalldeny, RuntimeMaxSec3s, äußerer10s-Wächter und -Schreiben ausschließlich im vorhandenen eigenen Chrony-Clientverzeichnis bleiben. -Keine Gruppenanlage, chmod, NTP-/Clocksetter, Schlüssel, Signatur, Broker-/RMM- -Dienständerung oder Jobwirkung. Jeder RMM-Job bleibt WebUI-genehmigungspflichtig. - -Rohlog und tatsächlicher Exit werden vor abschließenden Erhaltungsprüfungen als -eigene Ausführungsbelege gesichert. `before.json`/`after.json` enthalten vollständige -frische Originalprojektion, Pinmetadaten und Verzeichnisidentitäten; das Ergebnis -bindet beide Dateien per Name/SHA. Quelle, Artefakte, originale Phasen/fehlgeschlagene -Probe, Pin und tatsächlicher Laufzeitbestand werden vor/nach der einen Probe -erneut geprüft. Fehler oder Antwortverlust erlauben ausschließlich Lesen dieser -Phase; keine automatische Wiederholung, neuer Case oder generische Resumefunktion. - -## Ergebnisvertrag und geplante Bedienung - -Nur nach Exit0, erhaltenen Originalzeugen und streng validiertem Ausgabeobjekt -enthält `result.json` `source_quality_qualified=true`. Der genaue Samplevertrag -ist das unveränderte `operator_probe`-JSON: eigene Boot-ID muss dem Originalboot -entsprechen; UTC/Monotonic/Boottime sind echte begrenzte Integer, Gesamtfehler -höchstens500ms, Quellalter höchstens1h und Kernelstate0..4 gemäß geprüftem Provider. -Unbekannte/fehlende Felder, bool statt Zahl und abweichender Boot verweigern. -`clock_authority=false` und `signed_attestation=false` bleiben fest. Ein Exit -ungleich0 bleibt mit wirklichem Exit und `sample=null` unqualifiziert erhalten. - -Resultbinding: `profile`, `original_case`, `phase`, `unit`, `controller_sha256`, -`operator_sha256`, `pin_controller_sha256`, `public_pin_sha256`, -`source_tar_sha256`, `manifest_sha256`, `artifact`, -`original_group_receipt_sha256`, `original_probe_result_sha256`, `pin_result_sha256`. -`before_witness`/`after_witness` sind jeweils `{filename,sha256}` mit festen -`before.json`/`after.json`; diese enthalten dasselbe Binding plus `witness`. -Weitere Ergebnisfelder sind `exit_code`, `sample`, `probe_log_sha256`, -`source_quality_qualified`, `runtime_boot_pin_source_preserved`, -`clock_authority`, `signed_attestation`, `signer_created`, `broker_started`, -`http_deployed`. Diese Probe aktiviert weder Windowsclock noch Jobgate. - -Geplant, **nicht durch diese Implementierungsarbeit ausgeführt**: - -```text -python3 -I /reviewter/geschuetzter/pfad/probe_acceptance.py host-probe -python3 -I /reviewter/geschuetzter/pfad/probe_acceptance.py host-read -``` - -`host-read` liest ausschließlich vorhandene begrenzte Phasenrecords und Log; -kein subprocess, NSS, Preflight, Socketaufruf oder erneutes Sampling. -Roottransport/Quellhashreview und die tatsächliche native Ausführung bleiben -beim Rootoperator. Dieser Schnitt behauptet keinen nativen Qualitätsnachweis. - -## Tatsächlich lokal geprüft - -Source-SHA256 -`d04989ccf6d3e7b379a1b02f5fd3ce2545a3563fbce1368f33102f58a36f2dcf`. -Im privaten Fall `847bfdf0-ea79-44b2-b0ef-5f1193c95e49` bestanden Python-AST -und zwei reine lokale Fixturefälle: der tatsächliche gespeicherte GROUPbefund -wurde als positive Eingabe verwendet; Exit0, nichtleeres Altlog, fehlende -Journalbelege und bereits vorhandene10001 wurden verweigert. Die zweite -Fixture verglich alle systemd-Argumente unmittelbar gegen den fest gehashten -Originaloperator: ausschließlich eigene Unit und leere Zusatzgruppen ändern -sich. Strikte numerische Qualitäts-/Boot-/Schemasperren bestanden ebenfalls. -Receipt-SHA256 -`0ffa57a2ac522794e81784360a9e9af570a861bffb31df3033192c50f03d3e53`. -Die Receipt bindet die davor vorhandene Dokumentfassung; dieser Ergebnisnachtrag -ändert weder Source noch die tatsächlich geprüften Argumente. Die Fixtures -rufen weder systemd/Docker noch NSS, Journal oder Clockgetter auf; keine -Zielaktion wurde ausgeführt. Native Ausführung bleibt offen. - -## Tatsächliche Ausführung und geschlossene Qualitätsgrenze - -2026-11-15: Originalprobe im Buildfall5b358997 endete vor Exec mit216/GROUP. -Die rein lesende Originalunit-Journalabfrage bestätigt fehlgeschlagene -Supplementarygroup-Auflösung10001;989/_chrony existiert. Receipt -`4977876b935bed8903ce4c880a0d9c77c49cd2c7110551fbf854baeccbe64ea7`. -Die getrennte neue Phaseprobe-group-acceptance-v1 mit Controllerd04989cc -wurde anschließend genau einmal ausgeführt, ohne unnötige Zusatzgruppe. -Das Programm wurde diesmal gestartet, endete aber mit1 und festem -TIME_SOURCE_OPERATOR_PROBE_DENIED. Keine Sample-/Qualitätsqualifikation. -Ausführungsreceipt -`6923cc1893619f67ae8677b84f9cfea6d0edd554120e9139d843115e52aa7643`, -Log-SHA256 -`f80644630b09f50fdc731418dbe4f17fff32622910b3efd346a0369b75e985ef`. -Originalphase und ihr fehlgeschlagenes Resultat bleiben unverändert. - -Eine getrennte tatsächlich rein lesende DAC-Diagnose erfasste zwei eigene -Rootprozesse mit EGID989/keinen Zusatzgruppen: CAP_SYS_PTRACE allein -(CapEff0x80000) verweigert Öffnen des Chrony0700-Verzeichnisses und bloßes -Unixdatagramm-Connect zum Socket0755 mit EACCES13. Mit zusätzlich -CAP_DAC_OVERRIDE (CapEff0x80002) gelangen beide. Kein Datagramm gesendet, -keine Datei angelegt, kein Zeitsetter, keine Änderung an Chrony-ACLs. Receipt -`d999e5260cab3457a7a66603fdb0288615443628e5a28f31df9c1cecd3401ef5`. -Die bisherige Rootdienst-Capabilitybegrenzung reicht folglich für diese -tatsächliche vorhandene Quellkonfiguration nicht. Eine folgende eigene -Probephase benötigt diese dokumentierte zusätzliche Zugriffscapability; -Root-ROFS, AF_UNIX-only/IPdeny, Pfad-/Inode-/Owner-/SCM-Credentialprüfungen -und Verbot von CAP_SYS_TIME bleiben erhalten. Es wurde noch kein -erfolgreiches natives Qualitätssample oder signierter Vergleich gemessen. diff --git a/docs/server-time-source-probe-dac-acceptance.md b/docs/server-time-source-probe-dac-acceptance.md deleted file mode 100644 index 2b8fbcf..0000000 --- a/docs/server-time-source-probe-dac-acceptance.md +++ /dev/null @@ -1,114 +0,0 @@ -# Eigene DAC-Qualitätsprobe nach tatsächlicher Zugriffsverweigerung - -`deploy/server_time_source_probe_dac_acceptance.py` erzeugt ausschließlich die -neue einmalige Phase `probe-dac-acceptance-v1` im Originalfall -`5b358997-3abc-43db-945f-f41855b4e3c0`. Der frühere Controllerd04989cc und -die Phase `probe-group-acceptance-v1` bleiben unverändert und fehlgeschlagen. -Die ursprüngliche noch ältere Probe216/GROUP wird ebenfalls nicht wiederholt. - -## Tatsächlich belegte Ursache und enge Änderung - -Die tatsächliche Group-Probe endete mit Exit1 und ausschließlich generischer -`TIME_SOURCE_OPERATOR_PROBE_DENIED`-Ausgabe. Ihr Ergebnis enthält ausdrücklich -`source_quality_qualified=false`, `sample=null`. Result-SHA256 -`96b714e2e43aa13073317c310b213863a02f26dbf2e6c975dc0801ef621eccd5`, -Log-SHA256 `f80644630b09f50fdc731418dbe4f17fff32622910b3efd346a0369b75e985ef`, -Root-Ausführungsreceipt6923cc18. Dies wird nicht nachträglich zu Erfolg erklärt. - -Der separate tatsächliche rein lesende DAC-Vergleich03dc8e2a, Receipt-SHA256 -`d999e5260cab3457a7a66603fdb0288615443628e5a28f31df9c1cecd3401ef5`, -belegt UID0/GID989 mit CapEff0x80000: Öffnen von `/run/chrony` und Verbinden mit -`/run/chrony/chronyd.sock` werden jeweils mit errno13 verweigert. Mit zusätzlich -CAP_DAC_OVERRIDE (CapEff0x80002) waren beide Zugriffe möglich. Die Diagnose -sendete keine Datagramme und erzeugte keine Dateien. - -Deshalb ändert der neue feste Probeaufruf gegenüber d049 ausschließlich -`CapabilityBoundingSet=CAP_SYS_PTRACE CAP_DAC_OVERRIDE` sowie eigene Phase, -Profil und Unit. CAP_SYS_PTRACE bleibt für gehaltenen fremden `/proc/.../exe`- -Identitätszugriff erforderlich. CAP_DAC_OVERRIDE übergeht hier sowohl die -diskretionäre Verzeichnissuche als auch die Schreibberechtigungsprüfung beim -Unix-Datagrammsocket-Connect. Es ist keine bloße Lesecapability. Die zusätzliche -Autorität wird ausschließlich dem fest gehashten Provider mit seinen geschlossenen -Pfaden und unverändertem Root-Readonly-Dateisystem gewährt; kein allgemeiner Reader. - -Root/GID989, leere SupplementaryGroups, NoNewPrivileges, ProtectSystem=strict, -ProtectHome, PrivateTmp/Devices, AF_UNIX-only, IP-deny, Debug-/ptrace-/process_vm- -Syscalldeny, RuntimeMaxSec3s und äußerer10s-Wächter bleiben erhalten. Keine -CAP_SYS_TIME, chmod, Gruppenanlage, NTP-/Clocksetter, RMM-/Brokerdienständerung, -Schlüssel oder Signatur. Jeder RMM-Job braucht weiterhin seinen WebUI-Plan. - -## Gebundene Originale und Ergebnis - -Das ursprüngliche ELF bleibt848632Bytes/SHA256 -`216b4d6a0f29ef47576f5ccc469954623141e55d7b43bd73175c1d956363bbbd`, -Root500/Singlelink, ELF64/AArch64-Machine183. Der unveränderte fac85-Pincontroller -wird geschützt aus seinen geprüften Root600-Bytes geladen und prüft weiterhin -den Originaloperator ecb72, Sources/Artefakte, Chronyprozesse/-socket, Boot und -RMM-Containermetadaten. Der reale öffentliche Pin203f63 und Pinresultd0a9ac -bleiben auf Originalbytes und Metadaten gebunden. Vor und nach dem neuen Exec -werden zusätzlich Result/Log/beide Witnessdateien der gescheiterten Group-Probe -auf erhaltene Originalbytes, Hashlinks und Metadaten geprüft. - -Genau ein create-only/fsync-Intent steht vor der eigenen Probeunit -`rmm-time-source-probe-dac-acceptance-5b358997-3abc-43db-945f-f41855b4e3c0.service`. -Bestehende neue Phase oder unklare Antwort bedeutet ausschließlich ihren eigenen -`host-read`, keinen Retry und keinen neuen Case. Live-NSS-/Original-GROUP- -Journalguards bleiben erhalten; die Qualityprobe muss vor der späteren separat -beauftragten Anlage von Gruppe10001 erfolgen. - -Ergebnis ausschließlich unter -`/var/lib/rmm-time-source-bootstrap/5b358997-3abc-43db-945f-f41855b4e3c0/probe-dac-acceptance-v1/result.json`. -Profil ist `rmm.server-time-source.dac-acceptance.v1`. Das bisherige geschlossene -Result-/Sample-/Witnessschema aus [Group-Probe](server-time-source-probe-acceptance.md) -bleibt erhalten; neu im gemeinsamen Binding von Intent/Execution/Result/Witnesses: - -- `original_group_acceptance_controller_sha256`: d04989cc… -- `original_group_acceptance_result_sha256`: 96b714e2… -- `original_group_acceptance_log_sha256`: f8064463… -- `original_group_acceptance_receipt_sha256`: 6923cc18… -- `original_dac_diagnostic_receipt_sha256`: d999e526… - -Ein nachfolgender Broker-Installgate darf ausschließlich das tatsächliche neue -DAC-Result mit Exit0, `source_quality_qualified=true`, erhaltenen Source-/Pin-/ -Runtimezeugen und strengem numerischem Sample prüfen. Alte Group-Resultate -bleiben false. `clock_authority=false` und `signed_attestation=false` bleiben -auch bei erfolgreicher Qualitätsprobe bestehen; Windowsclock/Jobs bleiben eigene -offene Gates. Alle tatsächlichen Messwerte fehlen bis zur Rootausführung. - -Geplant, durch diese Implementierungsarbeit **nicht ausgeführt**: - -```text -python3 -I /reviewter/geschuetzter/pfad/probe_dac_acceptance.py host-probe -python3 -I /reviewter/geschuetzter/pfad/probe_dac_acceptance.py host-read -``` - -Der Read liest ausschließlich eigene vorhandene Phasenrecords und begrenztes -Log, ohne Subprozess, NSS, Preflight, Socket oder Zeitabfrage. Diese Quelle -implementiert keinen SSH-Transport. Native Ausführung bleibt Root vorbehalten. - -## Tatsächlich lokal geprüft - -Controller-SHA256 -`1b79a4ab8d587338e43330db0fc73ff2e199dc61f1172da7cc3fc93d3538d2ac`. -Im privaten neuen Fall `ef50bb99-f958-4f41-beae-7ba0f8d38f53` bestanden AST und -eine enge reine Fixture: sämtliche Execargumente entsprechen unmittelbar dem -unveränderten Controllerd049, ausschließlich eigene Unit und zusätzliche -CAP_DAC_OVERRIDE weichen ab. Die wirklichen gespeicherten Group-/DAC- -Transportreceipts wurden auf ihre exakten Hashes geprüft; das tatsächlich -fehlgeschlagene Groupresult wurde akzeptiert, eine umgeschriebene Erfolgs- oder -Controllerherkunft verweigert. Receipt-SHA256 -`daae6c0de9e467ab2362691915765b671875dbc3097235ce78f98abf4c95a95e`. -Sie bindet die Dokumentfassung vor diesem Ergebnisnachtrag. Keine Builds, -Subprozess-/NSS-/Journal-/Clockgetter- oder Zielaktionen durch diese Fixture; -der tatsächliche neue DAC-Qualitätsnachweis bleibt offen. - -## Tatsächlicher DAC-Probelauf - -2026-11-15: Genau ein Lauf mit dem belegten Zwei-Capability-Profil endete -mit1 und weiterhin ohne Sample. Ausführungsreceipt -`553bc8580deb0e78d780b43c569f3827715a54a7b8629c51c705cf4e9ded7c61`; -Originalfehler und alle früheren Phasen bleiben erhalten und fehlgeschlagen. -Die anschließend separat gebaute [begrenzte Fehlerdiagnose](server-time-source-error-probe.md) -lokalisiert TIME_CHRONY_CONNECT. Keine weiteren Capabilityvermutungen oder -Qualitätslockerung; die konkrete neue Peer-Namespacefreigabe wird gesondert -reviewt. NativeSourcequality, Signer-/Brokerbetrieb und Jobgates bleiben zu. diff --git a/docs/server-time-source-probe-peer-acceptance.md b/docs/server-time-source-probe-peer-acceptance.md deleted file mode 100644 index 51961a0..0000000 --- a/docs/server-time-source-probe-peer-acceptance.md +++ /dev/null @@ -1,118 +0,0 @@ -# Einmalige reale Sourceprobe nach tatsächlicher Peer-Namespacefreigabe - -`deploy/server_time_source_probe_peer_acceptance.py` besitzt genau die neue -Phase `probe-peer-acceptance-v1` im erhaltenen Originalfall -`5b358997-3abc-43db-945f-f41855b4e3c0`. Keine alte Probe wird erneut ausgeführt, -umgeschrieben oder erfolgreich umgedeutet. Der tatsächliche Namespacebootstrap -2f1dafece war erfolgreich; das ist noch kein Source-Sample. - -Sein Originalresult-SHA256 ist -`cb1665cb14086d3ba79089a2eb9e01a532dd779bdcf577eafca0e343b5cc6a8b`, -Rootreceipt1dc76b5a und separater Readreceipt -`129584f296b53614e10a9e5eac2bab0a1e70b1c51f7fd70eb31bdf907ce767b3`. -Der Qualifier verlangt diesen tatsächlich erfolgreichen Rootrecord samt allen -gehashten Before-/After-/Offline-/ACL-/Reloadrecords und unverändertem privaten -Leeroverride-Altbackup. Der geschützte Namespacecontroller wird ausschließlich -aus exakt gehashten Root600-Bytes geladen, ohne dessen mutierenden Pfad aufzurufen. - -## Unveränderte Probe, frische Namespaceguards - -Das ursprüngliche Root500-/Singlelink-ELF bleibt848632Bytes, -SHA256`216b4d6a0f29ef47576f5ccc469954623141e55d7b43bd73175c1d956363bbbd`, -ELF64/AArch64-Machine183. Providerquelle3fd9, fac85-/ecb72-Originalguards, -öffentlicher Pin203f63, Pinresultd0a9 und komplette ursprüngliche Source-/Boot-/ -Chronyprozess-/Runtimebindung bleiben unverändert. Vor/nach werden zusätzlich -Root644-Singlelink-Mainprofil214e509a und neues Localprofil -`27e3708a34988fb778cbc8cfd892e0f222b8caf927034e472f391aab65349394` -auf gehaltene Originalbytes/Metadaten geprüft. Der Parent muss exakt die -erwartete benannte989--x/Mask--x-ACL ohne Default-ACL besitzen; sein originaler -Owner, GID, Modus und Inode bleiben unverändert. Das aktuelle Chrony-Kernelprofil -muss weiterhin `/usr/sbin/chronyd (enforce)` sein. - -Gegenüber dem vorherigen DAC-Qualifier1b79 ändern sich im Execvektor ausschließlich -eigene Unit/Phase, keine Härtung oder Capability: Root/GID989, leere Zusatzgruppen, -BoundingSet CAP_SYS_PTRACE+CAP_DAC_OVERRIDE, NNP, ProtectSystem=strict, ProtectHome, -PrivateTmp/Devices, AF_UNIX-only/IP-deny, Debug-/ptrace-/process_vm-Syscalldeny, -RuntimeMaxSec3s/äußerer10s-Wächter und Schreiben nur in vorhandene Chronyclients. -Neue Unit: -`rmm-time-source-probe-peer-acceptance-5b358997-3abc-43db-945f-f41855b4e3c0.service`. -Ein eigener create-only/fsync-Intent steht vor genau einem Exec. Kein MAC-/ACL- -Ändern, Signer, Schlüssel oder RMM-Job. Vorhandene Phase oder unklare Antwort -erlaubt ausschließlich Lesen, kein Resume/Retry. Gruppe10001 muss weiterhin -abwesend sein; diese Qualityprobe kommt vor späterem Broker-Gruppenbootstrap. - -## Ergebnis und alte Fehler - -Das alte DAC-Result ist strikt auf Exit1/kein Sample/qualityfalse gebunden: -SHA256`5f8e0634e44c7caeab2020af5f5dd0d6e83249265d0ebd67f938f0797b551fca`, -Logf8064463, ursprünglicher Controller1b79 und Rootreceipt553bc858. Es und -seine beiden Witnessdateien werden vor/nach unverändert gehalten. Die noch -älteren GROUP-/VorExecbelege bleiben ebenso gebunden. Ein neuer Erfolg wäre -ausschließlich ein neuer tatsächlicher Beleg dieser Peerphase. - -Ergebnis nur unter -`/var/lib/rmm-time-source-bootstrap/5b358997-3abc-43db-945f-f41855b4e3c0/probe-peer-acceptance-v1/result.json`, -Profil `rmm.server-time-source.peer-acceptance.v1`. Das bisherige geschlossene -Sample-/Exit-/Before-/After-Schema bleibt gleich: genau ein NativeTimeSource- -Sample bei Erfolg, Boot exakt Originalboot, echte begrenzte Integer, Gesamtfehler -höchstens500ms, Syncalter höchstens1h, Kernelstate0..4. Nur Exit0 mit vollständig -validiertem Sample und erhaltenen Zeugen erlaubt `source_quality_qualified=true`. -`clock_authority=false` und `signed_attestation=false` bleiben fest. - -Zusätzlich zu den bisherigen19 Bindingfeldern werden überall exakt diese neun -Herkunftsbindungen gespeichert: -`peer_namespace_controller_sha256`, `peer_namespace_result_sha256`, -`peer_namespace_local_profile_sha256`, `peer_namespace_receipt_sha256`, -`peer_namespace_read_receipt_sha256`, `original_dac_acceptance_controller_sha256`, -`original_dac_acceptance_result_sha256`, `original_dac_acceptance_log_sha256`, -`original_dac_acceptance_receipt_sha256`. -Der vorhandene Witness erhält zusätzlich `peer_namespace`: Result-/Main-/ -Localhash, gehaltene Main-/Localmetadaten, exaktes Parent-ACL-Hex und aktuellen -Enforceprofilbeleg. Jeder Before-/After-Record bleibt per Name/SHA im Ergebnis -gebunden. Ein Broker-Qualitygate darf ausschließlich das tatsächliche neue -Peerresult prüfen; alle alten false-Ergebnisse bleiben false. - -Geplant, durch diese Implementierung **nicht ausgeführt**: - -```text -python3 -I /reviewter/geschuetzter/pfad/probe_peer_acceptance.py host-probe -python3 -I /reviewter/geschuetzter/pfad/probe_peer_acceptance.py host-read -``` - -Der Read liest nur eigene vorhandene Records/Logs; kein NSS/Preflight/Socket/ -Reload oder erneutes Sampling. Roottransport, unabhängiger Quellenreview und -tatsächliches natives Sample bleiben separate Rootabnahmeschritte. Windows- -Clock-/Jobgates und jeder WebUI-genehmigte RMM-Plan bleiben davon getrennt. - -## Tatsächlich lokal geprüft - -Controller-SHA256 -`ca89eac44d6b1e8bbbb14cca58ecabb02fd05d59292b77f703997fad0c29e3c8`. -Privater Fall `6fdd3d67-8608-49db-9735-0b68e49a773c`: AST und zwei gezielte -reine Fixturefälle bestanden. Der Execvektor ist gegenüber dem tatsächlichen -DAC-Qualifier bis auf die eigene Unit exakt gleich. Das gespeicherte tatsächliche -Namespace-Ergebnis wurde positiv geprüft; falsches Enforce, Replace-Exit und -Localhash wurden verweigert. Der tatsächliche alte DAC-Exit1 wurde als Origin -akzeptiert, umgeschriebenes qualitytrue/Exit0 verweigert. Receipt-SHA256 -`88d059d7af5fa40ca124c2781866393d1f1d58c0d6567a15568cf58fb8ad4915`. -Sie bindet die Dokumentfassung vor diesem Ergebnisnachtrag. Keine Builds, -Kernel-/NSS-/Zeitgetter, Probe-, Parser-, SSH- oder Zielaktionen ausgeführt. -Unabhängiger Review und der neue tatsächliche native Sample stehen noch aus. - -## Tatsächliche Cloud-Abnahme 2026-11-15: fehlgeschlagen - -Nach unabhängigem Quellenreview wurde diese neue Phase genau einmal auf dem -permanenten Server ausgeführt. Rootcallf37040c5, Receipt -`c10e40296991f2075953782eca737764e872596e379934630aea918f192a4c13`. -Tatsächlicher Probe-Exit1, kein Sample, `source_quality_qualified=false`; -Loghashf8064463 bleibt die generische Providerverweigerung. Namespaceguards -und Before/After-Witnesses sind identisch (beidee16a55a1). Kein Signer, Broker -oder HTTP-/Windows-Jobgate wurde aktiviert. - -Separater ausschließlich lesender Rückabruf c4acb44e, Receipt -`a4df17e5160687a97e34f4c9f376c2a5dacfed6cedb7d39e0875e0df3e429aac`, -bestätigt Originalresult -`71f212c5886b786f98d3dbe39f8a0adf76769e4f66ee516476db7df31cda413c` -und unveränderte Zeugen. Der erfolgreich eingerichtete Namespace allein hat -damit die reale Providerverweigerung noch nicht beseitigt. Keine Wiederholung -dieser Phase; eine getrennte Diagnose soll den verbleibenden Fehler benennen. diff --git a/docs/server-time-source.md b/docs/server-time-source.md deleted file mode 100644 index 70f9bf8..0000000 --- a/docs/server-time-source.md +++ /dev/null @@ -1,251 +0,0 @@ -# Nativer Linux-Zeitprovider: Quellencheckpoint - -Der neue Quellpfad `crates/time-source-linux` beobachtet eine fest provisionierte -Chrony-Instanz und den Linux-Kernel lesend. Er ist weder eine Zeitstellung noch -ein Jobgrant. Dieser Stand ist implementierter, lokal geprüfter, noch nicht nativ -qualifizierter Quellcode. Es wurde durch diesen Implementierungsauftrag keine tatsächliche -Chrony-Abfrage, Provisionierung, Dienstaktion oder VM-Änderung ausgeführt. -Die tatsächlichen lokalen Dockerprüfungen sind unten getrennt dokumentiert. -Der Codec-Nachweis ersetzt diesen Providernachweis nicht. - -`NativeTimeSource::open()` benötigt einen engen Root-Brokerprozess. Der -unprivilegierte Anwendungsserver wird dadurch nicht zu Root. Die Runtime- -Brokerintegration und die getrennte Zeit-Signierschlüsselprovisionierung sind -separate Arbeitspakete. `sample()` liefert ausschließlich nach erfolgreicher -authentisierter Beobachtung einen privat konstruierten `QualifiedSample`. -UTC, Fehlerobergrenze, tatsächliches Referenzalter, Boot-ID sowie Monoton-/ -Boottime-Erfassungszeiten sind lesbar; Caller können keine Qualifikation per -Boolean oder eigenem Konstruktor erzeugen. Der Broker muss Zeit bis zum -Signieren konservativ ergänzen, Frische und Boot erneut prüfen und den -Sourcezustand ohne Holdover verwenden. Dieser Typ allein autorisiert keinen -HTTP-Aufrufer und keine Agentaktion. - -## Festes Provisionierungsprofil - -Die folgende Konfiguration beschreibt Voraussetzungen, keinen ausgeführten -Bootstrap. `/etc/rmm-time-source/chrony-pin.json` muss eine reguläre, -root-eigene Datei mit Modus0600 und genau einem Link unter geschützter -root-eigener Verzeichniskette sein. Striktes JSON-Schema1, keine Zusatzfelder: - -```json -{ - "schema_version": 1, - "daemon_pid": 1234, - "daemon_birth_ticks": 123456, - "daemon_uid": 999, - "daemon_gid": 999, - "daemon_image_sha256": "<64 kleingeschriebene Hexzeichen>" -} -``` - -Die Zahlen sind ausschließlich Platzhalter. Ein Operator muss die tatsächlichen -Werte unabhängig aus der vorgesehenen Instanz prüfen. Der Imagepfad ist fest -`/usr/sbin/chronyd`. PID-Startzeit, alle vier UID-/GID-Werte, lebendes pidfd, -gehaltenes und aktuelles `/proc/PID/exe`, aktueller fester Imagepfad und SHA256 -müssen übereinstimmen. Die geschützte Binärdatei wird vor und nach der Abfrage -geprüft. Neustart, Konto-/Imagewechsel oder unklarer Zustand bleiben deny; -keine automatische PID- oder Pinübernahme. Root muss einen neuen vertrauens- -würdigen Pin separat provisionieren und die Providerinstanz neu eröffnen. - -Ziel ist ausschließlich `/run/chrony/chronyd.sock`. Seine Identität und -Verzeichniskette werden vor und nach der Abfrage geprüft. Nicht-root-eigene -Verzeichnisse müssen dem gepinnten Chrony-Konto gehören; kein Gruppen- oder -Fremdschreibrecht. Der Socket muss ein einzelner Socketinode des gepinnten Daemonkontos sein -und darf weder Gruppen- noch Fremdschreibrecht haben. Lese-/Ausführungsbits -wie beim tatsächlich beobachteten Modus0755 verleihen auf Linux kein Recht, -ein Datagramm zu senden; dafür ist Schreibrecht am Pathnamesocket erforderlich -([Linux unix(7)](https://man7.org/linux/man-pages/man7/unix.7.html)). Der Server -verwendet tatsächlich das gehaltene Chronyverzeichnis UID/GID9890700; dessen -Identität sowie sämtliche übrigen Ancestry-/Credentialprüfungen bleiben Pflicht. Andere Images oder Layouts bleiben vorerst -nicht unterstützt, ohne permissiven Fallback. - -Der vom Rootoperator separat anzulegende Clientbereich ist -`/run/rmm-time-source/clients`, root:ChronyGID0710 unter geschützter root-eigener -Kette. Eine einzelne Zufallsadresse `tracking-.sock` wird einmalig dort -gebunden, root:ChronyGID0660 gesetzt und mit Device/Inode/Name/Konto/Modus -gehalten. Chrony erhält nur Traversierungsrecht am Verzeichnis und Socket- -zugriff; es kann dort keine Namen ändern. Vor jedem Namespacezugriff werden -gehaltener Verzeichnis-FD und aktueller Pfad verglichen. Cleanup konsumiert -seine einmalige Autorität vor der Prüfung und verwendet ausschließlich -`unlinkat` für die exakt eigene Identität. Unklarer Cleanup bleibt liegen; -kein Retry, rekursives Entfernen oder Übernehmen fremder Dateien. Vor Beginn -wird das Clientverzeichnis exklusiv per nonblocking flock am gehaltenen -Verzeichnis-FD gesperrt und muss leer sein. Ein unbekannter Rest blockiert -auch neue Instanzen. Die laufende Providerinstanz bleibt nach einem unklaren -Clientpfad sticky gesperrt; keine neue UUID-Schleife. - -## Drahtvertrag und Qualität - -Primärquellen: Chrony [candm.h](https://github.com/mlichvar/chrony/blob/master/candm.h), -[pktlength.c](https://github.com/mlichvar/chrony/blob/master/pktlength.c), -[addressing.h](https://github.com/mlichvar/chrony/blob/master/addressing.h) und -[util.c](https://github.com/mlichvar/chrony/blob/master/util.c). - -Ein einzelner Unix-Datagrammaufruf verwendet Version6, Tracking-Befehl33, -Antworttyp5 und eine zufällige32-Bit-Sequenz. Request und erfolgreiche Antwort -sind jeweils104Bytes; das Requestpadding gehört dazu. Kein Retry, Shellaufruf, -CLI, UDP-/IP-Fallback, frei wählbarer Befehl oder Zeitsetter. `SO_PASSCRED` und -`recvmsg` verlangen genau eine unveränderte Kernel-Credential mit gepinnter -PID/UID/GID. Fremde Sequenz, fehlerhafte Status-/Headerfelder, abgeschnittene -Nutz- oder Kontrolldaten und fehlende Credentials verweigern. - -Die ursprünglich vorgesehene abstrakte Linux-Autobindadresse wird nicht -verwendet. Die Chrony-[Socketimplementierung](https://github.com/mlichvar/chrony/blob/master/socket.c) -behandelt Unix-Rückadressen als C-Strings und rekonstruiert sie mit `strlen`; -eine mit NUL beginnende abstrakte Clientadresse verliert dadurch ihren Namen. -Dieser reine Quellenbefund wurde auch in4.6.1 geprüft, nicht als reales -fehlgeschlagenes Runtimeexperiment ausgegeben. Die technische Entscheidung -des Hauptagenten erlaubt stattdessen den engen sichtbaren Clientbereich oben. - -Das Trackingalter wird aus Chronys tatsächlicher Referenzzeit berechnet, -nicht aus Abfragezeit oder Pollintervall. Unsynchronisiert, lokale Referenz/ -Refclock, Nullreferenz, Nicht-Netzwerkquelle, Loopback, ungültiger Stratum, -Leapstatus, Zukunftszeit oder ein Alter über1h verweigern. Die spezialisierte -Draht-Floatdarstellung wird als exakte ganzzahlige rationale Größe mit -Aufrundung nach Nanosekunden dekodiert, einschließlich negativer Korrektur; -negative Verzögerung/Dispersion oder Overflow verweigern. - -Vor und nach der Abfrage wird `adjtimex` ausschließlich mit modes0 abgefragt: -Status0–4, weder `STA_UNSYNC` noch `STA_CLOCKERR`, gültiger `maxerror`. -REALTIME, MONOTONIC und BOOTTIME werden zeitlich eingegrenzt beobachtet; -Bootwechsel, Rücksprung, Suspendabweichung, unpassende Wanduhrdifferenz und -überschrittenes Gesamtbudget verweigern. Eine Erfassung darf höchstens10ms, -das ist ausschließlich das gemessene Erfassungsfenster, keine Zusage -physikalischer Timerqualität oder Kalibrierung. Die gesamte Abfrage -einschließlich Auth-/Nachprüfung und Cleanup darf höchstens -100ms dauern. Fehlerobergrenze ist konservativ aufgerundet: -Betrag der Chrony-Korrektur + Rootdispersion + halbe Rootverzögerung + größter -Kernel-maxerror + vollständige verstrichene Abfrage-/Nachprüfzeit. Über500ms -verweigert. Nachlauf bis Signierung ist zusätzliche Brokerpflicht; es gibt -keine erfundene Timerkalibrierung und keinen Offline-Lease. - -## Tatsächlich lokal ausgeführt - -Im unveränderten Offline-Buildimage -`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`, -Quellmount read-only, UID1000, eigenes `devstate/provider-target`: - -- `cargo test --locked --offline -p rmm-time-source-linux --all-targets`: - 4bestanden,0fehlgeschlagen,0ignoriert,0gefiltert. Parserbindung und signed-Float- - Grenzen; synthetische Zeitbracket-Fehler; ausschließlich eigener temporärer - Socket mit echter Namenersetzung und genauem Inodecleanup. -- `cargo clippy --locked --offline -p rmm-time-source-linux --all-targets -- -D warnings`: - bestanden ohne Warnungsunterdrückung. -- Gezieltes `rustfmt --edition2024 --check --config skip_children=true` der - drei eigenen Rustdateien: bestanden. - -Der erste Compilerlauf meldete den konkreten `pread`-Offsettypkonflikt -`i64/isize`; er wurde explizit konvertiert und danach bestanden alle obigen -Prüfungen. Die Tests rufen weder den echten Chrony-Provider noch `adjtimex` -auf. Kein Rootlauf, keine Dienstinstallation, keine Server-/Clientwirkung. - -## Verbleibende reale Gates - -Unabhängiger Quellenreview, -Linux-first-Nachweis mit tatsächlichem Chrony-/Kernelzustand, geschützte -Provisionierung, Broker- und mTLS-HTTP-Anschluss sowie unabhängige Agent-/ -SYSTEM-Verifikation bleiben getrennt. Fehlende Plattformqualität bleibt deny. -WebUI-Genehmigung und sämtliche ursprünglichen Clock-/Jobgrenzen bleiben -bestehen. Auf dem Notebook wird kein RMM-Dienst oder Agent installiert. - - -## Unabhängiger Quellenreview und gezielter Parserfix - -Die enge unabhängige Prüfung korrigierte ausschließlich konkrete Fehlerpfade: -Chrony-Ownerausnahme nur am letzten `/run/chrony`-Verzeichnisteil, gebundene -Ancillary-Grenzen vor Credentiallesen sowie sticky Cleanupfence und exklusiver -Verzeichnislock/Leerverzeichnisprüfung. Keine unbekannten Namen automatisch -entfernen oder bei unklarem Cleanup neue UUID-Dateien anhäufen. - -Danach wurden zusätzlich IPv4-mapped und IPv4-compatible Loopback-/ -Unspecified-Adressen im IPv6-Feld verweigert. Der bestehende Parserfall prüft -vier Gegenfälle und zwei erlaubte Netzwerkdarstellungen; Testzahl bleibt4. -Neuer ReceiptSHA256 -`275e6661ad1342cf63df573cab4309ca49d1f7a1066ee2d03fdf686ac58370a6`; -lokale4/4,Clippy,Fmt und Release-Link bestanden. Originale4041333 bleibt -historisch unverändert. Kein nativer Provider-/Kernelquery durch diese Tests. -Der Quellenreview ist abgeschlossen; tatsächliche Providerqualität bleibt offen. - -## Getrennter tatsächlicher Kernelbefund auf dem Server - -Im nur lesenden Originalfall `09f56716-6175-41f6-8217-5de46854aaf1` wurde auf -dem festgelegten ARM64-Server genau eine Kernelabfrage mit modes0 ausgeführt. -Gemeldet: state0/flags0, kein STA_UNSYNC/STA_CLOCKERR, -maxerror55773us,esterror544us. Eigenes monotones Erfassungsfenster128082ns. -ResultatSHA256 -`5422ab7182fd7ff7896f56ce61ea3fe96e9b3a9ef236c39f74a6add8a538a61b`. -Keine Zeitstellung, kein Resync, keine Dienst-/Anwendungsänderung. - -Das ist ein einmaliger ABI-begrenzter LP64-Diagnosebefund. Er bildet mit dem -älteren separaten Chrony-CLI-Beleg keine neue gemeinsame native Qualitätsprobe. -Kein signierter Beleg oder freigegebenes Clockgate daraus. Der neue native -Provider muss diese Kernel- und Chronyprüfung selbst frisch zusammen ausführen. - - -## Tatsächlich nativ: vier Provider-Vertragsunits auf Cloud-Linux - -2026-11-15. Der neue unabhängig geprüfte Runner -`deploy/time_source_linux_acceptance.py`, SHA256 -`94f8b020780689dc002415b253fdffc67b6152175a039f5864f9afeb31a323c5`, -verwendet die sieben eingefrorenen Inputs des gezielten275e6661-Checkpoints. -InputmanifestSHA256 -`bec674868abb3de37310368c18259660c5fd073b806afa53e82aa21faca7d922`; -Releaseexe1169896Byte/SHA256 -`1e529e2a82ba845e3b0573e358461d5a7490ca8663df5534039eddb05a17e2d4`. - -Originalfall `fe3f5082-bc1d-4455-9fcf-9d35f6154756`: tatsächlich prepare, -einmal execute und separater read ausgeführt. **4/4,0ignored/filtered, Exit0** -auf der Cloud-Linux-VM als UID0; Rückabruf vollständig. Die gesamte native -Viererliste war vor Ausführung exakt gebunden. Bekannte drei RMM-Prozesse, -Kontrollbytes, Boot sowie Datenbank-/Lock-Dateiidentitäten blieben gleich. -Keine RMM-Jobs, Dienststeuerung oder Produktdateitausche. - -FallmanifestSHA256 -`f7b2415d8186c9d20786848adabb12a8cf8961c465edaccb1fbd216db4917c19`; -ExecuteSHA256 -`b740d465ca0c638d296480b213b43076f4a3aea6e74b23238f2c7ea3b4f5e91f`; -ReadbackSHA256 -`c0d44f80a606d620fb542befdd99b495e6ce3cc45d198694caf1ab423d9cf22d`. -Rohbelege und Originalquellen bleiben privat. Kein neuer gesamter Workspace- -nachweis: zusätzliche Broker-/HTTPänderungen sind getrennte Quellenstände. - -Die vier Units prüfen Parser-/Zeitbracketdaten und ausschließlich eigene -Socket-Fixtures einschließlich tatsächlicher Namenersetzung/FD-Cleanup. -**Kein NativeTimeSource::open/sample, kein echtes Chrony oder adjtimex in -diesem Lauf.** Der neue native OS-/Validatornachweis ersetzt nicht die offene -reale ARM64-Serverprobe mit provisioniertem Pin und frischer gemeinsamer -Chrony-/Kernelqualität. - -## Tatsächlich nativ: Socketberechtigungsfix auf Cloud-Linux - -2026-11-15, Originalfall `8ee39b4f-daed-4953-b90f-c04a7b2857c1`: -alle vier vollständig gelisteten Provider-Vertragsprüfungen auf der -tatsächlichen Cloud-Linux-VM als UID0 bestanden,0 fehlgeschlagen,0 ignoriert, -0 gefiltert. Separater Originalfall-Readback vollständig; bekannte Runtimezeugen -vorher/nachher/aktuell unverändert. Der bestehende Sockettest enthält jetzt -ausdrücklich0755 positiv sowie0775/0757 negativ. Root-/Daemonidentitäten, -gehaltene Verzeichnis-/Socketinodes, Singlelink und SCM-Credentials werden -nicht durch eine Berechtigungsausnahme ersetzt. Auf dem Server wurde keine -Chrony-Datei oder -Berechtigung geändert. - -Qualifizierte Nativequelle-SHA256 -`f1fede6a260c4f91c4bf647f2dcadb63520cdadff22c0130327ecd7cae57921b`. -Lokale eingefrorene Releasequalification7a8cb5be-41b3-400a-bd9b-b4b6f505a6e9, -Receipt-SHA256 -`74759e286ba7c9762fe4c455da952a0e62de48f55ea643e0a8f435d2128497a5`, -Sieben-Inputmanifest -`c0067889fa6e79e5b1dc2ad46685613fd0b379b30a4541670f635140405718d9`. -Diese Inputs enthalten auch die zum Freezezeitpunkt gesicherte Dokumentfassung; -nachfolgende Ergebnisdokumentation ist kein Compilerinput. ELF1169800Bytes, -SHA256 `9bd41ff166aeaae45fdf3dda2d72b04fc30e5ef87a181fe733c47e511a836d59`. -Neuer Operator `deploy/time_source_socket_linux_acceptance.py`, SHA256 -`eef43096cac8a83751f844d810b97a3f68025786ca64ff34f82be59280ca1aa8`. - -Der Lauf verwendet eigene Parser-/Clock-/Socketfixtures. Er öffnet keine -echte NativeTimeSource, fragt weder tatsächliches Chrony noch die Kernelzeit -ab und qualifiziert keinen signierten Zeitanker oder Windowsclock. Reale -Serverprobe und nachfolgender Broker-/mTLS-Roundtrip bleiben offene Schritte. - -Ausführungsreceipt-SHA256 `0decb992bfbfa88389da1949fddb491f2ec02a30abc9f4cce886d1f645768e07`. - -Separater Rückabruf-SHA256 `88728b6659d506ba96140dd1924a089969e63fcd6f6d308109c4603ec4043da8`. diff --git a/docs/signed-time-contract-results.md b/docs/signed-time-contract-results.md deleted file mode 100644 index ce52a85..0000000 --- a/docs/signed-time-contract-results.md +++ /dev/null @@ -1,149 +0,0 @@ -# Signierter Zeitvergleich: gemeinsamer Prüfkern nativ auf Linux - -2026-11-14, Spezifikation1.22. Neuer gemeinsamer Codec/Verifier implementiert; -noch kein vertrauenswürdiger produktiver Zeitadapter oder Windowsjobgate. - -`rmm-time-attestation` bindet kanonische JSONbytes mit eigener Ed25519-Domäne, -geschützte Schlüsselgeneration/Serverinstanz, vollständigen Requesthash, -Geräte-/Boot-/Verbindungs-/Rollenbezug und eine pro Verifier gehaltene aktuelle -Nonce. Challenges sind nicht klonbar und werden auch bei Fehler verbraucht. -Der Verifier misst nach Signaturprüfung erneut über den nativen Caller. -Ganze RTT, drei Capturebudgets und Serverfehler gehen konservativ in die -UTCspanne ein; Startfristen müssen deren beide Grenzen erfüllen. Keine neue -Jobautorität, kein Synclease, kein Holdover und keine Uhrstellung. - -Das unabhängige Review fand einen echten Replayfehler: Nach fremder -Fehlerantwort konnte ein alter eigener Challenge unter einem neuen offenen -Slot akzeptiert werden. Der Fix hält die exakte aktuelle Nonce zusätzlich zu -Verifier-ID/Epoch/Context; ein gezielter Gegenfall prüft die gesamte Sequenz. -Der erste lokale Signatur-Negativtest konnte durch Ersetzen mit00 zufällig -unverändert bleiben; jetzt verändert XOR1 garantiert ein Signaturbyte. -Diese ursprünglichen Fehler werden nicht als erfolgreiche Prüfungen geführt. - -## Tatsächliche lokale und native Prüfungen - -Lokal debug4/4, keine Skips/Filter. Finale eingefrorene Quelle separat Release -gebaut und gelinkt, Clippy-Dwarnings und Formatcheck bestanden, Offlinebuilder -9a76ad3744eb. Qualifikationsreceipt SHA256 -`a50017a1a80042351a639ab2fa8f813435d7d40bd236331dd34f075e98cd09eb`. -Ein vorheriger Qualifikationsfall stoppte korrekt an `--locked`, als parallel -nur die neue Windows-Abhängigkeitskante ergänzt worden war. Nach deren enger -Lockdateiergänzung entstand ein neuer, vollständig bestandener lokaler Fall. -Keine alten Belege ersetzt, keine Abhängigkeitsversion geändert. - -Vier eingefrorene Inputs: Workspace-/Crate-Manifeste, Cargo.lock und Codecquelle. -Inputmanifest SHA256 -`c01a21bfa09a77b7fa529b85931ac111d08f0dcce137e6aa86a9a22c2c35cf73`. -Releaseexe1515200Byte, SHA256 -`0e06243dc6d9d502681fb62f755bf5267140a483f89ae61cd6a2e31201a85a13`. -Nur der gemeinsame Prüfkern, keine übrigen Workspacequellen qualifiziert. - -Der unabhängig geprüfte neue Runner -`deploy/time_attestation_linux_acceptance.py`, SHA256 -`7572171fee75b5e994253e8190871778e439f8575691256d644a405e23cdaac6`, -verlangt die exakte native Viererliste vor einem einzigen Lauf. Originalfall -`2b282376-5002-4a75-91e2-8928fa8688cd` auf der Cloud-Linux-VM: -**4/4,0ignored/filtered, Exit0**, separater lesender Rückabruf vollständig. - -Tatsächlich ausgeführte Originalbefehle: - -```sh -python3 deploy/time_attestation_linux_acceptance.py prepare -python3 deploy/time_attestation_linux_acceptance.py execute --case 2b282376-5002-4a75-91e2-8928fa8688cd -python3 deploy/time_attestation_linux_acceptance.py read --case 2b282376-5002-4a75-91e2-8928fa8688cd -``` - -Fallmanifest SHA256 -`60d306685fa8b37217cd973aa5ff19b3a520aaab9154eb3e77cc1450f802212c`; -Execute-Beleg SHA256 -`282a597183ed02f4c767407aa7ed94975f8e3571d56eaa6835bb9bbe429e8fb0`; -Readback SHA256 -`1156610d7b41d92b3f55932d3b39547c2e0f24ee906edf00fd43860419e952b5`. -Bekannte drei RMM-Prozessgenerationen, Boot, vier Kontrollbytebelege und -DB-/Lock-Dateiidentitäten blieben vor/nach sowie beim Readback gleich. -APT inaktiv/disabled, Full aktiv/Autostart disabled. Keine Dienststeuerung, -Produktzeitabfrage, RMM-Jobs, Dateitausche oder vollständige SQL-/PKI-Abnahme. -Die Tests erzeugen nur kurzlebige In-Memory-Signierschlüssel/Codecfixtures. - -## Offene Integration - -Der native Beleg prüft Codecbytes und Validatoren, keine Server-/Windows- -Zeitqualität oder komplette Runtime. Geschützte Pinprovisionierung, tatsächliche -Chrony-/Kernelquelle samt lokalem Signierbroker, mTLS-/SQL-Kontextprüfung, -unabhängiger Windows-Agent/SYSTEM-Timerbeleg und Jobintegration bleiben offen. -Der erste Codec bindet noch den provisorischen Audiencepfad -`/api/agent/v1/time-attestation`; die nachfolgende Korrektur an den -bestehenden `/agent/v1/...`-Vertrag ist unten mit eigenem Beleg dokumentiert. Keine zusätzliche öffentliche API-Wildcard vorsehen und den -ursprünglichen nativen Beleg dabei nicht nachträglich umetikettieren. - -Die unverbundene Windows-Slice-/Providerentwicklung parallel dazu eröffnet -keine Capability. Das Windows-MVP und der Selbstupdater sind nicht abgeschlossen. - - -## Nachfolgender Quellenstand: tatsächlicher Agent-Endpunkt - -Der feste Audiencepfad ist jetzt `/agent/v1/time-attestation`, passend zum -bestehenden Agentvertrag. Genau eine Codec-Konstante geändert; keine neue -öffentliche API-Wildcard oder geänderte Verifikationsregel. Der erste -Originalfall2b282376 bleibt unverändert und qualifiziert weiterhin seine alten -Bytes, nicht diese nachfolgende Generation. - -Neuer unabhängiger Runnerreview und eingefrorene lokale Release4/4, Clippy und -Fmt bestanden. ReceiptSHA256 -`b708000c9ca9ba8da2128003683ed26382d4349833c322663bdd393dd60ad751`, -InputmanifestSHA256 -`989bcd56c96747ce8f2c4020423360ce4a8c9d8057f7c3deccba4e44fbc30c9a`. -Neue Releaseexe1515168Byte/SHA256 -`4dc10170500912c703f815f8c13f9ac28715afe919ad94020fe713ade8fbafdb`. - -`deploy/time_attestation_uri_linux_acceptance.py` SHA256 -`b156729ef7e8bf4b19f6f95be87b4b3be2145dad820146d1d935191484386898` -verwendet eigene Fall-/Remote-/Profilnamen und denselben begrenzten -Einmal-/Readback-/Erhaltungsvertrag. Tatsächlich prepare, genau ein execute -und separater read mit Originalfall `a22de8d2-7cf7-4820-affa-79b4792132d1` -ausgeführt: **Cloud-Linux4/4,0ignored/filtered, Exit0**, Readback vollständig. -Bekannte Prozess-/Kontroll-/Stateidentitätszeugen erneut unverändert. -FallmanifestSHA256 -`c20c8ce40ea3fa55ec6db4aa5614a15ca63ded88b913835e2c29f78ae1eb3fcb`; -ExecuteSHA256 -`d2340962c7b1a56aa6d51d81eb7b2259ea2dcab80d0c9a1d251e8c5cbd23cf0e`; -ReadbackSHA256 -`2b5c4a428fab45f5f1e865dbb00bbacce2f0e86128134f31f6c3e9d3f4c3caf2`. - -Keine reale Zeitqualifikation oder Windowsfähigkeit daraus ableiten. Die -parallel hinzugefügte Linux-Providercrate ist separat lokal4/4 geprüft, -noch nicht nativ abgefragt; ihr Code wird durch diesen Codecbeleg nicht -mitqualifiziert. [Providerstand](server-time-source.md). - -## Kurz gehaltene Evidenz: tatsächlich sechs Linux-VM-Prüfungen - -2026-11-15: Originalfall `44514778-8617-4e60-a5da-46750f15ce51` -führte auf der tatsächlichen Cloud-Linux-VM als UID0 alle sechs gelisteten -Codecprüfungen aus:6 bestanden,0 fehlgeschlagen,0 ignoriert,0 gefiltert. -Der separate Originalfall-Readback war vollständig und bestätigte die -unveränderten bekannten Prozess-/Datei-/Dienstzeugen. Keine Dienststeuerung, -Uhrstellung, RMM-Jobs, Grants oder Runtimeaktivierung. - -Geprüfter Codec-SHA256 -`38009d0393c64d3c9b8db6154210e02cbf349d1a67b25ef2cc58c05f926b2346`; -Operator `deploy/time_evidence_linux_acceptance.py`, SHA256 -`4234214fa72cccb47c41db856b2218708e9f23a9cfe3880ec6d87129705ef398`. -Gefrorene Quellenqualification-Receipt -`4a3aad94ccf26e1b40fb08ef77d92bfd6cbe30d70827ce3af42b535c9744dd85`, -190-Inputmanifest -`60bab3aeaa3ff65f6046af73645c2bc6736ff946bb88d579622c24aa9ca4c6a5`. -Tatsächlich ausgeführtes ELF1543576Bytes, SHA256 -`0eb40face421325822887b2104fe82bd4050621e9c792e1b1d5751547e77208b`. - -Die zwei hinzugekommenen Vertragsprüfungen belegen: gehaltene Evidenz -verlängert ihre ursprünglichen Zeitgrenzen nicht, ihr Ablauf verbraucht nicht -die bereits ausstehende neue Refreshnonce; Evidenz ist an Verifier, Epoche -und beobachtete Kontinuität gebunden. Die vier bisherigen Signatur-/Nonce-/ -Intervallfehlerprüfungen liefen ebenfalls. Es handelt sich um native -Vertragsfixtures, nicht um echte Windows-Kernelcaptures oder einen realen -Chrony-/Broker-/mTLS-Roundtrip. Der getrennte Windowsadapter befindet sich -noch in Quellenqualifikation; Windows-Jobs bleiben gesperrt. - -Native Ausführungsreceipt-SHA256 `3df70a8451fdbde8e355d353fe1f0318e7707006830322d0caf400550fcaa72e`. - -Separater Readback-SHA256 `7b95f6dff1b2aeb20c63e3c61b9594ee5eba88266dc118d7628eca4496d6cdc3`. diff --git a/docs/time-attestation-freshness-results.md b/docs/time-attestation-freshness-results.md deleted file mode 100644 index a192686..0000000 --- a/docs/time-attestation-freshness-results.md +++ /dev/null @@ -1,40 +0,0 @@ -# Signierter Zeitvergleich: konservative Frischegrenzen - -Stand2026-11-15: enger Quellfix und lokale Qualifikation abgeschlossen; tatsächlicher Cloud-Linux-Nachweis und neuer Windows-Kandidatenlink folgen separat durch Root. Keine Kalibrierungswerte, Schlüssel oder Zielkonfiguration wurden erzeugt. Die ursprüngliche [Kalibrierungsbewertung](windows-signed-clock-calibration-assessment.md) bleibt unverändert erhalten; ihr zusätzlicher Frischebefund wird durch diesen neuen Schnitt behoben. Die fehlende tatsächliche Plattformqualifikation bleibt offen. - -`Verifier::evidence_interval` prüft die Frische nun unter Einbezug derselben bereits vorhandenen qualifizierten Capture-/Timerunsicherheit, die auch die UTC-Obergrenze verwendet. Es gilt weiterhin `delta = error_begin + error_receive + error_check <= 50ms`. Neu müssen `elapsed + delta <= 1s` und `age + delta <= 100ms` sein; ganzzahlige Additionen sind überlaufgeprüft. Für das Empfangsalter ist der Beginnfehler bewusst zusätzlich mitgezählt. Diese Überzählung ist konservativ und verhindert eine neue nicht belegte feinere Fehlerallokation. Server-U und Quellalter verwenden weiterhin nur `elapsed + delta`, keine doppelte Addition. Ein Belegrefresh oder eine spätere Nutzung verlängert keine Grenze. - -Zwei neue Boundarytests verwenden bewusst ungleiche **Fixturewerte** von7/11/13ms (Summe31ms), keine Messungen oder installierbaren Kalibrierungen. Erstverifikation und spätere Eigennutzung akzeptieren die jeweils exakt erreichte obere Frischegrenze und verweigern einen weiteren Nanosekundenwert, obwohl die rohe Timerdifferenz noch innerhalb der bisherigen nominalen Grenze läge. Die bestehende Sequenz für gehaltene Evidenz, offenen Folgechallenge und fehlende Verlängerung wurde an dieselbe konservative Grenze angepasst. Originalrequest, Codec-/Signaturdomäne, Wirebytes, Schlüsselrollen und unabhängige Signaturprüfung bleiben unverändert. - -Tatsächlicher lokaler Fall `freshness-qualification-af7a9fb3-0460-4ddc-b682-39931accd249`: vollständige202 Compilerinputs, Manifest-SHA256 `e85271e4ec92b8fe05ebdf779206214366ac0e25f8083a4bb13bdd5828c3daa2`; Codecquelle `807cac064b00760d9131dc2a44d01ad9770a3660f4acd5f8d2948bb0f9234d08`. Offline-Docker ohne Netzwerk, Quellen nur lesbar und eigene private Buildausgaben. Rustfmt, Crate-Alltargets-Clippy mit `-D warnings` und Linux-Release-Link PASS. Alle acht vorhandenen/neuen Codec-Guards tatsächlich lokal PASS:0failed/ignored/filtered. - -Der erste Compilerlauf dieses Falles scheiterte an verlorenen Ausführungsrechten kopierter Cache-Buildskripte. Der originale Fehlerlog und Exit101 sind erhalten. Nach Wiederherstellung ausschließlich der ursprünglichen Execbits im eigenen neuen Cache wurden dieselben eingefrorenen Quellen erfolgreich separat geprüft. Kein Sourcefehler unterdrückt und kein historischer Beleg umgedeutet. - -Standalone-ELF `freshness-contract-tests`,1554688Bytes, SHA256 `8c1b47a892d8e0afe8d8cd47cfcbd150240fe771be13e990f8bbe161d18f5e21`, Modus0500 und genau ein Hardlink. Receipt-SHA256 `6a624ee9b795ce67d80a91536ba242835be9757a2f502d2d9fbc545532e1b560`. Vollständige Liste und Logs liegen im privaten Fall. **Geplant, nicht ausgeführt:** unabhängiger Quellreview, tatsächliche Cloud-Linux-Ausführung und separater Originalfall-Lesebeleg, danach neuer Windows-Paarlink mit diesem Codec. Die früheren Windowskandidaten `e7ba…`/`e71b…` enthalten diesen Fix noch nicht und werden nicht als aktueller Fixkandidat ausgegeben. - -## Neuer vorbereiteter Native-Runner und Windowslink - -`deploy/time_freshness_linux_acceptance.py` (SHA256 `276b86c5ae19d5acfa4ff9f6b80534cdf05afcec9b126a5c14d9037f4386861e`) bindet den aktuellen achtteiligen Codec-Testlauf an exakt diesen202-Input-Freeze, Receipt und ELF. Alle acht vollständigen Namen müssen vor Ausführung passen; keine Filter oder Skips. Der vorbereitete lokale Fall ist `4072ed8d-c157-460c-bc3b-cb31ddb1a1b8`, Manifest `c02e7c645cf5eaf9bff8146b94e94fd4cb925e3e996310495a80ec4b0972092c`. Python-AST, lokale Vorbereitung und erneute Fallvalidierung PASS. Die bestehenden tatsächlichen Linuxruntime-Witnesses und der auf die eigene Prozessgruppe begrenzte Runner wurden bytegleich aus dem vorherigen Evidence-Operator übernommen. Noch keine Zielausführung durch diesen Agenten; nach verlorener Antwort ausschließlich Originalfall lesen. - -Danach tatsächlich separat gebaut: Windows-GNU-Releasepaar aus demselben unveränderten202-Input-Freeze, Fall `freshness-candidate-link-917425d6-412b-4f70-a7db-bc02de6b9b2a`. Link Exit0 (16.86s), Netzwerk aus, Quellen nur lesbar, keine Credentials-Mounts; ausschließlich die beiden Produktbinärdateien. Alle Quellen vorher/nachher gehasht identisch. Neuer Receipt `2abf7fe56633e68864469de2ff9ded21888301bdc737e53211d024cfd044e22e`; Buildlog `416834c6ac9abbfba4ea13cbb86ab78bbf078eabc15512bcae3825816ee58e09`. - -| Neuer Kandidat | Bytes | SHA256 | -| --- | ---: | --- | -| Agent | 22244878 | `751657ee873c4f4d013abc4ea6daaa4641fea2fe55838fb1c701e6a71b57c192` | -| SYSTEM-Helper | 13055259 | `acf1e3f3b1609a97e0d5e88a43a421bed530a09a236bfc0dec1b1abbb22d4413` | - -Beide Übergabedateien sind AMD64-PEs, Modus0500, jeweils genau ein Hardlink. Das frühere Kandidatenpaar bleibt unverändert erhalten. Kein VM-Deploy, keine Änderung vorhandener Indizes, PKI, DB-/Lockdateien oder Konfiguration und keine Clockgateaktivierung. Der neue Cross-Link ersetzt weder die tatsächliche Linux-First-Ausführung noch die native Windowsabnahme und liefert keine Kalibrierung. - -## Tatsächlich auf der Cloud-Linux-VM bestanden - -Originalfall `4072ed8d-c157-460c-bc3b-cb31ddb1a1b8`: vollständige acht -Testnamen vor Ausführung geprüft, anschließend8PASS/0failed/ignored/filtered -als UID0. Execute-Receipt -`4e17db56039e45657b145c91b951f81c5a2327af7bc2754369e5be2b69cce943`. -Der separate lesende Originalrückabruf bestätigte das gebundene Ergebnis und -die unveränderten aktuellen Cloud-Runtimezeugen; Readreceipt -`8c885f79986b6046d2dfce08984b1eaae3716880fc03726eaa6aeb84ba5795fb`. -Unabhängiger Quellenreview ebenfalls ohne konkreten Blocker abgeschlossen. -Keine RMM-Aufträge, Servicekontrolle, Schlüssel-/Policyänderungen oder echte -Server-/Windows-Zeitbereitschaft daraus ableiten. Plattformkalibrierung und -tatsächlicher signierter Austausch bleiben zusätzlich offen. diff --git a/docs/tls-expiry-acceptance.md b/docs/tls-expiry-acceptance.md deleted file mode 100644 index d388659..0000000 --- a/docs/tls-expiry-acceptance.md +++ /dev/null @@ -1,69 +0,0 @@ -# Abgelaufenes Gerätezertifikat: native Cloud-Abnahme - -**Bestanden am 2026-11-13.** Ergänzung der Linux-M1-/AT-03-Nachweise um ein -tatsächlich abgelaufenes Clientzertifikat. Dies erklärt ausschließlich diesen -Prüfschritt für bestanden; die übrige MVP-Abnahme bleibt getrennt. - -Ausgeführt: `PYTHONDONTWRITEBYTECODE=1 python3 deploy/cloud_tls_expiry_acceptance.py`. -Laufkennung: `33ddd365-fece-4be4-a3f4-67a9517da69d`. - -Auf der erlaubten Cloud-Linux-VM wurde ein eigener P-256-Fixtureschlüssel erzeugt. -Er blieb dort im privaten Lifecycle-Verzeichnis. Auf dem festgelegten Cloudserver -signierte die vorhandene vertrauenswürdige CA zwei Clientzertifikate zum selben -öffentlichen Schlüssel, Subject und Clientprofil. Ein eigener Fixture-Index samt -Seriennummern wurde benutzt; bestehende CA und CA-Schlüssel blieben unverändert. -Kein Enrollment, keine Geräteinstallation oder Registrierung und kein Job -entstanden. Der Test ersetzte keine dauerhafte Geräteidentität. - -Das Tool verweigert Fixture-Vorbereitung und CA-Nutzung außerhalb des tatsächlichen -Gateway-Profils `RMM_PROFILE=development` mit `RMM_DEV_AUTH=true`. Dafür liest es -ausschließlich diese beiden nicht geheimen Runtime-Schlüssel. Diese zusätzliche -Schutzprüfung wurde anschließend am bestehenden Lauf rein lesend ausgeführt und -bestand; erneut **0/0/0/0**, keine erneute Ausstellung oder TLS-Testverbindung. - -Die tatsächlichen Zertifikatsfenster lagen innerhalb der bestehenden CA-Gültigkeit. -Beide Blätter begannen am **2026-11-13 17:28:45 UTC**. Das negative Blatt endete -bereits um **17:37:45 UTC**, die gültige Kontrolle um **17:53:45 UTC**. -OpenSSL prüfte die gültige Kette erfolgreich und meldete beim negativen Blatt -den Ablauf des Leaf-Zertifikats, Fehlercode **10**. Weder Systemuhr noch -TLS-Zeitprüfung wurden verändert. - -Der native TLS-Client lief auf derselben Cloud-VM als **UID 993**. Er verwendete -die vertrauenswürdige CA und den tatsächlichen Servernamen -`discovery.ease-technologies.de` mit normaler Hostnamenprüfung. Drei Verbindungen -lieferten diese Ergebnisse: - -| Reihenfolge | Clientzertifikat | Tatsächliches Ergebnis | -|---|---|---| -| 1 | Gültige, nicht registrierte Kontrolle | TLS akzeptiert, danach HTTP **401** wegen fehlender Anwendungsbindung | -| 2 | Abgelaufenes Blatt | Server-TLS-Alert **`SSLV3_ALERT_CERTIFICATE_EXPIRED`**, keine HTTP-Antwort | -| 3 | Dieselbe gültige Kontrolle | Erneut TLS akzeptiert, danach HTTP **401** | - -Beide positiven Kontrollen beobachteten denselben tatsächlichen -Serverzertifikatsfingerprint. Die negative Verbindung scheiterte damit bereits -an TLS und erreichte keine Anwendungsbindung. Keine Zertifikatsprüfung wurde -deaktiviert oder durch einen Test-Override ersetzt. - -Vor und nach dem Test waren für die Fixture **0 Registrierungen / 0 Jobs / -0 Outbox-Einträge / 0 Grants** vorhanden. Hashes und Inodes der dauerhaften -Geräteidentität und des aktuellen Zertifikatsselectors blieben gleich. Es gab -keinen Neustart des dauerhaften Agenten oder Helpers, keine Provideroperation -und keine Paketwirkung. Es blieb kein laufender Testdienst zurück. - -Geschützte lokale Nachweise liegen unter -`devstate/cloud-lifecycle/expiry-33ddd365-fece-4be4-a3f4-67a9517da69d/`: - -- `gate-before.json` und `gate-after.json`: unveränderte Nullzählungen. -- `prepared.json`: öffentliche CSR und Zeugen der dauerhaften Identität. -- `signed-public-fixtures.json`: öffentliche Testzertifikate, Gültigkeitsfenster - und CA-/Profilprüfungen. -- `native-result.json`: beide HTTP-401-Kontrollen, tatsächlicher TLS-Alert, - UID und Identitätserhalt. -- `development-gate-verified.json`: zusätzlicher rein lesender Nachweis des - tatsächlichen Development-Profils und unveränderter Nullzählungen. - -Verzeichnis **0700**, Dateien **0600**; über `devstate/` vom Git ausgeschlossen. -Private Schlüssel wurden weder in diese lokalen Berichte noch in Git übertragen. -Die vorherige native Abnahme von CA-/Namensfehlern, Rotation und tatsächlichem -WebUI-Widerruf bleibt unter -[`implementation-status.md`](implementation-status.md) dokumentiert. diff --git a/docs/transport-acceptance.md b/docs/transport-acceptance.md deleted file mode 100644 index 9206c79..0000000 --- a/docs/transport-acceptance.md +++ /dev/null @@ -1,94 +0,0 @@ -# Tatsächlicher automatischer WSS-/HTTPS-Fallback - -Stand 2026-11-13. **Tatsächlicher passiver Cloudnachweis bestanden**, einschließlich -ergänzender Verifikation desselben Falls nach einer unten offengelegten -Auswertungskorrektur. Ein ausdrücklich gewählter HTTPS-Modus und ein -WSS-Reconnect allein ersetzen diesen Nachweis nicht. - -Der minimale Entwicklungsadapter sitzt nach gültigem mTLS-Peer, Ablaufprüfung -und autoritativer Gerätebindung im WSS-Connectpfad, noch vor dem Upgrade. -Nur das konfigurierte Tenant-/Agentpaar erhält HTTP 503. HTTPS bleibt normal; -es entstehen keine JobOffers, Grants oder Genehmigungen. - -Aktivierung ausschließlich mit `RMM_DEV_TRANSPORT_FAULTS=true`, -`RMM_DEV_TRANSPORT_FAULT_FILE=/root-policy/transport-fault.json`, -`RMM_PROFILE=development` und `RMM_DEV_AUTH=true`. Standardmäßig deaktiviert; -Produktionsaktivierung und mehrdeutige Konfiguration verweigern den Start. -Datei/Verzeichnis im bestehenden read-only Rootpolicy-Mount müssen UID 10001, -Modi 0600/0700 und sichere reguläre Inodes besitzen. Striktes Konfigurationsschema: -Version 1, neue Fault-UUID, exakte Tenant-/Agent-UUIDs, `issued_at` und -`expires_at` mit höchstens 15 Minuten. Kein öffentlicher Faultendpunkt. - -Zwei begrenzte append-only Audit-Slots erfassen tatsächliche authentisierte -Handshakeabweisungen: Peerzertifikatfingerprint, unterschiedliche Handshake-IDs, -Status 503, Zeit sowie exakte Fault-/Scope-/Konfigurationsbindung. Nach zwei -Slots bleibt die Abweisung bis Ablauf aktiv, ohne weiteren Auditbestand -anzuhäufen. Bestehende Slots dürfen nicht mit anderer Konfiguration wieder- -verwendet werden. Keine Job-/Outbox-/Grantänderung und keine neue Migration. - -Tatsächlich lokal bestanden: drei gezielte Guards für explizites Opt-in, -Produktionsverweigerung, exakten Scope, Fristen und stabile begrenzte Audit-Slots; -Server-Clippy aller Targets mit `-D warnings`; Syntaxprüfung des Cloudrunners. - -`deploy/cloud_transport_acceptance.py` wurde tatsächlich für diesen Fall -ausgeführt; nach der Auswertungskorrektur wurde kein weiterer Fault aktiviert: - -1. Nur permanente Cloud-VM und `discovery.ease-technologies.de`; keine offenen - Wirkungen. Bekannte Agent-/Compose-/vorherige Konfigurationshashes prüfen. -2. Den erhaltenen Agenten im tatsächlichen Automatikmodus prüfen; ausschließlich - einen bekannten alten Transport-Testoverride bei Bedarf versioniert entfernen. - Standard-WSS, Heartbeat und signierten Sync bestätigen. -3. Den begrenzten privaten Hook aktivieren. Der normale ausgehende Agent muss - zweimal an authentisiertem WSS scheitern und selbstständig auf HTTPS wechseln. - Zwei echte Peer-Auditbelege sowie anschließend gespeicherten frischen - **HTTPS-Heartbeat** und `sync_ready` nachweisen. Kein TLS-Bypass. -4. Im `finally`-Pfad Hook deaktivieren, tatsächlich laufende Serverrollen ohne - aktiven Flag/FILE prüfen und nach kontrolliertem, identitätserhaltendem - Agentneustart normalen WSS-Heartbeat samt Sync wiederherstellen. - Keine geänderte Geräteidentität, keine neuen Jobs/Outbox/Grants. Auch bei einer - verlorenen SSH-Antwort akzeptiert Cleanup ausschließlich vorher bekannte alte - oder vorgesehene neue Hashes, keinen ungeprüften Hostzustand. - -## Tatsächlicher Cloudfall - -Fall-ID `697b19ba-e7ff-4ebf-8a45-f5a0b0514fea`, permanente Ubuntu-Cloud-VM gegen -`discovery.ease-technologies.de`, tatsächlich geprüfter Automatikmodus. - -| Tatsächlicher Beleg | Ergebnis / UTC am 2026-11-13 | -| --- | --- | -| Authentisierte WSS-Abweisung 1 | HTTP 503 um 18:21:21.708609 | -| Authentisierte WSS-Abweisung 2 | HTTP 503 um 18:21:21.737690; andere tatsächliche Handshake-ID | -| HTTPS nach beiden Abweisungen | Tatsächlicher Heartbeat und signierter Sync bereits um 18:21:22.070325 beobachtet; erhaltene ergänzende HTTPS-Aufnahme Generation 78, Heartbeat 18:23:28.546877, `sync_ready=true` | -| Hook deaktiviert | Tatsächlich laufende API/Gatewayrollen jeweils Flag `false`, FILE fehlt | -| Operative WSS-Wiederherstellung | Nach kontrolliertem Agentneustart im Automatikmodus Generation 79, Heartbeat 18:24:41.316642, signierter Sync bereit | -| Historie / Ausführungsgrenze | Vorher und nachher unverändert **19 Jobs / 19 Outbox / 17 Grants / 0 offen**; kein neuer RMM-Job oder Antrag | -| Gerätebindung | Gleiche Agent-/Asset-IDs, Enrollmentgeneration und Zuordnungsversion; beide Faultbelege mit demselben tatsächlichen Peerzertifikatfingerprint | - -Der ursprüngliche Runner meldete nach tatsächlichem Fallback `KeyError`, weil -die private Bootstrap-DTO nur Agent-/Asset-IDs enthält, die Auswertung aber -zusätzliche Generation-/Zuordnungsfelder dort voraussetzte. Diese Felder werden -nun gegen den tatsächlich gespeicherten initialen Serverkanal verglichen. -Der Fehler blieb im ursprünglichen Checkpoint erhalten. Die ergänzende -Verifikation las denselben Auditfall und den tatsächlichen HTTPS-Kanal; keine -neue Fault-ID und keine Wiederholung der beiden Abweisungen. - -Außerdem bleibt ein bestehender HTTPS-Aktor gegebenenfalls auf HTTPS, nachdem -der Hook entfernt wurde. `auto` wählt beim Verbinden; eine selbstständige Rückkehr -zu WSS wird hier **nicht behauptet**. Bei weiterhin null offenen Wirkungen wurde -der erhaltene Agent kontrolliert neu gestartet und dessen normale WSS-Verbindung -erneut nachgewiesen. Der korrigierte Runner führt diesen Schritt ausdrücklich -im Cleanup aus. Weder Geräteidentität, Journale, Helper/Provider noch Artefakte -wurden ausgetauscht. - -Geschützte tatsächliche Belege: -`devstate/cloud-transport/697b19ba-e7ff-4ebf-8a45-f5a0b0514fea/` mit ursprünglichem -`checkpoint.json`, `passive-before-wss-restoration.json`, -`preserving-auto-restart.json` und abschließend geprüftem `completion.json`. -Die ergänzende Prüfung bestätigte sämtliche oben genannten Bindungen und -unveränderten Ausführungszähler. Der korrigierte vollständige Runner wurde -nicht als zweiter Faultlauf ausgeführt. - -Diese passive Transportabnahme benötigt keine Jobgenehmigung. Sie darf keine -laufenden RMM-Wirkungen oder einen anderen VM-/Deploymenttest unterbrechen. -Der Fall ist kein TLS-Negativ-, Widerrufs-, Paket- oder Produktionsnachweis und -schließt die übrigen MVP-Gates nicht ab. diff --git a/docs/updater-compatible-linux-contracts.md b/docs/updater-compatible-linux-contracts.md deleted file mode 100644 index fda4f84..0000000 --- a/docs/updater-compatible-linux-contracts.md +++ /dev/null @@ -1,28 +0,0 @@ -# Kompatible Updaterverträge: tatsächliche Linux-VM-Prüfung - -Am 16. November 2026 wurden auf der vorgesehenen Cloud-Linux-Test-VM -alle 18 vorgesehenen gezielten Prüfungen der kompatiblen Updaterquelle erfolgreich ausgeführt: -eine Prüfung der tatsächlich gelieferten sieben systemd-Statusfelder, elf -reine Handoff-Vertragsprüfungen und sechs gezielte Sync-/ACK-/SQLiteprüfungen. Die unveränderten Testprogramme liefen als -UID 65534, mit NoNewPrivileges und isoliertem Netzwerk. Kein RMM-Dienst wurde -dafür verändert und kein Updateauftrag ausgeführt. - -Die Handoffprüfungen decken den festen Linux-Dreidienstsatz, die vollständige -Windows-Fünfdatei-/Zeitprofilfolge, unveränderte Plan-/Versuchs-/Eigentümer- -und Fristbindungen, Health-Domänenbindung sowie die Weigerung vorzeitiger -Besitzübernahme und partieller Dateipaare ab. Sie sind ein tatsächlicher -VM-Nachweis des gemeinsamen Vertrags, **kein** Nachweis einer nativen -Windows-Dateiumstellung oder eines vollständigen Linux-Selbstupdates. - -[Exakte Testnamen, Binärhashes und Originalresultate](evidence/compatible-updater-linux-contracts-20261116.json). -Die spätere Installation der kompatiblen Linux-Paarung, ein tatsächlich -WebUI-genehmigter UpdateAgent-Auftrag und der kontrollierte Rückfall nach -bekanntem ersten Helperstartfehler bleiben eigenständige Abnahmeschritte. - -Die sechs ergänzenden gezielten Läufe prüfen die originale Applyfrist bis zur -Nanosekunde, die Unterscheidung zwischen Handoffannahme und Ergebnis, den -atomaren Verbrauch mit Stopintent, weiterhin geschlossene Starts während des -Updates, die Bindung eines nativen Stopintents an den ursprünglichen Head und -den Wiederanlauf ausschließlich aus dem verifizierten Original. Jeder dieser -Läufe bestand einzeln auf der Cloud-VM; die SQLitefälle verwenden ausschließlich -eigene temporäre Fixtures, keine vorhandenen Produktdatenbanken. diff --git a/docs/updater-original-time-generation.md b/docs/updater-original-time-generation.md deleted file mode 100644 index e78c725..0000000 --- a/docs/updater-original-time-generation.md +++ /dev/null @@ -1,97 +0,0 @@ -# Signierter Zeitvergleich des ursprünglichen Windows-Updaters - -Quellenstand 16. November 2026. Dies ist ein implementierter und lokal geprüfter -Vertrag, noch kein bereitgestellter Serverpfad und kein realer Updateerfolg. -Der stabile Updater behält seine ursprüngliche Verbindungsgeneration und -Prozessidentität. Der neue Agent erhöht beim regulären ClientHello die aktuelle -Servergeneration. Damit konnte der bisherige Zeitendpunkt einen weiterhin an -denselben Originalauftrag gebundenen Updater nicht mehr bedienen. - -## Enge Ausnahme für Zeitevidenz - -Der vorhandene aktuelle Identitätsvergleich bleibt für Tenant, Asset, Agent, -Enrollment, Assignment, Windows-Boot und Windows-Capability erhalten. Nur -`role=updater`, `binding_schema=2`, ohne Helperimage und mit genau dem im -Originalauftrag gespeicherten stabilen Updaterimage darf eine kleinere -ursprüngliche Generation benutzen. Agent und SYSTEM-Helper müssen weiterhin -die aktuelle Generation nennen. Zukunftsgeneration, anderer Boot, andere -Images, Sequenzrückgang und Sync-Recovery verweigern die Ausnahme. - -Der Server verlangt unter dem bestehenden Agent-Control-Lock genau einen -laufenden/verifizierenden ursprünglichen SYSTEM-Updateauftrag: unveränderte -Jobbytes und Hash, genehmigter unveränderlicher Plan, nicht widerrufene -Authorization, signierter ursprünglicher Grant, reservierter Start sowie weder -Cancel noch Ergebnis. Beide vorhandenen Planakteure benötigen weiterhin -`updates:apply` und `system:execute`; ihre Mitgliedschaften und die relevanten -Job-/Authorizationzeilen werden bis zum Abschluss des Zeitaufrufs lesend -gehalten. Die Zeitantwort erzeugt keine Genehmigung, Ready-Lease oder Wirkung. - -Ein bereits gespeicherter signierter Sync-Entscheid enthält Handoff-/Delegation- -und Head-Hashes, Ownernonce und Originalfrist, jedoch nicht den ursprünglichen -Header oder dessen Generation. Deshalb darf der Zeitpfad diese Daten nicht aus -einem alten Grantzeitpunkt oder irgendeinem historischen Ready-Entscheid raten. -Die bestehende vollständig verifizierende UpdateInflight-Syncstrecke speichert -nun **innerhalb derselben ursprünglichen Transaktion** genau einmal einen -zusätzlichen Auditdatensatz `agent_update_original_context` mit den kanonischen -öffentlichen Handoff-/Delegationbytes und Hashes. Unter demselben Grant sind -andere Bytes oder mehrere Datensätze ein Fehler. Keine Migration, kein neuer -Policy-Wireparameter und keine neue private Schlüsseldatei entstehen daraus. - -Die Ausnahme vergleicht diesen Originalbeleg mit dem **aktuell autoritativen** -gespeicherten und erneut signaturgeprüften Sync-Entscheid, dessen einzigem -passenden negativen UpdateInflight-Acknowledgement und dem Originalplan/-grant. -Header, Job, Versuch, Grant, Authorization, Plan, Boot, ursprüngliche Generation, -Ownernonce, Updaterimage und feste Frist müssen übereinstimmen. Ohne solchen -aktuellen Beleg keine Suche nach einem älteren passenden Entscheid und keine -Ersatzfrist. Die Frist bleibt exakt `consumed_at + 600`; ein Überschreiten -während des Brokeraufrufs verwirft dessen Antwort. Ein historisch verifizierter -Syncbeleg erneuert dabei keine abgelaufene Sync-Lease. Er bindet ausschließlich -die weiterhin laufende Originaloperation für diesen separaten Zeitvergleich. -Unknown, neuer Versuch oder Wiederaufnahme werden nicht autorisiert. - -Dies ist weiterhin mTLS-/signierte Protokollevidenz, keine serverseitige -OS-Prozessattestierung. Der tatsächliche Updater muss unabhängig seinen -gehaltenen Originalprozess, unveränderte geschützte lokale Policy und eigenen -Uhrkontext prüfen. Agent-/Helperzeitprofile werden dadurch nicht ersetzt. - -## Erster Beleg vor jedem Stop - -Vor dem ersten Stop muss der Server den Originalkontext bereits behalten und -der tatsächlich ursprüngliche Helper dessen signiertes UpdateInflight- -Acknowledgement bereits angewandt haben. Andernfalls würde der neue Agent die -Generation ändern, bevor ein ursprünglicher Abgleich belegbar ist. - -Die optionalen Felder `pre_stop_sync_request_base64url` und -`pre_stop_sync_response_base64url` im bestehenden `ReadOriginal` transportieren -nur diese tatsächlich behaltenen Rawbytes: ursprünglicher protobuf-SyncRequest -und vorhandenes JSON `SignedResponse`. Beide fehlen gemeinsam, solange noch kein -passender tatsächlich angewandter Beleg existiert. Andere Methoden dürfen diese -Felder nicht verwenden. Fehlende Felder behalten die bisherigen Wirebytes bei. - -Die Linux-Fullstrecke liest den aktuellen angewandten Entscheid aus dem -Originalledger, prüft die vorhandene originale Applyquittung, Signatur, -Rawrequest-/Responsehashes, False-Ready/Unlock sowie exakten Originalauftrag und -StopIntent. Der Worker verifiziert die Signatur und dieselben Bindungen nochmals -selbst und wartet bei fehlendem Beleg ausschließlich lesend innerhalb seiner -ursprünglichen Boot-/Owner-/Fristbindung. Vorher kein Stop und keine weitere -Aktivierung. Die Windows-Helper-/Workerstrecke verwendet denselben zusätzlichen -Beleg; deren native Bereitstellung wird separat nachgewiesen. - -## Tatsächlich lokal geprüft und verbleibende Abnahme - -- Server all-targets Check und Clippy mit `-D warnings`: bestanden. -- Zwei fokussierte Serververträge bestanden, 0 Fehler/ignoriert, 54 gefiltert: - ausschließlich exakte ursprüngliche Updatergeneration; kanonischer gespeicherter - Originalheader samt Delegation/Grant, Ablehnung von Padding, anderem Grant, - alternativen Headerbytes und geänderter Ownernonce. -- Gemeinsamer all-targets-Clippy-Lauf Server, privilegierter Linux-Helper und - Updater-Worker nach Einbindung des tatsächlichen Pre-Stop-Abgleichs bestanden. -- Formatierung und `git diff --check` bestanden. Ein vorangehender Teilcheck - meldete fehlende direkte Worker-Protokoll-/Prostabhängigkeiten; diese sind - ergänzt. Keine externen Bibliotheksversionen oder Prüfungen wurden unterdrückt. - -Noch nicht ausgeführt: isolierter SQL-/Broker-End-to-End-Fall dieses neuen Pfads, -Deployment, realer alter/neuer Generationswechsel eines genehmigten Updatejobs -und Windows-Updaterzeitnachweis unter dessen tatsächlichem Dienstkonto. Die -lokalen zwei Verträge ersetzen diese Nachweise nicht. Erst die reale Linux-first- -Strecke und anschließend Windows können den Updaterabschluss belegen. diff --git a/docs/windows-boot-identity.md b/docs/windows-boot-identity.md deleted file mode 100644 index 42af47e..0000000 --- a/docs/windows-boot-identity.md +++ /dev/null @@ -1,112 +0,0 @@ -# Windows-Bootidentität: Bestandsquelle und unqualifizierter Kandidat - -Stand 2026-11-14: Die neue Strecke ist **nur als separate Diagnosequelle -implementiert, lokal geprüft und crossgebaut**. Es wurden **keine nativen -Boot-API-Aufrufe**, keine LocalService-Probe, keine Zeitänderung und kein -OS-Reboot damit ausgeführt. `job_binding_qualified` ist in jedem Ergebnis -`false`. Die produktive Agent-/Helper-Bootquelle wurde nicht geändert; es wird -keine zusätzliche Capability angeboten. - -## Bestehende CIM-Quelle - -Der bestehende Windowscode liest mit einem festen passiven CIM-Aufruf -`Win32_OperatingSystem.LastBootUpTime`, wandelt den Wert in UTC-Ticks um und -bildet daraus einen UUID-förmigen Hash mit dem Namensraum -`rmm.windows.boot.cim.ticks.v1`. Agent und Helper verwenden diese bestehende -Quelle. Die dokumentierte CIM-Eigenschaft bezeichnet den Zeitpunkt des letzten -Betriebssystemstarts; sie ist ein Zeitwert und kein dokumentierter opaker -Boot-Identifier. [Microsoft: Win32_OperatingSystem](https://learn.microsoft.com/en-us/windows/win32/cimwin32prov/win32-operatingsystem). - -Übereinstimmende wiederholte CIM-Abfragen belegen ausschließlich die beobachtete -Übereinstimmung. Sie sind kein Nachweis, dass die Ableitung einen Prozessneustart, -einen Wanduhrsprung, Suspend/Resume, Fast Startup oder einen tatsächlichen -OS-Neustart korrekt voneinander unterscheidet. Hier wurde insbesondere **kein -Fehlerverhalten bei einem Zeitsprung beobachtet oder nachgewiesen**. Aus dem -fehlenden Stabilitätsnachweis folgt weder die Behauptung, CIM ändere sich bei -jedem Zeitsprung, noch eine belastbare Garantie, dass dies niemals geschieht. - -Für gespeichertes passives Inventar bleibt die Herkunft damit nachvollziehbar. -Eine zukünftige Job-/Rebootbindung benötigt einen eigenständig qualifizierten -Vertrag. Ein bloßer Wechsel vom bisherigen Hash zu einer anderen GUID darf nicht -als tatsächlicher Neustart ausgegeben werden; historische Bindungen bleiben -historisch und werden nicht nachträglich umgedeutet. - -## Getrennter nativer Diagnosekandidat - -Der unexportierte [native_boot.rs](../crates/agent-windows/src/native_boot.rs) -fragt ausschließlich einen experimentellen Kandidaten ab. Der Decoder ist auf -**Windows 11, x86-64, Build 26300** beschränkt. Fehlendes API-Symbol, andere Builds, -Architekturen, Rückgabelängen oder ungültige Werte bleiben `unsupported`; -Zugangsverweigerung wird als `permission_denied` ausgewiesen. Es gibt keinen -Fallback auf Wanduhr-/Uptime-Subtraktion oder einen Registry-Bootzähler. - -Die Implementierung löst `NtQuerySystemInformation` und `RtlGetVersion` dynamisch -im bereits geladenen `ntdll.dll` auf. Sie verwendet Klassenwert 90 und einen -festen, ausgerichteten 32-Byte-Puffer. Nur Status 0, exakt 32 zurückgemeldete Bytes, -eine nichtleere GUID aus den ersten 16 Bytes und ein passender Firmwaretyp an -Offset 16 werden als **Kandidatenbeobachtung** akzeptiert. Der Firmwaretyp wird -zusätzlich mit `GetFirmwareType` gelesen. Andere Pufferinhalte werden nicht -exportiert. Der Kandidat wird nicht aus einem Zeitwert berechnet. - -Dabei sind API-Nachweis und Interpretation klar getrennt: - -- Microsoft dokumentiert den allgemeinen dynamisch aufzulösenden - `NtQuerySystemInformation`-Einstieg, warnt aber vor Änderungen interner - Strukturen und nennt **keinen öffentlichen Vertrag für Klasse 90 und deren - BootIdentifier-Layout**. Die hier gewählte Feldinterpretation ist deshalb - ausdrücklich eine zu qualifizierende Hypothese, keine allgemeine Windowszusage. - [Microsoft: NtQuerySystemInformation](https://learn.microsoft.com/en-us/windows/win32/api/winternl/nf-winternl-ntquerysysteminformation). -- Die WDK-Dokumentation beschreibt die Versionsstruktur von `RtlGetVersion`; - sie garantiert damit nicht selbst einen unterstützten user-mode Boot-Identifier - aus `ntdll`. Fehlende Exporte werden verweigert. - [Microsoft: RtlGetVersion](https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nf-wdm-rtlgetversion). -- `GetFirmwareType` ist eine dokumentierte lokale Win32-Abfrage. Ihr Abgleich - prüft die Plausibilität eines Feldes; er beweist weder die GUID-Semantik noch - deren Lebenszyklus. - [Microsoft: GetFirmwareType](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getfirmwaretype). - -Auch zwei gleiche Kandidatenwerte bleiben `candidate_unqualified`. Weder -`job_binding_qualified` noch `public_class_90_abi_documented` werden dadurch wahr. - -## Vorbereitete LocalService-Probe, noch nicht ausgeführt - -[boot_probe.rs](../deploy/windows/boot_probe.rs) ist ein eigenständiges -SCM-Diagnoseprogramm, kein zusätzlicher RMM-Agent. Es akzeptiert ausschließlich -seinen eigenen Serviceaufruf, prüft den tatsächlichen Prozess als LocalService -`S-1-5-19`, verwirft Thread-Impersonation und aktivierte Administratorrolle und -schreibt zwei begrenzte Kandidatenbeobachtungen in einen neuen privaten Fall. -Ein Administrator-Konsolenaufruf ersetzt diesen Nachweis nicht. - -[BootIdentifierProbe.ps1](../deploy/windows/BootIdentifierProbe.ps1) bereitet -gehashte Artefakte vor und kann später ausdrücklich einen eigenen temporären -Manual-/LocalService-Dienst anlegen. Diese SCM-Registrierung ist ausschließlich -Bootstrap für die Probe; es werden keine Registry-Bootzähler, permanenten -Agent-/Helperdienste, Zeiteinstellungen, Privilegien oder Truststores verändert. -Create-only Intents verhindern wiederholtes Starten nach unklarem Reply. -`Readback` liest nur; `Cleanup` entfernt ausschließlich den gebundenen, bereits -beendeten Probedienst. Alte Fälle und Berichte bleiben erhalten. - -Zwei unabhängig gestartete frische Fälle könnten später Prozessunabhängigkeit -beobachtbar machen. Auch das ersetzt weder einen tatsächlichen genehmigten -OS-Reboot noch den noch fehlenden Nachweis der behaupteten Zeitsprungsemantik. -Diese Schritte sind hier **geplant, nicht ausgeführt**. Ein produktiver Wechsel -ist dadurch nicht freigegeben. - -## Tatsächlich ausgeführte Prüfungen und eingefrorene Quellen - -Ein lokaler Decoder-/Fehlerpfadtest bestand ohne Ignorieren: Status, Länge, -Firmware-Abweichung, GUID-Byteordnung und leere GUID führen nicht zu einer -Jobqualifikation. Windows-GNU-Clippy aller Targets mit `-D warnings`, Release-Link -und PowerShell-Parser bestanden. Die resultierende Windows-EXE wurde nicht -nativ ausgeführt. Private Qualifikation: -`devstate/windows-boot-probe/qualification.json`. - -| Quelle | SHA-256 | -| --- | --- | -| `crates/agent-windows/src/native_boot.rs` | `4f4dfcce2ec57b7f901dec878ec19f985f6d86379ec90ef7b582be8218eda18f` | -| `deploy/windows/boot_probe.rs` | `f150fc81b4a5f3d9cfdc5f83ec96209a315bc72d2170d04ec59f899f01c34fe8` | -| `deploy/windows/BootIdentifierProbe.ps1` | `60b6787ab77caebbbea4b39689dd9b80cd618517f9292ec8ca9c1ba8ac3bd539` | - -Der eigenständige Release-Link hat SHA-256 -`7cd57577e8a75b408c9119a6f2f2bf325c0a8978c3f1be1800f254088cfeeb9e`. -Das ist ein Buildnachweis, kein nativer Boot- oder Reboot-Abnahmenachweis. diff --git a/docs/windows-certificate-renewal.md b/docs/windows-certificate-renewal.md deleted file mode 100644 index 09d0807..0000000 --- a/docs/windows-certificate-renewal.md +++ /dev/null @@ -1,196 +0,0 @@ -# Windows: Geräte-TLS bei passiver Telemetrie erneuern - -Quellenstand 2026-11-15, Spezifikation 1.23. Der Windowsdienst verwendet jetzt -einen eigenen `RotationStore` und den vorhandenen gemeinsamen mTLS-Transport. -Die portable Logik ist nativ auf Linux und Windows geprüft. Dies ist keine -Rotation der permanenten Windowsidentität und keine native -Windows-Renewal-/Datei-I/O-Abnahme. - -Der tatsächliche Serverendpoint `POST /agent/v1/certificates/renew` verlangt -eine noch gültige, registrierte mTLS-Identität. Er prüft die signierte P-256-CSR, -stellt ein neues Gerätezertifikat für dieselbe Agent-ID aus, erhöht die -Verbindungsgeneration und akzeptiert den vorherigen Fingerprint 300 Sekunden. -Die exakten CSR-Bytes sind der serverseitige Wiederholungsschlüssel; eine -Wiederholung innerhalb des zulässigen alten Identitätsfensters liefert dasselbe -bereits gespeicherte Zertifikat. Weder Reenrollment noch Widerruf sind enthalten. - -Der Client prüft alle 30 Sekunden, ob das Zertifikat mindestens 20 Tage alt ist -oder höchstens zehn Tage Restgültigkeit hat. Automatische Erneuerung läuft in -diesem Schnitt ausschließlich bei `enable_jobs=false`. Ein dauerhaftes Pending -wird nach Prozessneustart und vor einem neuen Transport-Hello wiederaufgenommen, -ohne zuvor einen erfolgreichen WSS-/HTTPS-Kanal vorauszusetzen. Während eines -Pending ist die Umschaltung auf Jobbetrieb verweigert. Nach erfolgreichem Commit -baut der Client eine neue Verbindung auf; Heartbeats und unbestätigte -Inventarbytes behalten den bestehenden Journalvertrag. - -Die bisherigen Dateien `identity.json`, `device.pem` und `device.key` werden -nicht ersetzt. Nur vor der ersten Versionswahl wird das bestehende Paar als -Initialversion aufgenommen. Jeder neue private Schlüssel entsteht mit -`CreateNew` als `device-.key` im bestehenden geschützten State. Das -exklusive Dateihandle verweigert gleichzeitiges Ersetzen; Reparsepoints und -Hardlinks werden abgewiesen. Die bestehende SYSTEM-/Administratoren-/Service- -SID-DACL wird vor dem ersten Schlüsselbyte geprüft, anschließend werden die -Dateibytes mit Write-through und `sync_all` geflusht. Das gehaltene -Verzeichnishandle verweigert Löschen/Umbenennen seines Parents. Keine neue -ACL-Freigabe oder allgemeine LocalService-Schreibfreigabe wird hinzugefügt. - -Im vorhandenen exklusiv gesperrten Telemetriejournal stehen ausschließlich -öffentliche CSR-/Zertifikatsbytes und UUID-/Identitätsselektoren; private -Schlüssel gelangen weder in SQLite noch WAL. Die neue Schlüsseldatei ist vor -Pending-Commit vollständig geschrieben. Vor der Netzwerkanfrage committen -Versions-ID und exakte CSR gemeinsam. Die Antwort wird gegen die konfigurierte -CA-Kette, ClientAuth-Verwendung, Gültigkeit, genau einen passenden Geräte-CN, -Nicht-CA-Leaf und tatsächlich passende private Schlüsselbytes geprüft. -Zertifikat und aktiver Selektor wechseln in einer einzigen SQLite-Transaktion -unter dem vorhandenen WAL-/`synchronous=FULL`-Vertrag. - -Ein Schreib-, Antwort-, Validierungs- oder Commitfehler lässt den bisherigen -Selektor erhalten. Unselektierte Schlüsseldateien nach Abbruch werden nicht -adoptiert oder automatisch gelöscht. Nach Auswahl einer neuen Version gibt es -keinen automatischen Rückfall auf die Initialversion, auch nicht bei fehlender -Datei oder Ablauf. Alle vorhandenen mTLS-Verbraucher des Windowsagenten -(WSS/HTTPS, Zeitabruf und gegebenenfalls MSI-Download) verwenden dieselbe -Version. Kein Helper-Signierpin, Zeitpin, Geräte-/Enrollmentgeneration oder -Jobrecht wird rotiert oder freigeschaltet. - -Antwortverlust länger als die serverseitigen 300 Sekunden, abgelaufene oder -widerrufene Zertifikate und beschädigter State benötigen eine ausdrücklich -abgestimmte Wiederherstellung. Der Client erfindet kein neues Identitätsfenster. -Die Crashsicherheit beruht auf der vorhandenen SQLite-/Dateisystem- und -Datenträger-Durabilität: keine Behauptung unabhängiger Stromausfalltests oder -Schutz gegen Administratoren, die Schlüssel und State verändern können. - -Lokale Prüfungen und noch offene native Gates werden im Implementierungsstand -getrennt festgehalten. Native LocalService-DACL-/Flush-/Reparse-/Hardlinktests, -Windows-Renewal mit tatsächlichem Server, Antwortverlust, Prozessabbruch, -Transportwechsel und Negativabnahmen bleiben vor einer Runtimefreigabe offen. -Die permanente Identität darf hierfür nicht ohne weitere Abstimmung rotiert -oder widerrufen werden. Keine RMM-Jobs oder Operatorenserie sind Bestandteil. - -Tatsächlich lokal ausgeführt: `cargo test --offline --locked -p -rmm-agent-windows --lib` (23/23, keine Filter); `cargo check --offline --locked --p rmm-agent-windows --target x86_64-pc-windows-gnu --all-targets --features -system-helper`; Clippy für beide Targets mit `-D warnings`, -`cargo fmt --all --check` und tatsächlicher GNU-Link beider Windowsbinaries mit -`system-helper` bestanden. Das Windows-Lib-Testbinary wurde mit `--no-run` -gebaut (SHA256 `60e053e6e9cc7fb43de73fe05d50f7934a890e2f5de3c330175af4eba5ed50c5`), -hier nicht ausgeführt. Der erste Crosscheck in der unvollständigen -Builderimage scheiterte an fehlendem WIDL; der vorhandene vollständige -WIDL-/clang-Builder bestand danach, ohne Buildguardänderung. - -Der Orchestrator führte anschließend dasselbe Linux-Testbinary tatsächlich -auf Cloud-Linux als UID65534 aus: genau fünf `certificate_rotation::tests::*` -bestanden, 18 andere Tests bewusst gefiltert, keine Skips oder Fehler. -Binary-SHA256 `33d6e1f0c145e90247e123fba00bad6a972bad6aa8d1f84ffcfa801a97787890`; -eigene geschützte Quittung -`devstate/cert-renewal-linux/d61686f2-7829-4756-869e-a407667d1f97/result.json`, -SHA256 `7e6cab5915ec00a9b1392c1f15ddb13fe9ac6dd3b8e007b82e1dc914cb0507e1`. -Das ist ein nativer Linuxnachweis der portablen Logik mit synthetischen -In-memory-KeyFiles, kein Windows-DACL-/Dateiflush- oder echtes Renewal. -Keine permanente Identität oder Dienstkonfiguration wurde hierfür geändert. - -Die fünf Fälle prüfen exakte CSR-Wiederverwendung nach Antwortverlust; -falsche Agent-ID, CA, Schlüssel, Verwendung und Ablauf bei erhaltener alter -Version; fehlenden neuen Key ohne Legacyfallback; manipuliertes Pending und -Enrollmentbindung; sowie echten SQLite-/WAL-Reopen mit fortbestehender Sequenz -und einen absichtlich verweigerten Selektorcommit, bei dem auch das zuvor im -selben SQL-Commit geschriebene Zertifikat zurückgerollt wird. - -Erster tatsächlicher Windows-Unitlauf: vier Fälle bestanden, der fünfte endete -mit Exit101/Win32-Fehler33 beim rohen Dateiscan nach allen SQL-Prüfungen. Die -Testfixture hatte ihr Journal noch geöffnet und traf auf SQLite-WAL-/SHM- -Bytebereichssperren. Originalbeleg -`f981a395f4eceb527ad8a8859cff3c69ba79e52421300968b057404742fa1d8c` -bleibt fehlgeschlagen. Die Fixture schließt nun das Journal vor dem rohen -Restdateiscan; keine Fehler werden übergangen und kein Produktguard geändert. -Dieser Scan behauptet keinen Zugriff auf ein aktiv gesperrtes Windows-WAL. -Der erste Viererfolg ist keine vollständige Windowsabnahme. - -Das enge Testdelta ist anschließend tatsächlich zuerst auf Cloud-Linux als -UID65534 bestanden: fünf PASS, 18 andere gefiltert, keine Skips oder Fehler; -Fall `bc2158ce-d500-4c64-8f17-e12527559f5b`, Quittung-SHA256 -`1736a19a75d49eca91062e4e7adb28732f254279b64003474efcd6201ffa08ac`. -Linux-Binary-SHA256 -`1f9482ce78b6690e6bfbadecc5df61d5157620fce5302c094364cc8c371d1093`. -Danach auf Windows11 AMD64 im Entwicklungsbenutzerprozess: dieselben fünf -PASS, 44 andere gefiltert, keine Skips oder Fehler; Fall -`01d26081-895f-4dea-8eb0-7c4defed1d27`, Quittung-SHA256 -`64e960c2eb0b755b376028d923c6fdebbc11d5f96534103452f865ccf51a4fc0`. -Windows-Binary-SHA256 -`951a0ddad1225752d8817c15234f74926f1e216c1ca22e1aee8ba0a5e7f97e60`. -Beide Nachprüfungen führte der Orchestrator aus. Der Produktcode blieb beim -Fixturefix unverändert. Die Windowsfälle verwenden synthetische -In-memory-KeyFiles: kein LocalService-/ProtectedKeyFiles-Nachweis, kein echter -Renewal-HTTP-Aufruf und keine permanente Zertifikats-, Dienst- oder -Jobänderung. Die oben benannten Runtimegates bleiben offen. - -Die Dateiflags folgen [CreateFileW](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilew) -und [FlushFileBuffers](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers); -der öffentliche Selektor übernimmt den vorhandenen -[SQLite-WAL/FULL-Vertrag](https://www.sqlite.org/pragma.html#pragma_synchronous). - -Historischer Vorbereitungsstand45b5337: eine weitere enge native Datei-I/O-Unit -war **vorbereitet, nicht ausgeführt**: -`certificate_rotation::tests::protected_key_files_create_new_reopen_acl_and_hardlink_guards`. -Sie steckt im vorhandenen Lib-Testbinary; kein zusätzliches Diagnostikbinary, -keine Tokenübernahme, Impersonation, Dienste oder Accounts. Wegen ihrer -expliziten Administrator-/Dateisystemwirkung ist sie im Defaultlauf als -`ignored` markiert und muss separat mit `--ignored --exact` ausgewählt werden. -Dies ist ein offenes natives Gate und wird nicht als bestandener Test gezählt. - -Die Unit verlangt bereits vorhandene Administratorrechte und die vorhandene -Agent-Service-SID, erstellt ausschließlich einen eigenen zufälligen Unterordner -im temporären Verzeichnis mit expliziter SYSTEM-/Administratoren-/Agent-SID-DACL -und nutzt darin den unveränderten `ProtectedKeyFiles`-Produktpfad. Sie prüft -CreateNew/Flush, die wirkliche geerbte DACL, bytegleiche Wiederöffnung samt -öffentlichem P-256-Keyhash, verweigertes Überschreiben, verweigertes Umbenennen -des gehaltenen Verzeichnisses und Hardlinkablehnung. Eine zu breite DACL wird -nur an einer separaten **leeren** eigenen Verzeichnisfixture geprüft. -Private Schlüsselbytes stehen weder in stdout noch in Assert-Debugausgaben. -Bei Erfolg entfernt sie ausschließlich ihre eigenen Fixturedateien und das -leere eigene Verzeichnis; ein Fehler lässt den isolierten Fall erhalten. - -Das belegt nach einem zukünftigen tatsächlichen Lauf nur Datei-I/O des bereits -vorhandenen Administratorprincipals und die geprüfte Service-SID-DACL. Die -produktive Ownerprüfung bleibt vollständig bestehen; ein unzulässiger -Dateieigentümer wird weiterhin verweigert. Tatsächliche LocalService-Erzeugung, -Wiederöffnung und erneutes Öffnen nach Prozessabbruch sind damit weiterhin -nicht nachgewiesen. Es wurde kein konkreter Produkt-I/O-Fehler nachgewiesen, -also kein Produktguard dafür verändert. Der Controller-/Dienstupgradeumfang -und die permanente Identität bleiben unberührt. - -Für diesen vorbereiteten Testschnitt tatsächlich lokal: Linux23/23 ohne -Filter, Windows-GNU-Lib `--no-run`, Windows-Alltargets-Clippy mit -`system-helper`/`-D warnings` und Workspacefmt bestanden. Noch kein neuer -Zielaufruf. Das vorbereitete Windows-Testbinary hat SHA256 -`cd385c3b8696303220d8e601768d70ac96a6e4187a14cbac9d511162a57eee5a`. - -Nach dem ausdrücklichen SSH-Readback-Signal des Orchestrators wurde genau diese -Unit tatsächlich einmal auf der Windows-VM ausgeführt. Eigener Fall -`e0590d96-7e62-4bdc-a0b1-f53e8a9a9972`, unverändertes Binary `cd385c3b…`, -Aufruf `--ignored --exact certificate_rotation::tests::protected_key_files_create_new_reopen_acl_and_hardlink_guards --test-threads=1`. -Ergebnis: **ein PASS, null Fehler, null ignored, 49 andere gefiltert**, Exit0, -gemeldete Unitlaufzeit0.09s. Der vorhandene Administratorprincipal wurde im -Test geprüft; keine Tokenübernahme oder Impersonation. - -Damit sind der wirkliche geschützte Windows-KeyFiles-CreateNew-/Flush-/Reopen- -Pfad, bytegleiche private Wiederöffnung, öffentlicher P-256-Keyhashvergleich, -Nichtüberschreiben, breite leere DACL-Negativfixture, gehaltenes Verzeichnis -und Hardlinkablehnung für diesen Principal bestanden. Die Unit entfernte ihren -eigenen temporären Schlüssel, Hardlink und Testordner erfolgreich. Es gab keine -Änderung an Client, SCM, Accounts, SSH-Zugang oder dauerhafter Identität. Stagingbinary und -eigene öffentliche Ergebnisdateien bleiben geschützt im Bootstraparchiv. - -Der private Aufrufwrapper gab das bereits auf der VM beständig gespeicherte -Ergebnis zunächst als PowerShell-Tabelle aus; dadurch schlug ausschließlich das -lokale JSON-Einlesen fehl. Es gab **keinen zweiten Teststart**. Ein anschließend -streng lesender Aufruf übernahm nur die ursprüngliche eigene `result.json`. -Geschützter lokaler Rohread: -`devstate/windows-keyfile-fixture/e0590d96-7e62-4bdc-a0b1-f53e8a9a9972/result-read.json`, -SHA256 `68dd458a24c2455049b7799f57e30f1e858e323fa82c578e3b962f58282b5e49`. -Die separate lokale Acceptancequittung `acceptance.json` bindet Intent, -Transfer, Start und diesen Originalread; SHA256 -`268e3146acfcab55022f9534509e74c80caf7b8ca246bcc5eb3c30e08cfd1383`. -Dies bleibt eine Administrator-Fixtureabnahme; tatsächliches -LocalService-Keyfile-I/O, Prozessabbruch und echte Zertifikatserneuerung sind -weiter offen. Keine bestehende Plattform-/Jobqualifikation wird damit erweitert. diff --git a/docs/windows-certificate-runtime-acceptance.md b/docs/windows-certificate-runtime-acceptance.md deleted file mode 100644 index bf755c3..0000000 --- a/docs/windows-certificate-runtime-acceptance.md +++ /dev/null @@ -1,155 +0,0 @@ -# Native Windows-Zertifikatserneuerung: vorbereitete Abnahme - -Stand 2026-11-16. **Vorbereitet, noch nicht nativ ausgeführt.** Dieser Ablauf -ergänzt [die bisherigen Zertifikatsnachweise](windows-certificate-renewal.md) -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\` 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 ` 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 ` 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. - -## Konkrete Vorbereitung vom 16. November - -Der bereits gebaute SDK ist lokal erhalten: -`devstate/windows-certificate-acceptance/windows_certificate_acceptance.exe`, -SHA256 `c6b581b60ce803318ff946cd3cc8306aa8589d6bff6b022c0bf1d48eb8f5a8e1`. -Sein Beispielquelltext hat SHA256 -`74b2bc85d3d68d27154e87fcaca0ed313d3d721692473e1a47e577bff34474b7`. -Die Produktionsdateien `certificate_rotation.rs`, `native.rs` und `journal.rs` -stimmen bytegenau mit dem qualifizierten Dienstpaar aus -`devstate/windows-helper-apply-fix/source` überein. Buildreceipt und tatsächliche -Quellen liegen unter `devstate/windows-certificate-acceptance/`; das SDK wurde -bei dieser Vorbereitung weder auf der VM ausgeführt noch dort neu installiert. - -`deploy/windows/Prepare-CertificateAcceptanceFixture.ps1` ist ein expliziter -Bootstrap, der **keinen** SDK-Prozess startet. Er erwartet ausschließlich eine -JSON-Zeile auf stdin mit `case_id`, `ca_base64`, `ca_sha256` und -`enrollment_token`. Der Token muss unmittelbar vor dem koordinierten Test für -eine neue, separate Identität erzeugt werden; bestehende Geräte-/Enrollmentdaten -werden nicht übernommen. Ein vorhandenes Fallverzeichnis verweigert die -Vorbereitung statt Token oder Dateien zu ersetzen. Teilfehler erfordern Lesen -des bestehenden Falls, keine blinde Wiederholung. - -Das SDK wird nach -`C:\Program Files\RustDiscoveryCertificateAcceptance\\WindowsCertificateAcceptanceSDK.exe` -kopiert, mit SYSTEM-/Administrator-Schreibrecht und Agent-Service-SID-Leserecht. -Das Fallverzeichnis liegt getrennt unter dem oben genannten festen Pfad; -nur SYSTEM, Administratoren und die tatsächliche Agent-Service-SID erhalten -Schreibrecht. Die permanente Geräteidentität, RMM-Journale, Helperpolicy, -Dienste und Zeitprofile werden nicht gelesen oder geändert. - -`deploy/windows_certificate_acceptance.py` erzeugt ausschließlich lokal die -vollständigen PowerShell-Pläne für `renew` und `revoked-read`. Es führt keine -Netzwerkanfrage aus, plant keinen MCP-Auftrag und genehmigt nichts. Das Skript -bindet SDK-Hash und Fallkennung, hält das SDK während Prüfung und Ausführung -gegen Schreiben/Löschen geöffnet und verlangt die tatsächliche LocalService- -Quittung. Die vorgesehenen Aufträge laufen mit 120s Laufzeitgrenze, -`powershell_51_remote_signed` und festen Ausgabepostconditions. Der zweite Plan -darf erst nach unabhängig geprüftem Renewal und tatsächlichem WebUI-Widerruf -**ausschließlich der Testidentität** eingereicht/genehmigt werden. Zeitplan beim -tatsächlichen MCP-Antrag neu rendern; ein lokaler Entwurf ist keine Genehmigung. - -Tatsächlich ausgeführt wurden Python-Syntaxprüfung und der rein lesende -PowerShell-5.1-AST-Parser für den Bootstrap: null Syntaxfehler. Es wurden kein -Fixturetoken erzeugt, keine Registrierung/Erneuerung/Widerruf ausgelöst und -keine neuen Jobs erstellt. Die ACL-/I/O-Wirkung des neuen Bootstrap bleibt bis -zur koordinierten nativen Ausführung ausdrücklich **nicht abgenommen**. Der -Linux-Vergleich bleibt die bereits tatsächlich ausgeführte separate -Cloud-Identitätsabnahme in `deploy/cloud_lifecycle_acceptance.py`. - -## Weitere offene Neustartvoraussetzung - -Der tatsächliche lesende SCM-Stand am 16. November nach Installation von -Profil 7: Agent `Running/Auto/LocalService`, Helper `Running/Manual/LocalSystem`. -`system_helper_bootstrap.py` legt den Helper ausdrücklich mit Startart Manual -an. Der Agent besitzt keinen eigenen Helper-Startpfad; der vorhandene -`PreparedService::execute` startet nur separat genehmigte, allowlistgebundene -Dienstaufträge und aktiviert nicht den eigenen SYSTEM-Helper. Ein laufendes -Paar beweist daher noch keinen vollständigen Wiederanlauf nach Windows-Boot. -Eine eng koordinierte automatische Helper-Startkonfiguration und die dazu -gehörenden tatsächlichen SCM-/Rollen-/Zeitbelege sind vor einer vollständigen -Windows-MVP-Neustartabnahme nötig. Diese Vorbereitung hat die Startart nicht -verändert und keinen Neustart ausgeführt. diff --git a/docs/windows-clock-attestation-proposal.md b/docs/windows-clock-attestation-proposal.md deleted file mode 100644 index bd12a07..0000000 --- a/docs/windows-clock-attestation-proposal.md +++ /dev/null @@ -1,164 +0,0 @@ -# ADR: unabhängiger signierter Zeitnachweis für Windows - -Status2026-11-14: **Vom User ausdrücklich angenommen: „Ja, signierten -Zeitvergleich umsetzen“.** Normativ in Spezifikation1.22/Kapitel0 und -Projektentscheidungen übernommen. Implementierung und tatsächliche -Qualifikation stehen noch aus; kein Schlüsselsetup oder Clockgatewechsel. -Vorausgehender konkreter OSF-Befund: -[QOS5-Analyse](windows-clock-rpc-qos5-analysis.md). - -## Angenommene Änderung der Trustsource - -Die vollständig gelesene Spezifikation1.18 samt aktuellen Main1.20-Deltas, -Projektentscheidungen und Entwicklungsregeln verlangen weiterhin tatsächliche -lokale Status-/Boot-/Unsicherheitsnachweise. Der aktuelle Windowsvertrag -verlangt lokalen W32Time-Sync höchstens1h alt, maximal2s Unsicherheit und nach -Diskontinuität einen neuen Sync; er schließt einen Serverzeitanker ausdrücklich -aus. Die VM meldet derzeit W32Time Leap3/Stratum0. Ein signierter Beleg darf -diesen Dienstzustand nicht nachträglich als synchronisiert ausgeben. - -Die angenommene Entscheidung erlaubt eine **andere zulässige Vertrauensquelle**: ein signierter -Onlinevergleich qualifiziert die aktuelle lokale Windows-Wallclock; er stellt -sie nicht und ersetzt sie nicht durch einen Hello-Zeitwert. Er ersetzt bewusst -lokalen W32Time-Sync als alleinige Voraussetzung durch streng begrenzte, -kryptografisch belegte Vergleichsqualität ersetzen. Auch „neuer Beleg nach -Diskontinuität“ wäre dann ein neuer expliziter Vertrag, kein behaupteter neuer -Windows-NTP-Sync. Die ausdrückliche normative -Produktentscheidung ist in Kapitel0/Projektentscheidungen1.22 festgehalten. -Review und eigene Qualifikation bleiben nötig. Bis dahin bleibt der -produktive Windowsclock-Adapter geschlossen. - -## Kleiner vorgeschlagener Vertrag - -Nur der bereits festgelegte Server `discovery.ease-technologies.de` darf mit -einem eigenen provisionierten Ed25519-Zeitschlüssel signieren. Domainkennung -`RMM-TIME-ATTESTATION/v1`, feste Version und exakte Codecbytes; kein frei -wählbarer Algorithmus. Schlüssel strikt getrennt von TLS, Jobs und Updates. -Der geschützte Helperpin bindet die erlaubten Zeitpublickeys samt monotoner -Konfigurationsgeneration. Der Netzwerkagent kann keinen Publickey ergänzen; -Rotation/Entzug brauchen den gesondert geschützten Konfigurationsweg. - -Agent und SYSTEM-Helper prüfen unabhängig. Jeder Verifier erzeugt selbst -256Bit CSPRNG-Nonce und eigene zufällige Prozessinkarnation, hält höchstens -eine Anfrage und beobachtet selbst Boot-ID, präzise Interrupt-/Unbiasedzeit -sowie Wallclock. Der Agent darf Helperanfrage und Antwort nur transportieren. -Seine behaupteten Zeiten oder Timer ersetzen keine Helperbeobachtung. - -Der signierte Beleg bindet Nonce, Anfragetype/-hash und Verifierrolle, -Serverinstanz/-boot, erlaubten Endpunkt, Tenant/Asset/Agent, -Enrollment-/Assignmentgeneration, aktuelle Connectiongeneration, -Windows-Boot-ID, Verifierinkarnation sowie beim Helper dessen gepinnten -Imagehash und Bindingschema. Serverseitig Tenant/Agent ausschließlich aus -gültigem mTLS ableiten; aktuellen Verbindungskontext selbst nachprüfen. -Eine solche signierte Kontextbestätigung darf initiale Clockprüfung vor dem -normalen Sync ermöglichen, ersetzt aber weder diesen Sync noch ein Startgrant. -Striktes TLS/SAN/SNI bleibt Pflicht; falsche OS-Zeit rechtfertigt keinen -Zertifikatsprüfungs-Bypass zur vermeintlichen Zeitreparatur. - -## Qualität und konkrete Zeitgrenzen - -Vor jeder Signatur braucht der Server eine frische, nur lesende native -Kernel-/Providerprüfung: kein `TIME_ERROR`, `STA_UNSYNC` oder `STA_CLOCKERR`, -eindeutige Einheiten, gültiger UTCwert und konservativer Gesamtfehler -`epsilon_server <= 500ms`. Die bestehende Linuxfunktion erlaubt Kernel- -`maxerror <= 5s`; sie ist dafür **nicht unverändert ausreichend**. Maximal1h -seit tatsächlichem letztem guten Quellensync bleibt erforderlich. `timex` -enthält Fehler-/Statusfelder, aber keinen universellen Last-good-sync-Zeitpunkt; -der tatsächlich vorhandene Zeitprovider muss dafür eine vertrauenswürdige -native Schnittstelle liefern. Fehlend bedeutet deny, kein aus Pollzeit oder -Heartbeat erfundenes Syncalter. -[Linux-UAPI](https://raw.githubusercontent.com/torvalds/linux/master/include/uapi/linux/timex.h). - -Vorläufige bewusst kurze Grenzen: vom verifiereigenen Challengebeginn bis zur -konkreten Prüfung maximal1s, davon nach Empfang höchstens100ms. Keine längere -Holdover-/Offlinephase. Capture-/Rundungs-/Timerunsicherheit wird explizit mit -`delta` berücksichtigt; dessen Höchstbudget50ms braucht einen tatsächlichen -Plattformnachweis und darf nicht aus Timerauflösung als Genauigkeit erfunden -werden. Microsoft trennt monotone Intervallmessung von UTC und setzt für VMs -einen korrekt implementierten Hypervisor voraus; diese OS-/Kernelannahme -bleibt ausdrücklich bestehen. -[Zeitstempelvertrag](https://learn.microsoft.com/en-us/windows/win32/sysinfo/acquiring-high-resolution-time-stamps). - -Für signiertes Servercapture `T`, Fehler `epsilon_server` und selbst -gemessenes Gesamtintervall `R` ist die konservative UTCspanne zum Prüfzeitpunkt -`L = T - epsilon_server`, `U = T + epsilon_server + R + delta`. -Der gesamte RTT wird berücksichtigt; keine unbelegte Halbierung oder Annahme -symmetrischer Paketlaufzeiten. Die gleichzeitig selbst gelesene lokale -Wallclock `W` ist nur qualifiziert, wenn -`max(abs(W-L), abs(W-U)) <= 2s`. Spätere Vergleiche brauchen wieder einen -fristgerechten eigenen Beleg; keine freie Extrapolation einer Serverzeit. - -Deadlineprüfung muss konservativ die ganze Spanne verwenden: -`L >= not_before` und `U < start_before`, zusätzlich bestehende monotone -Laufzeit-/Verbrauchsgrenzen. Ein einzelnes `SyncClock::now()`-UTCdatum reicht -diesen Intervallvertrag nicht automatisch weiter; dessen konkrete Integration -ist vor Implementierung zu prüfen. Alte Grantbytes, Fristen und60s-Startfenster -werden weder geändert noch durch Belegrefresh verlängert. - -## Restart, Replay und Fehler - -Jeder Boot-/Prozess-/Connectionwechsel verwirft offene Nonces und Bereitschaft. -Kein auf Platte gespeicherter Zeitbeleg eröffnet nach Restart oder Restore. -Neue zufällige Nonce/Inkarnation und normaler unabhängiger Ledger-/Syncabgleich -sind nötig; Journale, Schlüsselidentitäten und Verbrauchshistorie erhalten. -Nur Schlüssel-/Konfigurationsgeneration und gebundene Jobprüfbelege werden -im bestehenden geschützten Persistenzmodell ergänzt, keine Ledgerresets. - -Rückwärtszähler, Wallstep oder Sleepdifferenz über der bisherigen1s-Grenze, -fehlerhafte Bootbeobachtung, falsche Nonce/Rolle/Bindung/Signatur, doppelte -Antwort, Überlauf oder Überschreitung einer Grenze sperren. Nach beobachteter -Diskontinuität darf nur eine danach erzeugte Challenge Bereitschaft herstellen. -Ein neuer Objektkonstruktor löscht keinen bestehenden Diskontinuitätsfence. -Ein bösartiger LocalService-Agent kann so höchstens verzögern/verhindern, -nicht Helpernonce oder Signatur fälschen. Server-/Zeitschlüsselkompromittierung -und bösartiger Hypervisor bleiben Vertrauensgrenzen; Signatur authentifiziert -den Beleg, nicht automatisch den vorgelagerten NTPserver. - -Ohne frischen gültigen Beleg `CLOCK_UNTRUSTED`; Telemetrie bleibt möglich. -W32Time-Rohstatus bleibt separat sichtbar. Keine Clocksetter, Resyncs, -NTP-/ACLänderungen, neue Jobfreigaben oder Ersatz menschlicher WebUI-Genehmigung. - -## Enger Review- und Nachweisplan - -Die ausdrückliche Entscheidung über die andere Trustsource und die -beibehaltenen Grenzen liegt vor. Als Nächstes ausschließlich lesend tatsächliche -Serverqualität/Provider-API, Windows-Timer und Sync-/Deadline-Integrationspunkte -prüfen. Fehlt eine belastbare Qualitäts-/Alters-/Timergrenze, bleibt der -Entwurf blockiert; keine Implementierung mit angenommener Güte. - -Nur nach bestandenem Review: wenige Byte-/Signatur-/Bindungs-/Intervallguards, -Serverseite zuerst auf der Linux-Cloud-VM qualifizieren, danach getrennt reale -Windows-Agent-/SYSTEM-Verifikation samt Replay, Delay, Restart und falscher -Rolle/Identität. Suspend/Clockstep zunächst injizierte Validatorinputs; kein -unangekündigter OS-Suspend/Uhrsprung. Quellen-/Buildnachweise eröffnen keine -Capability. Erst eigene reale Abnahme und anschließend tatsächlicher neuer -WebUI-genehmigter Windowsjob belegen eine nutzbare Strecke. - -## Separater tatsächlicher Serverproviderbefund - -Root hat nach diesem Entwurf nur lesend die vorhandenen Zeitdienste auf dem -festgelegten Cloudserver ermittelt: Chrony ist aktiv; chrony.service und -chronyd.service melden dieselbe vorhandene Dienstgeneration. Providerfall -`7534ada0-c4ce-47d0-a04f-8c0d94e9ba0d`, ResultatSHA256 -`11f7f1e9bd9af49127bb4745440a739e7a92faef70d17fb48291cc4688485181`. -Kein Dienststart, Zeitsetter, Resync oder D-Bus-Autoaktivieren. - -Eine getrennte feste `chronyc -n -c -h /run/chrony/chronyd.sock tracking`- -Abfrage lief mit Exit0, leerem stderr und14 CSVfeldern. Das geschützte -vorhandene Binary wurde gehasht, die Socketidentität vor/nach verglichen. -Fall `24390534-25f7-4f5f-a3c7-8ca3cb24aec1`, ResultatSHA256 -`33cffb1ec13647fbc09a7f989518e0162920aea3e99e9aba0ace4eb5b006fb20`. -Gemeldet wurden Stratum3/Normal; Peeradresse und Rohdaten bleiben privat. -Chrony dokumentiert CSV-Einheiten, Referenzmesszeit und die konservative -Fehlerschätzung aus verbleibender Systemkorrektur, Rootdispersion und halber -Rootverzögerung [im Primärhandbuch](https://chrony-project.org/doc/latest/chronyc.html). -Für genau diese Aufnahme ergeben sich 379.043210s Messalter und -0.011525568s geschätzte Fehlergrenze unter Chronys Referenzannahmen. -Das ist ein einmaliger Diagnosebefund, **keine qualifizierte Zeitquelle**. - -Vor einer Implementierung bleiben tatsächliche Kernelstatusprüfung, -authentisierte/beschränkte Provideranbindung aus der Serverlaufzeit, -frische gemeinsame Erfassung, konservative Gesamtschranken und deren -Linux-first-Nachweise offen. Die vorhandene CLI-Diagnose wird nicht als -fertiger Produktadapter übernommen. Die Userentscheidung genehmigt die Umsetzung; sie ersetzt diese technischen -Nachweise nicht. Windowsclock bleibt bis zur Qualifikation geschlossen. diff --git a/docs/windows-clock-descriptor-result.md b/docs/windows-clock-descriptor-result.md deleted file mode 100644 index 694da7b..0000000 --- a/docs/windows-clock-descriptor-result.md +++ /dev/null @@ -1,133 +0,0 @@ -# V5-Serverdescriptor mit Discoveryprincipal: Fehler87 - -2026-11-14. Getrennter nicht qualifizierender Nachfolger der -[SID-/Descriptorprobe](windows-clock-identity-result.md). Der ursprüngliche -RPC-Befund ist vollständig erhalten. Der separat hängende Cleanupaufruf wurde -ohne Wiederholung des Originals aufgelöst; der eigene Diagnosedienst ist -inzwischen separat nachgewiesen entfernt. Produktclock und Windowsjobs -bleiben geschlossen; Fehler87 ist keine Clockabnahme. - -## Fester Vergleich und tatsächlicher Build - -Die vier eingefrorenen Quellen unter -`deploy/windows/clock-spnego-descriptor-trace/` behalten GSS9/Privacy6/ -Impersonate3 und QOS5 mit Mutual-Auth-Anforderung. Gegenüber dem vorherigen -SID-Vergleich verwenden sie `Sid=NULL` und exakt den tatsächlich vorhandenen -Discoveryprincipal, einschließlich einer vorhandenen leeren Zeichenfolge. -Ein NULL-Discoveryresultat bleibt verweigert. Discovery ist keine -Identitätsautorität. Der clientseitige Serverdescriptor bleibt absolut und -enthält genau eine feste ACE; keine Änderung einer OS-/Dienst-DACL. - -Kontrolle0 bindet darin die W32Time-Service-SID. Die fest kompilierten -Kontrollen1/2 sind falscher SYSTEM-Account beziehungsweise falsche -RmmDiscoveryWindows-Service-SID; beide wurden hier nicht nativ ausgeführt. -Einmalige Aktivierung und Wiederherstellung des eigenen vorhandenen Privilegs -bleiben diagnostische Tokenänderungen. Fremde Prozess-/Tokenhandles bleiben -QUERY-only. Kein Fallback, W32Time-Setter oder RMM-Job. - -Der vorbereitete lokale Build bestand C-Werror, unveränderten Microsoft-MIDL- -Compile, Link, Importgrenze, PowerShell-AST und Manifestprüfung. Keine erneute -Buildbehauptung aus der folgenden reinen Dokumentations-/Readerprüfung. -Manifest SHA256 -`34c51e005a90eb4344ffd31231a4b6df866d7f495f33fa81dcfcb8b34294dec7`; -PE117588Byte/SHA256 -`e7f2abc34b9c5ef5537892825724d15e488fdfd276de0d4468f6e1eae011769a`. -Die131 ursprünglichen Produktinputs,27 älteren Diagnoseinputs und die vier -neuen Descriptorquellen sind unverändert separat hashgeprüft. - -## Tatsächlicher VM-Befund - -Root führte nur Kontrolle0 im eigenen Fall -`4b1ae5cf-1573-4cac-8c01-17d1d36029c3` aus. Eigene Vorbereitung/Übertragung -und genau ein SYSTEM-Diagnosedienststart; anschließend getrennte Nur-Lese- -Readbacks desselben Falls: - -- SYSTEM-Token bestätigt, DienstStopped/Exit0; -- genau eine erfolgreiche Principaldiscovery, tatsächlich non-NULL und leer; -- QOS5/Control0 und vorhandener Serverdescriptor; -- `RpcBindingSetAuthInfoExW` verweigert87 bei Stage30; -- **null Statusqueries**, kein Statusobjekt oder normaler Statusreturn; -- EEInfo-Capture versucht, Start1761/keine Records; -- Principal- und Bindingfreigabe jeweils erfolgreich; -- eigenes Privileg vollständig wiederhergestellt, beobachtete Peertoken - unverändert; kein Agent-/W32Time-Konfigurationswechsel oder neuer RMM-Job. - -Original `diagnostic-result.json`, SHA256 -`27315e9a56735b929527f54309b3aecb372584f8f9a3efe689d7d3d230355121`. -`complete=true` bezeichnet den vollständig erhaltenen diagnostischen Fehler, -keinen positiven Clock-/Identitätsnachweis oder abgeschlossenen Cleanup. -Der Originalbericht enthält ausdrücklich `cleanup_completed=false`. - -Separater Erhaltungsbeleg vor/nach dem Diagnosebefund: sechs native -RMM-Bereiche und Servergate erhalten; Windows0/0/0/0, Linux31/31/27/0, -Rootpolicycf15 geschlossen, Transportfaults aus. Before-SHA256 -`54eb250bbdcbb49315bdb4dc23e01509497b8264249f5f4fc4756fe7290025e2`, -After-SHA256 -`eb0ee568745e488e38cc43a68c03424aab697c740168b8b22c31d627c2c035fe`. -Dieser Erhaltungsnachweis bestätigt noch keine spätere Cleanupauflösung. - -## Cleanupantwort verloren, eng begrenzter eigener Prozess beendet - -Der separat gestartete ursprüngliche Cleanupaufruf überschritt50s. -Sein lokaler Timeoutbeleg bleibt erhalten; remote war kein Cleanupmarker -nachgewiesen. Ein wiederholter Originalcleanup wurde ausdrücklich nicht -gestartet. Die Nur-Lese-Auflösung fand den eigenen hängenden -PowerShell-Bootstrapclient PID4460, exakte Erzeugungs-FILETIME -`134391586730921083`. - -Root prüfte dessen gehaltenes Prozesshandle, PID/Erzeugungszeit, Image und -genauen ursprünglichen Command und beendete ausschließlich diesen Client -einmal. Separater Beleg `spnego-descriptor-own-client-terminate-result.json` -im geschützten Pipefall14fb, SHA256 -`b3312d4abd8a2722f729eaac4a132909f6ae1f5072ced47be62b24ad788e5635`: -`terminated=true`, `wait_code=0`, `no_rmm_service_termination=true`, -`no_retry_original_cleanup=true`. - -Das beendet den alten Bootstrapclient und war alleine noch kein Beleg für -das Entfernen des Diagnosedienstes. Er blieb bis zur folgenden eigenen -Auflösung Stopped/registriert. Originalintent/-timeout/-result bleiben -unverändert; der Originalcleanup wurde nicht wiederholt. - -## Separate Cleanupauflösung tatsächlich abgeschlossen - -Root führte danach ausschließlich die neue eng gebundene Auflösung aus. -Das private Skript hat SHA256 -`573c0cf7512add7ef51f7c3d76609b1388536963c21ee5e435ba978921ec5d40`. -Es hält ein natives SCM-Servicehandle und prüft per `QueryServiceConfigW`/ -`QueryServiceStatusEx` exakt den ursprünglichen Image-/Argumentcommand, -LocalSystem, Manual, Servicetyp16 sowie Stopped/Exit0/PID0. Erst nach diesen -Prüfungen einmal `DeleteService`, Handle schließen und Abwesenheit prüfen. -Neue Resolution-Intent-/Completedmarker gehören ausschließlich zu dieser -separaten Phase; beide alten Remote-Cleanupmarker bleiben nachweislich false. - -Ergebnis `spnego-descriptor-cleanup-resolution-result.json`, SHA256 -`3c9bc0d4be2c5fb1cf404d4e94c492611662830c1867bc55bb96d53f4b80948d`; -separater Nur-Lese-Nachbeleg SHA256 -`d51b3c5e9811a04265c114ba3197c9d07f2700dd862d538b3735c6a5f4802a28`. -Beide bestätigen den eigenen Dienst als abwesend und keinen RMM-Wechsel. -Das originale `diagnostic-result.json` behält weiterhin seinen damaligen -Wert `cleanup_completed=false`; es wird nicht rückwirkend umgeschrieben. - -Vollständiger neuer Erhaltungsnachbeleg SHA256 -`df4b241d885d11c83c10562b8f31b9154f4c6dcfc54917e6a3d09257f3dd4c09`: -Root verglich erneut die sechs RMM-Erhaltungsbereiche `service`, -`helper_service`, `agent_kernel`, `helper_kernel`, `files`, `helper_witness` -mit dem vorigen eb0e-Beleg; bestanden. Der komplette Serverrecord ist gleich. Passive -Agenttelemetrie/Probe-/Journalbeobachtungen dürfen sich weiterentwickeln; -der gesamte native Rohbericht wird deshalb nicht als bytegleich behauptet. -Keine neue Diagnosequery, Jobwirkung oder W32Time-Änderung durch diese Auflösung. - -## Lokal nachgelesen und verbleibende Grenzen - -Der unveränderte lokale Manifestreader sowie Report-/Privilegewitnessreader -wurden auf den erhaltenen Originaldateien erfolgreich ausgeführt; beide -Pythonquellen zusätzlich per AST geparst. Diese Prüfungen starten weder SSH -noch einen Prozess auf einem Ziel. `git diff --check` betrifft die vorbereiteten -Quellen-/Dokumentationsänderungen. Kein erneuter Compiler-/VM-/Joblauf. - -Die anschließende [statische RPC-Runtimeanalyse](windows-clock-rpc-qos5-analysis.md) -grenzt die Verweigerung des konkreten OS-Stands ein. Sie ist kein nachträglich -erfundener dynamischer Trace und begründet keinen weiteren Formatclone. -Der [Zeitbeleg-ADR](windows-clock-attestation-proposal.md) ist ausschließlich -ein entscheidungsbedürftiger Vorschlag; keine angenommene Trustsource oder -implementierte Clockalternative. Keine Capability oder Policy aktiviert. diff --git a/docs/windows-clock-eeinfo-trace.md b/docs/windows-clock-eeinfo-trace.md deleted file mode 100644 index dd7eb9d..0000000 --- a/docs/windows-clock-eeinfo-trace.md +++ /dev/null @@ -1,190 +0,0 @@ -# Begrenzter EEInfo-Nachfolger: Fehlerlage statt Ursachenbehauptung - -Stand 2026-11-14: **separat implementiert, lokal gebaut und durch den -verantwortlichen Rootprozess einmal auf der Windows-VM ausgeführt**. Dieser -Subagent führte keine VM-Aktion aus. Der tatsächliche vorherige SYSTEM-Vergleich -`562ff9de-67ff-48a1-96f0-c2474b3b0777` meldete wie LocalService RPC5/Stage90 -ohne Status oder normalen RPCreturn. Die einfache Erklärung durch ausschließlich -LocalService ist damit nicht belegt. Authentifizierungs-/Autorisierungsschicht -und tatsächliche serverseitige Calleridentität bleiben offen. Kein Produktgate -wird aus diesem Befund geöffnet. - -## Microsoft-Quellen und konkrete Grenzen - -Die [V5-QoS-Dokumentation](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w) -beschreibt den Serverdescriptor nur allgemein. Sie dokumentiert für unser -lokales `ncacn_np` keinen vollständigen Vertrag, der genau den tatsächlichen -Serverprozesstoken einschließlich W32Time-Service-SID beweist. Die -[SDK-Deklaration](https://github.com/microsoft/win32metadata/blob/main/generation/WinSDK/RecompiledIdlHeaders/shared/rpcdce.h) -belegt das Layout, nicht diese Laufzeitsemantik. Microsoft warnt außerdem, dass -NTLM erfolgreiche Mutual-Auth-Aushandlung melden kann, obwohl echte gegenseitige -Authentifizierung fehlt. V5, ein gesetztes Flag oder erfolgreicher SetAuth-Aufruf -sind deshalb kein selbständiger Konto-/Service-SID-Nachweis. Das ist eine -verbleibende Nachweislücke, keine Behauptung, der Descriptor könne grundsätzlich -nie wirksam sein. Microsoft-Q&A-Erfahrungsberichte wurden nicht als verbindliche -Produktgarantie verwendet. - -Die LocalService-Beschreibung anonymer **Netzwerk**credentials beweist keinen -anonymen SSPI-Caller dieser lokalen NPFS-Verbindung. Laut -[RPC-Credentialsvertrag](https://learn.microsoft.com/en-us/windows/win32/rpc/client-authentication-credentials) -werden implizite Credentials aus Thread-/Prozesstoken gewonnen. Die tatsächlich -vom Server verwendete Identität lässt sich nicht einfach aus einem Client- -Account oder den konfigurierten Bindungsoptionen ablesen. Die dokumentierte -[Callattributes-Struktur](https://learn.microsoft.com/en-us/windows/win32/api/rpcasync/ns-rpcasync-rpc_call_attributes_v2_w) -enthält Authentifizierungsdaten und NullSession, wird jedoch serverseitig mit -`RpcServerInqCallAttributes` abgefragt; sie ist keine Clientabfrage in W32Time. - -EEInfo kann die Fehlerlage eingrenzen: Microsoft benennt unter anderem SSP, -NPFS/Redirector/Named Pipe und Authz als -[GeneratingComponents](https://learn.microsoft.com/en-us/windows/win32/rpc/understanding-extended-error-information). -Eine einzelne Zahl beweist weiterhin weder einen anonymen Caller noch die -konkrete verweigernde ACL. Fehlende Records sind kein Gegenbeweis: -[EEInfo ist standardmäßig grenzüberschreitend deaktiviert](https://learn.microsoft.com/en-us/windows/win32/rpc/security-and-extended-error-information). -Der neue Versuch schaltet keine Registry-/Audit-/EEInfo-Policy um. - -## Exakt begrenztes Source-Delta - -Neue sibling-Dateien unter `deploy/windows/clock-eeinfo-trace/`, eigener Dienst -`RmmClockSystemEeInfoDiagnostic`, eigene History. Original131, alter Wrapper -und vorheriger SYSTEMrunner bleiben unverändert und readbackfähig. - -`clock_rpc_eeinfo.c` ist eine sichtbare Diagnosequellvariante gegenüber -`clock_rpc.c`, Original-SHA256 -`74aceb6e2b70c5dd628fae069a842c356c20300b8c8ab12754258c78eaf295c8`. -Der Build speichert `wrapper-source.diff` samt Hash. Änderungen ausschließlich: -`rpcasync.h`, fester104Byte-Numerikpuffer, Parameterweitergabe, neuer -Diagnoseexport und Capture im bestehenden `RpcExcept` direkt nach dem lokal -gespeicherten ursprünglichen Exceptioncode. Auth-/Endpunkt-/NDR-/QoSzeilen -bleiben gleich. Originalcode5 wird nicht durch Enum-Returncodes ersetzt. - -Die tatsächlichen SDK-Prototypen werden aus dem Header verwendet: -`RpcErrorStartEnumeration(RPC_ERROR_ENUM_HANDLE*)`, -`RpcErrorGetNextRecord(RPC_ERROR_ENUM_HANDLE*, BOOL, RPC_EXTENDED_ERROR_INFO*)` -und `RpcErrorEndEnumeration(RPC_ERROR_ENUM_HANDLE*)`. -Microsoft verlangt den [sofortigen Enumerationsstart](https://learn.microsoft.com/en-us/windows/win32/api/rpcasync/nf-rpcasync-rpcerrorstartenumeration), -da spätere Aufrufe die Threaddaten überschreiben können. Der Start steht vor -jedem weiteren RPC-/BindingFree-Aufruf im Handler. - -Höchstens vier NextRecord-Aufrufe, keine fünfte Abfrage. Je Record verlassen -nur GeneratingComponent, Status, DetectionLocation, Flags und NumberOfParameters -C. Keine Parameterwerte, Strings, ComputerName, Binary-/Pointerdaten oder -Zeit-/Namensfelder werden kopiert/exportiert. Gemäß -[GetNextRecord](https://learn.microsoft.com/en-us/windows/win32/api/rpcasync/nf-rpcasync-rpcerrorgetnextrecord) -werden Version, Flags und **MaxNumberOfEEInfoParams** als Eingabekapazität gesetzt; -Nullkapazität könnte sonst BUFFER_TOO_SMALL auslösen. CopyStringsFALSE bedeutet -geborgte RPC-Daten, die der Aufrufer weder verändert noch freigibt. Bei -erfolgreichem Start wird immer -[EndEnumeration](https://learn.microsoft.com/en-us/windows/win32/api/rpcasync/nf-rpcasync-rpcerrorendenumeration) -aufgerufen. `limit_reached=1` bedeutet ausschließlich erreichtes Viererbudget, -keinen Beweis eines weiteren Records. - -Die neue SID18-Servicehülle ruft genau einmal denselben Tracepfad auf. Höchstens -4096Bytes Ergebnis, ausschließlich numerische Zusatzdaten und feste Labels; -clock/adapter/productgate bleiben false. Keine Impersonationserhöhung, -Anonymous-/unauthenticated-Fallbacks, ACL-, NTP- oder Accountänderung. -Prepare/Start/Readback/Cleanup bleiben getrennt; Cleanup nur eigener eindeutig -gebundener gestoppter Dienst, Remote-Readback ausschließlich lesend. - -## Tatsächlich lokal geprüft - -```text -python3 deploy/windows/clock-eeinfo-trace/build.py -``` - -Offline im gepinnten bisherigen Image gebaut. Neue C-Hülle/Wrapper bestehen -`-Wall -Wextra -Werror`; nur dieselben drei bekannten Stilwarnungen am -unveränderten echten Microsoft-MIDL-Stub bleiben sichtbar. Kein Typ-/Security- -Warning wurde unterdrückt. Link/PE-x64-/Import-/private Manifestguards bestanden, -ebenso der tatsächliche PowerShell-AST-Lauf; EncodedCommand16718Zeichen. -Imports nur ADVAPI32/KERNEL32/RPCRT4/msvcrt. - -Finaler Manifest: -`devstate/windows-clock-eeinfo-trace/build-8d33bc4b-a0ce-430e-aa5b-5d1dc112ecf0/manifest.json`, -SHA256 `2b10417c41ff5c293f71e303b703e8d883d3ba7bc361bb047417d5de66124b49`. -PE101312Bytes, SHA256 -`cef50aa281069c76494f88ef893191e3978f9a3c66d162658f5914a5193d2787`. -Der frühere lokale Pack `9ca2ff31…` bleibt erhalten und wird nicht für die -Probe verwendet; der finale Driver bindet zusätzlich den sichtbaren Diff und -prüft ursprünglichen Exceptioncode gegen Originaltrace. - -Acht manipulierte Record-/Reportfälle, Viererbudget, ursprünglicher RPCcode, -String-/Parameterverweigerung, kein Datenbeleg bei leerem EEInfo und rein -lesendes Readback wurden lokal mit ausdrücklich **simulierten** Reports geprüft. -Diese dürfen eine vollständig ausgeführte Diagnose darstellen, beweisen aber -keinen echten RPC-/Status-/Clockerfolg. `local-guards.json` kennzeichnet die -Mocks und `native_executed=false`; alte SYSTEMdateien wurden bytegleich -nachgeprüft. Keine SSH-/VM-/Dienst-/RMM-Aktion durch diesen Subagenten. - -## Tatsächliche einmalige Root-Probe und getrenntes Readback - -Root führte den freigegebenen finalen Pack im Fall -`e4e6e12f-6c1b-4bd2-8072-70c5e6634aa6` auf der Windows-VM aus. Der eigene -SYSTEM-Diagnosedienst meldete genau einen Queryaufruf und beendete sich mit -Service-Exitcode0; die RPC-Abfrage selbst blieb ausdrücklich fehlgeschlagen: -`token_system=true`, RPC5, Stage90, Exception5, kein normaler RPCreturn und kein -Statusobjekt. Service-Exit0 ist hier ausschließlich Abschluss der Diagnose. -Clock-, Adapter- und Produktgate blieben false. Kein RMM-Job entstand. - -Die unmittelbar im Exceptionhandler erfassten numerischen EEInfo-Daten sind: - -| Feld | Tatsächlicher Wert | -| --- | --- | -| capture_attempted / start_status | 1 / 0 | -| next_status / end_status | 1761 / 0 | -| count / limit_reached | 1 / 0 | -| generating_component / status | 2 / 5 | -| detection_location / flags / number_of_parameters | 1750 / 0 / 1 | - -Keine Parameterwerte, Strings, Rechnernamen oder Binary-/Pointerdaten wurden -exportiert. Der lokal erhaltene `diagnostic-result.json` hat SHA256 -`80accca4f99a2ede0ccb3fd0a21730f69a53a6310c6c6ead42aa4d958c56b6f4`. -Ein gesonderter lesender Aufruf lieferte dasselbe vollständige Reportobjekt: -`readback-2a256a82-5e0d-4895-b3d9-0a67cfa841e8.json`, SHA256 -`93a1655fa4327579580e6df661ec7243af282af1f175735d882ccbd1ec9002b5`. -Die Dateien liegen im privaten ursprünglichen Caseverzeichnis unter -`devstate/windows-clock-eeinfo-trace/`; keine Zugangsdaten oder Transportpräfixe -gehören zum publizierbaren Beleg. - -Root entfernte anschließend ausschließlich den eigenen gebundenen gestoppten -Diagnosedienst. Der separate Cleanupbeleg -`readback-a1ef841d-218e-4adc-9075-1af320baf1f5.json`, SHA256 -`c03b535f21f430399f9ae3fbdca8d1e869b80ae6567b762eded04f208a68fcc3`, -meldet `cleanup_verified=true`; das war eine explizite Cleanupaktion, kein -lesender Aufruf. Root hat zusätzlich die vollständige Preservationprüfung -abgeschlossen: ursprüngliche Agent-/Helperdienste und Prozessgeburten, Codehashes, -FileIDs, PKI-/Datenbankzeugen und serverseitiger Zustand stimmen vor/nach exakt -überein. Keine neuen Jobs, Clockgate weiterhin false. Vorherbeleg-SHA256 -`3d508df7a46b3ab181f9d9575432e544627609fed98c77dabb107a7798bcb87b`; -Nachherbeleg `eeinfo-trace-after.json` im ursprünglichen privaten -`windows-pipe-drain/devstate/windows-client/system-pipe-upgrade/14fb176a-f653-4573-a8d7-6f9fe47a3020/`-Kontext, -SHA256 `921cd12b8f90c0921a6a11ec48d3ef61d4fffb2f6f3979f5f8731d2ac6425240`. -Das ist ein Erhaltungsnachweis der Diagnose, kein erfolgreicher Clock-/Jobnachweis. - -## Belegte Deutung und verbleibende Grenze - -Microsoft ordnet [GeneratingComponent2 der RPC-Runtime zu](https://learn.microsoft.com/en-us/windows/win32/rpc/understanding-extended-error-information). -Status5 bezeichnet [Access denied](https://learn.microsoft.com/en-us/windows/win32/debug/system-error-codes--0-499-). -Dies benennt den meldenden Layer und den Fehler, weder die konkrete verweigernde -ACL noch den tatsächlichen serverseitigen Caller oder einen anonymen SSPIkontext. - -DetectionLocation ist laut derselben EEInfo-Dokumentation ein von der -Implementierungsversion abhängiger interner Codeort. Die öffentliche -[Detection-Locations-Tabelle](https://learn.microsoft.com/en-us/windows/win32/rpc/extended-error-information-detection-locations) -gilt ausdrücklich für WindowsXP und enthält1750 nicht. Auch -[MS-EERR2.2.3](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-eerr/92064599-dc99-4e86-a887-b377a95ac678) -liefert keine Zuordnung für1750/Component2. Die geprüften Primärquellen erklären -diesen Windows-11-Codeort somit nicht. Die Zahl1750 ist hier außerdem kein -Win32-Returncode und darf nicht als dessen Fehlername dekodiert werden. - -Der Enumstatus1761 ist gemäß [GetNextRecord-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcasync/nf-rpcasync-rpcerrorgetnextrecord) -das normale Ende nach dem letzten erfolgreich gelesenen Record. Ein Record -wurde erfasst, das Viererbudget nicht erreicht; dies ist kein Enumfehler anstelle -des ursprünglichen RPC5. Flags0 meldet keine Missing-Record-Flags. Microsoft -beschreibt EEInfo dennoch ausdrücklich als [best effort und ungeeignet für Produktentscheidungslogik](https://learn.microsoft.com/en-us/windows/win32/rpc/reliability-of-extended-error-information): -eine vollständige Ursachen- oder Nichtanonymitätsgarantie folgt daraus nicht. - -Die enge Diagnose hat damit einen tatsächlichen Runtime-EEInfo-Beleg geliefert, -keinen W32Time-Status oder Clocknachweis. Eine weitere Deutung des Codeorts -braucht einen zum tatsächlichen Windows-/RPC-Build passenden Primärnachweis. -Keine ACL-/Konto-/Auth-/NTPänderung und keine Ersatzclock/Brokerarchitektur wird -aus diesem Record abgeleitet; sämtliche Produktgates bleiben geschlossen. diff --git a/docs/windows-clock-identity-result.md b/docs/windows-clock-identity-result.md deleted file mode 100644 index fba4a44..0000000 --- a/docs/windows-clock-identity-result.md +++ /dev/null @@ -1,69 +0,0 @@ -# V5-SID-/Service-Descriptorprobe: Bindung verweigert - -2026-11-14. Nach dem [erfolgreichen reinen RPC-Vergleich](windows-clock-impersonate-result.md) -wurde eine getrennte, ausdrücklich nicht qualifizierende Identitätsprobe -vorbereitet. Die Produktdateien und alle früheren Reader/Belege blieben erhalten. - -Die vier Quellen `deploy/windows/clock-spnego-identity-trace/` verwenden -GSS9/Privacy6/Impersonate3 sowie QOS5 mit Mutual-Auth-Anforderung, fester -Account-SID als dokumentierter Alternative zum Authprincipal und einem -clientseitigen Serverdescriptor mit fester Service-SID. Die tatsächlich -zurückgegebene Discoveryzeichenfolge wird weiterhin geprüft und freigegeben; -sie wird nicht als Identitätsautorität übernommen. Die Bindung verwendet hier -ausdrücklich NULL für ServerPrincName und dafür den festen SID-Parameter. -[Dokumentierter QOS5-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w). - -Drei eng geschlossene Buildkontrollen sind vorgesehen:0 für LocalService/ -W32Time,1 für falschen Systemaccount,2 für falsche RmmDiscoveryWindows-Service-SID. -Die Kontrolle wird fest kompiliert und im Manifest gebunden; der tatsächliche -numerische Report muss exakt dazu passen. Kein Setter, Fallback, RMM-Job oder -Produktgate. Derselbe eigene Enable-/Restoreablauf mit ausschließlich lesenden -fremden Tokenhandles und erhaltener Prozessbindung bleibt bestehen. - -Tatsächliche lokale Prüfung: Der erste Build `bafde30c…` scheiterte vor Link -an einer fehlenden QOS5-Typdeklaration im neuen Wrapper. Der fehlende Block -wurde danach bytegleich aus dem bisherigen Produktwrapper übernommen, -einschließlich x64-/SDK-ABI-Assertions. Kein Compilerfehler wurde unterdrückt. -Der neue Build für Kontrolle0 bestand C-Werror, unveränderten Microsoft-MIDL- -Compile, Link, Importgrenze, PowerShell-AST und lokalen Manifestreader. -Unabhängiger Quellenreview ohne weitere Funktionsblocker;131 Produktinputs -und23 frühere Diagnoseinputs unverändert. Kontrollen1/2 wurden noch nicht gebaut -oder auf der VM ausgeführt. - -Manifest `d3a6222da8aed64e4e5ad5c07993177a11f56af229d4754ea04f248ee79385bc`, -PE117586Byte/SHA256 -`5c55327f5569723875bb4b2622dd12fda76dbb041ea80d0a64324acc940440ba`. - -## Tatsächlicher VM-Befund - -Root führte ausschließlich Kontrolle0 im eigenen neuen Fall -`bcda2ede-d3e0-41bf-94e9-9f44ea785c54` aus. Einmalige Vorbereitung/Übertragung -und ein eigener SYSTEM-Dienststart, anschließend separater lesender Readback: - -- DienstStopped/Exit0, Diagnose vollständig aufgezeichnet; -- eine erfolgreiche Discovery mit tatsächlich nicht-NULL leerem Principal; -- QOS5/Control0, Serverdescriptor vorhanden; -- `RpcBindingSetAuthInfoExW` verweigert mit87 bei Stage30; -- **null Statusqueries**, kein normaler Statusreturn und kein EEInfo-Record; -- eigenes vorhandenes Privileg nach Aktivierung vollständig nachgelesen - zurückgesetzt, beobachtete Peertoken unverändert; -- anschließend ausschließlich der eigene gestoppte Diagnosedienst entfernt. - -Endbeleg `diagnostic-result.json`, SHA256 -`ce4004b1fd833b9590f23d31a918daefccf8870e6630be6beb28869fad1f8b5c`. -Separater Erhaltungsnachweis: alle sechs bestehenden nativen RMM-Bereiche -und Servergate gleich, Windows0/0/0/0 und Linux31/31/27/0, Rootpolicycf15 geschlossen. -Before-SHA256 `ee28b23c474958b47ebeb50e03e3c2b21df4bddfc777583908921d5b4982de77`, -After-SHA256 `de130d3e6f279d84f8b56cc896fd50ef04415b09f6349eb615eda87971ca97a7`. -„Diagnose vollständig“ bedeutet hier einen vollständig erhaltenen Fehlerbefund, -keinen positiven Identitäts- oder Clocknachweis. Weil schon die erwartete -Identität keinen Statuspfad erreicht, wurden keine negativen Identitätskontrollen -als vermeintliche erfolgreiche Sicherheitsabnahme nachgeschoben. - -Der konkrete Parameterverbund ist damit auf dieser VM nicht zugelassen. -Welcher einzelne Parameter diese87-Ablehnung verursacht, ist noch nicht isoliert. -Insbesondere wird daraus weder eine generelle Nichtunterstützung jeder V5- -Named-Pipe-Konfiguration noch eine erlaubte Lockerung der Produktidentität -abgeleitet. Eine weitere dokumentierte Parameteralternative benötigt einen -separaten Quellen-/Build-/Nativefall. Produktclock/Jobs bleiben geschlossen. -NTPresync wartet weiterhin auf die konkrete Benutzerfreigabe. diff --git a/docs/windows-clock-impersonate-result.md b/docs/windows-clock-impersonate-result.md deleted file mode 100644 index 79909dd..0000000 --- a/docs/windows-clock-impersonate-result.md +++ /dev/null @@ -1,102 +0,0 @@ -# Nativer RPC-Vergleich: Impersonate statt Identify - -2026-11-14. Der getrennte Diagnosefall -`daf8205c-a110-4fb7-9ae0-f27ca1532d8f` liefert erstmals einen normalen -erfolgreichen W32Time-Statusreturn. **Keine Produktclockfreigabe:** Dienstidentität, -LocalService-Pfad und tatsächliche Zeitqualität sind weiterhin separat nachzuweisen. - -## Konkreter Anlass und geprüfter Unterschied - -Die [vorherige Diagnose](windows-clock-process-privilege-result.md) hatte trotz -nachgewiesen aktivem vorhandenem Prozessprivileg weiterhin RPC5/Stage90 ergeben. -Der Windows-eigene `w32tm /query /status /verbose` dagegen lieferte als -bestehender Admintransport Exit0. Seine Ausgabe war selbst Leap3/Stratum0, -nicht synchronisiert; damit bestehen unabhängige Transport- und Zeitqualitätsgates. - -Root las ausschließlich die vorhandenen Microsoft-Systemdateien `w32tm.exe` -und `w32time.dll`, prüfte SignaturstatusValid und identische SHA/Länge vor und -nach der privaten Kopie. Keine Installation oder DLL-/Produktänderung: - -| Datei | Bytes | SHA256 | -| --- | ---: | --- | -| w32tm.exe | 274432 | `e81bcc55d0ed5d744b2f23417e9b2706e17a1c02a340503887679f54005570e5` | -| w32time.dll | 745472 | `38c2efef83c2becb913d820b02fb16e987eccebf06ae4072093632b4c3bcc2ab` | - -Lokale PE-Analyse dieser konkreten DLL: Der Export `W32TimeQueryStatus` -(RVA280d0) ruft Discovery mit GSS9 und anschließend -`RpcBindingSetAuthInfoW` mit Privacy6 auf. Der gefundene serverseitige -Callback ruft nach `RpcImpersonateClient(NULL)` -`OpenThreadToken` mit TOKEN_QUERY und OpenAsSelfFALSE auf. Das ist ein -versionsgebundener Binärbefund, kein allgemeiner Vertrag jeder Windowsversion. -Microsoft dokumentiert, dass das Öffnen des Tokens auf Identification-Stufe -OpenAsSelfTRUE benötigt, da diese Stufe keine Executiveobjekte öffnen darf. -[OpenThreadToken-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-openthreadtoken). -Die RPC-Standardstufe ist Impersonate, wenn die höhere Ebene nichts anderes -vorgibt. [MS-RPCE](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-rpce/fd5d5c6e-80f4-49b5-887f-4ce844cc62c4). - -Deshalb wurde ein neuer, ausdrücklich getrennter Diagnosekandidat erstellt: -die RPC-Stufe wechselt von Identify2 auf Impersonate3. Das erlaubt dem lokalen -RPC-Server die lokale Impersonation des Diagnoseprozesses; es ist keine -Delegatestufe und keine stille Produktlockerung. Namen/Fallprofil/Elternbezüge -sind getrennt. GSS9, Privacy6, tatsächlicher zurückgegebener nicht-NULL -Principal einschließlich Emptystring, eine Discovery und höchstens eine -Opnum6 bleiben unverändert. Kein Authfallback oder Setter. Der gleiche -SYSTEM-Own-Token-Enable-/PreviousState-Restoreablauf und die vier gehaltenen -Peerprozesse mit ausschließlich TokenQUERY bleiben erhalten. - -## Tatsächliche lokale und native Ergebnisse - -Die vier neuen Quellen unter `deploy/windows/clock-spnego-impersonate-trace/` -wurden unabhängig geprüft. Manifest -`5644a50aee329144cb32c5bf0ebf4992ec068c59ca024416b66e8201366fd702`, -PE114089Byte/SHA256 -`885a6f28df76ebc06e1457628cb4387bc9c0fa822b750fd29ce29d50aaf08fa5`. -Tatsächlich bestanden: C-Compile mit Warnungen als Fehler, unveränderte -Microsoft-MIDL-Ausgaben, Link, DLL-Importgrenze, PowerShell-AST sowie lokaler -Manifestreader. Original131 Produktinputs,19 vorherige Diagnoseinputs, -Elternmanifest6c976583 und ursprünglicher Fehlerbelegc7556589 bleiben bytegleich. - -Root bereitete den separaten Fall vor, übertrug dessen feste EXE und startete -genau einmal den eigenen temporären SYSTEM-Dienst. Tatsächlich: - -- DienstStopped/Exit0; vollständiger normaler Return, RPC0, Stage80; -- native Rückgabe0, Status vorhanden, ulSize120, cEntries0, pEntriesNULL; -- genau eine erfolgreiche Principaldiscovery, tatsächlich nicht-NULL/leer, - genau eine Opnum6 mit GSS9/Privacy6/Impersonate3; -- keine RPC-Ausnahme und kein EEInfo-Record; -- genau ein erfolgreiches Aktivieren des vorher vorhandenen Privilegs und - nachgelesene vollständige Rücksetzung; alle beobachteten Peertoken unverändert. - -Ein separater rein lesender Same-case-Aufruf bestätigte das Originalergebnis; -anschließend wurde ausschließlich der eigene gestoppte Dienst entfernt. -Endbeleg `diagnostic-result.json`, SHA256 -`26a06f8f46a7b5fa173c5ee81cd97a4542571a7b97b15fd5e0e8a41315680c4e`. -Zusätzliche native Erhaltungsnachlese bestanden: sechs bestehende RMM-Bereiche -und vollständiger Servergate gleich; Windows0/0/0/0, Linux31/31/27/0, -Rootpolicycf15 geschlossen. Before-SHA256 -`d0f45d6d25936de2d4d66ef79b9bd3a1bb9bd5013cbbcd7ef3d145703e6c96cd`, -After-SHA256 `792e164fcdc567c3ac620d89a7d8907ab6d80b9485e135c6744c92191eae31fe`. - -Im kontrollierten Vergleich ändert der explizite RPC-Stufenwechsel das Ergebnis -von5/Stage90 auf0/Stage80. Das stützt die konkrete Identify-/Callbackursache; -ein interner Fehlerort des früheren fehlgeschlagenen Aufrufs wurde nicht -serverseitig instrumentiert. Eine Discovery oder der zurückgegebene SPN, -insbesondere unter NTLM, ist weiterhin kein unabhängiger Dienstidentitätsbeweis. -Der Diagnosepfad enthält keine Produktionsfreigabe oder RMM-Jobausführung. - -## Weiter offen - -Die Produktclock braucht einen nachgewiesenen Account-/W32Time-Servicebezug -mit passenden tatsächlichen negativen Identitätskontrollen; außerdem einen -nativen LocalService- und Unsicherheits-/Kontinuitätsnachweis. Die vorhandene -VM-Uhr ist laut Builtinstatus unsynchronisiert. Zwei rein lesende NTP- -Stripchartproben zum bereits konfigurierten Peer antworteten; privater Beleg -`156f5df32f54f3886b9712eecee6f73d7f08b3ddb3b216e9219137c89dc15785`. -Dies prüft den Stripchartpfad und beweist nicht die erfolgreiche -W32Time-Synchronisierung über dessen eigenen Quellport. Ein einmaliger -`w32tm /resync` wurde dem Benutzer konkret zur Freigabe vorgelegt und hier -noch nicht ausgeführt. NTPserver/Peers, Startart, ACLs, Rechtezuweisung, -Produktdateien, Clockgate und Windows-RMM-Verbrauch blieben unverändert. - -Private Belege einschließlich PE-Kopien/Disassembly bleiben gitignoriert; -Microsoft-Binärdateien oder deren vollständige Disassembly werden nicht publiziert. diff --git a/docs/windows-clock-midl-codegen.md b/docs/windows-clock-midl-codegen.md deleted file mode 100644 index 3387e3f..0000000 --- a/docs/windows-clock-midl-codegen.md +++ /dev/null @@ -1,107 +0,0 @@ -# Nächster Clock-Diagnosekandidat: Microsoft-MIDL-Codegenerierung - -Stand 2026-11-14. **Geplant, nicht auf der Windows-VM ausgeführt.** Der -Narrow-IDL-Pointerkandidat `91889303…` liefert laut getrenntem nativen -Root-Beleg weiterhin `1783` in Trace-Stage 90, ohne normale RPC-Rückkehr und ohne -Status. Seine einzelne Pointeränderung ist damit nicht als ausreichender Fix -belegt. Das beweist nicht, dass Pointersemantik irrelevant ist. ALPC `1753` und -das geschlossene Clock-Gate werden davon nicht verändert. - -## Enger nächster Nachweis - -Microsoft beschreibt [MIDL-generierte Clientstubs](https://learn.microsoft.com/en-us/windows/win32/midl/files-generated-for-an-rpc-interface) -als vorgesehenen Weg; die [NDR-Dokumentation](https://learn.microsoft.com/en-us/windows/win32/rpc/rpc-ndr-engine) -rät ausdrücklich von handbearbeiteten Stubdaten ab. Deshalb folgt kein weiterer -Formatbytepatch. Ein separat gehaltener Microsoft-Generator soll denselben -Quellvertrag erzeugen, bevor ein weiterer RPC-Diagnosekandidat gebaut wird. - -Das offizielle [SDK-NuGet-Paket 10.0.26100.9169](https://www.nuget.org/packages/Microsoft.Windows.SDK.CPP/10.0.26100.9169) -wurde ausschließlich auf dem Entwicklungsrechner über verifiziertes TLS geladen -und als ZIP aufgelistet, nicht installiert oder ausgeführt. Privater Fall: -`devstate/windows-clock-midl/6b7fb9b1-0bb7-4880-850b-e6812d3df1b1`. -Paket: 160512239 Bytes, SHA-256 -`475269434dcd808a67853773272f972c3229c0e10c3ddc821290e70cc0f6904d`. - -Genau die enthaltenen Tools `c/bin/10.0.26100.0/x64/midl.exe` und `midlc.exe` -reichen nach statischer Importprüfung als Kandidat: beide importieren nur -`KERNEL32.dll` und `msvcrt.dll`. Das ist noch kein Beweis, dass sie auf dem Ziel -ohne weitere Abhängigkeit laufen. Tool-SHA-256: - -- `midl.exe`, 154048 Bytes: - `7a2a717be64f755390ad8b04cb034549b2606acec646ec7cbe44c67516ccba83`. -- `midlc.exe`, 1366464 Bytes: - `34293d7bd256f2d43311d197f13bbb8a1ae26c92cc1605d9f35dd3ddfe264b65`. - -**Microsoft-Authenticode und Zertifikatskette sind noch nicht geprüft.** -Der Paketdownload und ein berechneter Hash ersetzen diese Prüfung nicht. -Vor Toolausführung müssen die exakten Dateien am Ziel einen gültigen erwarteten -Microsoft-Signer und dieselben Hashes besitzen. Keine Trust-/Zertifikatänderung. - -## Geplanter begrenzter Ablauf - -Ein eigener create-only Fall erhält Quellen, Toolhashes und vor dem Start einen -dauerhaften Startintent. Es werden nur die beiden Tools und die gehashte -IDL-Quelle in ein eigenes Administratorverzeichnis übertragen. Keine Installation, -kein Registry-/PATH-/Policy-/Servicewechsel und keine RPC-/RMM-Ausführung. -Verlorene Antwort bedeutet ausschließlich Readback desselben Falls, keinen -neuen Toolstart. Toolausgabe und erzeugte Dateien bleiben als private Originale -erhalten; Ausgangsquellen werden nicht überschrieben. - -Geplante feste Argumente: - -```text -/nologo /no_cpp /env amd64 /Oicf /robust /Zp8 /protocol dce -/client stub /server none /h w32time.h /cstub w32time_c.c w32time.idl -``` - -[`/no_cpp`](https://learn.microsoft.com/en-us/windows/win32/midl/-no-cpp-nocpp) -ist der offizielle Verzicht auf den C-Präprozessor. Die enge Quelle besitzt keine -Includes oder Präprozessordirektiven; ein fehlendes CL soll nicht durch -Installation/Policyänderung kompensiert werden. [`/env amd64`](https://learn.microsoft.com/en-us/windows/win32/midl/-env) -setzt das tatsächliche x64-Ziel und 8er-Packung; -[`/protocol dce`](https://learn.microsoft.com/en-us/windows/win32/midl/-protocol) -hält die bisherige DCE-NDR-Transfersyntax konstant. Es gibt keine stillschweigende -NDR64-Umstellung. - -Zuerst werden die originale [Microsoft-Voll-IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a) -und die unveränderte enge Quelle separat generiert. Zu vergleichen sind der -Opnum-6-Vertrag, der vollständige Pointerpfad, expliziter Bindinghandle, alle -19 Statusfelder und der 120-Byte-x64-ABI. Die Voll-IDL ist ausschließlich -Vergleichseingabe; ihre anderen Operationen werden niemals aufgerufen. - -Nur nach erhaltenem nativen Codegenbeleg kann ein neuer separat gehashter -Diagnosebuild mit **unverändertem generiertem** Clientstub und bisherigem -C-Wrapper untersucht werden. Ein konkretes Compiler-/Headerproblem muss offen -benannt werden; kein manuelles Umschreiben von NDR-Daten. Authentisierung, -Endpoint, SEH-Grenze, Allocatorgrenze, Statusguard und `ADAPTER_QUALIFIED=false` -bleiben unverändert. Ein lesbarer Named-Pipe-Status allein ist keine qualifizierte -Clock oder Helper-Zeitautorität. - -## Vorbereiteter Runner (weiterhin kein Zielnachweis) - -`deploy/windows/midl_codegen.py` implementiert die getrennten Aktionen -`prepare`, `start`, `readback` und verwendet ausschließlich den streng geparsten -bestehenden SSH-Bootstrapzugang aus dem expliziten Hauptrepo-Accessroot. Der -15-KiB-Body wird als gehashte `MidlCodegen.ps1` übertragen und regulär mit -prozessbezogenem `RemoteSigned` als Datei aufgerufen; kein großer -EncodedCommand und kein ScriptBlock-Dateiausführungsersatz. - -Vor Start prüft der Runner gültiges Microsoft-Authenticode, die Onlinekette, -Hash, Länge und die tatsächliche feste Tool-Dateiversion `8.1.628.1`. Die -zugehörigen lokalen PE-Zertifikatsmetadaten wurden lediglich gelesen; das ist -noch keine Authenticodeprüfung. Ein vor `CreateProcessW` installierter -`PROC_THREAD_ATTRIBUTE_JOB_LIST` ordnet den MIDL-Prozess samt seinen eigenen -Nachkommen atomar einem unbenannten Kill-on-close-Job zu; höchstens zwei -Prozesse, ausschließlich drei Standardhandles geerbt, kein später -Assign-Fallback. Nach zehn Sekunden oder überschrittenem Outputlimit wird nur -dieser eigene Job beendet, höchstens insgesamt zwei weitere Sekunden beobachtet -und dann geschlossen. Auch die Pfade für Header und Clientstub sind fest, -jeweils höchstens 256 KiB. Kein globales Compiler-/Installer-Kill. - -Lokale Qualification: -`devstate/windows-clock-midl/6b7fb9b1-0bb7-4880-850b-e6812d3df1b1/runner-final-qualification/qualification.json`, -SHA-256 `dab36fbab3e407cbae6d97f27068abe8f57cc13243b94b4fd95fe9108dc7a508`. -Python-Syntax, drei PowerShell-ASTs ohne Fehler und reine C#-Deklarationskompilierung -bestanden; keine Win32-Funktion aufgerufen, keine Zielverbindung. -Runner-SHA-256: -`078bf2303979dbeccdb7eb84e116325e7f155146d93d0dc0fff6b3e6bdd1b2eb`. diff --git a/docs/windows-clock-midl-diagnostic-build.md b/docs/windows-clock-midl-diagnostic-build.md deleted file mode 100644 index a38435b..0000000 --- a/docs/windows-clock-midl-diagnostic-build.md +++ /dev/null @@ -1,237 +0,0 @@ -# Getrennter Diagnosebuild mit tatsächlichem Microsoft-MIDL-Output - -Stand 2026-11-14. Eigene Buildquelle; keine Änderung des Produktbuilders, -der bisherigen Runner oder früherer Binär-/Abnahmebelege. Kein VM-Zugriff, -kein RMM-Job und keine Clockqualifikation durch diesen lokalen Build. - -## Tatsächliche Eingangsdaten - -Root hat MIDL auf der Windows-VM im eigenen Fall -`149bafe2-3469-4580-b133-988812bcc3db` ausgeführt und anschließend denselben -Fall separat nur gelesen. Der neue lokale Builder prüft dessen vollständigen -Readback gegen SHA256 -`0dc2373825f7f8f224cda04ecd5c521dd3c37a6e712bc3ed83bc4fa6d0d89c8c`. -Der Beleg enthält erfolgreiche Microsoft-Authenticode-/Kettenprüfung der -festen Tools, Codegenexit0 und das Ende aller eigenen Prozesse. Es fand kein -RPC-Aufruf statt; `clock_qualified=false` bleibt ausdrücklich erhalten. - -Die zwei zurückgelesenen tatsächlichen Outputs werden unverändert als neue -Buildinputs kopiert und sowohl gegen die Originalbytes im Readback als auch -gegen feste Hashes geprüft: - -| Datei | Bytes | SHA256 | -|---|---:|---| -| `w32time.h` | 3779 | `db5dbe5b335eaa58a6512d4abfda44e7273f3aa8a43077dcb0719e4b97ee2bde` | -| `w32time_c.c` | 18866 | `d806adb431f16724c8afdea0c0751588a4bc6f82b6f0b8391d4d189d6a6f4a38` | - -`deploy/windows/clock_midl_diagnostic_build.py` erstellt pro lokalem Aufruf einen -neuen privaten Fall unter `devstate/windows-clock-midl/diagnostic-builds/`. -Er kopiert einen gehashten Quellsnapshot und verwendet ausschließlich diesen -Snapshot. Das separate Cargo-Paket unter -`deploy/windows/clock-midl-diagnostic/` bindet das vorhandene originale -`examples/clock_readiness.rs` und dessen originales `src/clock.rs` ein. C-Wrapper, -Endpointcode und Narrow-IDL sind ebenfalls unverändert und im neuen build.rs -zusätzlich fest gepinnt. `ADAPTER_QUALIFIED=false`, Authentisierung, Statusguard, -SEH- und Allocatorgrenzen werden nicht verändert. - -Es wird weder ein Compilerwrapper anstelle von WIDL ausgegeben noch ein -bestehendes OUT_DIR nachträglich verändert. Das neue build.rs kompiliert die -zuvor geprüften Originaloutputs direkt, ohne Generatorfallback oder NDR-Patch. -Der vorhandene Produktpfad `crates/agent-windows/build.rs` bleibt unverändert. -Der Lockfileabgleich erlaubt keine neue externe Paketversion gegenüber dem -ursprünglichen Root-Lockfile. Alle nachfolgenden Cargobefehle verwenden -`--locked --offline`; Docker läuft ohne Netzwerk und mit read-only Rootfilesystem. - -## Tatsächliche Compiler-/Linkerbefunde - -Die Microsoft-Quelldatei schützt ihren AMD64-Code mit `_M_AMD64`; Clang/GNU -definiert diesen Makronamen nicht selbst. Nur im getrennten tatsächlichen -x64-Build wird deshalb `_M_AMD64=100` gesetzt. Weder `_MSC_VER` noch -`__RPCNDR_H_VERSION__` werden definiert oder erhöht. Der echte MinGW-Header -meldet475; der originale Microsoft-Header verlangt475. - -Der unveränderte Microsoftstub enthält legale C-Klammerelision an einem -Unioninitializer sowie zwei unbenutzte konstante Tabellen. Der erste strikte -Versuch scheiterte an `-Wmissing-braces`; der zweite bewahrte zusätzlich die -konkreten `-Wunused-const-variable`-Befunde. Nur die exakt gepinnte generierte -Stubunit erhält `-Wno-error=missing-braces` und -`-Wno-error=unused-const-variable`: Die drei Warnungen bleiben im Log sichtbar, -alle übrigen Diagnosen bleiben Fehler. Die beiden unveränderten C-Wrapper -werden getrennt weiterhin mit `-Wall -Wextra -Werror` kompiliert. Kein -Typfehler, Strukturassert oder Sicherheitscheck wird abgeschaltet. - -Das isolierte kleine Rustpaket benötigt außerdem `mincore` zum Linken der -beiden unveränderten präzisen Interruptzeitgetter. Das vorhandene -MinGW-Kernel32-Importarchiv kennt sie nicht; `libmincore.a` enthält die -Windows-Realtime-API-Imports. Bereits die vorherige Readiness-EXE91889303… -importierte beide Getter über `api-ms-win-core-realtime-l1-1-1.dll`. -Es gibt keinen Ersatzgetter, keine Zeitberechnung aus Serverzeit und keinen -Runtimefallback. Die neuen PE-Imports werden separat erhalten. -Der tatsächlich erfolgreiche neue Link wählt für diese beiden Getter -`api-ms-win-core-realtime-l1-1-2.dll`, der frühere918…-Link dagegen -`api-ms-win-core-realtime-l1-1-1.dll`. Das ist eine zusätzliche tatsächliche -Linkdifferenz, kein reiner Einvariablenvergleich ausschließlich des Generators. -Ihre native Zulässigkeit wird hier nicht behauptet. - -Die unvollständigen Fälle `4ce00b43-4ca1-4e50-9f65-e89bd82f9364`, -`81b5503a-d78f-49be-b323-380c254cedff` und -`81d93ea1-f886-4853-8db4-f4e1c95f33ea` bleiben samt Eingängen und Logs erhalten. -Der letzte enthält bereits erfolgreiche Windows-Clippy- und fünf tatsächliche -Linux-Clocktests, aber einen fehlgeschlagenen Windows-Testlink. Diese Fälle -sind keine erfolgreichen vollständigen Diagnosebuilds. - -## Ausführung und Nachweisgrenzen - -Lokaler Buildbefehl, keine VM-Aktion: - -```text -python3 deploy/windows/clock_midl_diagnostic_build.py -``` - -Jeder Fall erhält Intent, genaue Compiler-/Lock-/Quellhashes und einzelne -Checklogs. Nur nach erfolgreichen fünf tatsächlichen Clocktests, Windows- -Clippy/-Testlink und Release-Link wird eine finale Qualifikation geschrieben. -Original-Linkdatei und separat gestrippte `WindowsClockReadiness.exe` bleiben -beide erhalten. Ein Windows-Crosslink ist kein nativer Windows-Lauf. - -Vollständiger tatsächlich erfolgreicher Fall: -`181c3a1c-8324-41fd-9b7c-aa8010262912`.131Compilerinputs vor/nach identisch; -Fmt, Windows-Alltargets-Clippy mit Rust-Warnungen als Fehler, alle fünf -Linux-Clocktests ohne Skip, Windows-Unitlink, Release-Link und PE-Importausgabe -bestanden. Die sichtbaren drei C-Stilwarnungen gelten ausschließlich für die -oben beschriebene gepinnte Microsoftstubunit. - -- Finale EXE:1217536Bytes, SHA256 - `b1d3da4f393ddf20bc8e48a9894ee314666f2ac3613ef97f5c228e3d089ca560`. -- Original-Linkdatei SHA256: - `5efcbbbdfe9c9d8b5954e4d550ba8f35fbaf1bcffefa610bd25b0c3797340d1c`. -- Finale `qualification.json` SHA256: - `2e0de3acf72ab5c3a8e0baa54e8643d086ea7c03d1b38fd89b6bfc00e45f8cbb`. - -Python-Syntaxprüfung des neuen Builders wurde ebenfalls tatsächlich ausgeführt. -Das ist lokale Crossbuild-/Vertragsqualifikation, kein Cloud-Linux- oder -Windows-VM-Nachweis und kein bestätigter Fix für die bisherige RPC1783-Ausnahme. - -Eine spätere tatsächliche Ausführung bleibt eine eigene Root-geführte -Diagnose mit konkretem Binaryhash und dem bestehenden Readinessrunner. -Selbst ein erfolgreicher Statusreturn würde weder die Named-Pipe-Serveridentität -noch Clockauthority oder den SYSTEM-/Jobpfad qualifizieren. Keine automatische -Wiederholung früherer RPC-Aufrufe und keine Genehmigungsabkürzung. - -## Ursprüngliche Vorbereitung der portablen Linux-Vorstufe - -`deploy/windows/clock_midl_linux_native.py prepare-local` wurde tatsächlich -lokal ausgeführt. Es kopiert ausschließlich die bereits im erfolgreichen -Build181c… ausgeführte Linux-Testexe; kein neuer Build und kein Strip. -Der separate Packfall lautet `f5d85873-96b2-41d5-97be-4c8f5c6baaef`, unter -`devstate/windows-clock-midl/linux-native-packs/`. Finale Manifest-SHA256: -`dcd6351898a1893253b352dce144d52dd45cd71aa1453295e648aa9d41afa67c`. - -Die tatsächlichen unveränderten26577504Bytes besitzen SHA256 -`6b3153d0d781798454f483c1c5b58089dcd2fe98b03c43aea3d928fd6107a9c8`. -ELF-Metadaten: x86-64, Interpreter `/lib64/ld-linux-x86-64.so.2`, höchste -benötigte Version `GLIBC_2.34`, direkte Abhängigkeiten `libc.so.6`, -`ld-linux-x86-64.so.2`, `libgcc_s.so.1`. Containerseitiges reines Listing -derselben Bytes bestätigt genau diese fünf bereits bestehenden Tests: - -```text -clock::tests::gate_requires_all_status_and_uncertainty_evidence -clock::tests::production_clock_stays_closed_until_native_adapter_qualification -clock::tests::suspend_closes_until_actual_post_resume_sync -clock::tests::timeout_worker_stays_closed_without_a_second_call -clock::tests::wall_step_and_overflow_fail_closed -``` - -Der neue Runner besitzt die getrennten Aktionen `native` und `readback`. -Nur Root führt `native --execute-native-tests --access-root ---manifest ` aus. Der bestehende strikte -SSH-/Credentialparser wird ausschließlich dann aufgerufen. Der Zielpfad -`/var/lib/rmm-clock-midl-portable-tests/` ist privat und create-only. -Originalintent, Startmarker vor dem ersten Prozess und finales Ergebnis werden -dauerhaft gespeichert. Verlorene Antwort erlaubt nur `readback --case `; kein zweiter Start. Ausschließlich die fünf hart codierten Tests dürfen -laufen, mit eigener Netzwerknamespace, bereinigter Umgebung, fünf Sekunden -je Test, zwanzig Sekunden Gesamtbudget und begrenzter Ausgabe. ELF-Loaderprüfung -erfolgt zusätzlich auf dem tatsächlichen Linuxziel. Keine bestehenden Dienste, -Jobs, Journale, Policies, Schlüssel oder Zeitdienstkonfiguration werden benutzt. - -Python-Syntax und lokales ELF-/Listpaket sind geprüft. **Der Autor dieses -Quellschnitts hat keine VM-Verbindung oder native Testausführung vorgenommen.** -Ein späterer Linux5/5-Beleg betrifft ausschließlich portable Clockguards, -keine Linux-NDR-Prüfung und keinerlei Windows-RPC-/Serveridentitäts- oder -Clockauthority-Nachweis. Root führt Windowsdiagnostik getrennt danach aus. - -### Readbackkorrektur vor der ersten nativen Ausführung - -Root-Review fand im zuvor vorbereiteten Linuxrunner einen konkreten Fehler: -Auch `read` hätte bei fehlender Zielwurzel ein Verzeichnis angelegt. Die -Korrektur beschränkt diese einzige Wurzelanlage auf `prepare`; `read` und -`run` verweigern eine fehlende Wurzel ausschließlich lesend. Der äußere -Readbackzweig ruft nur `action=read` auf, ohne Prepare, Upload oder Teststart. -Das ursprüngliche Pack f5d85873… bleibt erhalten, ist durch seinen alten -Runnerhash aber für den korrigierten Runner nicht mehr verwendbar. - -Der neue Packfall **68c5b69c-3391-4ff9-943d-3e5955be4e1f** enthält dieselben -unveränderten Testexebytes und dieselbe ursprüngliche Buildqualifikation. -Neues `manifest.json` SHA256: -`eceec2cc3f778cc46d58d1c10679fc38e5fcc7c7bee6eac99ef9454162f7ce48`. -Runner-SHA256: -`27a6a62e24a3908765bfe3c94d5ae75022210ebc6ab35ffc7f659bfe45844956`. -Die tatsächliche `native_case`-Teilquelle ist zusätzlich separat mit SHA256 -`ab7cd86e03684a6e7167d0c6814bc71edb39046e07b5794cfb0d6f195e2b6828` -gebunden. Manifest und spätere Originalintents binden außerdem die drei -Supportquellen `remote_client_bootstrap.py`, `vm_mvp_acceptance.py` und -`vm_access_check.py`. Jeder Native-/Readbackaufruf prüft diese Bindungen vor -dem ersten SSH-Aufruf; Sourceänderung verweigert den Zugriff. - -Tatsächlich lokal mit gemockten Ziel-/Transportobjekten geprüft: `read` bei -fehlender Wurzel ohne mkdir/open/Prozessstart; gleiches für `run`; äußerer -Readback genau ein Read-RPC ohne mkdir/SFTP/Testlauf; geänderte Supporthashes -vor RPC verweigert. Vier Guards bestanden, kein realer Zielzugriff. Beleg: -`readback-guards.json` im neuen Pack, SHA256 -`4db073802235d86b5233255a5fbf42be87808307abe32f47c4f6bb059ae8de31`. -Python-Syntax und erneutes reines ELF-/Testlisting bestanden. Alle ursprünglichen -131 Windowsbuildinputs wurden erneut gegen181c… verglichen und sind exakt -unverändert. Kein neuer Build, kein Strip und keine native Ausführung. - -## Danach tatsächlich: Cloud-Linux5 und Windowsdiagnose - -Root führte den korrigierten Pack68c5b69c nativ auf der Cloud-Linux-Test-VM -aus. Fall `222a0d60-4ddb-41c3-961c-2fa04138db28`: alle fünf festen portablen -Clocktests bestanden, jeder als exakter eigener Fall, keine ignorierten Fälle. -Originalbytes/Loader, Netzwerknamespace, begrenzte Ausgabe und feste Budgets -geprüft. `passed.json`-SHA256: -`b045ddccba9fff80ecba3b81649e14330b58f79b04990b5b257b1d6a3df39d3e`. -Keine Linux-NDR- oder Windows-RPC-Prüfung aus diesem Erfolg ableiten. - -Erst danach wurde Windows-EXEb1d3da4f im neuen eigenen LocalService- -Diagnosefall `94562d81-f75f-45c8-ab6b-28b70d12bd81` einmal ausgeführt. -Der bestehende Readinessrunner blieb unverändert; anschließend wurde derselbe -Originalbericht separat nur lesend identisch bestätigt. Der eigene temporäre -Dienst wurde entfernt. ResultatSHA256: -`91176b2c6832573786de9a8a15f9f239a0f93d7b0d5fef5eb36ac39f992b9232`. - -Tatsächliches Token: SID19/LocalService, kein Administrator und kein SYSTEM. -Beide ALPC-Versuche sowie deren falsche Account-/Servicekontrollen liefern -weiter1753 ohne Status; damit ist keine Identitätsverweigerung bewiesen. -Die getrennte Named-Pipe-Diagnose liefert jetzt **RPC5/AccessDenied** statt -des früheren1783. Trace: Stage90, `rpc_exception=5`, kein normaler nativer -Return und kein Status. Dies ist eine neue konkrete Fehlerbeobachtung, -**keine erfolgreiche W32Time-Abfrage** und kein isolierter Ursachennachweis; -die dokumentierte APIset-Linkdifferenz bleibt Bestandteil dieses Kandidaten. - -Ein separater Vorher-/Nachherabgleich des tatsächlich laufenden Agent-/ -Helperpaars prüfte PIDs/Geburt, Dateien/PKI/DB-/Lock-Datei-IDs, Helperwitness und -geschlossene Serverzähler/Flags unverändert. NachherbelegSHA256: -`09493104ca46b53b235df677f70289ef48bbfd718c8f5c82790921986db27bc8`. -Keine W32Time-ACL-/Konto-/NTP-Änderung, kein Agentwechsel oder RMM-Job. - -Microsoft dokumentiert für LocalService anonyme Netzwerkanmeldedaten und für -MS-W32T den authentisierten Named-Pipe-Endpunkt W32TIME_ALT. -[LocalService](https://learn.microsoft.com/en-us/windows/win32/services/localservice-account), -[MS-W32T-Transport](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655). -Ein Token-/Authentisierungseinfluss ist damit eine begründete **Hypothese**, -keine bewiesene Ursache des konkreten5. Als nächster enger Diagnoseschritt wird -ein eigener lesender SYSTEM-Vergleich mit unveränderten C-/Auth-/MIDLinputs -vorbereitet; kein Lockern der bestehenden LocalService-Prüfung oder -Zeitdienstrechte. Produktgate/Clock/Jobs bleiben geschlossen. diff --git a/docs/windows-clock-next-diagnostics.md b/docs/windows-clock-next-diagnostics.md deleted file mode 100644 index bff782c..0000000 --- a/docs/windows-clock-next-diagnostics.md +++ /dev/null @@ -1,92 +0,0 @@ -# Clock: nächste Diagnosegrenzen, noch keine Implementierungsfreigabe - -Historische Planungsnotiz vor der nativen MIDL-/EEInfo-Probe; deren tatsächliche -Ergebnisse stehen in [EEInfo-Diagnose](windows-clock-eeinfo-trace.md). Die hier -beschriebenen weiteren V5-Vergleiche wurden nicht ausgeführt. - -Stand 2026-11-14. Diese Notiz ändert weder den eingefrorenen MIDL-Runner -`078bf230…` noch Clock-/RPC-Produktquellen. Keine Zielverbindung ausgeführt. - -## MIDL-Signatur: tatsächlich statisch gelesene öffentliche Metadaten - -Die gehashten NuGet-PE-Dateien `midl.exe` und `midlc.exe` enthalten denselben -Microsoft-Corporation-Code-Signing-Leaf, SHA-256 -`0ba22e4765f7a160178ec90535c37f024916fbce0d9da63118d69662b5fed7eb`. -Sein Gültigkeitsintervall ist **2026-03-05 19:58:26 UTC bis -2027-03-03 19:58:26 UTC**, einschließlich Code-Signing-EKU. Das enthaltene -Zwischenzertifikat Microsoft Windows Code Signing PCA 2024 ist von -2024-08-08 bis 2035-06-23 datiert. Damit widerspricht eine Prüfung zum -14.11.2026 diesen eingebetteten Zeitintervallen nicht. - -Der private Beleg `public-certificate-time-metadata.json` im MIDL-Downloadfall -`6b7fb9b1-0bb7-4880-850b-e6812d3df1b1` enthält die exakten Toolhashes und beide -öffentlichen Zertifikatsbags. Dies ist **kein** Nachweis von PE-Signatur, -Signerauswahl, Zertifikatskette, Widerruf oder vertrauenswürdigem Zeitstempel. -Die Ziel-Vertrauensspeicher und Online-Widerrufsprüfung bleiben ungeprüft. - -Die zusätzliche `X509Chain.Build(SignerCertificate)`-Prüfung benutzt ohne -explizite VerificationTime das aktuelle Datum; die -[Microsoft-.NET-Framework-Quelle](https://github.com/microsoft/referencesource/blob/main/System/security/system/security/cryptography/x509/x509chainpolicy.cs) -setzt beim Reset `DateTime.Now`. Eine Dateisignatur mit gültigem vertrauenswürdigem -Timestamp kann dagegen auch nach Ablauf des Signierzertifikats zulässig bleiben, -wie Microsoft für [Authenticode-Zeitstempel](https://learn.microsoft.com/en-us/windows/win32/seccrypto/time-stamping-authenticode-signatures) -beschreibt. Eine separate heutige Blattkettenprüfung ist deshalb kein allgemeiner -Ersatz für die vollständige Dateisignatur-/Timestamp-Policy. - -Für die **jetzt fest gepinnten** Tools besteht nach den gelesenen Metadaten kein -solcher Ablaufkonflikt. Der Runner bleibt unverändert streng. Scheitert die -native Prüfung, muss der genaue Grund erhalten werden; kein IgnoreNotTimeValid, -kein abgeschalteter Widerruf und kein neu importierter Trustanker als Abkürzung. -Soll später ein anderer, abgelaufener, aber timestamp-signierter Input nötig -werden, verlangt das einen eigenen geprüften Verifiervertrag: vollständige -[Authenticode-Dateipolicy](https://learn.microsoft.com/en-us/windows/win32/api/wintrust/nf-wintrust-winverifytrust), -Dateidigest, erlaubter Signer und belegte Timestamp-/Kettenprüfung statt eines -frei gesetzten historischen Prüfdatenwerts. - -## Geplanter enger Named-Pipe-V5-Diagnosevergleich - -Voraussetzung ist zuerst ein **tatsächlich zurückgelesener** MIDL-Header/-Stub -und ein nativer Opnum-6-Statusbeleg. Ein weiterer gleicher NDR-Fehler 1783 ist -kein Identitätsnachweis und darf nicht als negatives Sicherheitskontrollergebnis -gezählt werden. Produktive Clockbereitschaft bleibt unabhängig davon false. - -Die [RPC-V5-Dokumentation](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w) -beschreibt `ServerSecurityDescriptor` zur Serveridentifikation und warnt, dass -NTLM trotz fehlender gegenseitiger Authentifizierung erfolgreiche -MUTUAL_AUTH-Verhandlung melden kann. `Sid` ist insbesondere für `ncalrpc` -beschrieben; die Wirkung der gewählten Kombination auf `ncacn_np` ist noch -nativ nachzuweisen. Ein gesetztes Flag oder erfolgreiche SetAuthInfo-Rückgabe -qualifiziert diese Kombination nicht. - -Kleinster **noch nicht implementierter** Vergleich, getrennt vom bisherigen -Named-Pipe-/ALPC-Pfad: - -1. Exakter lokaler authentifizierter Endpunkt `\\pipe\\W32TIME_ALT`, Interface - 4.1/Opnum 6, bestehender C-SEH-/Allocator-/Statusvertrag und PacketPrivacy. - Kein Remotehost, alternativer Endpunkt oder automatischer Fallback. -2. V5 mit festem erwarteten LocalService-SID und lokal konstruiertem Descriptor, - dessen einzige Allow-ACE den echten `NT SERVICE\W32Time`-SID bezeichnet. - Account und Service-SID kommen niemals aus der Endpointantwort. Descriptor, - ACL und beide SIDs leben bis nach dem vollständigen RPC-Aufruf. -3. Derselbe Statusaufruf mit ausschließlich falschem erwartetem Account - (LocalSystem statt LocalService), korrektem W32Time-Descriptor. -4. Derselbe Statusaufruf mit korrektem Account, aber ausschließlich falschem - Service-SID (`RmmDiscoveryWindows` statt W32Time). Damit wird die Trennung - gegenüber dem ebenfalls als LocalService laufenden Network-Agent getestet. - -Erforderlich wären echter positiver Return mit validem Status **und** zwei -nachvollziehbare Identitätsverweigerungen ohne gelieferten Status, unter -identischem frischem Dienst-/Boot-/Binarykontext. Timeout, fehlender Endpunkt, -ungültiger Stub oder derselbe 1783-Fehler auf allen Varianten sind unzureichend. -Eine akzeptierte falsche Identität falsifiziert den Kandidaten; keine Abschwächung -auf Account-only. Der tatsächlich aktivierte W32Time-Service-SID und die feste -Dienstkonfiguration müssen zuvor rein lesend belegt sein. Fehlende SID-Isolation -darf nicht durch eine Service-/Token-/ACL-Änderung für die Diagnose repariert -werden. - -Die spätere Probe benötigt einen einzelnen begrenzten Diagnoseworker, feste -Varianten und numerische Stage-/Return-/Status-Presencefelder. Kein freier -SID-/Endpunktparameter, kein Ersatzthread nach hängendem Call und kein Retry -mit schwächerer Authentisierung. Erst diese technischen Diagnosen wären eine -Grundlage für eine separate Clockvertrauensentscheidung; sie öffnen weder -`ADAPTER_QUALIFIED` noch Jobcapabilities oder den SYSTEM-Helperpfad. diff --git a/docs/windows-clock-pointer-native.md b/docs/windows-clock-pointer-native.md deleted file mode 100644 index 3ec6ddd..0000000 --- a/docs/windows-clock-pointer-native.md +++ /dev/null @@ -1,34 +0,0 @@ -# W32Time-Pointerkandidat — tatsächlicher Nachtest - -Der lokal qualifizierte Diagnosebuild91889303… wurde nach dem vom Benutzer -bestätigten manuellen Konsolenneustart und dem bereits autorisierten gezielten -W32Time-Start tatsächlich als eigener LocalService-Dienst ausgeführt. - -Fall `79896ca7-1337-4118-bda9-f7506f7649f6`, BinarySHA256 -`91889303e1650d8612b946512f069a3421eb686c7bed315426c48bd62b18a1fd`. -Eigener temporärer Dienst nach seinem Ende entfernt, Bericht getrennt identisch -lesend bestätigt. SID19, kein Administrator und kein SYSTEM. AgentPID3172 und -gestoppter manueller Helper sowie ursprüngliche Datei-/PKI-Metadaten und -Zeitdienstdefinition/-Konfiguration im frischen Nachbeleg exakt erhalten. -Zentrale Zähler und geschlossene Testflags unverändert, keine RMM-Jobs. - -Beide produktiv ausgelegten ALPC-Proben liefern weiterhin1753; Endpointmapper -keine Einträge; beide falschen Identitätskontrollen ebenfalls1753. Das ist kein -Verweigerungsnachweis. Die unabhängige Named-Pipe-Diagnose liefert weiterhin1783, -Status fehlt. Die zusätzliche Traceabfrage meldet Stage90/RPC-Ausnahme1783, -native_rpc_return_present0 und status_present0. Ohne Presenceflag ist das -numerische Returnfeld0 ausdrücklich kein erfolgreicher nativer Return. - -Die mit WIDL7 erzeugte ref→unique-Korrektur allein hat den Fehler somit im -realen Gast nicht behoben. Die genaue weitere Ursache bleibt offen; kein -nachträglicher Erfolg und keine Aussage, dass der Pointerunterschied irrelevant -sei. Die [Microsoft-IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a) -ist die Referenz, keine manuellen Stubbytepatches. Microsofts nativer -MIDL-/MSVC-Nachweis fehlt weiterhin; die Buildtoolsinstallation bleibt wegen -nativ nach dem Boot beobachtetem CBS-Neustartmarker gesperrt. - -Geschützte BewertungSHA256 -`fceb92c2ca059f23f3b930e80b59ec4f16b72741e4822aadc6c11c1933c01383`. -`ADAPTER_QUALIFIED=false`, keine Job-, SYSTEM- oder Paketcapability aktiviert. -Eine erfolgreiche rohe RPC-Statusabfrage allein würde noch keine gesicherte -Bindung an den tatsächlichen Zeitdienst oder vertrauenswürdige Uhr beweisen. diff --git a/docs/windows-clock-process-privilege-plan.md b/docs/windows-clock-process-privilege-plan.md deleted file mode 100644 index 0669c8d..0000000 --- a/docs/windows-clock-process-privilege-plan.md +++ /dev/null @@ -1,240 +0,0 @@ -# Plan: einmaliger Clockvergleich mit vorhandenem Prozessprivileg - -Ursprünglicher Plan 2026-11-14, vor Implementierung verfasst; die inzwischen erfolgte lokale Umsetzung steht im letzten Abschnitt. -**Keine Implementierung, kein Build und keine Zielaktion für diesen Nachfolger.** -Die Freigabe der konkreten Tokenabgrenzung und des Diagnoseumfangs liegt beim -Hauptagenten. Alle bisherigen Empty-, F6-, SYSTEM-, EEInfo- und Produktquellen -sowie deren Casebelege bleiben unverändert. - -## Ausgangspunkt und begrenzte Fragestellung - -Der Hauptagent meldet aus dem tatsächlichen Empty-Case -`5e0e8ce9-b9a3-4c4a-b739-3f84d714dc94`: eine Statusquery, RPC5/Stage90, -ein numerischer EEInfo-Record; vorhandenes SeSystemtimePrivilege mit -Attributen0/Enabled0. Dieser Plan ergänzt keinen abgeschlossenen -Readback-/Cleanup-/Preservationnachweis und leitet daraus keine Fehlerursache ab. - -Der nächste Vergleich soll ausschließlich prüfen, ob sich das Ergebnis eines -einzelnen lesenden Opnum6 ändert, wenn genau das bereits vorhandene -SeSystemtimePrivilege des getrennten Diagnoseprozesses vorübergehend aktiviert -ist. Es werden keine Kontorechte zugewiesen. Auch ein erfolgreicher Vergleich -wäre weder Produktionsfreigabe noch ausreichende Clock-/Serveridentitätsprüfung. - -## Geprüfte Microsoft-Verträge - -AdjustTokenPrivileges wirkt auf das übergebene Tokenobjekt. Es benötigt -TOKEN_ADJUST_PRIVILEGES, mit PreviousState zusätzlich TOKEN_QUERY. TRUE allein -bedeutet nicht, dass alle angeforderten Rechte angepasst wurden: -GetLastError ist unmittelbar auszuwerten; ERROR_NOT_ALL_ASSIGNED verweigert den -Diagnoseaufruf. Vorhandene Rechte können aktiviert werden, neue werden nicht -hinzugefügt. PreviousState enthält die tatsächlich geänderten ursprünglichen -Zustände und dient als NewState einer Wiederherstellung. Ein zu kleiner -PreviousState-Puffer führt ohne Anpassung zum Fehler. -[AdjustTokenPrivileges](https://learn.microsoft.com/en-us/windows/win32/api/securitybaseapi/nf-securitybaseapi-adjusttokenprivileges) - -OpenProcessToken öffnet das einem Prozess zugeordnete Token. Dieser Aufruf ist -kein eigenständiger Vertrag über die Exklusivität aller Referenzen auf dieses -Tokenobjekt. -[OpenProcessToken](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-openprocesstoken) - -TokenStatistics.TokenId identifiziert die konkrete Tokenobjektinstanz. -AuthenticationId identifiziert eine Anmeldesitzung, zu der viele Tokens gehören -können. ModifiedId ändert sich bei Tokenänderung. Deshalb weder gleiche -AuthenticationId als Tokenidentität noch gleiche ModifiedId nach Wiederherstellung -fordern; die ursprüngliche ModifiedId lässt sich nicht durch Zurücksetzen der -Privilegattribute wiederherstellen. -[TOKEN_STATISTICS](https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-token_statistics) - -Jeder Prozess hat ein Primärtoken; ein impersonierender Thread kann zusätzlich -ein Threadtoken besitzen. Der Vergleich soll weiterhin ohne Impersonation und -ohne Tokenwechsel laufen. -[Access Tokens](https://learn.microsoft.com/en-us/windows/win32/secauthz/access-tokens) - -LocalSystem-Dienste erben den Sicherheitskontext des SCM. Diese Aussage und -derselbe SYSTEM-SID belegen für sich allein keine verschiedenen TokenIds. -SeSystemtimePrivilege ist in Microsofts LocalSystem-Beschreibung standardmäßig -deaktiviert; das erklärt nicht allein den konkreten RPC5. -[LocalSystem Account](https://learn.microsoft.com/en-us/windows/win32/services/localsystem-account) - -SERVICE_WIN32_OWN_PROCESS belegt einen eigenen Prozess, nicht durch seine bloße -Bezeichnung eine geprüfte Trennung sämtlicher Tokenreferenzen. -[CreateServiceW](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-createservicew) - -## Noch vom Hauptagenten zu entscheidende Beweisgrenze - -Vorgeschlagener enger Gate: Vor jeder Anpassung rein lesend TokenId und -TokenStatistics des Diagnoseprozesses, des SCM-Prozesses und der aktuell an -W32Time, RMM-Agent und RMM-Helper gebundenen Prozesse erfassen. Prozesshandles -und Startzeiten binden die Ablesung gegen PID-Wiederverwendung; Dienst-PID und -Prozessbindung direkt danach erneut prüfen. Nur TOKEN_QUERY gegenüber fremden -Tokens; kein SE_DEBUG_ENABLE, kein fremdes TOKEN_ADJUST_PRIVILEGES. -Bei fehlender erforderlicher Probe, Prozesswechsel, gemeinsamem TokenId, -falschem SYSTEM-Primärtoken oder vorhandenem Threadtoken: Abbruch vor Anpassung -und vor RPC. Gleiche AuthenticationId allein ist kein Fehler. - -Dies belegt lediglich Trennung von den tatsächlich abgefragten Peer-Tokenobjekten. -Es beweist nicht, dass kein weiterer Prozess/Thread irgendeine Referenz auf das -Diagnosetoken hält. Die ausgewerteten primären Verträge liefern hierfür keine -ausreichende universelle Exklusivitätsgarantie. **Ohne ausdrückliche Akzeptanz -dieser Grenze wird kein Anpassungscode erstellt.** Alternativ ist zuerst ein -rein lesender TokenId-Vergleich vorzubereiten. Ein dupliziertes Token plus -Impersonation oder neuer Childprozess ist ein anderer Vergleich und wird nicht -stillschweigend als Ersatz eingebaut. - -## Vorgeschlagene neue Quellen, erst nach dieser Entscheidung - -Vier neue Dateien unter `deploy/windows/clock-spnego-privilege-trace/`: - -- `clock_rpc_spnego_privilege.c`: bytegleicher Empty-RPCpfad bis auf das neue - öffentliche Symbolsuffix. Tatsächlich zurückgegebenen nicht-NULL Emptystring - unverändert weitergeben; GSS9/Privacy6/Identify2, kein Authfallback. Maximal - eine Managementdiscovery und bei erfüllten Vorbedingungen eine Opnum6-Query; - Setupfehler bedeuten null Queries. EEInfo weiter maximal vier numerische - Records. Kein Setter und keine neue Serveridentitätsbehauptung. -- `system_trace_spnego_privilege.c`: eigener, einmalig gestarteter - SYSTEM-OWN_PROCESS-Dienst mit dem nachstehend beschriebenen Tokenablauf. -- `build.py`: alter Compiler/MIDL/Header/SDK/DLL-Vertrag unverändert, neue - vier Inputs sowie Empty-Manifest und tatsächlichen Ausgangscase hashen; - alte Inputs nur vergleichen und unverändert erhalten. -- `native.py`: eigene Case-/Service-/Profilbindung, create-once prepare/start, - rein lesender same-case Readback und getrenntes Cleanup nur des eigenen - gestoppten Dienstes. Antwortverlust erlaubt keine Wiederholung des Starts. - -Vorgeschlagene Namen: `RmmClockSpnegoPrivilegeDiagnostic`, -`clock-system-spnego-privilege-v1`, `ClockSpnegoPrivilegeTrace.exe`, -`C:\ProgramData\RustDiscoveryBootstrap\clock-spnego-privilege-trace-`. - -## Geplanter Tokenablauf und Fehlerverhalten - -1. Vor Anpassung eigenes gehaltenes Primärtoken mit exakt TOKEN_QUERY und - TOKEN_ADJUST_PRIVILEGES öffnen; keine Vererbung oder Weitergabe des Handles. - SYSTEM, Primärtoken und fehlendes Threadtoken prüfen. Vollständige begrenzte - Privilegliste auslesen, LUIDs numerisch sortieren und auf Duplikate prüfen. - SeSystemtimePrivilege muss genau einmal vorhanden sein, Attribut0 haben und - weder enabled noch removed sein. Abweichung verweigert den Vergleich. -2. Eigenes PID/Startzeit/TokenStatistics und Peer-Proben samt ursprünglicher - numerischer Privilegliste create-once vor Anpassung dauerhaft ablegen. - Geplantes Limit: höchstens256 Privilegien und derselbe4096Byte-Tokenpuffer. - Keine Namen, Anmeldeinformationen oder Tokenhandles als Ausgabedaten. -3. Ein einziges AdjustTokenPrivileges mit DisableAllPrivileges=FALSE, - PrivilegeCount=1, exakter vorhandener LUID und SE_PRIVILEGE_ENABLED. - Ausreichender fester PreviousState-Puffer für genau eine Änderung; - BOOL und sofortiges GetLastError getrennt speichern. Nur TRUE+ERROR_SUCCESS - und genau ein gültiger PreviousState-Eintrag derselben LUID/Attribut0 - erlauben den weiteren Ablauf. Kein SE_PRIVILEGE_REMOVED/DisableAllPrivileges. -4. Direkt am gehaltenen eigenen Token nachlesen: gleiche TokenId, - AuthenticationId und TokenType, unveränderte Privilegmenge sowie lediglich - der erwartete Enablebit-Wechsel. Direkt vor RPC fehlendes Threadtoken erneut - prüfen. Fehler springen zuerst in Restore, nicht in RPC. Der Enablezeitraum - umfasst den unveränderten Discovery-/Authsetup-/Querypfad; es wird keine - Behauptung aufgestellt, dass das Bit nur während des einzelnen Opnum6 aktiv ist. -5. Bestehende RPCfunktion höchstens einmal aufrufen; RPCexception/Fehler bleibt - ihr numerischer Befund. Unmittelbar danach Restore auf demselben gehaltenen - eigenen Token mit PreviousState als NewState. Jeder normale Fehlerpfad nach - Anpassungsbeginn erreicht denselben Cleanupblock, bevor Berichtschreiben - oder Dienstende. Auch fehlgeschlagene Nachprüfung löst Restore aus. - Bei unerwartetem PreviousState ist kein RPC erlaubt; der bereits separat - gesicherte eine ursprüngliche LUID/Attribut0 ist die begrenzte Restoreeingabe. - Keine Wiederholung eines RPCs oder Aktivierungsversuchs. -6. Restore-BOOL und unmittelbaren Fehlercode separat erfassen. Vollständige - Privilegliste erneut lesen; exakt ursprüngliche Attribute/Menge fordern. - TokenId/AuthenticationId/TokenType müssen gleich sein. ModifiedId darf und - wird gegebenenfalls anders sein; dies ist keine fehlgeschlagene Rücksetzung. - Peer-TokenIds/Attribute erneut rein lesend prüfen; Wechsel/Fehler ehrlich - als nicht nachgewiesene Erhaltung melden, nicht durch fremden Schreibzugriff - reparieren. Danach Ergebnis plus before/enabled/restored-Snapshots speichern. - -Ein Restorefehler kann nicht durch eine Erfolgsmeldung verdeckt werden und -beweist keine erfolgreiche Erhaltung; Dienstexit wird Fehler, kein weiterer -RPC. Unvorhersehbarer Prozessabbruch, TerminateProcess oder Stromverlust kann -keinen benutzerseitigen finally-Block garantieren. Ohne gespeicherte und -nachgelesene Wiederherstellung lautet der Nachweis daher `unknown`, auch wenn -der Prozess bereits beendet ist. Es wird keine universelle Rücksetzgarantie -für solche Abbrüche behauptet. - -Die Statusquery bleibt fachlich lesend; der neue Diagnoseprozess insgesamt ist -wegen AdjustTokenPrivileges **nicht rein lesend**. Maschinen-/Kontorechte, -ACL/GPO, W32Time-Konfiguration, Dienstkonten und Uhrzeit werden nicht geändert. -Die Erzeugung des eigenen Diagnosedienstes bleibt eine gesonderte ausdrückliche -Bootstrapwirkung. Kein Produktgate und keine Job-/Freigabe-/Policyänderung. - -## Geplante lokale und native Nachweise, sämtlich noch nicht ausgeführt - -Nach akzeptiertem Scope zunächst Quellenreview: genau ein Enable, ein gebundener -Restorepfad, kein Tokenwechsel, keine fremden Tokenwrites, bestehender RPCpfad -bis auf Symbol bytegleich. Lokale gezielte Guardfälle: TRUE mit1300 verweigern, -fehlendes/removed/dupliziertes Recht, bereits enabled, falscher PreviousState, -fremder gleicher TokenId, Peerwechsel, nichtlesbarer Peer, aktiver Threadtoken, -Nachprüfungsfehler, RPCexception sowie Restorefehler. Nicht jeder synthetisch -abgedeckte Fehler ist damit ein nativer Windowsnachweis. - -Erst nach getrenntem Source-/Buildreview kann der Hauptagent einen neuen nativen -Case ausdrücklich starten. Benötigte Belege: originale Snapshots vor Anpassung, -sichtbare einzelne Enableänderung, exakter RPC-/EEInfo-Befund, nachgelesener -Restore, unveränderte Peer-Zustände, gestoppter eigener Dienst, same-case -Readback sowie getrenntes Cleanup/Preservation bestehender RMM-Dienste. Keine -Clockqualifikation allein aus einem erfolgreichen Statusqueryreturn ableiten. - - -## Lokale Umsetzung nach ausdrücklicher Rootfreigabe - -Der Hauptagent hat die begrenzte TokenId-Trennung zu gehaltenen SCM-/W32Time-/ -Agent-/Helper-Prozessen ausdrücklich akzeptiert. Universelle Exklusivität aller -Referenzen wird weiterhin nicht behauptet. Der ursprüngliche176Zeilen-Plan -mit SHA25627b1035c… ist zusätzlich create-once unter -`devstate/windows-clock-spnego-privilege-trace/local-review/accepted-plan.md` -erhalten. Dieser Abschnitt ersetzt keine Freigabe einer Zielaktion. - -Die vier oben benannten neuen Dateien sind jetzt lokal implementiert. -Vorher werden eigene TokenUser/SYSTEM, Primärtoken, fehlender Threadtoken und -vollständige numerische Privilegliste geprüft. SCM wird eindeutig über -services.exe samt Systempfad ermittelt; die anderen drei Prozesse sind über -gehaltene Service-/Prozesshandles, Running/PID, Erstellzeit und feste Images -gebunden. Fremde Tokenhandles verlangen ausschließlich TOKEN_QUERY. Der eigene -Tokenhandle verlangt QUERY|ADJUST_PRIVILEGES. Vor Enable wird der vollständige -Beforebeleg create-once geschrieben. Der unmittelbare Enable-Rückgabecode und -GetLastError, PreviousState und volle Nachlese begrenzen den einzigen RPCpfad. - -Alle kontrollierten Fehlerpfade nach Enable erreichen dieselbe einzelne -Restorestelle; danach werden volle ursprüngliche Attribute und die -unveränderten numerischen Peer-Privilegzustände/TokenIds/ModifiedIds geprüft. -ModifiedId des eigenen Tokens darf nach korrektem Restore geändert sein. -Berichte kennzeichnen die gesamte Diagnose ausdrücklich als read_only=false; -SYSTEM wird nur bei erfolgreicher tatsächlicher Probe ausgewiesen. Ein eigener -Cleanupreceipt erhält den vorherigen Dienstexitcode, damit Serviceentfernung -keinen fehlgeschlagenen Ablauf nachträglich als vollständig erscheinen lässt. - -Finaler lokaler Build: -`devstate/windows-clock-spnego-privilege-trace/build-b56e3f3d-8904-4fd8-9c34-0e55e57c8f07/manifest.json`, SHA256 -`6c97658307ec66e6605574dca27cdbc79efefa9cd7f386e6e2cb3f73d9b5c6d3`. -PE114087Bytes, SHA256 -`68a217914c15f28b19c52a2f5adfd595854f88210fbb0b69c20e73a59952b65e`. -Originales Microsoft-MIDL/Header und gepinnter Compiler unverändert; eigene -C-Units Wall/Wextra/Werror, gleiche vier DLL-Imports ADVAPI32/KERNEL32/RPCRT4/ -msvcrt. PowerShell-AST bestanden, EncodedCommand18858Zeichen unter32767. -Alle131Produktinputs,15bisherige Diagnosequellen sowie F6-/Empty-Manifeste und -Ergebnisbelege unverändert geprüft. Der RPCwrapper unterscheidet sich vom -Empty-Elternteil ausschließlich durch das öffentliche Symbolsuffix. - -Gezielte lokale Nachweise, keine Windows-API- oder RPC-Ausführung: der tatsächliche -C-run_service-Block wurde bytegleich extrahiert und mit kontrollierten lokalen -API-Stubs übersetzt/ausgeführt.13Fälle bestanden, unter anderem TRUE/1300, -FALSE, ungültiger PreviousState, aktive Attributabweichung, Own-/Peerprobe-Fehler, -Restorefehler, fehlgeschlagene Nachlese sowie Writefehler vor/nach Enable. -Jeder Fall prüft höchstens1Enable, genau1Restore je Enable und höchstens1RPC. -Der echte Python-Reader akzeptierte zwei synthetische gültige Berichte und -verweigerte17Fälschungen/Fehler einschließlich fremdem TokenId, nicht erhaltenen -Attributen, Peerdrift, schwächerer Privacy und verstecktem Fehlerexit nach Cleanup. -Guardreceipt `local-review/guards.json`, SHA256 -`c12c5d06ecad63101874f7c66af1f49eb9f6d9b51dbba9c75e367462660fa831`. -Dies sind lokale Fehlerpfadbelege, keine nativen Token-/Erhaltungsnachweise. - -**Bis zum Abschluss dieser lokalen Vorbereitung war kein Privilegvergleich auf -Windows ausgeführt. Der Subagent hat keinen VM-/SSH-/SCM-Start vorgenommen und -keinen Produktcode/Clockgate geändert.** Das erforderliche unabhängige -Source-/Manifestreview und die spätere native Ausführung durch den Hauptagenten -sind inzwischen im [tatsächlichen Ergebnis](windows-clock-process-privilege-result.md) -mit Startfehler, separatem Readback, Restore, Cleanup und Preservation dokumentiert. -Auch eine künftig erfolgreiche Query ließe produktive LocalService-Privilegien, -gebundene Serveridentität und Transport-Positiv-/Negativnachweise weiter offen; -Discovery/NTLM/Mutualauth-Flags allein ersetzen diese nicht. diff --git a/docs/windows-clock-process-privilege-result.md b/docs/windows-clock-process-privilege-result.md deleted file mode 100644 index 685de46..0000000 --- a/docs/windows-clock-process-privilege-result.md +++ /dev/null @@ -1,185 +0,0 @@ -# Tatsächlicher Prozessprivilegvergleich auf der Windows-VM - -Stand 2026-11-14: eigener Diagnoseablauf, separater Readback, Cleanup und -After-Preservation durch den Hauptagenten abgeschlossen. Die W32Time-Statusquery -scheitert weiterhin mit RPC5. Kein Produktgate geöffnet, kein RMM-Job ausgeführt. - -## Verwendeter Quellen- und Buildstand - -Reviewter Nachfolger unter `deploy/windows/clock-spnego-privilege-trace/`, vier -Dateien; ursprünglicher Scope und lokale Nachweise: -[Prozessprivilegplan](windows-clock-process-privilege-plan.md). - -Buildmanifest: -`devstate/windows-clock-spnego-privilege-trace/build-b56e3f3d-8904-4fd8-9c34-0e55e57c8f07/manifest.json`, SHA256 -`6c97658307ec66e6605574dca27cdbc79efefa9cd7f386e6e2cb3f73d9b5c6d3`. -Windows-PE114087Bytes, SHA256 -`68a217914c15f28b19c52a2f5adfd595854f88210fbb0b69c20e73a59952b65e`. -Der Hauptagent und sein unabhängiger Reviewer haben Quelle, Manifest und PE -geprüft. Die vier Quellen wurden für den nativen Vergleich nicht verändert. - -## Fehlgeschlagener Startaufruf und getrennte Nachlese - -Neuer einmaliger Case: `6de04277-6bec-477d-b1c9-bfca88a9cd78`. -Der ursprüngliche Startaufruf meldet tatsächlich -`StartServiceFailed,Microsoft.PowerShell.Commands.StartServiceCommand` an Zeile26. -Transportbeleg `transport-6e33c04b-f149-426b-8da1-309129ff3469.json`, SHA256 -`83ccfd7db60ad27dd901ddbef223cde8f69ecc9e635373038f20ca864b954ba6`. -Dieser Aufruf bleibt als fehlgeschlagen dokumentiert. **Kein Startretry.** - -Anschließend gewinnt der Hauptagent ausschließlich durch einen separaten, -rein lesenden same-case Readback den vollständigen Diagnosebericht. Der eigene -Dienst ist gestoppt, Dienstexit0. Readback -`readback-9039311f-1b98-4d0c-b516-02a543fb2d7b.json`, SHA256 -`c5dcf129d329b879be00c801eead32d2047d9b73ffed0e0e692615e9a7459c07`. -Der gebundene vollständige Ergebnisbeleg `diagnostic-result.json` hat SHA256 -`c7556589a015fc5ab53feffe3caf74a3904b7f5a65b70066f256cc0693ff8152`. -Exit0 und complete=true belegen den abgeschlossenen Diagnose-/Restoreablauf, -keinen gelungenen W32Time-Aufruf. Die Ursache der anfänglichen Startfehlermeldung -ist nicht nachgewiesen; eine SCM-Race wird nicht als Erklärung behauptet. - -## Tatsächliche Token- und RPC-Ergebnisse - -Eigenes gehaltenes SYSTEM-Primärtoken; kein Threadtoken. Der vorhandene -SeSystemtimePrivilege-LUID ist12,0, ursprüngliches Attribut0. Genau ein -Enableversuch: BOOLtrue/GetLastError0, PreviousStateCount1,16Bytes, derselbe -LUID12,0 und ursprüngliches Attribut0. Die anschließende vollständige Nachlese -zeigt ausschließlich den vorgesehenen Enablebit-Wechsel auf2. - -Genau eine Wiederherstellung auf dem gehaltenen eigenen Token mit dem geprüften -PreviousState: BOOLtrue/GetLastError0. Danach sind die vollständige ursprüngliche -Privilegmenge und Attribute0 wiederhergestellt, restoration_verified1, -restored_status0, flow_status0. Vorher-/Nachher-TokenId und Authentifizierungs-ID -bleiben gebunden; eine geänderte eigene ModifiedId ist keine unerwartete -Attributabweichung. Die beobachteten gehaltenen Peer-Tokens für SCM, W32Time, -Agent und Helper behalten ihre TokenIds, ModifiedIds und Privilegattribute. -Dies ist der vereinbarte begrenzte Peer-Nachweis, keine universelle Behauptung -über sämtliche Tokenreferenzen des Betriebssystems. Fremdtokens werden nur gelesen. - -Eine SPNEGO-Managementdiscovery gelingt mit Status0 und normalem Return. Der -tatsächlich gelieferte Principalpointer ist nicht-NULL, UTF16-Länge0. GSS9, -PacketPrivacy6 und Identify2 bleiben unverändert. Danach genau ein Opnum6: -RPCexception5/Stage90, kein normaler Return, kein Statusobjekt. Unmittelbar -erfasst wird ein numerischer EEInfo-Record: Komponente2, Status5, -DetectionLocation1750, Flags0, Parameteranzahl1. Keine Parameterinhalte gelesen. -Principal-/Bindingfreigabe werden jeweils einmal erfolgreich ausgeführt. - -Der Unterschied zum vorherigen Emptyvergleich ist damit tatsächlich geprüft: -Aktivieren dieses vorhandenen Prozessprivilegs beseitigt den beobachteten RPC5 -nicht. Daraus folgt weder, dass jede Privilegprüfung erfolgreich war, noch eine -eindeutige Aussage über den vom Server geprüften Credential-/Impersonationkontext. -Keine Uhr-, Kontorechte-, ACL-, GPO-, Policy- oder W32Time-Konfigurationsänderung. -Die gesamte Privilegdiagnose kennzeichnet sich korrekt als read_only=false; -die einzige W32Time-Methodenquery selbst ist lesend. - -## Cleanup und Erhaltung - -Der Hauptagent bereinigt ausschließlich den eigenen gestoppten Diagnosedienst. -Cleanupreceipt `readback-d02e8c7a-5154-488b-a29f-4d4d8155ec7a.json`, SHA256 -`e163d7d4790ea4900f1cc1caedf11ff2619f30cf7b25388eabffa9afd75d8d50`, -bestätigt cleanup_verified=true; der eigene Dienst ist anschließend nicht mehr -registriert. Kein Retry, Reset oder zusätzlicher RMM-Job. - -Vorherbeleg SHA256 -`a4b321f965f4ccc968724fae9abd856cca5f799b5fc96a54d04f5316b95ab05b`; -Afterbeleg im Pipeworktree: -`devstate/windows-client/system-pipe-upgrade/14fb176a-f653-4573-a8d7-6f9fe47a3020/spnego-privilege-trace-after.json`, SHA256 -`f37a2e866ebc5dfd1ae13bfd18b7c5355da42dfd01b7e7e69f478555c60eb830`. -Alle sechs nativen Bereiche service/helper_service/agent_kernel/helper_kernel/ -files/helper_witness sind exakt gleich. Serverzustand ebenfalls gleich: -Windows0/0/0/0, Linux31/31/27/0, geschlossene Rootpolicycf15. Der separate -Nachweis meldet verified=true, read_only=true, no_jobs=true, clock_qualified=false. - -## Tatsächlicher Builtinvergleich und Primärquellen - -Der Hauptagent hat separat den vorhandenen Microsoft-Builtin -`w32tm /query /status /verbose` über den bestehenden Administratortransport -abgefragt. Beim ersten lesenden Aufruf scheitert der Texttransport an einer -UTF8-Dekodierung mit Byte0x84; Resultbytes wurden nicht erhalten. Dies ist kein -brauchbarer Status- oder Exitcodenachweis dieses ersten Prozesses. Ein zweiter, -separater lesender Query verwendet danach eine ASCII-JSON-Hülle und Base64 -für den ausdrücklich UTF8-kodierten Ausgabetext. Keine wiederholte Wirkung eines -RMM-Jobs; beide Bootstrapbefehle sind Statusabfragen, kein resync/config/register. - -Der zweite Aufruf liefert Exit0. Receipt im Pipeworktree unter demselben14fb-Pfad: -`builtin-w32tm-status-base64-result.json`, SHA256 -`4e5ea093ee8f9508b5327e664bbe9c824895c08feecdd8f425fe18f9d2ece262`. -Der erhaltene native Status meldet Leap3/nicht synchronisiert, Stratum0, -Rootdispersion8.8814534Sekunden, Phase-1.1113519Sekunden, letzte Synchronisation -14.11.2026 15:26:24, Alter15703Sekunden und letzte Synchronisationsfehlermeldung1/ -keine Zeitdaten. Konfigurierte Quelle: time.windows.com,0x9. Dies sind die Werte -im erhaltenen Statuszeitpunkt, keine aktuelle fortlaufende Messung und kein -vertrauenswürdiger Synchronisationsnachweis. - -Damit sind zwei getrennte Hindernisse belegt: der eigene SYSTEM-/SPNEGO-RPCpfad -scheitert weiterhin mit5, während der Builtin unter dem Administratortransport -Status lesen kann; zusätzlich zeigt der tatsächlich gelesene W32Time-Status -keine vertrauenswürdige Synchronisation. Exit0 des Tools behebt keines dieser -Produktgates und beweist kein bestimmtes internes Authentifizierungsverfahren. -Eine Netzprobe oder spätere Zeitsynchronisierung ist kein Bestandteil dieses -Schritts; daraus folgt keine Freigabe für Uhr-/NTP-/Serviceänderungen. - -Microsoft beschreibt /query /status als Statusanzeige, ohne /computer -standardmäßig lokal, und verlangt für lokale Toolnutzung Administratorberechtigung. -Die Quelle legt weder das konkrete interne Binding noch Authn-/Impersonation- -parameter dieses konkreten Builtinlaufs offen. -[Windows Time Service Tools and Settings](https://learn.microsoft.com/en-us/windows-server/networking/windows-time-service/windows-time-service-tools-and-settings) - -MS-W32T AppendixB33 beschreibt eine zusätzliche Prüfung des Rechts zur -Systemzeitänderung; auch eine nicht durchführbare Prüfung kann den Aufruf -verweigern. Der dokumentierte Clientpfad verwendet SPNEGO/Privacy mit dem -Discoveryergebnis. Daraus lässt sich ohne weitere Beobachtung nicht schließen, -welche Prüfung den konkreten RPC5 verursacht hat. -[MS-W32T Appendix B](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/bb576d39-587b-484a-86a4-e1d378cf9497) - -Ein serverseitiger RPC-Securitycallback kann Zugriffe prüfen; eine Ablehnung -wird zum Client als RPC_S_ACCESS_DENIED abgebildet. Der Zahlenwert5 identifiziert -deshalb keine einzelne fehlgeschlagene Prüfung und keinen bestimmten Callback. -[RPC_IF_CALLBACK_FN](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nc-rpcdce-rpc_if_callback_fn) - -Authentifizierung, Clientcredential-Snapshot, SSP-Verhalten und zulässige -serverseitige Impersonation sind getrennte Eigenschaften. Ein NULL-AuthIdentity -verwendet den aktuellen Login-Kontext, nicht explizit anonyme Credentials. -Der Authsetup-Aufruf nimmt einen Credentialsnapshot; die QoS-Unterscheidung -Static/Dynamic und Identify/Impersonate enthält SSP-/Transportsonderfälle. -Diese Unterschiede bleiben Hypothesen bis zu einem passenden Nachweis. -[RpcBindingSetAuthInfoExW](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcbindingsetauthinfoexw), -[RPC_SECURITY_QOS](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos) - -Produktiver Transport, LocalService-Rechte und gebundene W32Time-Serveridentität -einschließlich Positiv-/Negativnachweisen bleiben offen. Discovery, Negotiate, -NTLM oder ein Mutualauth-Flag allein ersetzen keinen sicheren Identitätsbeweis. -Keine weitere Diagnosequelle und keine Produktfunktion als Teil dieses Schritts. - - -## Enger Quellenvergleich nach dem Builtinergebnis - -Die Microsoft-Methode W32TimeQueryStatus ist ausdrücklich Opnum6. Sie hat genau -zwei Parameter: das primitive handle_t hBinding und den äußeren out/ref-Zeiger -auf PW32TIME_STATUS_INFO. Kein ulInfoLevel, Providername oder weiterer -Eingabeparameter ist für diese Methode beschrieben. Das ursprüngliche gepinnte -IDL bewahrt sechs unaufgerufene Slots davor; unser tatsächlicher Aufruf ist -RmmW32TimeQueryStatus(binding,&status). Der erhaltene Microsoft-MIDL-Header149b -hat denselben Zweiparameterprototyp. Dieser Vergleich liefert deshalb keinen -Hinweis auf einen fehlenden Infolevel-/Providerparameter bei unserer Opnum6. -[W32TimeQueryStatus, Opnum6](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/7e80a465-f5f4-4c3c-87ef-12f76e45f8d1) - -Der eigene Code aktiviert das vorhandene Recht vor dem Aufruf der gesamten -RPCfunktion. Erst danach entstehen in diesem neuen Prozess Binding, Discovery -und Authsetup. Die einfache Erklärung, unser eigener statischer -Credentialsnapshot sei bereits vor Enable erstellt worden, passt daher nicht -zu dieser nachgewiesenen Codefolge. Welche Identität und Privilegabbildung die -Gegenseite tatsächlich geprüft hat, bleibt ohne passenden Nachweis offen. - -Als Unterschiede zum Builtin bleiben Authn-/SSP-Auswahl, der tatsächlich beim -Server ausgewertete Clientcredential-Kontext und dessen zulässige Impersonation -zu untersuchen. Identify2 hat provider-/transportabhängige Sonderfälle; ein -Wechsel auf Impersonate3 würde zusätzliche Autorität erlauben und wird aus diesem -Befund weder still vorgenommen noch als Produktionsfix empfohlen. Die reine -Builtin-Ausgabe offenbart diese internen Einstellungen nicht. Es werden keine -Servercallbackursache oder DetectionLocation1750-Zuordnung erfunden. - -Die originalen IDL-Kommentare nennen teilweise ältere Kapitelnummern. Der hier -verifizierte Vertrag stammt aus der aktuellen Methodenbeschreibung3.2.5.7 und -der dort gebundenen Statusstruktur2.2.17; ein Kommentarfix kann nach dem MVP -folgen. Gepinnte IDL-/MIDL-/Produktquellen bleiben in diesem Abnahmeschritt bytegleich. diff --git a/docs/windows-clock-readiness.md b/docs/windows-clock-readiness.md deleted file mode 100644 index a87aa86..0000000 --- a/docs/windows-clock-readiness.md +++ /dev/null @@ -1,321 +0,0 @@ -# Windows-Zeitstatus: Adapter und native Readinessprobe - -**Ergänzung1.23:** Der User erlaubt den gesonderten aktiven Windows-KVM- -Opt-in-Zeitmodus ohne unabhängige physikalische Timerkalibrierung. -[Angenommener Vertrag](windows-kvm-clock-contract-proposal.md). Kein Fallback -auf den alten RPC-Adapter, keine native Zeit-/Jobfreigabe daraus. - -**Neue Userentscheidung1.22:** Ein unabhängiger signierter Onlinezeitvergleich -mit dem festgelegten Server ist ausdrücklich zur Umsetzung erlaubt. -Der frühere Ausschluss eines Serverzeitankers gilt für diese Alternative nicht -mehr. [Angenommener Vertrag und offene Nachweise](windows-clock-attestation-proposal.md). -Die folgenden RPC-Belege bleiben historische Befunde; kein Clockgate dadurch -eröffnet und kein W32Time-Sync behauptet. - - -Stand 2026-11-14. Ergänzung zu [Windows-Jobgrenze](windows-job-boundary.md). -Diese Strecke ändert weder die Windows-Geräteidentität noch die WebUI-Grenze. -Ein Zeitstatusbericht ist keine Jobgenehmigung. `NativeClock::now()` verweigert -aktuell immer mit `CLOCK_ADAPTER_UNQUALIFIED`, unabhängig von einem positiven -Diagnosestatus; `ADAPTER_QUALIFIED=false` bleibt bis zur tatsächlichen nativen -Adapterabnahme im Code fest geschlossen. Der aktuelle RPC-Prototyp ist -noch kein vollständig qualifizierter produktiver Zeitvertrauensnachweis. - -## Vertrag und konservative Genauigkeitspolitik - -`crates/agent-windows/src/clock.rs` enthält eine numerische Statusauswertung und -einen `SyncClock`-Adapter. Ein Stub wird aus dem engen IDL mit WIDL generiert; -der C-Adapter fängt RPC-Ausnahmen mittels Windows-SEH vor der Rust-Grenze ab. -Einziger aufgerufener Statusvertrag ist MS-W32T Interface4.1, Opnum6. Die sechs -vorherigen IDL-Platzhalter erhalten ausschließlich dessen Ordinal; sie werden -niemals aufgerufen und bilden keine mutierenden Produktfunktionen ab. - -Die Zeitintervalle für Verzögerung, Dispersion, Phasenabweichung und Alter sind -100ns-Einheiten. `qwLastSyncTicks` ist dagegen ein UTC-FILETIME seit1601; -`tpTimeLastGoodSync` bezeichnet das verstrichene Alter seit dem letzten guten -Abgleich, kein zweites UTC-Datum: -[Statusstruktur](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/f60ebce0-df96-4c96-b40b-fdbd34a2c936), -[Zeitdienstelemente](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/1da649d7-3edf-4a9a-98c2-907ecacd1633). - -Der technische Default verlangt gemeinsam: - -- `SYNC=2`, letztes Syncergebnis0, Leap0..2 und Stratum1..15; -- letzten erfolgreichen Abgleich höchstens3600s alt, UTC-Zeitstempel nicht in - der Zukunft, beide Altersdarstellungen innerhalb1s plus Abrufdauer konsistent; -- Dispersion + halbe nichtnegative Root-Roundtripverzögerung + absolute - Phasenabweichung + gesamte gemessene Abrufdauer höchstens2s; -- Abrufdauer höchstens1s, bekannte Flags und exaktes x64-Strukturlayout120Byte. - -Negative Root-Verzögerung wird konservativ verweigert, auch wenn einzelne -Zeitquellen solche Werte liefern können. Überlauf, unbekannte Felder, Fehler, -veralteter oder widersprüchlicher Status schließen das Gate. Das separate -MS-SNTP-Authentifizierungsflag wird nicht über die bestehende Linux-NTP-Politik -hinaus verlangt. Die Werte begrenzen die gemeldete technische Unsicherheit; -sie ersetzen keine neue kryptografische Vertrauensentscheidung für Zeitquellen. -[Synczustände](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/b4abb4b0-6d6e-41e4-bd41-d54980d0598a). - -Wallclock und beide präzisen Kernel-Interruptzähler werden vor und nach jedem -Abruf beobachtet. Der unbereinigte Zähler berücksichtigt Schlafzeit, der -unbiased-Zähler schließt sie aus. Eine Differenz oder Wallclockänderung über1s -invalidiert. Ein späterer Status kann erst nach einem tatsächlich erfolgreichen -Abgleich mit UTC-Zeitstempel nach dieser Diskontinuität wieder öffnen. Einfaches -Pollieren des alten Pre-Resume-Status genügt nicht. Es wird kein OS-Suspend oder -Uhrsprung als destruktiver nativer Test ausgelöst: -[Interruptzähler](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise), -[Zähler ohne Schlafzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise). - -## Lokaler RPC und verbleibende Identitätsfrage - -Der erste Readiness-Prototyp benutzt ausschließlich lokalen `ncacn_np` am -festen authentifizierten Endpunkt `\\pipe\\W32TIME_ALT`, WINNT, PacketPrivacy, -Identify und den tatsächlichen Prozesskontext; keine Zugangsdaten und kein -Fallback zum unauthentifizierten W32TIME-Endpunkt. Der NDR-Allocator begrenzt -seine Gesamtdaten auf64KiB. RPC-Timeout1,5s ist ein Paket-Inaktivitätslimit; -zusätzlich verweigert die Auswertung jede tatsächlich über1s dauernde Abfrage. -Ausgaben enthalten nur begrenzte numerische Statusfelder und Fehlercodes, keine -Peer-Namen, Adressen oder Rohdaten. -[MS-W32T-Transport](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655), -[RPC-Zeitlimit](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcbindingsetoption). - -WINNT mit PacketPrivacy authentifiziert allein noch nicht zuverlässig die -Identität des lokalen Named-Pipe-Servers. NTLM kann auch bei gesetztem -`MUTUAL_AUTH` Erfolg melden, obwohl es keine gegenseitige Authentifizierung -unterstützt. Eine solche Flagänderung ist kein Sicherheitsnachweis. Vor -Produktintegration muss zusätzlich die tatsächliche Serveridentität belastbar -gebunden werden. `RPC_SECURITY_QOS_V3.Sid` ist insbesondere für `ncalrpc` -dokumentiert; ob die aktuelle W32Time-Implementierung einen entsprechend -qualifizierbaren lokalen Endpunkt anbietet, ist offen. Kein automatischer -Wechsel auf einen schwächeren Transport. -[RPC-QoS](https://learn.microsoft.com/en-us/windows/win32/rpc/quality-of-service), -[SID-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v3_w). - -## Getrennte LocalService-Probe - -`examples/clock_readiness.rs` ist ein eigener kurzlebiger SCM-Dienst -`RmmWindowsClockReadiness`. Er prüft im eigenen nativen Prozess TokenUser -`S-1-5-19`, erfasst das tatsächliche Elevationflag und den Elevationtyp sowie -aktivierte Administratormitgliedschaft und SYSTEM-Identität separat, liest zwei -Zeitstatuswerte und schreibt einen -höchstens16KiB großen Bericht. Keine RMM-Verbindung, kein Agentenstop, keine -Uhrkorrektur und keine Änderung von W32Time-Konfiguration oder System-ACLs. - -`deploy/windows/clock_readiness.py` legt für jeden Versuch einen neuen privaten -Fall mit UUID, Source-/Binaryhash und dauerhaftem Intent vor dem RPC an. -Bootstrapdateien liegen versioniert unter einem eigenen privaten Verzeichnis. -Nur der eigene Readiness-Dienst erhält Schreibrecht auf seinen Ergebnisordner; -das Manifest bleibt Administratoren/SYSTEM vorbehalten. Nach Dienstende werden -Statusbericht und exakte Dienstkonfiguration gelesen und ausschließlich dieser -eng gebundene gestoppte Hilfsdienst entfernt. Ausgelieferte Dateien und private -Belege bleiben für Readback erhalten. Der vorhandene Bootstrap verwendet nur -prozessbezogen `RemoteSigned`, keine Maschinenrichtlinienänderung und keine -entsprechende Erlaubnis für spätere RMM-PowerShell-Jobs. - -Nach unklarer SSH-Antwort ausschließlich `readback --id ` -verwenden. Kein erneutes Starten desselben Falls, kein blinder neuer Start als -Ersatz. `native_execution_verified` weist die tatsächliche LocalService-Probe -nach; `diagnostic_status_ready` bildet den Rohstatus beider Berichte ab; `clock_ready` -verlangt zusätzlich die getrennte Adapterqualifikation. Rohstatus allein kann -niemals produktive Clock-Bereitschaft behaupten. Ein negativer -Status ist ein gültiger Messbeleg und keine Freigabe für Jobcapabilities. Die -oben offene Serveridentitätsbindung bleibt dabei eigenständig erforderlich. -Das rohe Elevationflag wird nicht mit Administratormitgliedschaft gleichgesetzt; -seine tatsächliche Bedeutung für dieses Diensttoken wird erst nativ ermittelt. -[Token-Elevation](https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-token_elevation), -[aktivierte Gruppenmitgliedschaft](https://learn.microsoft.com/en-us/windows/win32/api/securitybaseapi/nf-securitybaseapi-checktokenmembership). - -## Tatsächlich lokal ausgeführte Qualifikation - -- WIDL-Generierung und beide C-Objekte Windows-x64 mit Clang-SEH und `-Werror`: - erfolgreich; statische C-Assertions bestätigen120Byte-Status/64Byte-Rust-ABI. -- WindowsGNU-Crossbuild der Readiness-EXE mit Lockfile/offline: erfolgreich. -- Drei Rust-Tests: Status-/Unsicherheitsverweigerung, Suspend mit notwendigem - anschließendem Sync, Wallclockrücksprung/Überlauf: alle bestanden. -- Drei Python-Guards: readback nach verlorener Startantwort ohne erneuten Start, - Sourceänderung verweigert, fehlender nativer Bericht verweigert: bestanden. -- Alle drei PowerShell-Bootstrapfragmente mit PowerShell-Parser geprüft. - -Toolchain lokal im Entwicklungscontainer -`rust-discovery-windows-clock-full:local` aus dem bisherigen gecachten -Windows-Buildimage mit `mingw-w64-tools` und `clang`. `build.rs` verlangt für -Windows derzeit genau x86-64/GNU; MSVC und andere Architekturen sind nicht -qualifiziert. Compiler-/Containerprüfungen ersetzen keine tatsächliche -Windows-Ausführung. Native Ergebnisse werden getrennt im Projekt ergänzt. - -## Native Zwischenstände: keine Clock-Abnahme - -Der Root-Runner hat drei getrennte Fälle durchgeführt und die Belege privat -unter `devstate/windows-client/clock-readiness/` erhalten: - -- `995eb9c1-e1f4-4b17-85b4-5976e9e362e6`: vor Upload/Diensterstellung - verweigert. Die ACL-Prüfung berücksichtigte das automatisch ergänzte reine - Synchronize-Recht nicht. Tatsächlicher Readback: Rootbesitzer Administrators, - nur SYSTEM/Administrators FullControl und LocalService ReadExecute+Synchronize, - kein Hilfsdienst, kein Remote-Fall und keine Dateien. Danach wurde nur dieses - zusätzliche Nichtschreibrecht im engen ACL-Maskenvertrag zugelassen. -- `89b3e688-50ae-4cbd-b519-16a379aa6424`: Hilfsdienststart scheiterte mit - behandeltem1066, kein Ergebnisbericht. Derselbe Fall wurde ausschließlich - gelesen und sein exakt gebundener gestoppter Hilfsdienst entfernt. Ursache - noch nicht durch einen spezifischen Fehlercode belegt. -- `513fb6df-df3b-43a2-bada-a0f7bb939f54`: nach Erweiterung um tatsächliche - Tokenfelder wurde kein Ergebnisbericht erzeugt; Dienstexit1067. Nur die eigene - ApplicationError-Metadatenabfrage belegte Exception `c0000005` im eigenen - `WindowsClockReadiness.exe` um2026-11-13T23:52:57.3579204Z. Auch dieser exakt - gebundene gestoppte Hilfsdienst wurde im Readback entfernt. Das ist ein - tatsächlicher nativer Fehler, kein DLL-/Zugriffs-/Zeitstatus-Erfolgsnachweis. - -Die danach vorbereitete Probe schreibt den begrenzten Tokenbeleg bereits vor dem -RPC dauerhaft und führt numerische SCM-Stufen für behandelte Fehler. Der konkrete Compiler-TLS-Fehler wurde danach lokalisiert und behoben (unten). -Authentifizierte Serveridentitätsbindung bleibt offen; Windows-Jobclock -bleibt unqualifiziert und das Jobgate geschlossen. Die permanenten Agenten, -Geräteidentitäten, Zeitdienste und Cloudserver wurden von diesen ausschließlich -eigenen Readinesshilfsdiensten nicht verändert. - -Der zusätzliche eigene Fehleroffset `0x48b4e4` ließ sich mit der exakten -EXE9be65748… und ImageBase`0x140000000` lokal mittels MinGW-addr2line auf -`release_allocations()` abbilden. Disassembly zeigt dort den Zugriff auf eine -NULL-Compiler-TLS-Basis des SCM-Threads. Der Korrekturbuild ersetzt ausschließlich -diesen `_Thread_local`-Allocatorzustand durch `InitOnceExecuteOnce`/`TlsAlloc` -und eine pro synchronem Aufruf über `TlsSetValue` gebundene, geprüfte Arena. -Aufrufende Threads ohne Arena erhalten keine Allokation; nach Cleanup wird der -Pointer gelöscht. Endpoint, RPC-Authentifizierung und IDL wurden dafür nicht -abgeschwächt. Die begrenzte Tokenprobe wird vorher dauerhaft geschrieben. -Dieser korrigierte Build wurde erfolgreich crossgebaut; die drei Rusttests, -drei Runnerguards und PowerShellparser liefen erneut erfolgreich. Der native Nachweis folgt im nächsten Absatz. - -Native Korrekturprobe `ecf04ebb-23e4-48da-b324-56d98460cd64`, EXE -`4219054b8c51462458ab36fcb0eee3ad5e6905e4725621e6f5103c3e0eca9f4f`: -tatsächlich ausgeführt, zwei Statusabrufe, dauerhafte Token- und Ergebnisberichte, -Hilfsdienst danach entfernt. Beide Abrufe liefern RPC1722 (`CLOCK_UNSUPPORTED`), -keinen Zeitstatus und `clock_ready=false`; gemessene Dauer3,6513ms und0,2029ms. -Damit ist der Compiler-TLS-Absturz für diese Strecke nativ behoben, aber kein -Zeitvertrauen belegt. Das echte Diensttoken besitzt SID`S-1-5-19`, keine aktivierte -Administratormitgliedschaft und keine SYSTEM-Identität, dennoch -`TokenIsElevated=1`/`TokenElevationType=Default(1)`. Der rohe Elevationswert darf -nicht als gleichwertige Administratorzugehörigkeitsprüfung verwendet werden. - -Eine anschließende enge Endpointprobe ist nun implementiert und lokal -crossqualifiziert: ausschließlich lokaler EPM, exakte Clock-UUID/Version4.1, -höchstens16 Einträge, nur aggregierte Transportanzahlen und Fehlercode. Keine -Endpointnamen, Annotationen oder Adressen verlassen die C-Grenze. Diese Probe -führt keinen ALPC-Statusaufruf aus und ersetzt keine Serveridentitätsprüfung. -Der entsprechende neue native Durchlauf ist noch offen. - -## Implementierter nächster Kandidat: ALPC mit fester Server-SID - -Der zuvor vorbereitete V3-Kandidat verwendete ausschließlich einen -lokal per exakter Interface-UUID/Version gefundenen `ncalrpc`-Endpunkt. Die -verlangte Server-SID wird lokal als LocalService`S-1-5-19` erzeugt und mittels -`RPC_SECURITY_QOS_V3.Sid` und `MUTUAL_AUTH` fest gebunden. WINNT/PacketPrivacy, -Identify und der echte Prozesskontext bleiben erforderlich. Es gibt keinen -Status-Fallback auf Named Pipes und keine Übernahme einer Identität aus der -Endpointliste. Ein fremder registrierter Endpunkt kann so höchstens die -Bereitschaft verhindern. Dieser Vertrag trennt unterschiedliche Windowskonten; -ein Angreifer mit bereits denselben LocalService-Prozessrechten gehört nicht -zu einer neu behaupteten Prozessisolation. Der zuvor dokumentierte Named-Pipe- -Abruf bleibt eine getrennte Diagnose und liefert selbst bei geeignetem Status -immer `trusted=false`/`CLOCK_SERVER_IDENTITY_UNQUALIFIED`. - -Da Windows die synchrone RPC-Timeout-/Cancel-API für `ncalrpc` nicht entsprechend -unterstützt, begrenzt ein einziger prozessweiter RPC-Worker den Aufrufer. Er -verwendet einen Kanal mit Kapazität1 und maximal1s Antwortwartezeit. Ein Timeout -vergiftet diesen Worker dauerhaft: keine Ersatzthreads, kein blindes Wiederholen, -kein Rückfall auf Named Pipes. Selbst bei einem hängenden read-only RPC existiert -höchstens ein solcher Worker; die Agenten-/Telemetriearbeit kehrt mit -`CLOCK_UNTRUSTED` zurück. Rekonstruktion eines `NativeClock`-Objekts setzt diesen -Zustand nicht zurück. Parallelaufrufe bei belegtem Worker werden verweigert. -[RPC-Cancel-Grenzen](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpccancelthreadex). - -Dieser Kandidat wurde erfolgreich für WindowsGNU crossgebaut. Fünf lokale -Rusttests bestehen, einschließlich Timeout und nachfolgend verweigerter zweiter -RPC-Wirkung sowie unverändert geschlossenem Qualifikationsgate; die früheren -drei Clocktests bleiben erhalten. Vier Runnerguards bestehen, zusätzlich -Rohstatusbereitschaft ohne Adapterqualifikation verweigert produktive Bereitschaft. Native Nachweise für -ALPC-Verfügbarkeit, feste SID-Bindung und positive Zeitbereitschaft stehen aus. -Das ist weiterhin keine Windows-Jobclock-Abnahme. - -Ein eigener Bootstrap-Readback des Root-Agenten bestätigte für W32Time -`Stopped`, Startart`Manual`, KontoLocalService`S-1-5-19` und PID0. Die -RPC1722-Werte der korrigierten Probe sind damit konsistent. Der Zeitdienst wurde -für diese Readinessstrecke nicht gestartet oder umkonfiguriert. Ein entsprechender -eng begrenzter Start des bestehenden Dienstes bleibt bis zur hierfür vom -Root-Agenten angefragten Benutzerentscheidung ausgesetzt. Der neue -ALPC-/SID-Kandidat wurde deshalb noch nicht nativ ausgeführt. - -## Weiterer Quellkandidat: zusätzlich getrennte W32Time-Dienstidentität - -Die Kontobindung an LocalService allein trennt W32Time nicht vom Netzwerkagenten, -der ebenfalls SID19 verwendet. Sie darf daher noch keine unabhängige Helper- -Clockqualifikation begründen. Der aktuelle Kandidat verwendet ergänzend die -lokal ermittelte feste `NT SERVICE\W32Time`-SID in einem ausschließlich -clientseitig aufgebauten V5-Serverdescriptor. SID19, PacketPrivacy, Identify und -ALPC bleiben erforderlich; keinerlei schwächerer Fallback. Das ändert keine -OS-DACL, W32Time-Konfiguration oder Kontorichtlinie. - -Die Readinessprobe enthält zwei getrennte begrenzte Nur-Lese-Negativkontrollen: -falsches Serverkonto und falsche Dienst-SID bei demselben erwarteten Konto19. -Nur eine erfolgreiche echte W32Time-Abfrage zusammen mit tatsächlichen -Zugriffsverweigerungen beider Kontrollen kann diesen Kandidaten weiter -qualifizieren. Fehlender Endpoint oder Timeout ist kein Identitätsnachweis. -Ein separater einzelner Diagnoseworker begrenzt auch diese Kontrollen; Timeout -vergiftet ihn ohne Ersatz. Beide Kontrollen bleiben immer diagnostisch und -verleihen selbst bei unerwartetem Erfolg keine Uhrbereitschaft. - -Microsoft beschreibt das Descriptorfeld als Serveridentifikation, aber nicht -alle Einzelheiten seiner Auswertung. Die Dienstbindung ist deshalb ein zu -prüfender Adapterkandidat, keine aus einem erfolgreichen Konfigurationsaufruf -abgeleitete Sicherheitsgarantie. Vor Öffnen des Gates sind seine tatsächlichen -Positiv-/Negativnachweise und die Isolation vom Netzwerkagenten nachzuweisen. -[V5-SDK-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w). - -Lokal tatsächlich geprüft: C-Kandidat mit Clang/WindowsGNU und `-Werror` -kompiliert, feste56Byte-V5-ABI/SDK-Prefix-/48Byte-Descriptoroffset-Assertions -bestanden, fünf Clock-Vertragtests gegen den tatsächlichen Core unter Linux -bestanden. Ältere MinGW-Header enthalten V5 nicht; die eng benannte lokale -SDK-Struktur bleibt aufx64 begrenzt und wird beim MSVC-Build zusätzlich direkt -gegen die native SDK-Deklaration geprüft. Dies ersetzt weder einen nativen -MSVC- noch einen tatsächlichen W32Time-Nachweis. W32Time ist weiterhin gestoppt; -Produktgate unverändert `ADAPTER_QUALIFIED=false`. - -## Autorisierter Dienststart — noch keine Clockabnahme - -Nach ausdrücklicher Userentscheidung1.18 wurde das vorhandene W32Time im Fall -`c3552c3f…` genau einmal gestartet und separat lesend als Running bestätigt. -RMM-Agent/Helper samt ursprünglichen PIDs, Definitionen und PKI-Metadaten, -ausgewählte NTP-/Policywerte und zentrale Jobzählungen/Flags sind erhalten. -Keine Startart-/NTP-/ACLänderung oder Resynchronisierung angefordert; normale -Synchronisierung durch den Dienst ist erlaubt. [Genauer Beleg](windows-time-service-start.md). - -Ein neuer GNU-Diagnosebuild `a817cf61…`, EXE `f5003f96…`, wurde lokal mit -identischen Quellbindungen vor/nach gebaut. Sein tatsächlicher ALPC-/Status-/ -Identitätskontrolllauf ist inzwischen ausgeführt; Ergebnis folgt unten. Der -Dienststart allein öffnet weder Clock- noch Jobgate. - -## Tatsächlicher Kandidatenlauf nach Dienststart: nicht qualifiziert - -Fall `e1f3edbb-5a2f-4d82-a449-0432913c6bd7`, EXE `f5003f96…`, nativ als -separater LocalService-Dienst: TokenSID19, kein Administratormitglied/SYSTEM, -zwei Statusproben und beide Identitätskontrollen ausgeführt. ALPC meldet jeweils -`1753`/`CLOCK_UNSUPPORTED`; die Endpunktenumeration meldet Erfolg mit0Einträgen. -Beide Negativkontrollen ebenfalls1753, **kein Ablehnungs-/Identitätsbeweis**. -Die zusätzliche Named-Pipe-Diagnose meldet1783 ohne Status. Noch unbewiesen, -ob dessen Quelle RPC/NDR oder der eigene strikte Strukturguard ist. Keine -stillschweigende Status-/Authentisierungs-/Transportlockerung. - -Der eigene temporäre Dienst wurde nach Stopped entfernt; der normale Agent und -SYSTEM-Helper wurden nicht gestoppt oder verändert. Separater Readback bestätigt -identischen Originalbericht. Zentralstände0/0/0/0 und30/30/26/0 sowie geschlossene -Flags/Rootpolicyhash vor/nach unverändert. Privater Fallabschluss -`assessment.json`, SHA256 -`d80e5f39cbd6d332deb12bf4f21e1372c88025b551db4ef33a190e3f82b3300a`. -Native Ausführung belegt, **Clockabnahme fehlgeschlagen**; Produktionsgatefalse, -keine Windowsjobs oder Capabilities aktiviert. - -Nach dem Lauf erneut gegen Microsoft geprüft: MS-W32T2.1 verlangt Named-Pipe- -Transport und nennt den authentisierten Endpunkt `W32TIME_ALT`; ein ALPC- -Endpunkt ist damit kein zugesicherter Plattformvertrag. Der bisherige ALPC- -Kandidat war ein zu qualifizierender Zusatz, keine native Windowsgarantie. -[Transportvertrag](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655), -[vollständiges IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a). -Die konkrete1783-Ursache wird separat rein diagnostisch eingegrenzt; eine -erfolgreiche unqualifizierte Pipeabfrage würde die Clockgrenze weiterhin nicht -öffnen. Bereits vorhandene Originalfehler bleiben unverändert erhalten. diff --git a/docs/windows-clock-rpc-qos5-analysis.md b/docs/windows-clock-rpc-qos5-analysis.md deleted file mode 100644 index f10ca5b..0000000 --- a/docs/windows-clock-rpc-qos5-analysis.md +++ /dev/null @@ -1,108 +0,0 @@ -# QOS5-Fehler87: statischer Befund der tatsächlichen RPC-Runtime - -2026-11-14. Die beiden nativen QOS5-Diagnosen erreichen keine Statusquery. -Die folgende ausschließlich lokale Analyse grenzt ihre Parameterverweigerung -an der bereits nur lesend gesicherten Windows-System-DLL ein. Sie führt keine -PE-Datei, keinen neuen Dienst und keinen RMM-Job aus. Die bestehenden131 -Produktinputs und31 Diagnoseinputs bleiben bytegleich. Produktclock und -Windowsjobgate bleiben geschlossen. - -## Primärvertrag und gesicherte Artefakte - -Microsoft beschreibt `ServerSecurityDescriptor` in QOS5 als clientseitigen -Serveridentifikationsdescriptor. Die öffentliche Dokumentation präzisiert -weder seine Auswertung für Named Pipes noch eine Pflicht zum selbstrelativen -Format. Die SID ist eine Alternative zum erwarteten Serverprincipal; ein -erfolgreich gesetztes Mutual-Auth-Flag alleine belegt bei NTLM keine -gegenseitige Authentifizierung. -[QOS5-Vertrag](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/ns-rpcdce-rpc_security_qos_v5_w), -[SetAuthInfoExW](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcbindingsetauthinfoexw). - -Die tatsächlich auf der Windows-VM nur lesend kopierte `RPCRT4.dll` hat -1182928Byte und SHA256 -`35fa5f92f985cba9b33bc5f17968211d84ebb910d639ba2db8f35596befca6a6`. -Die getrennten nativen Before-/Aftermetadaten melden denselben Hash, dieselbe -Länge und Windows-Authenticode-Status `Valid`. Die lokale Kopie stimmt damit -überein. Das ist der untersuchte konkrete OS-Stand, keine Zusage für jede -Windowsversion oder jeden Transport. - -Die über den offiziellen Microsoft-Symbolserver zum CodeView-Schlüssel -`E9DD14015C33891F220822884DBE17FA1` geladene öffentliche `rpcrt4.pdb` hat -905216Byte und SHA256 -`1e31c17cb9f42e6bd503d149793104a50683dfc4421b3139a09836549aa3dd6c`. -GUID `e9dd1401-5c33-891f-2208-22884dbe17fa` stimmt überein. -DLL-CodeView-Age und PDB-DBI-Age sind jeweils1; der PDB-Informationsstream -meldet dagegen3. Diese Werte werden getrennt erhalten, kein vollständiger -Age-Gleichstand behauptet. Die unten genannten Codeadressen und der -Vtableslot sind zusätzlich unmittelbar gegen die DLL-Bytes geprüft. - -Alle OS-Binärdateien, PDB, vollständigen Disassemblies und Rohbelege bleiben -privat unter `devstate/windows-builtin-clock/f2de6c29-38f3-4e4d-813e-e9e498a870a6/` -im Hauptcheckout. Sie werden nicht ins Repository übernommen. - -## Frühere Verweigerung bei tatsächlich leerem Principal - -Der Export `RpcBindingSetAuthInfoExW` beginnt bei RVA`0x405f0`. Sein -Mutual-Auth-Parametercheck behandelt sowohl NULL als auch einen vorhandenen -Principal mit erstem UTF-16-Codeunit0 als fehlenden erwarteten Namen: -RVA`0x40962` prüft genau diese leere Zeichenfolge. Dieser Pfad verlangt -anschließend QOS-Version mindestens3 und eine vorhandene SID bei QOS-Offset -`0x20` (RVA`0x40771` bis`0x4077e`). Andernfalls liefert RVA`0x409b2` direkt87. -Der V5-Descriptor bei Offset`0x30` wird erst später betrachtet. - -Das erklärt den ersten erreichbaren Verweigerungszweig der nativen -Descriptorprobe `4b1ae5cf…`: ihr tatsächlich vorhandener Discoveryprincipal -ist leer, `Sid=NULL` und Mutual Auth ist gesetzt. Ein Wechsel nur vom absoluten -zum selbstrelativen Descriptor würde diesen früheren Check nicht verändern. -Dies ist eine aus den unveränderten konkreten Eingabewerten und DLL-Bytes -abgeleitete statische Erklärung; keine nachträglich erfundene dynamische -Debuggeraufzeichnung des ursprünglichen Falls. - -## Zusätzliche Descriptorverweigerung im OSF-Pfad - -Auch ein nichtleerer erwarteter Principal löst den nächsten Blocker nicht: - -- QOS5-Descriptor wird bei RVA`0x4099d` aus Offset`0x30` geladen und als letztes - Stackargument bei Caller-Offset`0x88` weitergereicht (RVA`0x40862`). -- Der virtuelle Aufruf benutzt Slot`0xd8`. Die tatsächliche - `OSF_BINDING_HANDLE`-Vtable bei RVA`0xdd408` verweist dort auf - `BINDING_HANDLE::SetAuthInformation`, RVA`0x7b110`. -- Dessen Prolog legt den Framepointer64Byte unter den vorherigen Callerstapel. - Somit bezeichnet `[rbp+0xc8]` genau das weitergereichte letzte Argument. - RVA`0x7b169` prüft dieses auf NULL; bei non-NULL führt RVA`0x7b170` unmittelbar - zu RVA`0x7b6a2`, Rückgabe87. Der Zweig liegt vor der Securityproviderarbeit. - -Der hier verwendete verbindungsorientierte Named-Pipe-/OSF-Pfad nimmt folglich -keinen non-NULL-Serverdescriptor an, unabhängig von dessen Format. Die native -SID-/Descriptorprobe `bcda2ede…` mit fester SID und NULL-Principal ist mit diesem -weiteren Blocker konsistent. Nicht behauptet wird, ein Debugger habe genau -diesen Branch beim damaligen Prozess beobachtet. Ein isolierter -`MakeSelfRelativeSD`-Nachfolger oder ein weiterer Descriptorvergleich mit -anderem SPN würde diese Runtimeverweigerung nicht beseitigen. - -## Tatsächliche Prüfung und verbleibende Grenze - -GNU `objdump` wurde lokal auf der gesicherten DLL ausgeführt. Ein eigener -lokaler Analysereader prüft DLL-/PDB-Hashes, GUID sowie alle getrennten -Agewerte, öffentliche Symbolpositionen, den echten Vtableslot und neun enge -Instruktionsbytesfolgen. Er prüft zusätzlich die unveränderten131 ursprünglichen -Produktinputs,27 älteren Diagnosedateien und die vier eingefrorenen -Descriptorquellen. Der erste lokale Readerlauf verweigerte ausdrücklich am -unterschiedlichen PDB-Info-Age; die anschließende Fassung erhält diese -Abweichung und bindet DBI-Age/Adressen/Bytes getrennt. Linker-Absolute-Symbole -werden nicht als PE-Sektionsadressen behandelt. - -Der abschließende statische Bericht `rpcrt4-qos5-static-analysis.json` hat -SHA256 `86328105c109e49f08b06bac9e33e1fc74c7debba88ac3951e565c63d0497a19`. -Kein neuer Native-, Build-, Identitäts-, Synchronisierungs- oder Clocknachweis -wird dadurch behauptet. Insbesondere bleiben der erfolgreiche reine -GSS9/Privacy6/Impersonate3-Statusabruf und die fehlende unabhängige Dienstbindung -getrennte Ergebnisse. - -Ein vorher separat per Pipehandle beobachteter SCM-PID-/Tokenbeleg bindet -nicht automatisch die andere, vom RPC-Runtimehandle eröffnete Verbindung. -Er darf daher keinen Ersatz für die fehlende Dienstidentitätsbindung bilden. -Ein gleichwertiger, auf der tatsächlichen Verbindung wirksamer OS-Vertrag -ist noch offen; keine Lockerung auf bloße Discovery-, Mutual-Auth-Flags oder -CLI-Textinterpretation. Auch eine positive OS-Zeitsynchronisierung würde diese -unabhängige Identitätslücke alleine nicht schließen. diff --git a/docs/windows-clock-spnego-empty-trace.md b/docs/windows-clock-spnego-empty-trace.md deleted file mode 100644 index 8fcc374..0000000 --- a/docs/windows-clock-spnego-empty-trace.md +++ /dev/null @@ -1,197 +0,0 @@ -# Isolierter Vergleich mit tatsächlich zurückgegebenem leerem Principal - -Stand2026-11-14: neuer getrennter Diagnosenachfolger lokal gebaut/geprüft. -**Native Ausführung, separater Readback und Cleanup durch den Hauptagenten inzwischen erfolgt; der Subagent hat keine VM-/SSH-Aktion ausgeführt.** -Produktcode, Clockgate, ursprüngliche131Quellen sowie WINNT-/SYSTEM-/EEInfo- und -F6-SPNEGO-Proben bleiben unverändert und mit ihren ursprünglichen Treibern lesbar. - -## Tatsächlicher Ausgangsbefund - -Der ursprüngliche SPNEGO-Case -`0f512772-3599-4c83-b877-41c74fe50fb0` verwendet Manifest -`f6b5cd23b1599c2db4fc803fd7232dfd3522dead840e492f659e4efd7a6be001`. -Sein unveränderter `diagnostic-result.json` hat SHA256 -`4c99b34b8c64f877dbbf0fe860d59499f1c054de7d036016e80b84581448cfc9`. -Der tatsächliche Bericht meldet Discovery1/Status0/normaler Return1, -Principalpointer vorhanden1 und UTF16-Länge0. Die eigene Nichtleerprüfung -verweigert dies mit123/Stage26, vor dem Authsetup und vor Opnum6; Statusaufrufe0. -Das ist kein Nachweis eines W32Time-Statusqueryfehlers. - -Die eigene SYSTEM-Primärtokenprobe wurde vorher erhalten: kein Threadtoken, -SeSystemtimePrivilege vorhanden1, Attribute0, Enabled0. Das bleibt eine reine -Beobachtung; weder daraus noch aus dem Leerstring werden Workgroup-, Domain-, -Provider-, ACL- oder Privilegursachen abgeleitet. Readback und Cleanup des alten -Cases erfolgen ausschließlich durch den Hauptagenten mit dessen originalem -Treiber; dieser Nachfolger ersetzt keinen historischen Beleg. - -## Primärquellen und Schlussgrenze - -Die Microsoft-API beschreibt den zurückgegebenen Principal als vom RPC-Runtime -allokierte Zeichenfolge, die anschließend mit RpcStringFree freizugeben ist. -Eine zusätzliche Mindestlänge wird dort nicht festgelegt. -[RpcMgmtInqServerPrincNameW](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcmgmtinqserverprincnamew) - -Die Syntax und Bedeutung des Authentifizierungs-Zielnamens bestimmt der -verwendete SSP. Das ist keine allgemeine Garantie, dass jeder SSP einen leeren -Namen akzeptiert. -[RpcBindingSetAuthInfoExW](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcbindingsetauthinfoexw) - -Microsoft nennt Systemdienste, für die manche Provider keinen Principalnamen -führen, und warnt ausdrücklich vor Principaldiscovery als sicherem -Serveridentitätsnachweis. Ein erfolgreicher Discoveryaufruf oder ein weiter -gelungener Statusaufruf beweist hier deshalb keine unabhängig gepinnte -Serveridentität. -[Principal Names](https://learn.microsoft.com/en-us/windows/win32/rpc/principal-names) - -MS-W32T AppendixB Fußnote16 beschreibt erfolgreiche Managementdiscovery und -danach den tatsächlich gelieferten Namen mit SPNEGO/PacketPrivacy. Sie fügt -keine Nichtleerbedingung hinzu. Die dort ebenfalls beschriebene unauthentisierte -Fallbackvariante wird hier ausdrücklich nicht implementiert. Fußnote33 beschreibt -eine zusätzliche Privilegprüfung aller authentisierten Methoden; sie erklärt -weder den jetzigen eigenen Stage26-Abbruch noch allein die Bedeutung von -Present/Enabled in unserem Tokenbefund. -[MS-W32T Appendix B, Fußnoten16/33](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/bb576d39-587b-484a-86a4-e1d378cf9497) - -Der engere Schluss ist daher lediglich eine begründete **Diagnosehypothese**: -die eigene Nichtleer-Zusatzprüfung einmal isoliert entfernen und die exakte -Runtimeantwort an den unveränderten SSP übergeben. Es wurde keine konkrete -Primärquellenpflicht gefunden, die genau diesen Diagnosevergleich verbietet. -Es wird weder universelle Leerstring-Zulässigkeit noch Produktionsfähigkeit -behauptet. - -## Exakter neuer Scope - -Vier neue Dateien unter `deploy/windows/clock-spnego-empty-trace/`: - -- `clock_rpc_spnego_empty.c`: im vorhandenen UTF16-Prüfer entfällt allein das - `!i`-Verbot am terminierenden Nullzeichen. NULL-Pointer bleiben Fehler, - Hoch-/Niedrigsurrogate, Steuerzeichen und die512-Unit-Grenze bleiben geprüft. - Der tatsächlich von RpcMgmt gelieferte Pointer wird unverändert und nicht-NULL - an RpcBindingSetAuthInfoExW weitergereicht, auch wenn er auf eine leere - terminierte Zeichenfolge zeigt. Kein erfundener SPN und keine NULL-Ersetzung. -- `system_trace_spnego_empty.c`: gleiches Token-/RPC-/EEInfo-Verhalten; - ausschließlich getrennte Symbol-, Service-, Profil- und Casepfadnamen. - `own_system_token` ist byteidentisch zum Original. -- `native.py`: eigene Case-/Manifest-/Servicebindung; Ergebnisprüfung erlaubt - nun0..512Units nur bei weiterhin vorhandenem und geprüftem Principal. - Ohne erfolgreiche einzelne Discovery kein Statusaufruf. -- `build.py`: gleicher lokaler Compiler-/MIDL-/SDKpfad; bindet zusätzlich - unverändertes F6, dessen beobachteten Ausgangscase und alle vier alten - SPNEGO-Quellen. Der kleine direkte Eltern-Wrapperdiff wird separat erhalten. - -Eigenes SCM-Serviceobjekt: `RmmClockSpnegoEmptyDiagnostic`; eigenes Profil: -`clock-system-spnego-empty-v1`; eigener Pfad: -`C:\ProgramData\RustDiscoveryBootstrap\clock-spnego-empty-trace-`. -Originale Services/Cases werden weder adressiert noch ersetzt. - -Unverändert bleiben GSS_NEGOTIATE9, PacketPrivacy6, Identify2, genau eine -Managementdiscovery und höchstens ein Opnum6 auf dem bereits bekannten -authentisierten W32TIME_ALT-Pfad. Fehler führen weder zu anderem SSP noch zu -anonymer oder unauthentisierter Wiederholung. Das unveränderte AuthIdentity-NULL -bedeutet die bestehende eigene Prozessidentität, keine neu gewählte anonyme -Identität. Die Principal-Pointer-Unterscheidung wird davon getrennt behandelt. -Maximal vier ausschließlich numerische EEInfo-Records, unmittelbare Aufnahme -vor weiterem RPC/Cleanup, keine Namen oder Parameterinhalte. - -Vor RPC werden ausschließlich das eigene SYSTEM-Token und dessen vorhandene -Privileginformationen gelesen und als numerischer Beleg create-once geschrieben. -Kein AdjustTokenPrivileges, kein Impersonate, keine Uhr-, ACL-, Policy-, NTP-, -W32Time- oder RMM-Änderung. Ein temporärer Diagnoseservice ist ausschließlich -separate explizite Bootstrapwirkung des späteren Hauptagenten, kein RMM-Job. -Readback bleibt rein lesend; Cleanup ist ein separater expliziter Vorgang nur -für den gebundenen eigenen gestoppten Service. Nach Antwortverlust kein Startretry. - -## Tatsächlicher lokaler Build - -Buildcase: -`devstate/windows-clock-spnego-empty-trace/build-9daffc05-64d1-45c2-954a-4ec642c5ef70`. -Manifest-SHA256: -`768293c37702e40876a83bbab4a24186a3b4e284cf9a193c40550dd72ef32548`. -Windows-x64-PE `ClockSpnegoEmptyTrace.exe`:99727Bytes, SHA256 -`7ca7cd51cc84678068f00d9ae5344a76485db6a600557757f925f6fcb3228fe5`. - -Verwendet wurde dasselbe gepinnte Image1b2fd985… und die ursprüngliche -Microsoft-MIDL-Ausgabe aus149bafe2 mit Headerhashdb5dbe5b… und Stubhashd806adb4…. -Keine Codegenerierung mit WIDL, kein Header- oder OUT_DIR-Patch. Beide eigenen -C-Units wurden mit Wall/Wextra/Werror übersetzt. Für die unveränderte tatsächliche -MIDL-Unit bleiben genau die bereits überprüften zwei sichtbaren Warnklassen -ohne Werror-Eskalation erhalten. Link, Strip, Importprüfung und echter -PowerShell-AST-Parse erfolgreich. EncodedCommand17146Zeichen, unter32767. - -Die DLL-Importliste stimmt **exakt** mit F6 überein: -ADVAPI32.dll, KERNEL32.dll, RPCRT4.dll und msvcrt.dll. Alle131Originaldateien und -die elf bisherigen Diagnosequellen blieben beim Build byteidentisch; das -ursprüngliche F6-Manifest und sein Ergebnisbeleg sind zusätzlich gehasht gebunden. -Vorhandene Primärunterlagen-Snapshots wurden nicht verändert. - -Der tatsächliche neue C-Prüfer wurde außerdem lokal mit einem temporären -uint16-Fixturetreiber ausgeführt: zehn Fälle einschließlich NULL, nicht-NULL -Leerstring, gültiger Surrogatfolge, ungültiger Unicode-/Steuerzeichen und -512/513Grenze bestanden. Die echte Python-Ergebnisprüfung wurde mit synthetischem -Empty-Query-Bericht geprüft und verweigerte neun Änderungen an Pointer-/Valid- -Status, Länge, Discovery-/Queryzahl, Authparametern und Tokenbefund. Das erzeugt -keinen Windows-RPC-Nachweis. Beleg `empty-local-guards.json`, SHA256 -`9d276e59c3376be3e47cc2580238904ac76bfeda08e4665b2edd5ff39011362a`. - -## Geplante native Fortsetzung, nicht ausgeführt - -Erst nach unabhängigem Rootreview dieses Source-/Manifeststands: - -```text -python3 deploy/windows/clock-spnego-empty-trace/native.py prepare --manifest ABSOLUTE_NEW_MANIFEST --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --execute-native -python3 deploy/windows/clock-spnego-empty-trace/native.py start --manifest ABSOLUTE_NEW_MANIFEST --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --id NEW_CASE --execute-native -python3 deploy/windows/clock-spnego-empty-trace/native.py readback --manifest ABSOLUTE_NEW_MANIFEST --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --id NEW_CASE -python3 deploy/windows/clock-spnego-empty-trace/native.py cleanup --manifest ABSOLUTE_NEW_MANIFEST --access-root /home/kevin/Schreibtisch/Coding/rust-discovery --id NEW_CASE --execute-native -``` - -Der ursprüngliche0f512772-Case bleibt beim alten F6-Treiber. Der neue Vergleich -beansprucht weder Clock-/Adapterqualifikation noch Serveridentitätsnachweis, -Produktgate, Signier-/Jobrecht oder eine tatsächliche native Messung. Auch ein -eventueller RPC-Return0 wäre erst ein Diagnoseergebnis; die vollständige -Zeitvertrags- und Sicherheitsabnahme bliebe gesondert erforderlich. - - -## Tatsächlicher nativer Emptyvergleich 2026-11-14 - -Der Hauptagent hat ausschließlich den neuen Case -`5e0e8ce9-b9a3-4c4a-b739-3f84d714dc94` mit obigem unverändertem -Manifest768293c3… nativ ausgeführt. Der erhaltene Ergebnisbeleg -`diagnostic-result.json` hat SHA256 -`c53378d5b6e1099a781bb007e2480609e4105b94498ce443df937a0a591ff307`. -Discovery1/Status0/Return1 liefert tatsächlich weiterhin einen nicht-NULL -Principal mit0UTF16-Units. Dieser wird unverändert akzeptiert und weitergegeben. -Danach wird genau eine Opnum6-Statusquery versucht. Ergebnis: RPCexception5, -Stage90, kein normaler RPCreturn und kein Statusobjekt. Der unmittelbar erfasste -numerische EEInfo-Befund enthält genau einen Record: Komponente2, Status5, -DetectionLocation1750, Flags0, Parameteranzahl1; Parameterinhalte werden nicht -gelesen. Eigenes SYSTEM-Primärtoken: Recht vorhanden1, Attribute0/Enabled0, -kein Threadtoken. Daraus folgt keine nachgewiesene Privileg-/ACL-/Providerursache. - -Separater rein lesender Readback -`readback-03d099ce-a024-49c7-8a80-6c30f0228756.json`, SHA256 -`7751477d29844f6f8b1e90f8c7322473014c631323aa5d88c54773445eb5f7ea`, -bestätigt den gleichen Bericht, den eigenen gestoppten Dienst und Exit0. -Exit0 bezeichnet den abgeschlossenen Diagnosebericht, keinen erfolgreichen -W32Time-Statusquery. Anschließend hat der Hauptagent den eigenen gestoppten -Diagnosedienst getrennt bereinigt. Cleanupreceipt -`readback-8786048c-06a9-43f1-bede-b62a1ef21e22.json`, SHA256 -`1eb2fdef2aef832973897bd4bb6c01f459ab30e544c603e6feb81e1a318b3bb1`, -meldet cleanup_verified=true und already_absent=false. - -Readback und eigenes Cleanup sind damit nachgewiesen. Nach dem separaten -ScopeClose hat der Hauptagent auch den After-Preservationvergleich gewonnen: -`rust-discovery-windows-pipe-drain/devstate/windows-client/system-pipe-upgrade/14fb176a-f653-4573-a8d7-6f9fe47a3020/spnego-empty-trace-after.json`, SHA256 -`a8ab4396c1c8ed4fa2f0f3b06434efb0ecb058865c69aeba278744a850dd910f`. -Alle sechs nativen Bereiche `service`, `helper_service`, `agent_kernel`, -`helper_kernel`, `files` und `helper_witness` sind exakt zum Before unverändert. -Serverflags bleiben gleich, Rootpolicycf15 geschlossen, Hooksfalse; die -Windows-spezifischen Job-/Outbox-/Permit-/Unresolved-Zähler bleiben0/0/0/0. - -Die global beobachteten Linux-Serverzähler sind ausdrücklich nicht unverändert: -30/30/26 wurden31/31/27, weiterhin unresolved0. Der Hauptagent belegt dies durch -den parallel tatsächlich über MCP beantragten und in der WebUI genehmigten -Linux-Fullscript-Caseced97b4d mit bestandenem Ergebnisbeleg89dcb583…. -Diese autorisierte parallele Wirkung wird nicht als Wirkung der Emptyprobe oder -als globale Preservationgleichheit dargestellt. Der Empty-Abnahmeschritt ist als -Diagnose abgeschlossen; sein Ergebnis bleibt RPC5. Clock-/Adapterqualifikation, -Serveridentität und Produktgate bleiben nicht nachgewiesen/geschlossen. diff --git a/docs/windows-clock-spnego-trace.md b/docs/windows-clock-spnego-trace.md deleted file mode 100644 index 0ca6eed..0000000 --- a/docs/windows-clock-spnego-trace.md +++ /dev/null @@ -1,169 +0,0 @@ -# Isolierter SPNEGO-/Privilegdiagnosevergleich - -Stand2026-11-14: separat implementiert, lokal gebaut/geprüft; **keine VM-Aktion -durch diesen Subagenten**. Kein Produktclockgate, kein neuer Agentadapter und -keine Änderung der ursprünglichen WINNT-/LocalService-/SYSTEM-/EEInfo-Proben. -Die tatsächlichen früheren Vergleiche bleiben RPC5/Stage90 ohne normalen Return -oder Status. Ihr einzelner Runtime-EEInfo-Record mit Detection1750 beweist keine -bestimmte ACL-, Privileg- oder Anonymitätsursache. - -## Primärbefund und begrenzte Hypothese - -[MS-W32T AppendixB, Fußnoten16/32/33](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/bb576d39-587b-484a-86a4-e1d378cf9497) -beschreibt den Windowsclient mit Principalabfrage für SPNEGO und anschließend -GSS_NEGOTIATE/PacketPrivacy. W32Time prüft bei allen authentisierten Methoden -zusätzlich das Systemzeitänderungsrecht. Der bisherige feste WINNT-/NULL- -Principalpfad unterscheidet sich davon. Dies begründet einen Diagnosevergleich, -keine erwiesene Fehlerursache und keine Erlaubnis, Produktprüfungen zu lockern. - -[LocalSystem](https://learn.microsoft.com/en-us/windows/win32/services/localsystem-account) -besitzt `SeSystemtimePrivilege` standardmäßig deaktiviert. Zusätzlich kann SCM -bei ausdrücklich eingeschränkten -[RequiredPrivileges](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/ns-winsvc-service_required_privileges_infow) -nicht benötigte Privilegien vollständig entfernen. SID18 bedeutet daher weder -„vorhanden“ noch „aktiviert“. Die eigene neue Diagnose verwendet einen separaten -SCM-Dienst; sie beweist keinen identischen Token des Produkthelpers. Kein -RequiredPrivileges-, Konto-, SID-, ACL-, NTP- oder Maschinenrichtlinienwechsel. - -## Exakte neue Sourcegrenze - -Vier eigene sibling-Inputs unter `deploy/windows/clock-spnego-trace/`: -`clock_rpc_spnego.c`, `system_trace_spnego.c`, `build.py`, `native.py`. -Eigener temporärer Dienst `RmmClockSystemSpnegoDiagnostic`, eigener Casepfad und -eigene create-only History. Die131 ursprünglichen Quellen und sieben bestehenden -SYSTEM-/WINNT-/EEInfo-Diagnoseinputs werden vor/nach dem Build gehasht und müssen -unverändert bleiben. Neuer Wrapperdiff gegen Original74aceb6e wird erhalten; -das tatsächliche Microsoft-MIDL-Header-/Stubpaar bleibt byteidentisch. - -Vor dem ersten RPC-Aufruf liest die Hülle ausschließlich den eigenen Token mit -TOKEN_QUERY. Primärer SID18-Token ist Pflicht; ein vorhandener Threadtoken oder -ein anderer Tokenfehler beendet den Versuch, ohne Impersonation/Revert. Fester -Lookup von `SeSystemtimePrivilege`, höchstens256 SDK-`LUID_AND_ATTRIBUTES` in -4096Bytes; SDK-Buffermengen werden geprüft. Vorhandensein, rohe Attribute, -Enabled/EnabledByDefault/Removed und numerische APIfehler werden getrennt -erhalten. `token.json` wird create-only und fsync-gesichert **vor** dem fremden -RPC-Code geschrieben. Fehlendes/deaktiviertes Privileg wird beobachtet; die -Diagnose aktiviert oder vergibt es nicht. Keine Passwort-/Credentialabfrage, -kein AdjustTokenPrivileges oder sonstiger Tokenänderungsaufruf. - -Der feste lokale `ncacn_np`-Endpunkt bleibt `\\pipe\\W32TIME_ALT`. Calltimeout1500ms -wird vor der Principalabfrage gesetzt. Genau eine -[RpcMgmtInqServerPrincNameW](https://learn.microsoft.com/en-us/windows/win32/api/rpcdce/nf-rpcdce-rpcmgmtinqserverprincnamew)-Abfrage -für GSS_NEGOTIATE darf stattfinden. Diese Managementabfrage ist gesondert gezählt; -sie ist keine W32Time-Statusabfrage. Nur APIstatus0, Nonnull und ein binnen512 -UTF16-Einheiten NUL-terminierter, nicht leerer und strukturell gültiger String -ohne C0/C1-Steuerzeichen darf an SetAuthInfoEx weitergegeben werden. Strings, -Principalname, Parameterwerte oder Pointer werden niemals ausgegeben. Die API -allokiert den String intern; die512-Grenze beschränkt Prüfung/Weiterverwendung, -**keine behauptete Vorabgrenze der internen RPC-Allokation**. - -Danach ausschließlich GSS_NEGOTIATE, PacketPrivacy, IDENTIFY, statische implizite -eigene Credentials und genau dieser Principal. Kein NULL-, WINNT-, anonymer oder -anderer Auth-/Transportfallback. Die erwartete Identität des Servers wird dadurch -nicht unabhängig bewiesen; der vom Endpunkt gelieferte Principal ist ausschließlich -Diagnoseeingabe. Kein Produkt-Trust, Konto-/Service-SID-Beweis oder persistierter -Identitypin entsteht daraus. - -Höchstens eine tatsächliche Opnum6-Invocation; bei fehlender Discovery, -Stringprüfung oder Auth-/Arenafehler auch null. Der Zähler steht unmittelbar vor -dem echten generierten Methodenaufruf. Unveränderte Größen-/Statusprüfung und -64KiB-Arena, begrenztes numerisches EEInfo mit höchstens vier Records. Ursprung -der EEInfo wird numerisch zwischen Discovery, SetAuth und Status unterschieden. -Originale Fehlercodes werden vor jedem Cleanup erhalten. Principal wird auf -jedem vorhandenen Pfad mit RpcStringFreeW freigegeben, danach BindingFree; beide -Cleanupstatuses sind eigene Zahlen. Kein Probe-Retry. - -Neue Phasen25/26 kennzeichnen Discovery/Stringprüfung,91 eine enthaltene -Discoveryexception;90 bleibt eine Status-RPCexception. Ein Diagnose-Serviceexit0 -heißt ausschließlich Bericht geschrieben. `clock_qualified`, `adapter_qualified` -und `product_gate_open` bleiben stets false, auch wenn künftig ein Status käme. - -## Build und geplanter Zielablauf - -Der bekannte Offlinebuilder wird mit read-only Quellmount verwendet. Hülle und -Wrapper mit `-Wall -Wextra -Werror`; nur die drei unveränderten bekannten -MIDL-Stilwarnungen bleiben sichtbar. Keine Typ-/Securitywarnungsunterdrückung. -Nur bisherige ADVAPI32/KERNEL32/RPCRT4/msvcrt-Imports; kein neues SDK, Broker, -WMI- oder Produktfeature. Benötigte RpcMgmt-/GSS-/Tokenbindings wurden im -vorhandenen Builderheader tatsächlich gelesen, keine eigenen ABIdeklarationen. - -Der frühere lokale Pack153a1030 enthält den ersten vollständig gebauten Stand, -noch vor zusätzlichen strikten Reportkonsistenzchecks. Er bleibt historisch -erhalten und wird nicht für eine VM-Probe verwendet. Der finale separate Pack -ist nach diesen Checks erneut quellgebunden bereitgestellt. Keine native -Ausführung oder Produktqualifikation ist ein Ergebnis des Builders. - -Geplant, nicht ausgeführt: Rootreview, unveränderte vorherige Preservationzeugen, -einmaliges Prepare/Upload und genau ein Start über den vorhandenen geprüften -Bootstrapweg. Der Reader liest nur den ursprünglichen Case einschließlich des -vor RPC gespeicherten Tokenzeugen. Antwortverlust erlaubt nur Readback, keinen -erneuten Start. Cleanup ist eine getrennte explizite Phase ausschließlich für -den eigenen nachgewiesen gestoppten, exakt gebundenen Diagnosedienst; Dateien -und Originalbelege bleiben erhalten. Anschließend eigene Preservationprüfung -von RMM-/W32Time-Prozessen, Kontrollen, FileIDs/PKI/DB/Serverzustand. Keine -W32Timeänderung, kein RMM-Job und keine WebUI-Genehmigungsabkürzung. - -## Tatsächliche lokale Guards - -Die tatsächliche Reportprüffunktion akzeptierte ausdrücklich synthetische -SYSTEM-RPCfehler- und Discoveryfehler-ohne-Query-Belege und verweigerte15 -unabhängige Manipulationen von Aufrufzahl, Authstärke, Impersonation, Privileg- -Attributen, Tokenzeugen, Principal-/Parameterstrings, EEInfo-Ursprung und Gates. -Die tatsächliche extrahierte C-Principalprüffunktion wurde lokal mit leerem/ -fehlendem Namen, gepaarten/ungepaarten Surrogaten, C1-Steuerzeichen sowie exakt512 -und513Einheiten kompiliert und ausgeführt. Dies sind reine lokale Guards, -keine echten Token-/RPC-/Clock- oder VM-Ergebnisse. - -Der finale Pack liegt unter -`devstate/windows-clock-spnego-trace/build-2ebcfe9c-1e2b-4a50-99c5-3370640aeb77/`. -Manifest-SHA256 -`f6b5cd23b1599c2db4fc803fd7232dfd3522dead840e492f659e4efd7a6be001`; -PE99721Bytes, SHA256 -`ce11b0f0c400160b1580e8f68666530eaa324626a557a267ad684dc069cf2fba`. -Alle ursprünglichen131 und sieben früheren Diagnoseinputs bleiben unverändert. -Aktueller PowerShell-AST-Parser bestanden; EncodedCommand17122Zeichen. -Hülle/Wrapper ohne Warnungen unter `-Werror`; unveränderter Microsoftstub mit -genau den drei bekannten sichtbaren Stilwarnungen. Imports ausschließlich -ADVAPI32/KERNEL32/RPCRT4/msvcrt. Der tatsächliche PE-Importdump enthält keine -Token-/Privileg-/Uhränderungsimporte. - -Die aktuelle strengere Reportprüffunktion wurde anschließend erneut mit zwei -synthetischen gültigen Fehlerbelegen und **16** unabhängigen Manipulationen -ausgeführt, einschließlich einer Boolzahl statt numerischem Aufrufzähler. -Die tatsächliche extrahierte C-JSONformatierfunktion wurde lokal mit kleinem -Fehlerbericht und maximalen32Bit-Zahlen/vier EEInfo-Records kompiliert und -ausgeführt; beide Berichte waren gültiges JSON, höchstens2074Bytes. Sie ersetzt -keine native Windowsausführung. `local-guards.json` im finalen Pack kennzeichnet -`native_executed=false` und `target_called=false`. Kein Zielaufruf oder Gitaktion -durch diesen Subagenten; der Pack ist ausschließlich für Rootreview vorbereitet. - - -## Tatsächliche isolierte Windows-Probe - -Root hat den finalen Pack im separaten Fall -`0f512772-3599-4c83-b877-41c74fe50fb0` einmal gestartet. Das ursprüngliche -Resultat (SHA256 `4c99b34b8c64f877dbbf0fe860d59499f1c054de7d036016e80b84581448cfc9`) -wurde zusätzlich getrennt identisch zurückgelesen. Eigener gestoppter -Diagnosedienst anschließend explizit entfernt; kein Start/Stop an W32Time oder -RMM-Diensten und keine Privilegaktivierung. - -Tatsächlich: eigenes SYSTEM-Primarytoken ohne Threadtoken, Systemzeitprivileg -vorhanden, Attribute0, enabled0/default0/removed0. Genau eine Principaldiscovery -mit Status0 und nichtleerem Zeiger, aber **Stringlänge0**. Deshalb verweigerte -der eigene Nonempty-Guard mit123/Stage26; es gab **keine** Opnum6-Abfrage, -keinen Status, keine RPCexception und keinen EEInfo-Record.123 ist in diesem -Fall das eigene Guardergebnis, kein W32Time-Status und keine neue Bestätigung -der Ursache des vorherigen RPC5. - -Vorher-/Nachher-Erhaltung der tatsächlichen RMM-Prozessgeburten/Codehashes, -Dienste, FileIDs, PKI-/DBzeugen und des Serverzustands bestanden; Vorher-SHA256 -`c4704d1b1ce0bbb7f7e3c062274167fa2031e7a78652acfd535d31af725f720d`, -Nachher-SHA256 `e69960b20dd96e3c5c1b667ad1cc0a41fb0d0bb623e8d3f03fcf99398fc43f61`. -Windows0Jobs/Outbox/Grants/ungeklärt, Linux30/30/26/0; Clockgate bleibtfalse. - -Microsoft beschreibt die Principal-Syntax als SSP-abhängig und nennt -[Systemdienste ohne Principalnamen](https://learn.microsoft.com/en-us/windows/win32/rpc/principal-names). -Das beweist weder eine konkrete Workgroupkonfiguration noch eine RPC5-Ursache. -Die Discovery ist laut derselben Quelle kein sicherer Serveridentitätsnachweis. -Ein begrenzter separater Diagnosevergleich für den tatsächlich zurückgegebenen -leeren String wird vorbereitet; Originalfall und Quelle bleiben unverändert. diff --git a/docs/windows-clock-status-diagnostic.md b/docs/windows-clock-status-diagnostic.md deleted file mode 100644 index f0f194a..0000000 --- a/docs/windows-clock-status-diagnostic.md +++ /dev/null @@ -1,69 +0,0 @@ -# Numerische Windows-Zeitdienstdiagnose - -Stand2026-11-14: Diagnosequelle implementiert und unabhängig vom Produktions- -Clockpfad gebaut. Keine Lockerung von Statusguard, ALPC-/Identitätsprüfung, -`NativeClock.now()` oder `ADAPTER_QUALIFIED=false`. Keine neue Clockauthority. -Die feste zusätzliche Named-Pipe-Statusabfrage liefert ausschließlich acht -numerische Felder: Phase, tatsächliche RPC-Rückgabe samt Presenceflag, -aufgefangene Ausnahme und Strukturgrößen-/Zeigerpräsenz. Keine Quellen-/Peer- -Namen, Pointerwerte oder zusätzlichen Rückgabeeinträge werden veröffentlicht. -Eigener begrenzter Diagnoseworker; nach Timeout kein Ersatz/Retry. - -Lokal tatsächlich bestanden: Windows-Example-Clippy mit Warnungen als Fehler, -fünf Linux-Clocktests, Windows-Testlink (nicht nativ ausgeführt) und Release- -Link.125Quellinputs vorher/nachher identisch. Originale Werkzeugabweichung -(Buildimage ohne WIDL) privat erhalten; erfolgreicher Build mit vorhandenem -unveränderlichem Clockimage. Artefakt `ecad703ad7208d55681c63ba9513fcf4c73b671951d4d1b5db1af9df49f43bdf`, -1779541Bytes. Privater Build `release-ca9a63b8-127c-4933-a45d-9e82449d6980`, -Qualifikation `36ce552e…`. - -Danach tatsächlich auf der Windows-VM unter dem separaten LocalService- -Bootstrapdienst ausgeführt, Fall `2996df8c-b261-466a-8963-a526babf7f67`. -NativeReport und getrennter Readback identisch, eigener Dienst entfernt. -ALPC weiter1753/kein Endpunkt, keine erfolgreichen Identitätsnegativkontrollen. -Zusätzliche unabhängige Abfrage:1783, `stage=90`, `rpc_exception=1783`, -`native_rpc_return_present=0`, `status_present=0`. **Eine aufgefangene RPC-/ -NDR-Ausnahme vor normaler Stub-Rückkehr ist belegt; der eigene nachgelagerte -Strukturguard wurde nicht erreicht.** Das Nullwertfeld `native_rpc_return=0` -ist ohne Presenceflag ausdrücklich kein erfolgreicher nativer Return. - -Die genaue RPC-/NDR-Ursache bleibt offen. Source-/IDL-Prüfung folgt anhand -des [Microsoft-IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a). -W32Time wurde für diese Diagnose nicht umkonfiguriert, keine Uhr gesetzt und -kein RMM-Job ausgeführt. Zentrale Windows0/0/0/0 und Linux30/30/26/0 samt -geschlossenen Testhooks/Rootpolicy erhalten. Dieses Ergebnis qualifiziert -weder Named-Pipe-Serveridentität noch eine vertrauenswürdige Uhr. Erst recht -öffnet es keinen Grant-/Jobpfad. - -## Enger WIDL-Zeigervertrag: lokal korrigierter Kandidat - -Die erhaltene generierte WIDL7-Typbeschreibung kodiert den ursprünglichen -Status-Ausgabeparameter als `FC_RP→FC_RP→STATUS`. Der dokumentierte Vertrag -verlangt außen eine Referenz, innen den Unique-Statuspointer. Auch die neu aus -Microsofts vollständigem IDL erzeugte WIDL7-Datei zeigt den doppelten Ref: -Es handelt sich präziser um die rekursive Parameterattributbehandlung dieses -Compilers, nicht lediglich um eine andere Schreibweise unseres Narrow-IDL. -[Pointerregeln](https://learn.microsoft.com/en-us/windows/win32/rpc/three-pointer-types), -[Typformat](https://learn.microsoft.com/en-us/windows/win32/rpc/pointers-tfs), -[WIDL7-Compilerquelle](https://raw.githubusercontent.com/wine-mirror/wine/wine-7.0/tools/widl/typegen.c). - -Der enge Kandidat deklariert den inneren Typ ausdrücklich `[unique]` und lässt -das redundante äußere `[ref]` zugunsten des dokumentierten Parameterdefaults -weg. WIDL erzeugt tatsächlich `FC_RP→FC_UP→STATUS`; kein Stubbyte wurde gepatcht. -Ganze Procedureformatfolge/Opnum6 unverändert, alle19Statusfeldoffsets und120B- -Struktur gegen frisch erzeugte Microsoft-Full-IDL-Header per AMD64-Clangassert -geprüft. C/Auth/Statusguard/Clockgate unverändert. MicrosoftMIDL wurde mangels -nativer Werkzeuge ausdrücklich noch nicht ausgeführt. - -Neuer privater Buildfall `f5805176-4a5a-468d-b1b2-088030253c8d`, Qualifikation -`e96baaf6…`:63Compilerinputs vorher/nachher gleich, fünf Clocktests tatsächlich -bestanden, beide WindowsGNU-Alltargets-Clippyprofile, Release- und Unitlink -bestanden. Ein zunächst0Tests selektierender Aufruf und ein falscher lokaler -Harnesslink bleiben als unvollständige Vorgängerlogs erhalten. Neues Artefakt -`91889303e1650d8612b946512f069a3421eb686c7bed315426c48bd62b18a1fd`, -Original-Linkdatei erhalten. Nur `native/w32time.idl` geändert, SHA `37da4acb…`. - -**Native Prüfung dieses Kandidaten noch nicht ausgeführt.** Der tatsächliche -Auslöser der bisherigen1783-Ausnahme ist damit weiter nicht bewiesen. Kein -Clockvertrauen aus Codegenerierung oder lokalem Build, keine Rückstufung vom -unqualifizierten ALPC-Pfad auf eine nur vermeintlich authentisierte Pipe. diff --git a/docs/windows-clock-system-trace.md b/docs/windows-clock-system-trace.md deleted file mode 100644 index a2df8a8..0000000 --- a/docs/windows-clock-system-trace.md +++ /dev/null @@ -1,142 +0,0 @@ -# Getrennter SYSTEM-Vergleich für die W32Time-RPC-Diagnose - -Stand 2026-11-14: **implementiert und lokal gebaut, nicht auf der VM ausgeführt**. -Der User-/Orchestratorauftrag erlaubt hier ausschließlich einen neuen separaten -SID18-Diagnosedienst mit genau einem lesenden Traceaufruf. Bestehende Readiness, -RPC-/Clock-Produktquellen und sämtliche131 bisherigen Buildinputs bleiben -unverändert. Keine Produktgate-/Policy-/Konto-/NTP-/W32Time-ACLänderung. - -Ausgangsbefund ist der tatsächlich ausgeführte LocalService-MIDL-Diagnosefall -`94562d81-f75f-45c8-ab6b-28b70d12bd81`: Named Pipe meldete RPC5/Stage90 ohne -Status, ALPC weiterhin1753. Der Unterschied zu früher1783 ist kein positiver -Status-/Clocknachweis. Microsoft beschreibt unterschiedliche Netzwerkidentitäten -für [LocalService](https://learn.microsoft.com/en-us/windows/win32/services/localservice-account) -und [LocalSystem](https://learn.microsoft.com/en-us/windows/win32/services/localsystem-account). -Dies begründet den Vergleich, beweist aber keine konkrete Ursache. Auch ein -abweichendes SYSTEM-Ergebnis unterscheidet für sich weder SSPI-Credentials von -serverseitiger Token-/ACLautorisierung noch schließt es alle Harnessunterschiede -aus. Der ALPC-Endpunktbefund bleibt eine eigene offene Frage. - -## Enger neuer Quellschnitt - -Nur neue Dateien unter `deploy/windows/clock-system-trace/`: - -- `system_trace.c`: eigenständige einmalige SCM-Servicehülle - `RmmClockSystemDiagnostic`; prüft den tatsächlichen eigenen Prozesstoken mit - `OpenProcessToken`/`GetTokenInformation`/`IsWellKnownSid` auf SYSTEM und ruft - danach exakt einmal `rmm_clock_query_trace` auf. Kein Tokenwechsel und keine - Impersonation. Numerische RPC-/Tracefelder, feste Booleans und Fall-ID; - Ausgabedatei create-only, begrenzt und dauerhaft geflusht. -- `build.py`: eigenständiger Offline-C-Build mit originalem `clock_rpc.c` und - exakt denselben tatsächlich von Microsoft-MIDL erzeugten Header-/Stubbytes - aus Fall `149bafe2-3469-4580-b133-988812bcc3db`. Keine NDR-/Headerbearbeitung, - kein WIDL-Fallback und kein Patch im alten Build-/OUT_DIR. -- `native.py`: Root-Orchestrator mit getrennten expliziten Phasen `prepare`, - `start`, `readback`, `cleanup`. Vor Start dauerhaftes einmaliges Intent; - verlorener Reply erlaubt nur ursprüngliches Readback. Remote-Readback liest - ausschließlich, ändert weder ACLs noch Servicezustand und bereinigt nichts. - Cleanup darf ausschließlich den eindeutig gebundenen **gestoppten eigenen** - Diagnosedienst löschen. Alle Dateien/Originalbelege bleiben erhalten. - -Die vorhandene ReadinessEXE verweigert SYSTEM weiterhin absichtlich; sie wird -weder verändert noch als Launcher eingesetzt. C-Wrapper, Named-Pipe-Endpunkt, -WINNT/PacketPrivacy und QoS bleiben identisch zur bisherigen Diagnose. Das -Programm bewertet keinen Clockstatus und setzt `clock_qualified=false`, -`adapter_qualified=false`, `product_gate_open=false` auch bei RPC0. - -## Tatsächlich lokale Prüfungen - -```text -python3 deploy/windows/clock-system-trace/build.py -``` - -Gepinntes Image `sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9`, -Netzwerk deaktiviert, Quellsnapshot nur lesbar, eigenes Ausgabe-/Belegverzeichnis. -Neue C-Hülle und unveränderter Wrapper bestanden Clang `-Wall -Wextra -Werror`. -Für den unveränderten generierten MIDL-Stub bleiben nur dieselben drei bekannten -Stilwarnungen sichtbar: fehlende Initialisierungsbrace und zwei unbenutzte -Konstanten; keine Typ-/Securitywarnung wurde abgeschaltet. MinGW-GCC-Link, -PE-x64-/Größen-/Importprüfung und tatsächlicher PowerShell-AST-Lauf bestanden. -Der fertige EncodedCommand umfasst16666Zeichen und liegt unter32767. - -Aktueller Manifest: -`devstate/windows-clock-system-trace/build-8b5fc22c-3dbe-4924-a431-9e889d6a4b7c/manifest.json`, -SHA256 `3b2c397eec9f3aa4a1e82ba10f2812f986c9b7e69e235c8f105ebaec221eaf5e`. -Standalone-PE98028Bytes, SHA256 -`0035fee43333b7cb8d34e70b9c53b31dae49e4793abb0f1e00271572c75b7922`. -Beobachtete Imports ausschließlich `ADVAPI32.dll`, `KERNEL32.dll`, `RPCRT4.dll`, -`msvcrt.dll`. `kernel32` wird vor `mincore` aufgelöst; dieser C-Trace benötigt -keine zusätzlichen präzisen Zeit-APIimporte der Rust-Readinesshülle. -Das sind Builddaten, noch kein nativer Loader-/RPCbeleg. - -Erhaltene frühere lokale Fälle werden nicht umgeschrieben: `58611089…` -scheiterte am Clang-Linkerpfad zu GCC-Runtimearchiven; `b900df4d…` wurde wegen -zusätzlicher aus `mincore` aufgelöster API-Set-Imports verweigert; der zunächst -fertig gebaute Pack `4d49b432…` scheiterte im nachfolgenden privaten -Manifestguard am Docker-root-eigenen Linkartefakt. Der neue Pack erhält nun -zusätzlich eine bytegleiche, vom Aufrufer besessene private Originalkopie. -Keine dieser Korrekturen verändert C/Auth/MIDL oder bestehende Produktdateien. - -Sechs manipulierte Berichtsfälle, nur numerische Ausgabe, historischer Bericht -nach gebundenem Cleanup und Readback ohne Upload/Start/Cleanup wurden lokal -mit ausdrücklich **simulierten** Transport-/Reportdaten geprüft. -`local-guards.json` beim aktuellen Manifest kennzeichnet `simulated_reports_only`, -`ssh_executed=false`, `native_executed=false`. Das ist keine simuliert als echt -ausgegebene SYSTEM-/RPC-/VM-Abnahme. Original131 und sämtliche neuen Inputs -wurden vor/nach dem Build unverändert gehasht. - -## Ursprünglich geplante Root-Ausführung - -Nur der Orchestrator benutzt den vorhandenen bestätigten Zugang zur festgelegten -Windows-Test-VM. Zugang bleibt in den privaten `credentials/` des Maincheckouts; -keine VM-Adresse oder Transportpräfixe in diesem Beleg. Der Notebook-Host -führt keinen Agenten und keinen Diagnosedienst aus. - -Zuerst `native.py prepare --manifest --access-root ---execute-native`: neuer privater Remote-Scratchfall und create-once Upload; -der Dienst startet dabei noch nicht. Anschließend `start` mit genau dieser -`--id` und `--execute-native`: eigener LocalSystem-Dienst wird einmal angelegt -und gestartet. Ein Create-once-Marker steht vor jeder möglichen Wirkung. - -`readback --id ` braucht **kein** `--execute-native` und -liest ausschließlich denselben Fall. Bei fehlendem/unklarem Ergebnis kein -neuer Start und kein erneuter Upload. Der tatsächliche numerische RPCcode -kann auch bei vollständig ausgeführter Diagnose ein Fehler sein; das ist -kein bestandener Status-/Clockbeleg. - -Erst danach gesondertes `cleanup --id --execute-native`. -Es verweigert fremde Binär-/Intent-/Servicekonfiguration, laufenden Dienst -oder wiederholte unklare Löschung. Bei Antwortverlust nur Readback. -Keine automatische Bereinigung im Leseweg, kein Stop fremder Dienste, -kein impliziter Reboot, kein Gatewechsel und kein RMM-Auftrag. - -## Tatsächlicher SYSTEM-Vergleich und getrennter Abschluss - -Root führte nach Source-/Manifest-/PowerShell-Parserprüfung den aktuellen -Pack8b5fc22c auf der Windows-Test-VM aus. Eigener Fall -`562ff9de-67ff-48a1-96f0-c2474b3b0777`: erst create-only Vorbereitung/Upload, -danach einmaliger eigener Dienststart. Das C-Programm bestätigte seinen -tatsächlichen SYSTEM-Token und führte genau einen Status-Traceaufruf aus. - -Tatsächliches Ergebnis: **RPC5, Stage90**, `rpc_exception=5`, kein normaler -nativer Return, kein Status. Der Dienst stoppte mit Exitcode0; dieser bestätigt -ausschließlich den abgeschlossenen Diagnosebericht, keinen erfolgreichen RPC. -Originalbericht danach im selben Fall separat rein lesend identisch bestätigt. -`diagnostic-result.json`-SHA256: -`5d8475f70a9cd6ef8713edb0264fa0d560499fa6abb6f5483e47b2332a4e6ca5`. - -Der Vergleich löst die Verweigerung durch den Callerwechsel nicht auf. Die -Erklärung allein durch LocalService ist damit nicht belegt. Ob SSPI, NPFS, -Serverautorisierung oder eine andere RPCschicht5 erzeugt, bleibt offen. Keine -beobachtete tatsächliche serverseitige Caller-/Service-SID und kein -Serveridentitäts- oder TrustedClock-Nachweis. - -Anschließend wurde ausschließlich der eigene exakt gebundene gestoppte Dienst -mit dem separaten Cleanupaufruf entfernt. Kein Stop eines bestehenden Diensts, -keine W32Time-ACL-/NTP-/Kontoänderung. Vorher/Nachher-RMM-/Serverabgleich -bestätigt dieselben PIDs/Prozessgeburten, Code-/Policydateien, PKI-/DB-/Lock- -Datei-IDs, Helperwitness und geschlossene Zähler/Flags. NachherbelegSHA256: -`65a9e98b6933a5c5f45acd8e6edcca837eaf28a7aeab0e8637ade8b09bf6c18c`. -Produktclock, Capabilities und Jobs bleiben gesperrt. Der nächste getrennte -Diagnosevorschlag erfasst ausschließlich begrenzte numerische RPC-EEInfo direkt -am Fehler; keine schwächere Authentisierung, Impersonation oder ACLänderung. diff --git a/docs/windows-closed-control-online-continuation.md b/docs/windows-closed-control-online-continuation.md deleted file mode 100644 index 42db877..0000000 --- a/docs/windows-closed-control-online-continuation.md +++ /dev/null @@ -1,100 +0,0 @@ -# S2-Fehlerkorrektur: frischer normaler Abgleich nach fehlendem Helper-ACK - -16. November 2026. Notwendiger technischer Folgeschritt des beauftragten -S0–S2-Abschlusses. **Kein neuer administrativer Fall 308, kein Replay alter -Applyantworten und keine zusätzliche Jobgenehmigung.** Die administrativen -Ausnahmen 150/205/221 aus Kapitel0 bleiben unverändert begrenzt. -Die gezielte Prüfung mit tatsächlichen Originalzeilen ist zuerst auf -Cloud-Linux und danach auf Windows bestanden. Bereitstellung der korrigierten -Runtime und SYSTEM-Ausführung stehen noch aus. -[Tatsächliche begrenzte Regression](evidence/windows-closed-control-contract.json). - -## Tatsächlicher neuer Befund - -Fall221 ist lokal und zentral als nicht gestarteter Fehler abgeschlossen. -Nach dem zunächst erfolgreichen normalen Abgleich trat eine weitere reine -Kontrolldifferenz auf. Agentcheckpoint10999 trägt Entscheidung7ea5dbda…, -der Helper bleibt bei Entscheidung7245d5c4…/Agentcheckpoint10995; sein -Capturecheckpoint ist inzwischen436 statt422. Alle vier bestehenden Jobs sind -terminal; es wurde kein neuer Auftrag oder Grant erzeugt. -[Native reine Leseergebnisse](evidence/windows-system-s2-control-gap.json). - -Der tatsächliche Helperfehler um20:32:35UTC lautet TIME_STALE_RESPONSE. -Die Quellenreihenfolge belegt den Fehler vor dem ersten SQLite-BEGIN: -Der Handler wartet zunächst auf frische eigene Zeit; danach prüft der Core -erneut die Ledgerdateien und liest erst dann die Uhr. Dazwischen kann die -unveränderte100-ms-Frischegrenze überschritten werden. Die Agentphase war -bereits dauerhaft gespeichert, die Helperphase noch nicht. Der nächste -Clientrequest scheitert anschließend an identischen letzten Kontrollheads. -Eine vorübergehend fehlende Zeitqualität wird dadurch zur dauerhaften Sperre. - -Die alte Antwort darf weder nach Fristablauf noch gegen einen inzwischen -anderen Capturecheckpoint angewandt werden. Neues Enrollen, Journaländerung, -Löschen eines Faults oder ein Dienstneustart allein beheben diese Ursache nicht. - -## Engste normale Fortsetzung - -Der bestehende Server prüft die Agent- und Helpervorentscheidungen bereits -getrennt. Deshalb genügt eine engere Zulässigkeitsprüfung im Client für einen -**neuen** regulären Request. Der bisherige Gleichheitsfall bleibt unverändert. -Bei unterschiedlichen Heads sind zusätzlich sämtliche folgenden Belege nötig: - -1. Genau eine partielle Kontrollkante aus vollständigem kanonischem - Originalrequest, Envelope, signierter Antwort und byteidentischem lokalem - Consumption-ACK. Keine bloßen UUID-Vergleiche oder unbestätigten Behauptungen. -2. Agentmetadaten entsprechen genau dieser gespeicherten Antwort. Deren - Originalrequest verweist sowohl beim Agentvorgänger als auch beim - Helpervorgänger auf den tatsächlich gemeldeten Helperhead. Dieser Vorgänger - ist selbst aus gültiger angewandter Historie und Signaturen nachzuweisen. -3. Aktuelle Identität/Bindung/Boot und Journalidentitäten stimmen, Checkpoints - sind monoton. Alle aktuellen Wirkungen sind vollständig terminal und - effektive Resultbytes stimmen überein. Historisches221-Unknown ist nur mit - seiner gültigen signierten zusätzlichen Resolution abgeschlossen. - Keine offenen/ungeklärten Verbräuche, Updates oder aktiven Ereignisse. -4. Keine alte Apply-/Executearbeit ist noch unterwegs. Die vorhandene - kontrollierte Clientlane und serialisierte Helperaufnahme müssen greifen; - zusätzliche Runtimezustände dürfen keine neue Vorbereitung überlappen. -5. Die Beweisprüfung verändert keine Zeile, keinen Fault, ACK oder Head. - Alte Signaturen werden ausschließlich als historische Authentizität geprüft, - niemals als gegenwärtige Lease. Nur ein neuer Request wird erlaubt. - -Die Serverantwort darauf hat aktuelle Bindung und Fristen. Beide Rollen prüfen -ihre eigene aktuelle Uhr und die neue Signatur. Bereitschaft entsteht weiterhin -erst nach neuer Helperanwendung und exakt bestätigtem neuem ACK. Es wird keine -alte Antwort nachträglich übernommen, kein alter Grant erneut verwendet und -keine historische Uhr an eine aktuelle Applyfunktion übergeben. - -## Dieselbe Fehlkante vor dem Commit abfangen - -Nur der belegte erste Core-Uhrfehler vor jeglicher SQLiteänderung wird typisiert. -Der Helper darf ausschließlich einen dafür freigegebenen flüchtigen Uhrfehler -innerhalb derselben authentisierten Applyanfrage erneut prüfen: identische -Request-/Antwort-/Capturebytes, insgesamt begrenzt und innerhalb der -ursprünglichen Antwortfrist. Keine neue Uhrgrenze, kein neuer Capture, kein -Execute-/Installer-/Skriptretry. Signatur-, Bindungs-, Speicher-, Nachcommit- -oder unklare Fehler bleiben gesperrt und werden nicht wiederholt. - -## Tatsächlicher Prüfstand und verbleibende Ausführung - -Ein gemeinsamer isolierter Speichertest bestand tatsächlich auf Cloud-Linux -als UID65534 mit separatem Netzwerkraum/NoNewPrivileges und danach auf Windows. -Die echte geschlossene Teilkante wurde akzeptiert; veränderter Request, -Serversignatur/ACK, verborgener offener Grant und fehlender Idle-Nachweis wurden -abgewiesen. Typisierter Precommit-Uhrfehler: keine SQL-Zeile geändert, Capture -erhalten; falsche Generation/Signatur erzeugen keine Retrybefugnis. Alte -Antworten erzeugten keine Bereitschaft und wurden nicht als aktuelle angewandt. -Private Originalfixture2982523Byte/SHA857a207a… bleibt außerhalb von Git. - -Der zusätzliche Runtimehunk betrifft nur die Idlebestätigung für die neue -Fortsetzung: Der gewöhnliche Gleichhead-Abgleich bleibt auch während regulärer -Arbeit unverändert. Offene persistente SYSTEM-Intents verhindern die -Fortsetzung; eine fehlende Intentdatei ist bei nichtleerer Helperhistorie kein -Idlebeleg. Lokaler Updater-WIP wurde nicht übernommen. - -Noch auszuführen: - -- Ein gemeinsamer Quellenstand und ein Paarwechsel mit erhaltenen Originalen; - kein weiteres Paket allgemeiner Updater-/Lifecyclefunktionen. -- Danach tatsächlicher neuer regulärer Abgleich beider Rollen, frische - Skriptqualifikation, eigener MCP-Antrag und tatsächliche WebUI-Genehmigung - für den ersten erfolgreichen SYSTEM-Auftrag. diff --git a/docs/windows-console-boot.md b/docs/windows-console-boot.md deleted file mode 100644 index e3bcbc2..0000000 --- a/docs/windows-console-boot.md +++ /dev/null @@ -1,47 +0,0 @@ -# Manueller Windows-Konsolenneustart — tatsächlicher Nachbeleg - -Der Benutzer stimmte das konkrete ruhige Zeitfenster ab, startete die VM über -die Konsole selbst und meldete anschließend „Neustart ist durch“. Kein -Remote-Reboot, kein RMM-Rebootjob und kein Produktionsfreigabenachweis. - -Nur lesender SSH-Nachbeleg unter unverändert geprüftem Hostschlüssel, -Fall `d888645b-b403-47b5-b45e-89a2ef03bd02`, beobachtet -2026-11-14T12:27:45.5207910Z: - -- Tatsächlicher Boot2026-11-14T12:26:50.5000000Z. -- Agent89004ad3… Running/Auto/LocalService, PID3172; Image unverändert. -- Helpere6aacbdd… Stopped/Manual/LocalSystem; Image unverändert. -- W32Time Stopped/Manual/LocalService. Kein erneuter Start in diesem Schritt. -- Windows-Update-Neustartmarkerfalse; CBS-Neustartmarker weiterhintrue. - -Privater BerichtSHA256 -`ab4a99b7cfc1d2f48de9ede45357b7c43d9df7b5f398fb5906009921bd327af9`. -Das beweist den erfolgten Boot und die beobachteten Dienst-/Markerzustände, -keine vollständige PKI-/Datenbankerhaltung oder neue Runtimeabnahme. Die -MSVC-Installation bleibt bei vorhandenem CBS-Marker gesperrt; keine Marker -entfernen oder Installation erzwingen. Die genaue Ursache bleibt offen. - - -## Bereits autorisierter Zeitdienst nach diesem Boot - -Eigener neuer Fall `203ce31a-e81e-4a38-af34-a9f1f08e5dc0`: W32Time einmal -gezielt gestartet und getrennt nur lesend Running nachgewiesen. Der erste -historische Startfall und dessen globaler Einmalmarker bleiben unverändert. -Die neue Admission ist fest an den tatsächlich bestätigten Boot gebunden; -kein allgemeiner Autostart oder Retry. AgentPID3172 Running und HelperStopped -bleiben erhalten; ursprüngliche Image-/Konfigurations-/PKI-Metadaten und -Dienstdefinitionen einschließlich Startarten/ACLs/SIDtyp sowie ausgewählte -stabile NTP-/GPO-Werte unverändert. Schlüsselinhalt wurde nicht gelesen. -Zentralzähler und geschlossene Testflags vor/nach Start und Readback identisch. -Normale Zeitsynchronisierung war durch die bestehende Userfreigabe erlaubt. - -Neue Quelle `deploy/windows/time_service_after_boot.py`, SHA256 -`7e533bc8624ac7c779812a3f0dde0a25d619bc7553681c1639c48b34cb2c842c`, -abgeleitet aus unveränderter ursprünglicher Quelleef5d4ce8…; enge vier -Substitutionen, Python-/PowerShell-AST und unabhängiger Quellreview bestanden. -Neuer Einmalmarker statt Reset des alten. Verlust einer Startantwort erlaubt -ausschließlich Readback desselben Falls. ErgebnisSHA256 -`badcc32035686f63b1aacf4183b53a802ee93a0a613f7ac89e40dee2de13d3ae`; -separater Readback bestätigt exakt den Originalbericht und denselben Nachzustand. -Dies qualifiziert keine vertrauenswürdige Uhr: Clockgate unverändertfalse, -keine RMM-Jobs, kein Helper-/Fixturestart, keine Änderung an NTP oder Startarten. diff --git a/docs/windows-dev-access-recovery.md b/docs/windows-dev-access-recovery.md deleted file mode 100644 index f47680a..0000000 --- a/docs/windows-dev-access-recovery.md +++ /dev/null @@ -1,340 +0,0 @@ -# Windows-Entwicklungszugang: Ablauf und vorbereitete Konsolenwiederherstellung - -Stand: 2026-11-14. Der bisherige SSH-Entwicklungszugang lief am -**2026-11-14T12:55:31.254999+00:00** ab. Die vorher vorbereitete automatische -Verlängerung wurde **nicht betreten**: kein Server- oder Windows-Enter, keine -Ablaufzeitänderung und kein angelegter Renewalworker. Die drei fehlgeschlagenen -Vorbereitungen und ihre Quellen bleiben historische Belege. - -**Aktueller Stand:** Die spätere User-Konsolenwiederherstellung wurde -erfolgreich ausgeführt; Root bestätigte anschließend die tatsächliche Rückkehr -des gepinnten SSH-Zugangs. Auch der getrennte vollständige Key-/Task- -Erhaltungsabgleich und der lokale Accessmetadaten-CAS sind inzwischen bestanden. -Einzelheiten stehen im neuen Abschlussabschnitt dieser Verlaufserfassung. - -Diese Entwicklungshilfe ist SSH-Bootstrap, keine RMM-Aktion und kein Ersatz für -Geräte-mTLS, Tenantgrenzen, TrustedClock, signierte Grants oder die -WebUI-Genehmigung. Das Notebook bleibt ausschließlich Entwicklungsrechner. - -## Tatsächliche abgebrochene Vorbereitungen - -| Fall unter `devstate/windows-client/dev-access-renewal/` | Tatsächliches Ergebnis | -| --- | --- | -| `45626a0c-edc4-4f35-9f36-921692bccbc1` | Rein lesende Windows-Vorbereitung verweigerte `Transport owner` vor dem Serveraufruf. Die zwei öffentlichen `.pub`-Dateien gehörten dem tatsächlichen lokalen Builtin-Administrator mit SID-Endung `-500`; deren bestehende öffentlichen Leserechte waren für die ursprüngliche private Dateiprüfung zu weit. Nur die separate öffentliche Metadatenprüfung wurde später präzisiert; keine ACL-Reparatur. | -| `d40c06a4-d6d3-4dc0-9ef6-b1ef1197bcc9` | Rein lesende Windows-Vorbereitung verweigerte `VariableNotWritable`: die Hilfsvariable `$host` kollidierte mit PowerShells schreibgeschütztem `$Host`. Die Quelle wurde anschließend auf `$hostPublic` korrigiert. Keine Server- oder Windowsmutation. | -| `6988fd11-0e0a-4fd7-878d-96b130d83aee` | Der lokale Datums-/Fristguard verweigerte nach Ablauf der alten Frist, noch vor `prepare-intent.json`. Dies war kein weiterer ausgeführter Windows-Readonly-Test. Der leere lokale Fall bleibt erhalten. | - -Die ersten beiden Fälle enthalten nur Vorbereitungsintent und Controllerkopie; -keiner enthält einen Server-/Windows-Enterintent. Root bestätigte zusätzlich, -dass kein Renewal-Enter und kein Worker ausgeführt wurden. Ablauf und Fehler -werden nicht nachträglich als erfolgreiche Verlängerung ausgegeben. - -## Getrennte Wiederherstellung des bereits abgelaufenen Zugangs - -Die neue Quelle -[`console_access_recovery.py`](../deploy/windows/console_access_recovery.py) -hat SHA-256 -`703fb5e4ae04d8555bad858c5d7b2ac4880e06d6fa951010acd43f7201a58053`. -Sie trennt den Server-CAS von der erst anschließend durch den User in der -Windows-Administratorkonsole auszuführenden Phase. Die frühere -[`dev_access_renewal.py`](../deploy/windows/dev_access_renewal.py) wird für den -abgelaufenen Lease nicht umgedeutet oder erneut gestartet. - -Root führte ausschließlich den Serverteil im neuen Fall -`4b6506a7-6c3e-4cca-a497-618fa8666300` aus. Dessen `server-entered.json` -meldet `completed=true`; ein getrennt gespeicherter lesender Readback bestätigt -dieselbe neue Autorisierungsdatei und Frist: - -| Bindung | Tatsächlicher Beleg | -| --- | --- | -| Neue feste UTC-Frist | `2026-11-15T13:05:58+00:00` | -| `authorized_keys` nach CAS | `fef4db300dd39fba9b52428817f453451c251c7768dd2fb6a76b39dd110dbbf2` | -| Unverändertes SSH-Profil | `932adc2ad3e88c3a47054c3d09e44024f21918cf144f0bb349bd8763e844e482` | -| Unveränderte effektive SSH-Konfiguration | `3a345912fdd4bb9bb29628d670a8bdbdfbbc22b3e308ab56fb3bafb7bc15533a` | -| Server-Enterbeleg | SHA `2185a88fc32db72119a584d84a46fb25cfca5f32f6e0c4ee5b7cf0728a361317` | -| Getrennter Readback | SHA `f6e3f69a6cd4f006d00c90cadd8bfd47f94e954f1297bea5f6eecc4fd27d3787` | - -Der Serverteil ersetzte ausschließlich den Ablaufwert des gleichen bestehenden -restriktiven Tunnelkeys. Keybytes und Optionen, Loopbacklistener -`127.0.0.1:22240`, SSH-Profil, Serverhostpin und der Account -`rmm-win-tunnel` mit Shell `/usr/sbin/nologin` blieben gebunden. Historische -`prepared.json`/`registered.json` wurden nicht überschrieben. Dieser CAS -veränderte weder einen Downloadlease noch die RMM-Konfiguration. - -## Öffentliches Paket und noch offene Userphase - -Unter dem privaten Consolefall liegt das **inzwischen zurückgezogene, -historisch erhaltene** öffentliche Paket mit genau -`Recover-ExistingDevAccess.ps1`, `public-recovery.json` und `README.txt`. -Es enthält öffentliche Pins und feste Parameter, keine privaten Schlüssel oder -Tokens. Die Paketdateien sind zusätzlich im unveränderlichen Intent gebunden. - -| Datei | SHA-256 | -| --- | --- | -| `windows-dev-access-recovery.zip` | `7bf4f7bb8336fb50852f72eec2f3e370e96cb7009b14ee15aa7232c025a38ed7` | -| `Recover-ExistingDevAccess.ps1` | `564da57d70ef06df7bd9adc37565b7e28ef446a6c69b984711c5b77b28441e8a` | -| Consoleintent | `cd827d4056fb0045f23bff1fd9bd21b6137b53f063fe8215ad0945c2013cc44a` | - -Vor der Userausführung fand Root im Konsolenguard eine unbelegte -Ganzsekundenannahme für den alten `AccountExpires`-Wert. Der feste Wert -`134391345310000000` ließ den Bruchteil `.254999` der ursprünglichen -Konfigurationszeit weg. Ein lokaler .NET-Roundtrip derselben vollständigen -UTC-Zeit ergibt `134391345312549990`. Dieser lokale Roundtrip allein war ein -**abgeleiteter Sollwert**, noch kein gemessener Windows-VM-Accountwert. Der -spätere tatsächliche Userreadback ist unten getrennt dokumentiert. Das alte Paket wird deshalb nicht zur -Ausführung weitergegeben; sein gültiger getrennter Server-CAS bleibt erhalten. - -Die kleine neue Quelle -[`console_access_precision.py`](../deploy/windows/console_access_precision.py) -mit SHA -`8b4d14edf0794c4ef662d7587b4538f8e7aebc06c11db76c3cafc2c24c11a37b` -erzeugte den neuen lokalen Consolefall -`5c96d3d8-1657-40c8-a6ec-c00b63a98210`. Sie bindet den ursprünglichen -Serverintent, Enterbeleg und getrennten Readback des Falls `4b6506…` sowie -sämtliche alten Paketdateihashes. Es gibt weder einen Serveraufruf noch eine -erneute Fristverlängerung: `2026-11-15T13:05:58+00:00` bleibt unverändert. - -Der neue Guard berechnet genau einen erwarteten 64-Bit-Wert über -`[DateTimeOffset]::Parse($cfg.expires_at).UtcDateTime.ToFileTimeUtc()` aus der -zuvor anhand der Originalbytes und der exakten alten Zeit geprüften Config. -Keine Rundung, Toleranz oder alternative Zeit wird akzeptiert. UUID und -Provenienzbeleg sind neu; die drei Mutationsschritte ab `File.Replace` bis -zum Ende sind gegenüber dem alten Paket bytegleich. Falls ein früheres Paket -entgegen dem bisherigen Kontrollstand bereits erfolgreich ausgeführt wurde, -muss der alte Config-Hashguard verweigern. Dann nur lesen und durch Root -abgleichen, kein neuer Versuch. - -| Neues Korrekturartefakt | SHA-256 | -| --- | --- | -| ZIP im Fall `5c96d3d8…` | `dbcd5ca863c0b09f89b67eb10eeaeaf89b941bbc5840079f1bb0c36dc6ff3b3e` | -| Neues `Recover-ExistingDevAccess.ps1` | `4977665fb092723998473f1c4be6685b1d93975176f8957bc3287d7e2f61cb69` | -| Neuer unveränderlicher Intent | `eae7995b5735bf1e8f0fafc0ae6ccf6bdd4576566663c1256a511f6c3408e32e` | - -Die Userphase mit dem Konsolenskript des Falls `5c96…` wurde inzwischen begonnen, -scheiterte aber vor jeder Wirkung an `Get-History / IdCannotConvert`: PowerShells -standardmäßiger Alias `h` wird auch unter `-NoProfile` vor der Funktion `H` -aufgelöst. Der Fehler trat im ersten Case-/Configguard vor `New-Item` auf. -Es wurde damit keine Konfigurations-/Accountablaufzeit geändert und kein -Tunneltask gestartet. Die unveränderte Case-Abwesenheitsprüfung bleibt für die -erste tatsächlich noch unerreichte Wirkung verbindlich. - -Die separate lokale Quelle -[`console_access_hash_command.py`](../deploy/windows/console_access_hash_command.py) -hat SHA `b682ced57bf7ac71c0b1ba67eb5a51a20dde814fe361e1ae2cc17872147444ad`. -Sie erzeugt `Recover-ExistingDevAccess-HashFix.ps1` mit SHA -`d366ae1705dac3252726dedf369c04462e42534ddcf6e15dc27bba8583427d2c`. -Ausschließlich die eine Funktionsdefinition und alle fünf Aufrufe heißen nun -`Get-RmmRecoveryFileSha256`; eine inverse Ersetzung ergibt exakt die alten -PS1-Bytes. Alle übrigen Guards, Pins, Fristen, die gleiche Console-UUID und -Mutationsschritte bleiben erhalten. Kein Alias wird entfernt oder geändert. - -Der kleine Userpatch `Create-VerifiedHashFix.ps1` mit SHA -`385a388476cef0c85f02bca236ade48f28a041476330d3e309ab1ca2f22bb9f5` -prüft zuerst den ursprünglichen PS1-Hash `4977665f…`, erzeugt ausschließlich -eine zuvor fehlende neue Datei mit UTF-8 ohne BOM, verlangt deren vollständigen -Hash `d366ae17…` und startet erst dann den separaten Bootstrapprozess mit -`-NoProfile -ExecutionPolicy RemoteSigned`. Kein neuer Download ist für diese -lokale Korrektur erforderlich. Bereits vorhandene Korrekturdateien werden -nicht überschrieben und eine unklare frühere Wirkung wird nicht wiederholt. - -ASTs, vollständige Command-AST-Ersetzung sowie ein tatsächlicher lokaler -Hashfunktionsaufruf bei unverändert vorhandenem Alias `h=Get-History` bestanden; -der unabhängige Review bestätigte die reine Namensänderung. Das sind lokale -PowerShellprüfungen, kein weiterer Windows-VM-Erfolgsnachweis. Alte Quellen, -ZIPs und Fehlerbelege bleiben unverändert. - -Die anschließende tatsächliche Userausführung des HashFix-Skripts `d366ae17…` -verweigerte im kombinierten anfänglichen Case-/Config-/Bootstrapguard weiterhin -vor Wirkung. Root ließ zunächst ausschließlich fünf Werte lesend ausgeben. -Der Userreadback ergab: - -| Tatsächlicher Konsolenwert | Ergebnis | -| --- | --- | -| Recoverycase vorhanden | `false` | -| Config-SHA | `4ad28ec55027718a4e384c79ff7cc15ec9c798411a991a5d479e960310ed6823` | -| Bootstrap-SHA | `332ceeedf49f597eac353e0ef1f6e614c85cef20a5a20cce68d947085aa9d50f` | -| Configablaufzeit | `2026-11-14T12:55:31.254999+00:00` | -| Tatsächliches Account-FILETIME | `134391345312549990` | - -Damit ist dieser Guardfehler konkret erklärt: die Recoveryquelle erwartete -den späteren Repositoryhash `9e992602…`, obwohl die VM exakt das ursprünglich -veröffentlichte Bootstrap mit Hash `332ceeed…` behielt. Das erhaltene Original-ZIP -`cba15946…` enthält genau diese Datei und die Config `4ad28ec5…`; das ebenfalls -veröffentlichte Reparaturpaket `2558448b…` bindet denselben Bootstraphash als -Voraussetzung und ersetzt Bootstrap/Config nicht. Der Maintainerteil beider -Bootstrapquellen ist bytegleich. Es wird somit keine unbekannte Datei anhand -eines beliebigen neuen Readbacks übernommen. - -Die getrennte lokale Quelle -[`console_access_original_bootstrap.py`](../deploy/windows/console_access_original_bootstrap.py) -mit SHA `c0816055407c17af4c0bf4b5bd5ce3055e5a9d44fe7f2334f5aa7913520478c6` -bindet den tatsächlichen Userreadback und beide publizierten Originalpakete. -Sie erzeugt `Recover-ExistingDevAccess-OriginalBootstrap.ps1` mit SHA -`aba0a5a4152347e639266e95a05eae4343a99be9070a94fa4fc6501bfc3283d2`. -Ausschließlich die eine Bootstrap-Sollhashkonstante wird von `9e992602…` auf -das bestätigte Original `332ceeed…` berichtigt. Alle anderen Bytes des -`d366ae17…`-Skripts, einschließlich gleicher Case-Abwesenheit, voller UTC- -Präzision, Aliasfix, Fristen und Wirkungsschritte, bleiben identisch. - -Der Userpatch `Create-VerifiedOriginalBootstrapFix.ps1` hat SHA -`64f1d62ea3a87d4db7103ca01f7d735689caf54a7cc4b2458908956624062549`. -Er verlangt den vollständigen Eingabehash `d366ae17…`, schreibt nur eine -zuvor fehlende neue Datei, prüft deren vollständigen Hash `aba0a5a4…` und -startet erst danach den separaten Bootstrapprozess. Lokaler Python-/AST-Test, -ein tatsächlicher lokaler PowerShelllauf des Patchpräfixes ohne Kindstart und -der unabhängige byteweise Review bestanden. Dadurch wird die Userausführung -der korrigierten Wirkung noch nicht vorweggenommen. Kein Serveraufruf und keine -weitere Serverfriständerung wurden durch diese lokale Korrektur ausgeführt. - -Eine erfolgreiche Windows-Konsolenphase und Tunnelwiederkehr sind **noch nicht -nachgewiesen**. Die korrigierte Strecke prüft die alten -Config-/Bootstrapbytes und öffentlichen Pins, den bestehenden Account sowie den -unveränderten SYSTEM-Tunneltask. Erst bei `Ready` und ohne verbliebenen -Maintainer/SSH-Kindprozess darf sie die vorhandene Konfigurations- und -Accountablaufzeit erneuern und den Originaltask mit dauerhaftem Startintent -**einmal** starten. Private Keydateien werden nur über Metadaten beobachtet, -nicht inhaltlich gelesen. Keine Installation, ACL-Reparatur, neue Schlüssel, -zusätzlichen SSH-Rechte, Prozesskills, Reboots oder RMM-Wirkungen. - -Die README verlangt den unabhängig mitgeteilten Downloadhash und den festen -PS1-Hash. Ein etwaiges `Unblock-File` betrifft nur diese exakt geprüfte -Download-Datei; `RemoteSigned` nur den separaten Bootstrapprozess. Eine -verweigernde GPO oder ein fehlgeschlagener Guard wird nicht umgangen. Ein -bereits vorhandener Recoveryfall bleibt zur lesenden Inspektion erhalten. - -Eine gesonderte, auf 45 Minuten begrenzte Veröffentlichung über den vorhandenen -öffentlichen TLS-Bootstrapdienst wird durch Root separat behandelt. Dieser -Server-CAS und diese Dokumentation belegen noch keine Downloadveröffentlichung. -Nach der Userausführung bleiben tatsächliche Tunnelwiederkehr, ursprüngliche -SSH-Hostidentität, erhaltene Schlüssel/Taskdefinition und die lokale -Accessmetadatenfortschreibung durch Root zu prüfen. **Neuer Windowszugriff ist -bis dahin nicht nachgewiesen.** - -Lokale Python-/AST- und Paketprüfungen sowie unabhängige Source-Reviews bestanden. -Der lokale Paketfixture verwendete einen gemockten Serveraufruf und ist kein -zusätzlicher nativer Recoverybeleg. Kein RMM-Job, keine Capability oder -Clockbereitschaft folgt aus der Zugangswiederherstellung. - -## Update: User-Konsolenerfolg und tatsächlicher gepinnter SSH-Kontakt - -Der User meldete die erfolgreiche Ausführung der korrigierten Konsolenstrecke -`Recover-ExistingDevAccess-OriginalBootstrap.ps1` mit Hash `aba0a5a4…`. -Root erhielt danach über den bereits gepinnten SSH-Zugang tatsächlich eine -getrennte rein lesende Antwort. Der lokale Verifikationsfall ist -`fc7a6ad5-5ec5-4280-b629-851aad2529b2`; sein `readback.json` hat SHA -`bb0e2b4747068433bcb7c950743ef56007f22206ca5d4b458f6b8221a4a031e2`. -Der Beleg nennt weiterhin den ursprünglichen Consolefall -`5c96d3d8-1657-40c8-a6ec-c00b63a98210`, `read_only=true`, -`completed=true` und `no_jobs=true`. - -| Tatsächlich beobachteter Wert | Ergebnis | -| --- | --- | -| Configablaufzeit | `2026-11-15T13:05:58+00:00` | -| Accountablaufzeit als FILETIME | `134392215580000000` | -| Originaler Reverse-Tunneltask | `Running` | -| `RmmDiscoveryWindows` | `Running`, PID `3172`, `NT AUTHORITY\LocalService`, Startart `Auto` | -| `RmmDiscoverySystemHelper` | `Stopped`, PID `0`, `LocalSystem`, Startart `Manual` | -| `W32Time` | `Running`, PID `3488`, `NT AUTHORITY\LocalService`, Startart `Manual` | - -Damit ist die Rückkehr des Entwicklungszugangs belegt. Die früheren Aussagen -zur noch offenen Userphase bleiben historische Zwischenstände. Der zusätzliche -rein lesende Erhaltungsbeleg desselben Falls (`preservation.json`, SHA256 -`490e01809ca1e4225f1dbb6a0a4414cf77f7822be31233366480b3a0d4810592`) -bestätigt alle sechs festen öffentlichen Dateien samt SHA/SDDL, Metadaten und -SDDL der vier privaten SSH-Schlüssel ohne Lesen ihrer Inhalte, den exakten -Originaltask-XML-Hash und Runningzustand, Account-SID sowie alle öffentlichen -Pins. Danach wurde lokal ausschließlich die Frist im Accessmetadaten-JSON per -CAS auf `2026-11-15T13:05:58+00:00` fortgeschrieben. Der SSH-Präfix blieb exakt -erhalten; Original und neuer Metadatenbeleg sind privat archiviert. Die alten -Fehlerfälle, Pakete und Korrekturquellen bleiben erhalten. - -Der Readback ist kein Paarupgrade-, TrustedClock-, Boot- oder RMM-Jobnachweis. -Insbesondere eröffnet `W32Time=Running` keine Clockbereitschaft. Der Helper -war tatsächlich noch gestoppt; daraus wird kein authentisierter neuer -Agent-/Helper-Pipeaustausch abgeleitet. Root führt die getrennten Pipe-/MIDL- -Prüfungen erst anschließend fort. - -Der User hat den nächsten Arbeitsfokus ausdrücklich auf die Skriptkonsole mit -vollständigem Shell-/PowerShellinhalt, tatsächlicher WebUI-Plangenehmigung, -Ausgabe und expliziten Root-/SYSTEM-Ausführungsrechten gelegt. Paketabnahmen -sind nachgeordnet. Der erneuerte SSH-Bootstrapzugang verleiht selbst keine -RMM-Ausführungsrechte und ersetzt keine dieser noch separat nachzuweisenden -Genehmigungs- und Ausführungsgrenzen. - -## Manuelles Wartungsfenster am 15. November 2026 - -Der Server bestätigte die abgelaufene Freigabe vom 15. November um 13:05:58 UTC. -Für die Windows-Entwicklung wurde die Frist desselben Forwarding-Schlüssels auf -15:30:00 UTC (16:30 Uhr MEZ) gesetzt. Ein separater SSH-Lesezugriff bestätigte -Frist, Hostpin, Schlüsselbindung, SSH-Profil und Konto. Der Port ist serverseitig -an Loopback gebunden. Ein einmaliger, aktiver Servertimer für 15:30:00 UTC -begrenzt auch eine noch offene Weiterleitung des dedizierten Tunnelkontos dieser -Schlüsselgeneration. Das tatsächliche Auslösen des Timers steht noch aus. - -Die Bedienperson öffnet das Fenster in der VM-Konsole mit -`deploy/windows/Open-ConsoleMaintenanceWindow.ps1`; Parameter sind -`-PreviousExpiry '2026-11-15T13:05:58+00:00' -Until '2026-11-15T15:30:00+00:00'`. -Während der einmaligen SSH-Verbindung pausiert das Skript den vorhandenen -Autostarttask. Bei normalem Ende oder Strg+C beendet es den Client und stellt die -vorherigen Fristen und den Task wieder her. Bei hartem Abbruch oder VM-Ausfall -den Zustand über die Konsole prüfen. Lokales PowerShell-Parsing bestanden. -VM-Ausführung, SSH-Readback und Dienstwechsel stehen bei Veröffentlichung aus. -Die WebUI-Freigabe für Agentjobs gilt weiterhin. - -Das manuell geöffnete Fenster wurde anschließend vom Entwicklungsrechner über -die bestehende gepinnte SSH-Verbindung bis zum Windows-Gast geprüft. Die -Kontofrist und die Frist in der Bootstrapkonfiguration ergaben beide -15:30:00 UTC. Der Gast bestätigte den Servernamen und den deaktivierten -Autostarttask. Beide installierten Dienste liefen beim Readback mit ihren -bisherigen Prozess-IDs: Agent 5528 als LocalService, Helper 9464 als LocalSystem. -Danach wurde die Ablaufzeit im lokalen Zugangsdatensatz an die geprüfte -Gastfrist angepasst. Dies ist der Nachweis für den Entwicklungszugang. - -### Unterbrechung nach Ruhezustand des Notebooks - -Das Hostjournal belegt Suspend zwischen 14:48:24 und 15:39:01 Uhr MEZ. -Danach blieb die Windows-VM im KVM-Status `running`. Der Entwicklungszugang -lieferte bei der SSH-Begrüßung einen Timeout. Auch direkt am bestätigten -Loopback-Listener des Servers kam keine Begrüßung an. Um 15:47 Uhr wurde -nur die anhand von Konto, Prozess und Listener erneut identifizierte alte -Forwarding-Sitzung geschlossen. Schlüssel und vereinbarte Frist von -16:30 Uhr MEZ blieben erhalten. Zum erneuten Aufbau ist die VM-Konsole nötig. - -Der Produktagent meldete sich nach dem Resume beim permanenten Server. MCP -lieferte bei der Abfrage um 15:48 Uhr MEZ für den Windows-Gast `online`, -Quelle `windows.base`, letzter Kontakt 15:47:51 Uhr MEZ. Beim Unterbruch war -der Dienstwechsel noch nicht in die Ausführungsphase gelangt. - -Eine weitere reine MCP-Abfrage bestätigte das nach dem Aufwachen neu -eingegangene Windows-Inventar. Beobachtungszeit 15:39:13 Uhr MEZ, späterer -Kontakt 15:52:23 Uhr MEZ. Betriebssystem, Volumes, Hardware und Software -lagen jeweils als `valid/partial` vor. CPU-Anzahl, Verhältnis von freiem zu -gesamtem Speicher und die Volumenwerte bestanden die Plausibilitätsprüfung. -Windows-Inodes waren ausdrücklich `unsupported` mit leerem Zahlenwert. -Beleg-SHA-256 `cce907d4c5e4ca9b788bab4aad8aac1f082b59f6a2922484289f19be061a1162`. -Die Abfrage nutzte gespeicherte Telemetrie und erforderte keine SSH-Verbindung. - -Beim erneuten Konsolenstart meldete der Gast die Sammelmeldung -`Unexpected account, task, server or previous expiry.`. Sie stammt aus der -Vorprüfung vor der ersten Änderung. Welcher Gastwert abweicht, steht bis zum -Konsolen-Readback offen. Die Serverfrist wurde zu diesem Zeitpunkt nochmals -mit 15:30 UTC bestätigt. Neuere Versionen des Konsolenskripts benennen die -abweichenden Felder einzeln. Drei lokal simulierte Vorprüfungen bestanden -(Ausgangszustand, drei abweichende Werte, alle sechs Bedingungen abweichend). - -Der Konsolenreadback vom 15. November um 15:59:11 Uhr MEZ ergab -`Disabled`, aktives Konto, Konto und Konfiguration beide mit Frist 16:30 Uhr -MEZ, passender Servername, laufender sshd und genau eine ausstehende Sicherung. -Der Bediener kann diesen konkreten Zustand mit `-ResumeInterrupted` im selben -Zeitfenster übernehmen. Das Skript prüft die ursprüngliche Frist der Sicherung -und rekonstruiert daraus die aktuelle Konfiguration. Bereits laufende -Wartungsprozesse verhindern einen Doppelstart. Bei regulärem Ende verwendet -es die ursprüngliche Sicherung zur Rücksetzung. Lokaler Parser- und Fixturetest -für passende Sicherung, aktiven Prozess, Konfigurations- und Fristabweichungen -bestanden. Die Wiederaufnahme muss auf der Windows-Konsole erfolgen. - -Um 16:04:25 Uhr MEZ war der Windows-Gast über die vom Bediener wieder -geöffnete Verbindung erreichbar. Der Gast bestätigte für Konto und Konfiguration -denselben Ablauf um 16:30 Uhr MEZ, den erwarteten Servernamen und den -deaktivierten Autostarttask. Agent und Helper liefen weiterhin mit ihren -ursprünglichen PIDs 5528 und 9464 als LocalService beziehungsweise LocalSystem. diff --git a/docs/windows-development-access.md b/docs/windows-development-access.md deleted file mode 100644 index afe39c1..0000000 --- a/docs/windows-development-access.md +++ /dev/null @@ -1,99 +0,0 @@ -# Entwicklungszugang zur Windows-Test-VM - -**Aktuelle Übernahme 17. November 2026:** Die folgenden Abschnitte belegen die -Einrichtung am 16. November, keinen heutigen Livezustand. Die heutigen Profile -sind vorhanden; der Reverse-Listener 22240 fehlt und Windows-SSH scheitert. -Gast läuft und lokale Konsole ist erreichbar. Konkrete Verbindungs- und -Konsolenwege: [operations-access.md](operations-access.md); -Produktzustand: [handover.md](handover.md). Keine alten Fenster-/Renewalskripte -neu starten und den historischen expires_at-Wert nicht zur Umgehung umschreiben. - -Stand 16. November 2026, 12:18 UTC. Der Betreiber hat für diese reine -Entwicklungstestmaschine ausdrücklich einen dauerhaft gültigen SSH-Rückkanal -beauftragt, damit keine wiederholten Konsolenbefehle nötig sind. Dies ersetzt -nur die bisherige Befristung des Entwicklungstransports. Geräteidentität, -RMM-Rechte, WebUI-Genehmigung und Einmalverbrauch bleiben eigenständig. -Das Notebook bleibt ausschließlich Entwicklungsrechner. - -## Tatsächlich eingerichtet - -Auf `discovery.ease-technologies.de` wurde beim vorhandenen Tunnelkey allein -`expiry-time` entfernt. Key, Account und die Beschränkungen auf ausschließlich -`127.0.0.1:22240` bleiben erhalten. Die vorherige Datei und ein Änderungsbeleg -liegen geschützt auf dem Server. Kein SSH-/RMM-/Zeitdienst wurde dafür neu -gestartet. SHA-256 der neuen Authorized-Keys-Datei: -`db10a5ce8e859bc7fc9bfe995006051c2bac3d15e3a5ce5166a82c4929457885`. - -Auf der Windows-VM hat `Set-PersistentDevelopmentAccess.ps1` den vorhandenen -Task `RmmDevReverseTunnel` unter SYSTEM durch den direkten OpenSSH-Aufruf -mit denselben Schlüsseln und strikter Prüfung des bestätigten Serverhostkeys -ersetzt. Das bestehende Konto `rmm-dev` hat jetzt kein Ablaufdatum. Der Task -startet beim Boot sowie zur Übergabe um **12:39:57 UTC / 13:39:57 MEZ**, -hat keine Laufzeitbegrenzung und startet nach einem Fehler erneut. Der -vorherige Task und das alte Kontoablaufdatum sind im privaten Windows-Fall -`C:\ProgramData\RmmDevAccess\persistent-development-access-20261116` -aufbewahrt. Task-XML-Hash nach tatsächlichem Readback: -`e7e8c304a8eb13ec06fd78b6d1fd6b90994f7741a0efe8feae61fc7539abc7fc`. - -Der derzeitige Vordergrundtunnel wurde nicht beendet. **Der automatische -Verbindungsaufbau nach der geplanten Übergabe ist unten separat nachgewiesen.** -Die Konfiguration allein ist kein Beleg für einen durchgehend aktiven Tunnel. - -Windows-sshd war bei dieser damaligen Einrichtung ausschließlich an `127.0.0.1:22222` gebunden; -kein öffentlicher Windows-Port wurde geöffnet. Die damalige Stoppaussage zu -Agent/Helper für Kontrollabschluss 205 ist historisch; aktueller Stand in der -Übergabe. Dieser Zugang -führt selbst keine RMM-Jobs aus und erteilt keine Jobgenehmigungen. - -## Prüfumfang und Grenzen - -Ein erster Versuch stoppte vor jeder Windows-Änderung: Die vorhandene -öffentliche `.pub`-Datei gehört dem eingebauten Administrator und besitzt -zusätzlich einen lesenden Everyone-Eintrag. Der Controller erwartete zunächst -bei allen Dateien dieselben privaten Eigentümer. Anschließend wurden nur -Eigentümer und ACL-Metadaten der festen Pfade gelesen. Der korrigierte -Controller bindet deren **exakte unveränderte Deskriptoren** einschließlich -der öffentlichen Datei. Private Schlüsselbytes wurden dafür nicht gelesen; -keine ACL wurde gelockert. Der tatsächliche PowerShell-5.1-Parserlauf war -fehlerfrei, danach lief die Konfiguration einmalig mit erfolgreicher Nachlese. - -Lokale Originalbelege liegen unter -`devstate/windows-client/mvp-closeout-20261116/persistent-access-*` und -sind absichtlich nicht Teil des Git-Repositorys. Bei einer späteren Entfernung -zuerst den konkreten Task und die einzige Server-Keyzeile prüfen; erhaltene -Originale nicht blind über einen zwischenzeitlich geänderten Stand kopieren. - -## Korrektur 17. November 2026: Wiederholungsauslöser - -Der Tunnel brach am 17. November um 06:31:38 UTC ab und startete nicht neu: -`RestartCount` greift nur bei Startfehlern, nicht beim Exitcode 255 von -`ssh.exe`. Auf Userauftrag wurde der Tunnel über die lokale KVM-Konsole -wiederhergestellt und dem Task ein zusätzlicher Auslöser „alle 5 Minuten, -unbegrenzt“ hinzugefügt. Mit `IgnoreNew` bleibt ein laufender Tunnel unberührt. -Aktion, Argumente, SYSTEM-Prinzipal, Schlüssel und Hostpin unverändert. -Original-XML (`e7e8c304…`) liegt unter -`C:\ProgramData\RmmDevAccess\tunnel-repetition-20261117`; neuer XML-Hash -`5fd0e13ed2d1d581a07736e3f9d54e68e6df97139cdabedf288648a4f91308d8`. -Seit 08:42:04 UTC läuft der Tunnel nachweislich als SYSTEM-Task (PID 3836). -Ein automatischer Wiederaufbau nach einem echten Abbruch ist damit -konfiguriert, aber noch nicht tatsächlich beobachtet. - -## Automatische Übergabe tatsächlich bestanden - -Am **12:39:57 UTC / 13:39:57 MEZ** startete der Task selbständig den neuen -OpenSSH-Prozess PID 9100 unter tatsächlicher SYSTEM-SID `S-1-5-18`. -Eine neue SSH-Verbindung nach Ende des alten Fensters bestätigte um 12:40:37 UTC: -Task Running, Konto aktiv ohne Ablaufdatum, Windowslistener ausschließlich -`127.0.0.1:22222`. `LastTaskResult=267009` ist der laufende Taskzustand -`0x41301`, kein abgeschlossener Fehlercode. -Anschließend wurde noch eine explizit neue SSH-Verbindung mit deaktiviertem -Multiplexing und unveränderter strikter Hostpinprüfung erfolgreich geöffnet. -Beide RMM-Dienste waren dabei weiterhin gestoppt; keine Produktwirkung. - -Die Servernachlese bestätigte zusätzlich das ebenfalls nicht ablaufende -Tunnelkonto und die effektiven SSH-Beschränkungen: nur Remote-Forwarding, -`permitlisten=127.0.0.1:22240`, kein GatewayPorts, kein Passwort, kein TTY -und kein Agent-Forwarding. [Tatsächliche Metadaten und neuer Verbindungsbeleg](evidence/windows-development-access-20261116.json). -Der Zugang braucht damit keine erneuten Konsolenbefehle zur Verlängerung. -Ein automatischer Start nach einem späteren vollständigen VM-Boot ist -konfiguriert, wurde durch diesen Übergang aber nicht als Bootabnahme getestet. diff --git a/docs/windows-development-pair-successor.md b/docs/windows-development-pair-successor.md deleted file mode 100644 index 6bccab7..0000000 --- a/docs/windows-development-pair-successor.md +++ /dev/null @@ -1,53 +0,0 @@ -# Entwicklungswechsel des gestoppten Windows-Paars - -Stand 16. November 2026. Der manifestgebundene Controller -[Install-DevelopmentPairSuccessor.ps1](../deploy/windows/Install-DevelopmentPairSuccessor.ps1) -beginnt mit **beiden gestoppten Diensten** und der unveränderten ursprünglichen -aktiven Konfiguration. Er startet das alte Paar nicht zwischenzeitlich. - -Der erste tatsächliche Schritt `PrepareStopped` bestand am 16. November um -12:52:49 UTC: Fall `a217415b-875b-4687-bf87-147cdaf67ab8`, Manifest -`a30c523d7e1a4e6a630325a486d7de23146df98f8269e4d1fdc2e736ecb71017`. -Beide Dienste blieben gestoppt, die ursprünglichen Zieldateien unverändert; -private Sicherungen, native Lebensdauersperren und File-ID-Prüfungen bestanden. -Installation, Profilveröffentlichung und Produktzeitprüfung folgen separat. - -Der genaue Controllerhash ist -`78e0e0111c08ab0c91774d7ef87e2f1e6ddf272629859af92c48292a289a42a4`. -Der tatsächliche Windows-PowerShell-5.1-Parser meldete null Syntaxfehler. -Ein zusätzlicher ausschließlich prozesslokaler Funktionstest bestätigte die -verwendeten Function-Provider-Pfade. Diese Prüfungen ersetzen keine Installation. - -Voraussetzungen sind der unabhängig überprüfte geschlossene G205-Abschluss, -der isolierte Pair-Build und die tatsächlich ausgeführten -[Linux-](evidence/windows-helper-clock-20261116-linux.json) und -[Windows-Units](evidence/windows-helper-clock-20261116-windows.json). -Die lokal beibehaltene Buildbeschreibung ist -`devstate/windows-helper-apply-fix/build-release-qualified.json`; ihr Feld -`compilation_source` bezeichnet den vollständigen tatsächlichen Quellstand. - -Der weitere, vorbereitete Ablauf ist: - -1. `InstallStoppedPassive`: Agent und Helper sowie ihre beiden neuen Pins - ersetzen; aktive Originalkonfiguration privat erhalten und ausschließlich - die begrenzt gerenderte passive Konfiguration installieren. Beide originalen - Lebensdauersperren bleiben bis zum Ende der Dateitransaktion gehalten. - PKI, Journale und deren Identitäten werden nicht ersetzt. -2. Erst danach das tatsächliche neue passive Paar starten und seine Prozesse, - Tokens, Images und Konfiguration unabhängig beobachten. -3. `PrepareProfile`: Profil7 an **beide** tatsächlichen neuen Images binden; - gemeinsame Buildbelege für beide Rollen verwenden. Zeitvertrauenswurzeln und - das bestehende begrenzte KVM-Vertrauensprofil bleiben erhalten. Es wird keine - physikalische Kalibrierung oder erfolgreiche signierte Laufzeit vorgetäuscht. -4. `PublishProfile`: nach exakt gebundenem Prozessstopp das vorbereitete Profil - installieren und das neue Paar wieder passiv starten. Fünf eindeutige - Ersetzungen binden Agent, Helper, Plattformbeleg und die beiden Rollenbelege. - -Die ursprünglichen versiegelten nativen Datei-/ACL-/SCM-Primitiven werden -nur als Deklarationen geladen. Ihre alten Agent-only-Aktionspfade werden nicht -ausgeführt. Vorhandene Wirkungsmarker sperren eine blinde Wiederholung. - -Der Controller reaktiviert keine Jobs und erteilt keine Freigabe. Die getrennte -Wiederherstellung des aktiven Betriebs verlangt den aktuellen Profil-/Pairbezug -und danach einen neuen regulären unabhängigen signierten Abgleich. Jeder neue -Skriptauftrag bleibt ein eigener WebUI-genehmigungspflichtiger Plan. diff --git a/docs/windows-eventlog-contract-acceptance.md b/docs/windows-eventlog-contract-acceptance.md deleted file mode 100644 index aec9aca..0000000 --- a/docs/windows-eventlog-contract-acceptance.md +++ /dev/null @@ -1,65 +0,0 @@ -# Native M3-Eventlog-Vertragsprüfung - -`deploy/windows_eventlog_acceptance.py` ist ein neuer, separater Bootstraprunner. -Der unveränderte Profilrunner und dessen16/7- beziehungsweise16/6-Belege bleiben -readbackfähig. Neuer Namespace: `windows-eventlog-contracts`. - -Der neue Pack enthält ausschließlich Domain-Lib17 und Core-Contracts7 auf Linux, -danach Domain-Lib17 und Core-Contracts6 auf Windows. Der Unix-OpenSSL-Paritätstest -entfällt unter Windows. Server-/Windows-M3-Quellen werden zusätzlich exakt an den -geprüften Stand gebunden, einschließlich Schemars-Metadatenfix und Gateway- -Ergebnisprüfung. Diese Adapterquellen werden durch die beiden Vertrags-EXEs -**nicht** als native Eventlogprovider qualifiziert. Es gibt weder Liveabfrage -noch RMM-Job, Capabilityaktivierung, Dienst-/Produktdatenbank-/PKIänderung. - -Tatsächlich auf Cloud-Linux bestanden:24Prüfungen ohne Skips, Fall -`6f9bdfb7-3902-462e-a08f-ec612e36c635`. Gemeinsamer Build -`afb44f9b-8040-4efa-ac2c-fd6c3a43f8a6`, Manifest-SHA256 -`ed1371e9b058f8e7f874b071fcfce1bc409769546d5e63235295adadb5ec1de7`, -Linuxproof-SHA256 -`d37ce1644dd169c932176e3e9bd33cee22b9fa4698e9faa0f5aea0f2de09f7d4`. -Anschließend bestanden auf der Windows-VM alle23Prüfungen ohne Skips, Fall -`ccb258a7-5930-4e02-b955-d522f98f0c36`, Windowsproof-SHA256 -`ee1ba206637f2465e7a066b6e23ca2f8bf9b57c0ae08ddc80fe23e0199b027e1`. -Dieser Beleg bindet denselben Build und den ursprünglichen Linuxproof. -Der lokale Build mit -98identischen Vorher-/Nachher-Inputs, vier erhaltenen Original-Linkdateien, -beiden Ziel-Clippyprüfungen und24lokalen Linux-Vertragstests ist bestanden. - -Der lokale Offlinebuild erhält Original-Linkdateien neben gestrippten -Lieferkopien, prüft Clippy für beide Vertragsziele und führt die tatsächlichen -Linux-Lieferbytes mit exakter Liste und ungefiltert aus. Windowslisten bleiben -bis zur tatsächlichen Windowsausgabe erwartet. Vor/nach müssen sämtliche -gebundenen Cargo-/Toolchain-/Domain-/Core-/Protocol-/Proto-/Server-/Windows- und -Runner-/Bootstrapquellen gleich sein. Ein weiterer Backend-/PG-Testlauf ist -nicht Bestandteil dieses Runners. - -**Aufrufschema; beide obigen nativen Fälle tatsächlich ausgeführt:** - -```sh -python3 deploy/windows_eventlog_acceptance.py build-local -python3 deploy/windows_eventlog_acceptance.py linux --manifest devstate/windows-eventlog-contracts/build-UUID/manifest.json --access-root /ABSOLUTER/PFAD/ZUM/HAUPTREPO --execute-native-tests -python3 deploy/windows_eventlog_acceptance.py windows --manifest devstate/windows-eventlog-contracts/build-UUID/manifest.json --access-root /ABSOLUTER/PFAD/ZUM/HAUPTREPO --execute-native-tests -``` - -Artefakte und lokale Belege bleiben im isolierten Eventlogworktree. Ausschließlich -`--access-root` liest bei ausdrücklicher nativer Ausführung streng geparste -bestehende SSH-Konfigurationen für Cloud-Linux beziehungsweise den -bekannten gepinnten Windows-Reversezugang. Keine Credentialkopie oder neue -Hostkeyannahme. Windows bindet den SHA256 des zuvor tatsächlich verifizierten -Linuxbelegs desselben Manifests. - -Jeder native Fall hat eigene Create-once-Intents und Startbelege. Linux nutzt -privaten Rootscratch, geleerte Umgebung und eigene Netzwerknamespace. Beide -Plattformen prüfen vor dem ersten Teststart die vollständigen Testnamen beider -Programme. Windows läuft als Bootstrapadministrator, kein LocalService-Nachweis. -Ausgaben und Transportfehler bleiben privat; stdout enthält nur Status und -Nachweishashes. - -Nach Antwortverlust ausschließlich `readback-linux` beziehungsweise -`readback-windows` mit ursprünglichem Manifest, `--case UUID` und `--access-root`. -Readback lädt nichts hoch und startet nichts neu. Er bindet unveränderliche -Originalintents, Manifest sowie Runner-/Remotescripthashes; spätere -Produktquellenänderungen erzwingen keinen neuen Lauf. Nur neue Starts benötigen -den aktuellen exakt qualifizierten Quellstand. Unvollständige Fälle bleiben -unvollständig; kein automatischer zweiter Versuch. diff --git a/docs/windows-eventlog-source.md b/docs/windows-eventlog-source.md deleted file mode 100644 index 1f6acd3..0000000 --- a/docs/windows-eventlog-source.md +++ /dev/null @@ -1,55 +0,0 @@ -# Windows-M3: begrenztes Ereignisprotokoll - -Stand2026-11-14: Quelle implementiert und unabhängig gegenseitig geprüft, -noch nicht auf dem Windowsgast installiert oder als RMM-Aktion ausgeführt. -Der isolierte Branch enthält auch das bereits separat nativ qualifizierte -optionale PowerShell-Prozessprofil. Keine Capability wurde veröffentlicht. - -`query_logs` bindet ausschließlich Quelle -`windows.eventlog.application.rustdiscovery-mvp-test`, Kanal `Application` -und Provider `RustDiscovery-MVP-Test`. Erforderlich sind Windows-/Sync- und -eigene Fixturecapability, `logs:read` und `agent_service`. Kein SYSTEM-Logpfad, -kein freies XPath, kein angeforderter Liveabruf als passives Inventar. -UTC-Zeitfenster höchstens24Stunden, höchstens65536Ausgabebytes und feste -innere5Sekunden-Grenze; äußerer Jobrahmen10–120Sekunden. Alle Werte stehen -aus hashgeprüften gespeicherten Planbytes vor der WebUI-Genehmigung fest. - -Die synchrone native Eventlog-API läuft im begrenzten eigenen Prozess innerhalb -des vorhandenen atomaren JobObjects. Der Child prüft tatsächlichen LocalService- -Token samt Agent-Service-SID, echten SCM-/Kernel-Elternprozess, geschützte -Konfiguration, signierten Originalrequest, aktuelle qualifizierte Uhr und Boot, -den bereits dauerhaft gebuchten Verbrauch/Start samt tatsächlichem SQLite- -Dateihandle sowie einen einmaligen Startmarker. Der Aufruf über den festen -CLI-Modus allein verleiht keine Berechtigung. Keine Schlüssel-/Requestbytes -auf der Kommandozeile. Uhr-/Jobgates bleiben geschlossen. - -Worker und Server prüfen konkrete Herkunft, Zeitfenster, Budget, Vollständigkeit -und Fehler. Bekannte Ereignis-/Byte-/Einzelereignisgrenzen bleiben ausdrücklich -partiell; Zeitüberschreitung oder Berechtigungsfehler werden kein vollständiger -Erfolg. Eine im Review gefundene Lücke im serverseitigen Successguard wurde -geschlossen: `win32_error` ausdrücklichnull, kein Neustartbedarf und generisches -Kürzungsflag identisch zur konkreten Evidenz. - -Lokal tatsächlich bestanden:238Rusttests, ein isolierter PostgreSQL-Fall und -38Webtests samt Typecheck/Build/Clippy. Der PG-Fall prüfte unter anderem fehlendes -`logs:read`, verlorene Capability und `pending_approval` mit0Jobs/Outbox/Grants. -Nach dem Successguard-Fix wurden dessen bestehende Mutationsmatrix und -Server-Clippy gezielt erneut ausgeführt. Drei portable Provider-/Ergebnistests -liefen tatsächlich im Linux-Buildcontainer; zwei Windows-Workerprüfungen sind -bisher nur crosskompiliert. Keine dieser Ebenen ersetzt den Nativepfad. - -Private Quellenbelege: `devstate/windows-eventlog-backend/qualification.json` -(`facab5cc…`), `qualification-success-flags.json` (`f5972644…`) und -`devstate/windows-eventlog/windows-source-qualification.json` (`feb16e79…`). -Die gesonderte Vertragsabnahme ist zuerst auf Cloud-Linux24, danach Windows23 -ohne Skips bestanden. Manifest `ed1371e9…`; Linuxfall `6f9bdfb7…`, Windowsfall -`ccb258a7…`. [Native Runnerdokumentation](windows-eventlog-contract-acceptance.md) -hält genaue Bindungen und Grenzen fest. Kein Live-Eventlog-/Workerrollenbeweis. - -Weiter offen: reale LocalService-Eventlog-API, eigene Fixtureereignisse, -Filter-/Zeit-/Ausgabe-/Fehlergrenzen und vollständiger WebUI-genehmigter Job. -Keine Registrierung oder Erhebung auf dem Ziel wurde durch diese Quellarbeiten -ausgeführt. Der Schemars-Attributfix entfernt lediglich die irreführende -Nullable-Angabe des optionalen Prozessprofils; strikte Deserialisierung und -fehlendes Feld bleiben unverändert. Die vorherigen Nativebelege bleiben an -ihre ursprünglichen Quellen gebunden. diff --git a/docs/windows-feature-runtime-upgrade.md b/docs/windows-feature-runtime-upgrade.md deleted file mode 100644 index e2dce3d..0000000 --- a/docs/windows-feature-runtime-upgrade.md +++ /dev/null @@ -1,84 +0,0 @@ -# Optionale IPC-Clientfunktion identitätserhaltend ausrollen - -Stand 2026-11-14: Der neue Runner -`deploy/windows/runtime_feature_upgrade.py` ist **implementiert, neu nativ -qualifiziert und auf der bestehenden Windows-VM erhaltend ausgeführt**. -`runtime_upgrade.py` und seine abgeschlossenen historischen Fälle bleiben -unverändert. Die frühere native Default-/Helperunit-Abnahme ersetzt nicht die -neue Featureabnahme. - -Der Runner erlaubt ausschließlich den belegten Übergang vom bisherigen passiven -Agentbinary `f64e81155a4d86089a9dd7e6ec42ffba50b939442386c3187a28769a4de1aa0b` -zu einem neuen Build mit `system-helper`. Er liest den maßgeblichen -`current-runtime.json` samt unveränderlichem tatsächlichem Upgradebeleg und -vergleicht vor der ersten Wirkung Image, öffentliche Identität, Konfiguration, -ACLs und Metadaten des unexportierten Geräteschlüssels. Die ursprüngliche -Sechsfeldkonfiguration und automatische WSS-/HTTPS-Auswahl bleiben erhalten. -Helper, Pin, Jobs, Uhr- oder Serverpolicy werden dabei nicht installiert/aktiviert. - -Der neue Quell-/Artefaktmanifest bindet auch `helper_runtime`, `helper_ipc`, -`helper_system`, die Helperbinaryquelle und den unabhängigen Shared-Core-Helper. -`build-local` verlangt die weiterhin geschlossene Produktionsuhr, baut offline -und führt Clippy mit `-D warnings` aus. Der Eltern-Orchestrator führt anschließend -`qualify-native` aus: Alle genau 21 neu gebauten Bibliotheks- und sechs Binarytests -müssen auf der Windows-VM bestehen. Die tatsächlichen Artefakthashes und die -Windows-/Linux-Jobzähler sowie Policy-/Faultflags werden davor und danach -verglichen. Das sind Administrator-Bootstrap-Units, kein laufender SYSTEM-Dienst -und kein positiver Pipebeleg. - -Die native Upgradephase benutzt einen eigenen create-only Namensraum -`runtime-feature-{UUID}` mit `runtime-feature-active-intent.json`. Sie überschreibt -den alten V1-Intent nicht. Das feste PowerShellverfahren wird mit engen, -eindeutigen Ersetzungen aus der erhaltenen V1-Quelle abgeleitet. Es erhält -Datenbankidentität, ursprüngliche Tabellen, unbestätigte Telemetriebytes, -Sequenzkontinuität, Geräte-/Zertifikats-/CAidentität und ACLs. Vor Stop, Austausch -und Start stehen dauerhafte Intents. Nach einem unklaren SSH-Ausgang wird -`enter` nicht wiederholt; `finish` liest den tatsächlichen Zustand, ein Rollback -ist eine gesonderte ausdrückliche Aktion mit eigenem einmaligem Startversuch. - -Erst nach zwei tatsächlichen WSS-Heartbeats, bestätigter Inventarübertragung, -Mandantengegenprobe und unveränderten Job-/Servergrenzen schreibt der Runner -`system_helper_client_feature=true` in Ergebnis und aktuellen Runtimeindex. -Der Indexwechsel prüft den erwarteten vorherigen Hash oder denselben bestehenden -Fall; ein fremder Übergang wird nicht überschrieben. Nach Rollback darf ein -historisches Feature-Ergebnis nicht als aktueller Zustand veröffentlicht werden. -Alle Finish-Aufrufe lesen das tatsächliche ausgewählte Image erneut. - -Phasenfolge; tatsächliche Ergebnisse dieses Durchlaufs unten: - -1. `runtime_feature_upgrade.py build-local` -2. `runtime_feature_upgrade.py qualify-native --manifest ` -3. `runtime_feature_upgrade.py upgrade-passive --manifest --qualification ` -4. Bei verlorenem Reply nur `finish --id `; eine ausdrücklich - gewünschte Wiederherstellung verwendet `rollback --id `. -5. Erst danach [den passiven SYSTEM-Helper installieren und die echte - LocalService-Pipeverbindung nachweisen](windows-system-helper-bootstrap.md). - -Tatsächlich lokal ausgeführt: Python-Syntaxprüfung, PowerShell-Parser aller drei -abgeleiteten Quellstrings und vier gezielte Guards bestanden. Diese prüfen -exakte/eindeutige Ableitung, getrennten Namensraum, Ablehnung des alten -Defaultprofils als Featurequalifikation, aktuelle Zustandsprüfung nach Rollback -und CAS-Ablehnung eines fremden Runtimeindex. Keine VM-/Serveraktion und kein -RMM-Job wurde durch diese lokalen Prüfungen ausgelöst. - -## Tatsächlich auf der Windows-VM ausgeführt - -Neuer Buildmanifest `923aa4e8-d1e7-43fb-bffb-6450b2fe233f` bindet57 Quellen. -Lokaler Offline-Releasebuild und Clippy bestanden. Neuer eigener nativer Fall -`23b0e0aa-d5c5-433b-a025-53293d86c1a0`: alle21 Library- und6 Binarytests -bestanden, ohne Skip, als Bootstrapadministrator. Unverdrahtete MSI-/Eventlog- -Quellen sind dadurch nicht als native Provider qualifiziert. - -Anschließend Fall `cea4d30f-06a1-4f80-b483-f8b1bb6b0899`: neues Agentimage -`2beed7fa…`, tatsächlicher LocalService-PID5140, Auto/WSS, ursprüngliche -Konfiguration/ACLs/Identität/Schlüsselmetadaten/Telemetrie-DB erhalten. Zwei -frische Heartbeats, konkretes Inventar-ACK und Fremdtenant-Verweigerung bestanden; -Windows0/0/0/0 und Linux30/30/26/0 erhalten. Der erste nachgelagerte Nur-Lese- -SSH-Aufruf lief in ein Timeout; ausschließlich `finish` desselben Falls wurde -wiederholt, kein zweiter Dienststart oder Binärtausch. Der aktuelle Index bindet -den tatsächlichen verifizierten Abschluss. - -`system_helper_client_feature=true` bezeichnet den kompilierten optionalen -Client, keine SYSTEM-Aktionsfreigabe. Uhr und Jobs bleiben geschlossen; noch -kein Signingbinding/Verbrauchsledger/Jobsverzeichnis beim Netzwerkagenten. -Die tatsächliche Dienst-Pipeverbindung ist ein getrennter nächster Nachweis. diff --git a/docs/windows-gates.md b/docs/windows-gates.md deleted file mode 100644 index bcd6f92..0000000 --- a/docs/windows-gates.md +++ /dev/null @@ -1,72 +0,0 @@ -# Windows-Client: aktueller MVP-Stand - -**Diese ältere Matrix ist als aktuelle Übersicht abgelöst.** Stand 16. November: -Allgemeine LocalService-PowerShell-Skripte bestanden; SYSTEM noch Unknown, -RMM-Dienste gestoppt, tatsächliche Selbstupdates offen. Maßgebliche vollständige -Matrix und nächste Agentaufträge: [mvp-completion-plan.md](mvp-completion-plan.md). -Die folgenden Quellen-/Teilprüfungen bleiben historische Belege. - -Stand2026-11-16, Spezifikation1.25. Das begrenzte Linux-MVP ist abgeschlossen; -der ausdrücklich zusätzlich beauftragte Windows-/Skriptkonsolen-/Updaterumfang -ist noch nicht vollständig abgenommen. Notebook ausschließlich Entwicklung, -Windowsgast eigenes Testgerät, endgültiger Server discovery.ease-technologies.de. -Quellen-/Build-/Unitnachweis wird nicht als laufender Dienst-/Jobnachweis ausgegeben. - -| Bereich | Tatsächlich implementiert/nachgewiesen | Was konkret noch fehlt / warum | -| --- | --- | --- | -| Passive Windowsverwaltung | Laufender LocalService-Agent, Enrollment/mTLS, WSS/HTTPS/Fallback, Inventar/Heartbeats und Tenanttrennung nativ bestanden. Die passive Zertifikatserneuerung ist implementiert. Fünf Tests mit separaten Zertifikaten bestanden auf der Cloud-Linux-VM und auf Windows 11. | Echte Erneuerung durch den LocalService-Dienst mit einer separaten Testidentität und anschließender Wiederverbindung sowie ein eigenständiger Widerrufstest fehlen. [Zertifikatsnachweise](windows-certificate-renewal.md) | -| SYSTEM-Trennung | Helper läuft als SYSTEM/Manual; Pipe-v2, gegenseitige Prozess-/Image-/Dateibindung und echte LocalService-Probe bestanden. | Unabhängiger signierter Laufzeitsync und erste genehmigte SYSTEM-Wirkung; die frühere Peerprobe-Störung ist kein aktueller offener Blocker. | -| Skriptkonsole | MCP-Antrag, feste Bytes/Plan/WebUI, PowerShell5.1/RemoteSigned-Prozessprofil, Vollwartungsprofil und Ausgabe-/Prozessgrenzen implementiert; native Windows-Vertragsunits bestanden. Linux-UID0-Vollwartungsjob tatsächlich bestanden. | Ein fester LocalService-PowerShell-Auftrag wurde über MCP geplant, sichtbar simuliert in der WebUI genehmigt und nativ mit Exit 0 sowie exakten Ausgabebytes verifiziert. Einmalverbrauch und Einzelaudit sind belegt. Der Client ist wieder passiv und zusätzlich dauerhaft auf diesen Testscope begrenzt. Allgemeine Windows-/SYSTEM-Wartung, Fehlerabnahmen und weitere Aktionsarten bleiben offen. [Nachweise](windows-profile-acceptance.md). | -| Zeitvertrauen | Signierter Codec, getrennte Agent-/Helperprüfung und ausdrückliches aktives KVM-OS-Profil1.23 implementiert; Linux-first und Windows-Rohcapture belegt. Auf dem permanenten Server läuft das Zeit-Gateway. Die Windows-VM prüfte über ihr Gerätezertifikat eine echte signierte Antwort (200). Fremder Mandant (403), alte Verbindung (409) und öffentlicher Zugriff ohne Geräteidentität (401) wurden abgewiesen. | Beide Dienstrollen prüften unabhängig signierte Zeitantworten. Nach dem korrigierten Build und geschützter Profilrevision 4 bestanden regulärer Sync und tatsächlicher Start im festen Echo-Scope. Neue Code-/Prozessgenerationen brauchen weiterhin frische Prüfungen. | -| Dienst-/MSI-Aktionen | Typisierte SCM-/MSI1.0→1.1-Verträge, getrennte SYSTEM-Policies, Runtime-/Nachbedingungsquellen und native Vertragsunits vorhanden. | Nach Zeit-/Syncbereitschaft je eigene WebUI-genehmigte Dienst- und MSI-Installation/Upgrade/Noop mit echten unabhängigen Nachbedingungen. Keine allgemeine EXE-/OSupdatefreigabe aus Fixtures. | -| Strukturierte Eventlogs | Begrenzter Provider-/Worker-/UI-Vertrag und native Vertragsunits vorhanden. | Eigenständig geprüfter Prozess-/Clockkontext des Kindworkers und echte genehmigte Live-Abfrage offen; Parentclock darf nicht als fremder Prozessbeleg verwendet werden. Genehmigte PowerShell-Skripte sind für Logwartung zusätzlich vorgesehen. | -| Dauerhafte Windowsjobs | Gemeinsamer Einmalverbrauch, Journale, Dispatch/Abandon/RawMirror und Fehlerverträge implementiert. | Redelivery/ACK-Verlust, Crash/Unknown, Ablauf/Entzug, Reconnect und gemischter Linux-/Windowsplan am echten aktivierten Windowsdienst nachweisen. Linuxerfolge ersetzen diese OS-Nachweise nicht. | -| Agent-Selbstupdate | Signierte Codepaare/Releasekatalog, eigene Artefaktstreams, WebUI-Plan, Handoff/Health und Readercensus im Quellpfad; lokale und ausgewählte native Linuxfixtures bestanden. Der passive [Linux-Katalogcheck](agent-updater-passive-catalog.md) ist integriert und mit sechs Fällen auf der Cloud-VM geprüft. | Ausgelieferter Worker/Full-Admission/Staging, kompatible erhaltende erste Baseline, unklare Record-I/O-Adjudikation und V2-Code-Rückweg fehlen; danach tatsächlicher genehmigter Linux-Apply, anschließend Windows. APT/MSI-Fixtures aktualisieren nicht den Agenten. | -| Auslieferung/Betrieb | Windows-GNU-Artefakte gebaut und bestimmte Binaries nativ ausgeführt; Verwaltung bleibt SSH-Tunnel, keine öffentliche Dev-Anmeldung. | MSVC-/signierter Installer und eigenständige native Installer-/Reboot-/Lifecyclebelege offen. Produktiver IdP/MFA/HA/Restore sind zusätzliche Betriebsreife, keine bestandene MVP-Produktionsfreigabe. | - -Aktuelle Detailbelege: [Windows-Zeitabruf](windows-time-route-operator.md), [Gatewaybereitstellung](server-time-gateway-deploy.md), [Zeitbrokerstart](server-time-broker-start-acceptance.md), -[Signaturen](server-time-broker-signature-acceptance.md), -[OS-Zeitprofil](windows-trusted-os-clock-source.md), -[Pipe-v2](windows-system-pipe-upgrade.md), -[Skriptkonsole](script-console-windows-link.md), -[Updater](agent-updater-runtime-source.md). -Jeder wirkende Auftrag bleibt bis zum tatsächlichen WebUI-Klick pending_approval; -Entwicklungsabnahmen ausschließlich sichtbar simuliert, kein Produktionsnachweis. - -## Historischer Stand2026-11-14 - -Die folgende ursprüngliche Tabelle bleibt als damaliger Snapshot erhalten. -Insbesondere fehlender Helper/Peerprobe und ausschließlicher Alt-Clockentwurf -sind durch die obigen aktuellen tatsächlichen Nachweise überholt. - -Stand 2026-11-14, Spezifikation 1.18. Der Windows-11-x64-Gast ist ein eigenes -Testgerät. Der Notebook-Host bleibt ausschließlich Entwicklungsrechner; -Server ist `discovery.ease-technologies.de`. Das abgeschlossene Linux-MVP -bleibt eine eigenständige Abnahme. Dieser Bericht erweitert dessen Umfang nicht. - -| Strecke | Tatsächlicher Stand | Nächster Nachweis | -| --- | --- | --- | -| Zugang | Gepinnter Reverse-SSH-Zugang zum Gast vorhanden; keine öffentliche Windows-SSH-Freigabe. Bestehender Agent bei Wiederaufnahme als LocalService laufend, Auto-Start, unveränderte Identität, kein Enrollmenttoken. | Zugang zeitlich begrenzt; keine automatische Verlängerung oder neue öffentliche Portfreigabe. | -| Passiver Client | SCM-Dienst, Service-SID/ACLs, Enrollment/mTLS/WSS, Inventar mit Quelle/Zeit, Heartbeats und Mandantentrennung nativ bestanden; sieben native Rusttests. | Bestehende Identität und Telemetriehistorie bei allen weiteren Schritten erhalten. | -| HTTPS/Fallback | Explizites HTTPS und automatischer Fallback nach zwei tatsächlichen mTLS-WSS503 unter LocalService nativ bestanden, jeweils mit frischen Heartbeats und Inventar-ACK. Testhooks geschlossen. Anschließend bestehende VM separat dauerhaft auf `auto` gestellt und bevorzugtes WSS erneut mit zwei frischen Heartbeats/ACK geprüft; Identität und ACLs erhalten, 0 Jobs/Grants. | Transportnachweise abgeschlossen; kein automatischer HTTPS→WSS-Switchback nachgewiesen. Installerdefault ebenfalls `auto`, aber keine neue Installationsabnahme. | -| TLS-Lifecycle | Falsche CA, falscher Name und abgelaufenes Clientzertifikat mit gültigen Kontrollen nativ als getrennte Admin-TLS-Proben bestanden. Permanente Identität/Dienst unverändert. | Rotation und Widerruf noch gesondert sicher implementieren und prüfen. Permanente Identität nicht widerrufen oder ersetzen. | -| Signierter Jobkern | Gemeinsamer Kern zuletzt nativ Linux80→Windows58 qualifiziert. Neuer enger SYSTEM-Delegationsadapter mit dauerhaftem Intent, deny-only Abandon und unabhängigem RawMirror implementiert; native23+7Units bestanden. Bestehender laufender passiver Client bleibt unverändert; neue Artefakte noch nicht installiert. Jobs bleiben deaktiviert. | Tatsächlichen signierten Dienst-Sync, qualifizierte Uhr und vollständige Startgrenze nachweisen. Units ersetzen keinen LocalService-/SYSTEM- oder Jobnachweis; [Quellenstand](windows-system-delegation-source.md). | -| PowerShell | Begrenzter5.1-Executor implementiert; exakte Skriptbytes, atomarer Prozessbaum, Rohbytes und Unknown bei unklarer Wirkung. Separates optionales festes RemoteSigned-Prozessprofil ausdrücklich erlaubt, sichtbar an Plan/Grant gebunden; native Vertragsunits zuerst Linux23, danach Windows22 bestanden, Quellenbranch gepusht. Keine tatsächliche Jobausführung oder Profilcapability. | Profilquelle in die laufende Strecke übernehmen, Encoding/Prozessgrenzen unter LocalService tatsächlich qualifizieren; ausschließlich vollständiger Antrag und tatsächlicher WebUI-Klick. Maschinen-/Gruppenrichtlinien unverändert. | -| Privilegierte Aktionen | Eigener SYSTEM-Helper nativ installiert und einmal gestartet, Manual/LocalSystem, leere Aktionsliste und Wirkungen/Reboot gesperrt. Die echte LocalService-Agentprobe scheitert derzeit; kein positiver Peer-/Sync-/Wirkungsnachweis. | Fehler ohne Erweiterung der Sicherheitsgrenze diagnostizieren; gegenseitige SID/PID/Binary-/Dateibindung und unabhängigen Sync nativ prüfen. | -| Pakete/Dienste/Logs | Kleines MSI1.0.0 auf der VM erstellt, nur lesend geprüft und nach Download gehasht; keine Installation. Dienst-/Eventlog-/Paketquellen teilweise vorbereitet, keine native Aktionsabnahme. | Unveränderliche Tenantrezepte integrieren; UI-genehmigte MSI-/EXE-Installation/Upgrade/Noop, Dienste und Logs mit unabhängigen Nachbedingungen prüfen. | -| Eventlog-Vertrag | Im separaten Branch `codex/windows-eventlog` fester Application-/Fixtureprovider, authentisierter begrenzter Worker und hashgebundene UI implementiert/geprüft. Lokal238Rust/PG1/Web38 bestanden; nativ Linux24→Windows23 Vertragsunits ohne Skips. Keine Live-API-Abfrage, Runtimeinstallation oder Capabilityaktivierung. | Tatsächlichen LocalService-Provider und ausschließlich WebUI-genehmigten Job samt Grenzen/Fehlern auf dem Windowsgast qualifizieren. | -| Dauerhafte Jobs/Fehlerfälle | Linuxnachweise vorhanden; sie ersetzen keine nativen Windowsnachweise. | Redelivery/ACK-Verlust, Prozessabbruch, Offline/Ablauf/Entzug und Wiederanlauf am tatsächlichen Windows-Jobpfad prüfen. | -| Mischplattform | Windows/Linux sind separat inventarisierbar; noch keine gemischte Skriptabnahme. | AT-15 mit festen Varianten/Zielen, passenden Interpretern und nachvollziehbaren Einzelresultaten. | -| Reboot/Installer | Entwicklungsbuild unsigniert, GNU-Crossbuild; kein MSVC-/signierter Installer-/Windows-Rebootnachweis. | Eigene Abnahmen; kein Windows-Reboot ist durch den bereits ausgeführten Linux-Testreboot autorisiert. | - -Jeder RMM-Job beginnt als persistenter Antrag `pending_approval`, ohne Jobs, -Outbox oder Startgrants. Nur die tatsächliche interaktive WebUI-Genehmigung -aktiviert den unveränderlichen Plan. Die bestehende sichtbare dev/test-Simulation -bleibt separat auditiert und ist kein Produktionsfreigabenachweis. -Bootstrapwartung an eigenen Agentdateien und Lesen gespeicherter Daten erzeugen -keine RMM-Ausführungsberechtigung. Live-Diagnose nicht als Inventar tarnen. - -Quellen und bisherige native Nachweise: -[Windows-Client](../deploy/windows/CLIENT.md), -[MSI-Paketbau](windows-msi-fixture.md), -[Plattformmatrix](platform-support.md), [Implementierungsstand](implementation-status.md). diff --git a/docs/windows-general-script-acceptance.md b/docs/windows-general-script-acceptance.md deleted file mode 100644 index 8f8dd10..0000000 --- a/docs/windows-general-script-acceptance.md +++ /dev/null @@ -1,119 +0,0 @@ -# Allgemeiner PowerShell-Auftrag auf der Windows-VM - -16. November 2026. Der erste allgemeine mehrzeilige PowerShell-Auftrag nach -Beendigung des festen Echo-Testbetriebs ist auf dem tatsächlichen Windowsgast -erfolgreich ausgeführt. Dies ist eine Entwicklungsabnahme mit sichtbar -simuliertem WebUI-Testprincipal, kein Produktions-Freigabenachweis. - -## Tatsächliche Strecke - -Die historienerhaltende Wiederherstellung von Verbindung 205 war zuvor -abgeschlossen. Danach wurden beide korrigierten Releaseprogramme installiert: -Agent `d6302aa0503afeb61d1c024d1cb32aea913d51234fd34e692a4b79381f1a9e4f`, -Helper `0502d6c87bd74c99f1665f3cc4b9d74b8e31d0f829d2ce1a1597d72e9be1e726`. -Der Fall `a217415b-875b-4687-bf87-147cdaf67ab8` erhielt Geräteidentität, -Schlüssel, Journale und deren Dateikennungen. Beide Programme starteten zunächst -passiv; Zeitprofilrevision 7 hat Hash -`04cc3b58ab233715fa0abf118b8af6a5518fe3fcee7a5b6a7c79e09b19495d28`. -Die zwei ersten signierten Zeitbeobachtungen stammen von getrennten Rollen, -Anfragen und Verifiern unter Verbindung 207. Anschließend wurde die zuvor -bereits genehmigte aktive Konfiguration bytegleich wiederhergestellt -(`5cd4cb9802d0dd20b961de7e3cd4e5874a1e9a72fc57b577e075e2d2918baac6`), -der alte Agentprozess nachweislich beendet und nur der Agent neu gestartet. -Helper PID 10052 blieb erhalten, neuer Agent PID 9084, Verbindung 208. -Der normale signierte Abgleich wurde bereit: lokaler Commit vorhanden, -Helperbestätigung nicht ausstehend; unabhängige authentisierte Helperprobe -bestätigte seine eigene qualifizierte Uhr. Privilegierte Wirkungen bleiben -bis zum eigenen SYSTEM-Bootstrap geschlossen. - -MCP plante und beantragte den festen Auftrag: - -- Operation `4968dc99-54f0-4383-a24f-19e34be36395`; -- Plan `bc26f431-777d-47a0-89af-9031849986dd`, Hash - `d40190dee2cd0b76a86022bd0fa4270a5b49dad59be2c5b25fe5368883ff3f16`; -- Job `5f1ffef4-2bb6-4c7e-a3a0-fb619144b4f8`, Versuch - `ebb387cf-ebb1-4609-a318-32f44d774d11`. - -Vor dem tatsächlichen Browserklick: `pending_approval`, **null Jobs, null -Outbox, null Startgrants**. Die Browserbedienung prüfte die gespeicherten -Planbytes und Skripthashes, feste Zielidentität, Rechte, Grenzen und Fristen, -öffnete die Planansicht und bestätigte die ausdrückliche Checkbox und den -sichtbar simulierten Genehmigungsbutton. Kein direkter API-/DB-Freigabeaufruf. - -Das Skript enthielt bereits vor der Hashbildung ein ausdrücklich genehmigtes -UTF-8-BOM, die Zeichenfolge `Grüße`, eine Codepointprüfung und die tatsächliche -Windowsidentität. Skripthash: -`dae890f8e78143e381cddbcd6dd74177045fcdf890845cc7f30ec7a9ac4857a3`. -Die Datei wurde nach Genehmigung nicht umgeschrieben oder normalisiert. -PowerShell 5.1 führte sie mit RemoteSigned ausschließlich für den Jobprozess -aus. Maschinen-, CurrentUser- und Gruppenrichtlinien wurden nicht verändert. - -## Ergebnis - -Der ursprüngliche Job endete `succeeded`, Revision 2, Exit 0, leeres stderr, -keine Ausgabekürzung und keine Neustartanforderung. Exakte Ausgabe mit CRLF: - -```text -Windows-MVP: allgemeine Skriptwartung -Unicode:252 -S-1-5-19 -``` - -Die Unicodeprobe belegt den korrekt gelesenen Codepoint des `ü` aus dem -BOM-gebundenen Skript. Die ausgegebene Prüfausgabe ist ASCII; dies behauptet -keine automatische UTF-8-Umwandlung beliebiger nativer PowerShell-Ausgabe. -Der tatsächlich gespeicherte Nachweis nennt LocalService-SID 19, -`powershell_51_remote_signed`, Prozessumfang und bestandene Nachbedingungen. - -Die separate zentrale Nachlese bestätigte genau einen Job, eine Outbox und -einen ursprünglichen Startgrant `cc09285a-2fa2-4d05-9836-50e74eb70c82`, -keine offenen Wirkungen. Audit: `simulated-testprincipal-a`, -`approval_origin=dev_test_browser_simulation`, `testsimulation=true` und -Bindung an denselben Planhash. Neue Versuche oder geänderte Inhalte sind -hierdurch weiterhin nicht genehmigt. - -## Grenzen und ergänzte Prüfung - -Die eigentliche Ausführung und das zentrale Ergebnis sind nachgewiesen. -Eine separate native lesende Journalprüfung für ursprünglichen Einzelverbrauch, -Start-/Outcomebytes und Permit-Signatur wird als eigener Beleg ergänzt. -Der reine Prüfer enthält keine Ausführung oder schreibende SQLite-Verbindung; -ein historischer Zeitpunkt wird nur zur Prüfung des gespeicherten Startbelegs -verwendet und kann keine heutige Starterlaubnis erzeugen. - -Ein erster zusätzlicher Zeitdateileser verwendete einen nicht vorhandenen -Readerpfad und brach vor jeder Wirkung ab. Der korrigierte Aufruf erwartete -neue gespeicherte Samples für den aktiven Modus. Die tatsächliche Quelle -schreibt diese Diagnosefiles ausdrücklich nur im passiven Modus; ihre alten -Beobachtungszeiten wurden weder umgeschrieben noch als Verbindung 208 ausgegeben. -Der aktive Auftrag verwendet seine laufende unabhängige Zeitprüfung und den -regulären signierten Abgleich; die zwei Diagnosefiles sind kein Jobgate. - -SYSTEM-Skripte, SCM/MSI, Zertifikat-Lifecycle, persistenter Helperstart und -vollständige Agent-Selbstupdates bleiben getrennte noch offene MVP-Abnahmen. - -## Unabhängiger nativer Journalzeuge bestanden - -Am 13:25:03 UTC bestand zusätzlich der reine Windows-Leseprüfer -`05440273d55a15911b01a2537bebbd260b60df5a43681a7f0e4fe5d17fdeb479` -mit Exit 0. Der Prüfer öffnete die **vorhandenen** beiden Datenbanken -read-only und bestätigte genau einen ursprünglichen Verbrauch, einen -Startzeugen und ein abgeschlossenes Outcome für genau denselben -Job/Versuch/Grant. `consumed.result` und der ursprüngliche Outcomebeleg -sind bytegleich. Das Agentjournal enthält genau diesen erfolgreichen -ursprünglichen Versuch, nicht einen Ersatzversuch. - -Die ursprüngliche Permit-Signatur und alle Bindungen wurden mit dem -vorhandenen öffentlichen Binding gegen den gespeicherten Reservierungszeitpunkt -**13:08:32.945728400 UTC** geprüft. Das ist ausschließlich historische -Belegprüfung; kein heutiger Grant, keine abgelaufene Ausführung und keine -Wirkung des Prüfers. Das unveränderte genehmigte BOM-Skript, exakte Ausgabe, -Exit 0 und SID 19 stimmen unabhängig mit dem zentralen Ergebnis überein. -[Plan-/Audit-/Byte-/Build- und native Ergebnisbindung](evidence/windows-general-script-20261116.json). - -Der Prüfer wurde im gepinnten Builder ohne Netzwerk aus einer separaten -öffentlichen SDK-Quellkopie gebaut; Clippy mit `-D warnings` bestand. -Vorherige lokale Aufrufe korrigierten den vom Login-Shell-Start zurückgesetzten -Builder-PATH und einen mit ausgegebenen rustfmt-Dateikopf. Diese fehlgeschlagenen -Buildvorbereitungen führten keine Windows-Datei oder RMM-Wirkung aus; erst -nach bestandenem Build wurde der Prüfer auf dem Gast gestartet. diff --git a/docs/windows-helper-apply-clock-contract.md b/docs/windows-helper-apply-clock-contract.md deleted file mode 100644 index a9bf549..0000000 --- a/docs/windows-helper-apply-clock-contract.md +++ /dev/null @@ -1,46 +0,0 @@ -# Windows: eigener Zeitbeleg vor Helper-Apply - -Stand 16. November 2026. Implementiert und gezielt nativ geprüft; das neue -Produktpaar wurde für diese Abnahme noch nicht installiert oder gestartet. - -Der SYSTEM-Helper wartet innerhalb desselben authentifizierten ursprünglichen -Apply-Aufrufs **vor** der Anwendung auf seinen eigenen frischen Zeitbeleg und -auf das Erreichen des signierten Ausstellungszeitpunkts. Er wartet höchstens -drei Sekunden. Die ursprüngliche Entscheidungsfrist bleibt unverändert; die -vollständige reguläre Signatur-/Journal-/Clockprüfung folgt danach weiterhin. -Der Client erlaubt für diesen einzelnen Transport acht Sekunden. Eine -unbekannte Antwort erlaubt keine erneute Übertragung oder Ausführung. - -Die gemeinsame Produktionsfunktion `wait_for_helper_apply_clock` wurde zuerst -auf der echten Linux-Cloud-VM und anschließend mit denselben drei ausgewählten -Units auf der Windows-11-VM ausgeführt: - -| Prüfung | Cloud-Linux | Windows | -|---|---:|---:| -| Eigener Helperbeleg nach fehlendem Beleg und künftigem Ausstellungszeitpunkt | 1 bestanden, 0,04 s | 1 bestanden, 0,04 s | -| Originalfrist erreicht: sofort geschlossen, kein zweites Sample | 1 bestanden, 0,00 s | 1 bestanden, 0,00 s | -| Kein Beleg: nach begrenzten drei Sekunden geschlossen | 1 bestanden, 3,01 s | 1 bestanden, 3,01 s | - -[Linuxbelege](evidence/windows-helper-clock-20261116-linux.json) und -[Windowsbelege](evidence/windows-helper-clock-20261116-windows.json) enthalten -Artefakt-/Quellhashes und die tatsächlichen Ausgaben. Linux lief als UID65534 -mit eigenem Netznamespace und `no_new_privs`. Die Windows-Unitprozesse liefen -als Bootstrap; vor und nach der Gruppe waren beide RMM-Dienste tatsächlich -`Stopped` (12:27:32 und 12:33:07 UTC). Es gab durch diese Units keine Dienste, -Hello-/DB-/TLS-Aufrufe oder Produktjobs. Ein erneuter Upload war zuvor wegen -des bereits vorhandenen identischen Artefakts vor jedem Teststart verweigert -worden; danach wurde ausschließlich dessen hashgeprüfte vorhandene Datei -verwendet. - -Diese Tests verwenden kontrollierte Clockantworten und beweisen die begrenzte -Produktwarteschleife, **keinen** realen signierten Zeitvergleich. Tatsächliche -Rollen-/Zeitprüfung und regulärer Abgleich des neuen Agent-/Helperpaars stehen -nach dessen gesonderter Installation noch aus. Strenges Windows-GNU-Clippy -für alle Targets und der isolierte Releasebuild waren erfolgreich. - -Eine normale Apply-Ablehnung hinterlässt künftig höchstens eine begrenzte, -statische Datei `apply-last-error.json` im bereits geschützten Helperstate. -Sie enthält keine Anfrage-, Skript- oder Schlüsselbytes und fließt nie in -Bereitschaft oder Wiederherstellung ein. Der Schutz ersetzt keine allgemeine -Heilung divergierender Journalphasen: ein tatsächlicher längerer Zeitverlust -kann weiterhin einen geschlossenen administrativen Abschluss erfordern. diff --git a/docs/windows-helper-peer-controls.md b/docs/windows-helper-peer-controls.md deleted file mode 100644 index db4baa3..0000000 --- a/docs/windows-helper-peer-controls.md +++ /dev/null @@ -1,217 +0,0 @@ -# Read-only Helper-Peer-Kontrollen und SDK-Diagnose - -Stand 2026-11-14: **Implementiert, lokal gebaut und quellgeprüft; native -Vorbereitung, Administrator- und fremde LocalService-Kontrolle bestanden.** Die positive Verbindung -des tatsächlichen Agenten ist weiterhin offen: der laufende Agent schrieb nur -`HELPER_NOT_AVAILABLE`. Ein laufender SYSTEM-Helper allein belegt keine -funktionierende gegenseitige Peerprüfung. Der neue Kontrollbuild ersetzt weder -die alte native 21+6-Unitqualifikation noch eine positive Agent-Pipeabnahme. - -Der neue `helper_peer_controls.py` bindet 60 vollständige Build-/Runnerquellen -und erstellt einen eigenen Manifest. Windows-GNU-Alltargets-Clippy mit -`-D warnings`, Release-Link, vier lokale Reporting-/Create-once-Guards und -PowerShell-Parser einschließlich des gemeinsamen speicherinternen Guards -bestanden. Der qualifizierte lokale -Fall ist `build-40f9d096-8532-45a3-b362-62b4983569bc`; sein EXE-SHA256 lautet -`c25243ff6af4d06c578840c929788d74657377a520b856a7fd96791e52bf406e`. -Der native Kontrollfall ist `603c2f9d-a2aa-42cb-b113-ad484cac5b7a`. -Vier tatsächliche Windows-PowerShell5.1-Speicherproben der verwendeten ACL- -Konstruktoren bestanden mit exakten Masken. Die anschließende Vorbereitung -erstellte nur den geschützten eigenen Kontrollfall; keine RMM-Wirkung. -Die Administratorkontrolle (PID9520, echte aktivierte Administratorgruppe, -keine Agent-Service-SID) erhielt beim rohen Pipeöffnen `ACCESS_DENIED`5. -Sie hat keinen SDK-Selbstcheck benutzt. Originale Agent-/Helperprozesse5140/6240, -Konfiguration, Schlüsselmetadaten, private Helperdateimetadaten, Serverflags und -Jobzähler blieben erhalten: Windows0/0/0/0, Linux30/30/26/0. -Die anschließende LocalService-Kontrolle (PID9064, User-SID19, eigene aktivierte -Service-SID, weder Agent-Service-SID noch Administratorrolle) erhielt ebenfalls -beim rohen Pipeöffnen `ACCESS_DENIED`5. Ihr eigener temporärer Manual-Dienst -wurde nach beobachtetem Stopped und dauerhaftem Cleanupintent entfernt. -Originalprozesse/-dateimetadaten und beide Jobzähler erneut unverändert geprüft. -Die Parentdiagnose wurde danach tatsächlich ausgeführt und blieb **unvollständig**: -eigener SYSTEM-Controller PID9060, `CONTROL_ORIGINAL_AGENT_BIRTH`, vor -Token-Duplikation und Childstart. Der gestoppte eigene Parentdienst wurde entfernt; -Originalprozesse/-metadaten und Jobzähler blieben erhalten. Kein Child-/SDK-Ergebnis -und kein tatsächlicher atomarer Childspawn-Nachweis aus diesem Versuch. - -Eine separate Nur-Lese-Probe belegte die Präzisionsdifferenz: Der CIM-Wert für -Agent5140 war `134390970107200320`, der echte verwaltete Prozesswert -`134390970107200328`; für Helper6240 betrug die Differenz einen100ns-Tick. -Beide Prozesse liefen weiterhin. Die ursprüngliche CIM-Abbildung hatte die -zusätzlichen100ns-Stellen nicht erhalten. Die Korrektur verwendet deshalb den -exakten Prozesswert statt einer Toleranz oder eines entfernten Sicherheitschecks. -Microsofts [.NET-Framework-Referenzquelle](https://github.com/microsoft/referencesource/blob/main/System/services/monitoring/system/diagnosticts/Process.cs) -führt `Process.StartTime` über `GetProcessTimes` und `DateTime.FromFileTime`; -das ist dieselbe Win32-Zeitquelle wie die unveränderte native Rustprüfung. -Der neue korrigierte Parentfall `00703dab-51c9-4275-84cb-270ff9917aa7` wurde -anschließend mit Manifest `build-869a999c…` und Kontrollartefakt `35dea018…` -tatsächlich ausgeführt. SYSTEM-Parent8256 erzeugte den festen Child7360 mit -dupliziertem Agent-PRIMARYtoken; tatsächliche atomare Jobmitgliedschaft vor -Resume bestätigt, Child beendet/Exit0, Originalagent5140 unverändert. -Admin-/SYSTEM-Controllerbelege blieben von Agent-/Childaussagen getrennt. -Die60 Buildquellen wurden zusätzlich als gehashter privater Snapshot erhalten; -der darin enthaltene vorbereitete Runtime-SCM-Pfad ist ausdrücklich keine -native Runtime-/Jobqualifikation und hat einen separat dokumentierten offenen -Reviewblocker. Das Kontrollprogramm führt diesen Aktionspfad nicht aus. - -Unter tatsächlicher SID19 und aktivierter Agent-Service-SID bestanden alle fünf -SDK-Vorprüfungen: eigener Token, öffentliche Root-/Pin-ACL, Helper-SCM-Konfiguration/ -Status, Helperprozess-/Tokenquery und Helperimage-/Parent-ACL/-hash. Die eigentliche -Probe erhielt nach18ms keine Antwort und `HELPER_PIPE_IO`. Der Child hat bewusst -einen anderen PID und ein anderes Image; dieses Ergebnis bleibt diagnostisch und -ist weder eine nachgewiesene konkrete serverseitige Ablehnung noch eine positive -Verbindung des echten Agenten. Der Parentdienst wurde nach Stopped entfernt, -ursprüngliche Prozesse/-metadaten, Policies und Windows-/Linuxjobzähler erhalten. -Der alte Parentfehler bleibt fehlgeschlagen. Die Ursache der tatsächlichen -Agentverbindung ist weiter offen. - -Der zusätzliche direkte Peerproof-Fall `d792c4c6-1fd6-4a7f-be3f-1c8e515a68e6` -bestand danach mit Manifest `build-f85a85ab…`, EXE `0a7259bf…` und ursprünglichem -Runner `27feeb82…`. Der eigene SYSTEM-Parent3992 führte den unveränderten -produktiven `PeerProof::for_service` gegen Agent5140 aus: tatsächlicher -LocalService-Token mit Agent-Service-SID, Startzeit `134390970107200328`, -Imagehash `2beed7fa…`, SCM- und gehaltene Datei-/Prozessprüfungen bestanden -in20ms. Kein Pipeaufruf, Child, Token-Duplikat oder ACLwechsel. Das ist ein -positiver direkter Prozessbeleg, weiterhin **keine positive Agent-Pipeabnahme**. -Der eigene Parentdienst wurde nach Stopped entfernt; Originalprozesse, -Metadaten, Policies und beide Jobzähler blieben erhalten. - -Der erste SSH-Aufruf dieses Falls verlor nach90s seine Antwort. Readback und -zusätzliche Nur-Lese-Prüfung belegten noch keinen `parent-start-intent.json`, -keinen eigenen Dienst und keine Ergebnisdateien. Erst nach dauerhaftem lokalen -Fortsetzungsintent wurde die noch nicht erreichte erste Startphase im selben -Fall fortgesetzt; ein zusätzlicher entfernter CreateNew-Intent und der bestehende -CreateNew-Startmarker verhindern zwei Starts. Der alte Timeout bleibt erhalten. -Die private Ergänzungsreceipt heißt `first-parent-continuation-result.json`. -Eine frische tatsächliche produktive Agentprobe um05:16UTC blieb zuvor -`HELPER_NOT_AVAILABLE`; weder diese noch der diagnostische Childfehler werden -durch den direkten Peerproof zu Erfolgen umgedeutet. - -Der frühere Fall `4a60d264…` bleibt vor jedem Kontrolldienststart fehlgeschlagen. -Nach einem verlorenen SSH-Reply bei der Stagingprüfung wurden ausschließlich -die bereits übertragenen Hashes und das Fehlen eines entfernten Kontrollfalls -gelesen. Erst dann wurde die noch nicht erreichte erste Fallvorbereitung -fortgesetzt. Diese scheiterte beim ACL-Konstruktor: Ein leerer PowerShell- -`if`-Zweig ergab `$null`, Arrayaddition erzeugte einen Null-SID-Eintrag für das -Controllerverzeichnis. Exakte speicherinterne Windows5-Proben reproduzierten -den Fehler; allgemeine/nestende Konstruktoraufrufe ohne diesen Nulleintrag -bestanden. Der Fix normalisiert ausschließlich leere Collections und verweigert -weiterhin ungültige einzelne SIDs. Alter Teilfall und alte Artefakte bleiben -erhalten; der korrigierte Lauf hat einen neuen Manifest und neuen Fall. - -## Ausschließlich feste interne Probeoperation - -`examples/helper_peer_controls.rs` enthält drei getrennte Kontrollarten: - -1. Ein Bootstrap-Administrator sendet einen **rohen**, gültig gerahmten - `Probe {}`-Call. Der SDK-Selbstcheck wird absichtlich nicht benutzt und daher - niemals als serverseitige Ablehnung gewertet. -2. Ein kurzlebiger eigener Dienst `RmmDiscoveryPeerControl` läuft als - LocalService mit seiner eigenen enabled Service-SID. Der tatsächliche Token - muss User-SID19, seine eigene Service-SID und keine Agent-Service-SID enthalten. - Auch dieser Akteur sendet nur den rohen Probe-Frame. Es werden weder Pin noch - bestehende DACLs gelockert, um ihm eine Verbindung zu ermöglichen. -3. Der ausdrücklich erlaubte eigene SYSTEM-Dienst `RmmDiscoveryPeerParent` - bindet den tatsächlichen laufenden Agenten über festen SCM-Namen, PID, - Prozessgeburtszeit, gehaltenes Prozesshandle und Imagepfad/-hash. Er fordert - ausschließlich ProcessQueryLimited/Synchronize und am Originaltoken - Query/Duplicate an. Ein duplizierter PRIMARYtoken startet nur dieselbe feste - Kontroll-EXE mit `--agent-child `, ohne Shell, freie Argumente, - Profilimport, SeDebug oder eigene Privileg-/DACLänderungen. Die Erzeugung mit - `CreateProcessAsUserW` und `STARTUPINFOEX/JOB_LIST` bindet den Child bereits - atomar an den vorher konfigurierten eigenen Kill-on-close-Job mit genau einem - erlaubten Prozess; es gibt keine nachträgliche Zuweisungslücke. Der dauerhafte - Child-Create-Intent steht vor dem API-Aufruf, die tatsächliche Jobmitgliedschaft - wird vor Resume geprüft. Die API kann ihre notwendigen Privilegien ausschließlich - während dieses Aufrufs am eigenen SYSTEM-Token aktivieren. Nach 20 Sekunden beendet der Controller nur - diesen eigenen Job und prüft den unveränderten Originalagenten erneut. - -Der Child zeichnet die tatsächliche SID19-/Agent-Service-SID-Identität auf. Er -prüft ausschließlich seine eigene SDK-Rolle, die öffentliche Root-/Pin-ACL, -Helper-SCM-QueryConfig/QueryStatus, Helperprozess-/TokenQuery sowie öffentliche -Image-/Parent-ACL und Imagehash. Danach ruft er das unveränderte SDK mit einer -Probe auf. Aufgezeichnet werden nur begrenzte statische SDK-Fehlercodes und -unmittelbar bei den separaten WinAPI-Prechecks gewonnene numerische Fehlercodes. -Keine privaten Tokenhandles, Schlüssel, Agentdateien oder privaten Ledgerbytes -werden gelesen, exportiert oder geloggt. Dies ermöglicht die Eingrenzung eines -fehlgeschlagenen Client-Sicherheitschecks ohne Änderung des tatsächlichen Agenten. -Kontrolle3 bleibt **diagnostic_only**: Ein SDK-Fehler wird nicht zu einer -unbeobachteten serverseitigen Fehlerklasse umbenannt. Jede erhaltene Antwort des -Helpers ist für diesen fremden PID-/Image-Child ein Testfehler. - -## Beweis- und Cleanupgrenzen - -Nur `ACCESS_DENIED` beim Öffnen oder eine geschlossene Pipe nach Kontakt mit der -exakten ursprünglichen Helper-PID gelten bei den rohen Kontrollen als negative -Verbindung. BUSY, Timeout, irgendeine Antwort oder SDK-Selbstverweigerung sind -keine positive Negativabnahme. Die eigene Tokenrolle und der konkrete Fall müssen -zum gespeicherten nativen Ergebnis passen. - -Controllerbelege und Intents liegen in einem ausschließlich für SYSTEM und -Administratoren schreibbaren Unterordner. Die übrigen Fallverzeichnisse sind für -Agent-/Control-SID nur lesbar. Bootstrap erstellt vor dem ersten Akteurstart genau -die festen Ausgabe-Leaves mit SYSTEM-/Admin-Owner: Controlausgaben sind ausschließlich -für die eigene Control-SID, Childausgaben ausschließlich für die tatsächliche -Agent-SID schreibbar. Keine dieser Rollen erhält gegenseitige Writerrechte oder -Directory-Create-Rechte; SID19 kann dadurch kein Owner-WRITE_DAC an selbst erzeugten -Reports erlangen. Native Ausgabe öffnet nur den vorerstellten leeren Leaf, validiert -seinen Pin und überschreibt keinen vorhandenen Beleg. Readback prüft Owner und -exakte Writerrolle vor dem JSONlesen und benennt Childausgaben ausdrücklich als -`agent_token_assertion`, niemals als unabhängigen SYSTEM-Beweis. - -Der Runner vergleicht vor und nach jedem Schritt ursprüngliche Agent-/Helper-PID, -Prozessgeburt, Konto, Image, Konfiguration und öffentliche Helperpin-/Policyhashes. -Private Helperdateien und der Geräteschlüssel werden nur anhand ihrer Metadaten -verglichen; es erfolgt keine Zeilenabfrage des privaten Helperledgers. Windows- -und Linux-Jobzähler sowie Serverflags müssen unverändert bleiben. Policyallowlist -bleibt leer, `enable_effects=false`, `allow_reboot=false`, Uhr und Fähigkeiten -bleiben geschlossen. Es gibt keinen Execute-, Snapshot- oder Applyaufruf und -keinen SCM-Fixturejob. - -Vor jeder nativen Phase steht lokal und remote ein create-only Intent. Ein -verlorener SSH-Ausgang erlaubt ausschließlich `readback --id `. -Der Runner wiederholt keinen Dienst-/Childstart. `readback` liest ausschließlich; -es erzeugt remote keine Intents, ACLänderungen oder Dienstlöschungen. Nur als Teil -der Startphase oder durch die gesonderte explizite `cleanup`-Phase löscht der Runner -seine eigenen exakt gebundenen bereits gestoppten Testdienste nach dauerhaftem Cleanupintent; -bestehende Agent-/Helperdienste werden nicht gestoppt, neu gestartet oder verändert. -Aktive Testdienste werden nach dem begrenzten Readbackfenster erhalten und -explizit als unvollständig gemeldet. - -Die fünf Sekunden begrenzen Pipe-Frame-I/O; synchrone SCM-/Datei-/Tokenabfragen -haben dadurch keine harte Gesamtlaufzeitgrenze. Der Child hat den genannten -separaten Prozess-Job; für einen im synchronen Vorlauf hängenden temporären -SYSTEM-Elterndienst ist gegebenenfalls ein eigener, eng geprüfter Cleanupschritt -nötig. Diese Grenze darf nicht als nachgewiesener harter Diensttimeout oder als -vollständig abgeschlossene native Abnahme dargestellt werden. - -Geplant, **nicht ausgeführt**: eigener neuer `prepare --manifest … --helper-case …` -und anschließend die getrennten Phasen `admin`, `service`, `parent` mit derselben -Kontrollfall-ID. Der bestehende tatsächliche Helperfall, aktuelle Runtimeindex -und deren Hashes sind Pflicht; der Runner übernimmt keine fremden PID-/Imagewerte. -Root führt diese Phasen erst nach unabhängigem Review aus. Die -WebUI-Genehmigungsgrenze bleibt für sämtliche tatsächlichen RMM-Jobs unverändert. - -Die atomare Jobliste und ihre Handlelebensdauer folgen -[UpdateProcThreadAttribute](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-updateprocthreadattribute); -Form und Aufrufflag folgen -[STARTUPINFOEXW](https://learn.microsoft.com/en-us/windows/win32/api/winbase/ns-winbase-startupinfoexw) -und [CreateProcessAsUserW](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-createprocessasuserw). -Die vorherige ungestartete Kontrollversion mit nachträglicher Jobzuweisung bleibt -historisch erhalten und ist für die native Parentphase nicht freigegeben. - -Die erste tatsächliche Prepare-Ausführung des vorherigen Quellstands stoppte im -Fall `4a60d264…` vor jedem SCM-/Kontrollstart. Die unabhängige WindowsPS5- -Speicherprobe reproduzierte den konkreten Fehler: `else {@()}` lieferte bei der -Controller-Verzeichnis-Leserliste `$null`; Array-Plus fügte daraus eine dritte, -ungültige Null-SID nach SYSTEM/Administratoren an. Der allgemeine Fünfargument- -Konstruktor und auch die verschachtelte SID-Konstruktion bestanden separat alle -sechs Rollen-/Inheritancekombinationen und sind keine nachgewiesene Ursache. - -Der neue Quellstand normalisiert nur Null-**Collections** vor der Identitätsliste -zu leeren Arrays; einzelne ungültige SIDwerte werden weiterhin verweigert. -`Protect` und der speicherinterne Guard benutzen dieselben `ControlIdentities`- -und typisierten `ControlRule`-Funktionen. Der echte lokale pwsh7-Test mit leerer -IF-Pipeline bestand; die reine WindowsPS5-Konstruktorphase `memory-guard` ist für -Root vorbereitet, noch kein behauptetes natives Ergebnis. Der alte partielle -Fall bleibt erhalten und wird nicht mit geänderter Quelle erneut vorbereitet. diff --git a/docs/windows-helper-pipe-drain.md b/docs/windows-helper-pipe-drain.md index d1c2eaa..560bd8e 100644 --- a/docs/windows-helper-pipe-drain.md +++ b/docs/windows-helper-pipe-drain.md @@ -1,112 +1,5 @@ -# Windows Helper: begrenzte Transportbestätigung +# Transportbestätigung zwischen Windows-Agent und SYSTEM-Helper -Dieser Schnitt ist im isolierten Zweig `codex/windows-pipe-drain` implementiert. -Eine native Ausführung des neuen Framings und ein Komponentenupgrade sind noch -nicht nachgewiesen. Die bestehenden Nachweise des Agenten `89004ad3…` und Helpers -`e6aacbdd…` bleiben historische Belege ihres ursprünglichen Framings. +Für einen SYSTEM-Auftrag kommunizieren der Agentendienst und der lokale Helper über die Named Pipe `\\.\pipe\RustDiscovery-System-v2`. Beide Seiten prüfen ihren Kommunikationspartner. Ein Frame enthält das Kennzeichen `RDPIPC02`, die Länge und die JSON-Nutzdaten. Der Agent bestätigt die vollständig gelesene und geprüfte Antwort mit einer Quittung, die an die Challenge und die genauen Antwortbytes gebunden ist. Der Helper prüft die Quittung vor dem regulären Trennen der Pipe. [Transport und lokale Tests](../crates/agent-windows/src/helper_ipc.rs) -## Anlass und Beleggrenze - -Beim tatsächlichen Agenten wurde `client_read_reply / HELPER_PIPE_IO / 233` -beobachtet; die Helperdiagnose war nicht vorhanden. Der bisherige Dienst rief -auch nach erfolgreichem Schreiben der Antwort sofort `DisconnectNamedPipe` auf. -Microsoft dokumentiert, dass dabei ungelesene Pipebytes verworfen werden. Das -ist ein konkreter möglicher Fehlerpfad, aber kein Nachweis, dass genau dieser -Pfad die beobachtete Störung verursacht hat. -[DisconnectNamedPipe](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-disconnectnamedpipe) - -Eine fehlende Diagnose beweist weder einen erfolgreichen Peercheck noch eine -bestimmte Ablehnung: strukturierte `Denied`-Antworten erzeugen keinen privaten -Pipefehlerbeleg, Connect-Leerlauf kann ohne Beleg enden, und das begrenzte -Diagnoseschreiben selbst kann fehlschlagen. Diese Pfade werden hier nicht -umgedeutet oder gelockert. - -## Framing v2 und Reihenfolge - -Agent und Helper verwenden ausschließlich `\\.\pipe\RustDiscovery-System-v2`. -Jeder JSON-Frame beginnt mit acht ASCIIbytes `RDPIPC02`, gefolgt von vier Bytes -Länge in Big Endian und den bisherigen, maximal 1 MiB großen JSONbytes. -V1 und V2 haben unterschiedliche Endpunkte; zusätzlich verweigert der V2-Parser -alte oder fremde Framingtags. Es gibt keinen stillen Fallback. Beide EXEs müssen -als gemeinsam qualifiziertes, gegenseitig gepinntes Paar bereitgestellt werden. -Die JSONschemas von Call/Reply, `helper.system.v1`, Systempolicy-Schema 1 und -RMM-Jobbytes ändern sich nicht. - -Nach dem vollständigen Lesen der Antwort prüft der Agent weiterhin den tatsächlichen -Helperprozess, Schema, Challenge, Enrollmentbindung, Policyhash, Helperbinaryhash -und die Operation/Antwort-Zuordnung. Erst danach schreibt er genau 56 Bytes: -`RDPACK02` (8), ursprüngliche UUID-Challenge in UUID-Bytefolge (16), SHA-256 der -**exakt empfangenen JSON-Antwortbytes** (32). Es findet keine Re-Serialisierung -für diese Prüfsumme statt. Auch eine vollständig geprüfte `Denied`-Antwort wird -so transportseitig bestätigt, ohne sie in einen Erfolg umzuwandeln. - -Der Helper prüft denselben bereits authentifizierten Peer vor dem Schreiben und -nach dem Lesen der Bestätigung. Schreiben, Empfang und Prüfung der Bestätigung -teilen dieselbe bisherige Antwortdeadline von fünf Sekunden; der Client behält -seine bisherige Gesamtdeadline. Erst danach trennt die Dienstschleife die Pipe. -Fehlende, falsche oder verspätete Bestätigung schließt den bestehenden Syncgate -und trennt die Verbindung über den bisherigen Fehlerpfad; statische Diagnosen -unterscheiden `server_drain_receipt` und `client_drain_receipt`. Es gibt keinen -weiteren Aufruf, Retry oder erneute Ausführung. - -Diese Bestätigung bestätigt nur den Empfang der Antwortbytes. Sie ist kein -JobResult-, Journal-, SignedSync-, Grant-, Freigabe- oder Wirkungsbeleg und löscht -keinen dauerhaften Zustand. Ein bereits ausgeführter Auftrag wird durch einen -fehlenden Transport-ACK nicht zurückgenommen oder wiederholt. - -`FlushFileBuffers` wird nicht verwendet: dieser synchrone Pipeaufruf wartet laut -Microsoft bis zum Lesen aller gepufferten Daten und bietet hier keine passende -begrenzte Warteoperation. -[FlushFileBuffers](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers) - -## Prüfung und verbleibender nativer Nachweis - -Die bestehenden IPC-Codecfälle prüfen zusätzlich fremde/alte Frameversionen, -begrenzte Längen sowie manipulierte ACK-Tags, Challenge und Prüfsumme. Eine andere -JSON-Bytefolge mit gleichem JSON-Inhalt darf den ursprünglichen Frame nicht -bestätigen. Die bestehenden Unitfallzahlen bleiben dadurch unverändert. -Lokale Qualifikation wird separat in einem geschützten `devstate/`-Beleg mit -Quellen- und Artefakthashes erfasst. Cross-Clippy und Linken sind kein nativer -Pipebeleg. Vor einem Zielupgrade sind unabhängiger Quellreview, die nativen -Windows-Units des gleichen Manifests und ein eigener erhaltender Paarupgrade mit -explizitem Backup sowie anschließendem tatsächlichen Agent/Helper-Austausch -notwendig. Alle Produktgates bleiben geschlossen. - -Lokale Ausführung: Default- und `system-helper`-Clippy für alle Windows-GNU-Targets -mit `-D warnings`, Release-Build beider EXEs und Linken beider Unitprogramme waren -erfolgreich. 61 gebundene Quelldateien blieben vor/nach dem Lauf gleich. Die -bestehenden 23 Library- und 7 Binary-Unitfälle sind weiterhin die **erwartete** -native Liste; hier wurde kein Windows-Testprogramm ausgeführt. Geschützter -Beleg: `devstate/windows-pipe-drain/qualification-1e0f2b22-1e74-41af-b8ed-0a356be054ba/qualification.json`. - -## Separater Build-/Unitrunner - -`deploy/windows/system_pipe_acceptance.py` erstellt einen neuen Pack unter -`devstate/windows-pipe-drain-build/`. Er prüft den unveränderten lokalen -Qualifikationsbeleg samt ursprünglichen Links und verwendet die bereits -bestandenen Clippy-/Release-/Unitlinkschritte wieder. Nur die fehlenden beiden -Release-Stateprobes werden ergänzt. Alle sechs Auslieferungsdateien erhalten -eine unveränderte `.linked`-Kopie; ausschließlich die Unit-Auslieferungskopien -werden von Debuginformationen befreit. Neue Quellen einschließlich Runner, -Compilerimage, Cargo-/Protoinputs und tatsächlich verwendeter Bootstrapmodule -sind vor/nach dem Build gebunden. - -`--access-root` muss der ursprüngliche Hauptcheckout sein. Nur dort werden die -vorhandenen geschützten Zugangskonfigurationen für den bereits gepinnten -Bootstraptransport und die tatsächlichen Linux-80-/Windows-58-Corebelege gelesen. -Es werden keine Zugangsdaten oder Main-`devstate`-Bäume kopiert oder verlinkt. -Neue Build-, Upload- und Unitfallbelege gehören zum isolierten Pipeworktree. - -Der Native-Unitfall verwendet den neuen Namespace `native-pipe-v2`. **Beide** -vollständigen nativen Listen müssen exakt den erwarteten 23 Library- und 7 -Binary-Namen entsprechen, bevor irgendein Unitfall ausgeführt wird. Intent, -Listen, Start und einzelne Testergebnisse werden create-only gespeichert. -Nach einem Antwortverlust darf ausschließlich derselbe Fall gelesen werden; -auch ein fehlender oder unvollständiger Fall löst keinen erneuten Start aus. -Die Units laufen als Bootstrapadministrator, nicht als Produkt-LocalService, -und beweisen keinen tatsächlichen Pipeaustausch. Zentral gespeicherte -Gerätezähler und geschlossene Fault-/Policyflags werden vor/nach verglichen. - -Der bestehende rohe `helper_peer_controls::raw`-Probe schreibt weiterhin einen -V1-Header. Sein Ablehnungsresultat ist deshalb **kein** V2-Peernegativnachweis; -Runner und Manifest behaupten ausdrücklich keine solche Qualifikation. +Für die Freigabe und das Ergebnis eines Skripts zählen der signierte Auftrag, der feste Versuch und das gespeicherte Ausführungsergebnis. Die Pipe-Quittung bestätigt den lokalen Transport. Die [Windows-Betriebsanleitung](../deploy/windows/README.md) beschreibt die Einrichtung des Helpers. Der [native SYSTEM-Dateitest](evidence/mcp-scoped-script-requests-20261118.json) belegt die Skriptausführung auf der Test-VM. diff --git a/docs/windows-intent-store-preparation.md b/docs/windows-intent-store-preparation.md deleted file mode 100644 index 74b10dd..0000000 --- a/docs/windows-intent-store-preparation.md +++ /dev/null @@ -1,35 +0,0 @@ -# Windows: geschützte leere Intentablage vorbereitet - -Stand2026-11-14. Tatsächlicher Windows-11-Testgast am endgültigen Cloudserver; -Notebook weiterhin ausschließlich Entwicklungsrechner. Dies ist eine eng -begrenzte Vorbereitung eigener Komponenten, keine RMM-Jobausführung. - -Die unabhängig quellgeprüfte Quelle `deploy/windows/system_intent_bootstrap.py` -(SHA256 `7597ac0f3176cc43a2f2d955f38650d74bfdcd6eda898d2221a2842082cfe7bd`) -wurde im neuen Fall `f322a4d2-c537-4842-bf04-658ad8f814b0` einmal ausgeführt. -Anschließender separater Readback bestand ohne neue Remoteänderung. - -Erstellt wurden ausschließlich: - -- `C:\ProgramData\RustDiscoverySystem\agent-intents`, SYSTEM-/Adminbesitz, - Agent-Service-SID nur ReadAndExecute, ohne Anlage-/Löschrecht; -- `system-intents.sqlite` und `system-intents.sqlite-journal`, beide0Bytes, - Adminbesitz, SYSTEM/Administratoren FullControl, tatsächliche Agent-Service-SID - exakt Read/Write/Synchronize (`0x12019f`). Keine Owner-/DACL-/Delete-Rechte. - -Native ACL-/Owner-/Reparseprüfungen und Vorher-/Nachhervergleich bestanden. -Agent5140 und Helper6240, deren Konfiguration und öffentliche Pins sowie private -Helper-/Geräteschlüsselmetadaten blieben erhalten. Keine privaten Schlüssel -gelesen, kein Dienststart/-stop, keine Clock-, Policy- oder Capabilityänderung. -Zentrale Jobzähler und Flags wurden separat gelesen und stimmten mit dem -vorhergehenden Peer-Kontrollbeleg überein: Windows0/0/0/0, Linux30/30/26/0. - -Die privaten unveränderten Rohbelege und `acceptance.json` liegen unter -`devstate/windows-client/system-intent-bootstrap/f322a4d2-c537-4842-bf04-658ad8f814b0/`. -Der ursprüngliche Helper-Bootstrapfall wird nicht überschrieben. - -**Noch offen:** tatsächliche SQLite-PERSIST-/Sharing-/Hotjournalfunktion und -Zugriff unter dem echten Agenttoken. Keine SQLiteinitialisierung oder -synthetischen Grants/Requests in diesen Dateien. Die Dateivorbereitung belegt -keinen SYSTEM-Nichtstart-/Mirror-/Sync- oder Jobpfad. Dessen unveränderte Grenzen -stehen im [Abandonvertrag](windows-system-abandon.md). diff --git a/docs/windows-job-boundary.md b/docs/windows-job-boundary.md deleted file mode 100644 index 28e81af..0000000 --- a/docs/windows-job-boundary.md +++ /dev/null @@ -1,182 +0,0 @@ -# Grenze vor dem ersten Windows-PowerShell-Job - -**Aktueller Vorrang2026-11-15:** Dieser Text enthält den historischen1.15- -Entwurf. Gemeinsamer Jobkern, SYSTEM-Helper/Pipe-v2 und Skriptquellen sind -inzwischen implementiert und teilweise nativ geprüft; der signierte Zeitanker -ist mit1.22 und das aktive KVM-OS-Profil mit1.23 ausdrücklich angenommen. -Der laufende Windowsclient bleibt trotzdem passiv, bis neue Zeit-/Sync-/ -Jobruntimebelege vorliegen. Aktueller Überblick: [windows-gates.md](windows-gates.md), -[Zeitprofil](windows-trusted-os-clock-source.md). Die folgenden Aussagen -„kein Helper“/„Alternative nicht beschlossen“ sind historisch, keine aktuellen -Entscheidungen oder offenen Produktfragen. - -Stand 2026-11-13, Spezifikation **1.15**. Dieses Dokument beschreibt notwendige -Voraussetzungen und offene Nachweise, keine neue Zeitvertrauensentscheidung und -keine Windows-Jobfreigabe. Notebook ausschließlich Entwicklungsrechner; -Windows-11-Testgast als eigenes Gerät, Server `discovery.ease-technologies.de`. -Der abgeschlossene Linux-MVP bleibt eigenständig; diese Planung startet keine -Linux-Jobs. Passive Windows-Nachweise: [Clientstand](../deploy/windows/CLIENT.md), -fortgeführte Foundation-Abnahmen: [Windows-Gates](windows-gates.md). - -## Aktuelle Grenze - -Der Windows-Agent bietet ausschließlich `windows.base/1` und `heartbeat/1` an. -Er besitzt bisher keinen Jobexecutor, Startgrantverbrauch oder privilegierten -Helper und verweigert JobOffers/ExecutionPermits. Implementierte passive -Transportfunktionen sind kein Nachweis ausführbarer Windows-Jobs. - -Auch der erste Hello-Job benötigt einen persistenten Antrag `pending_approval` -und einen unveränderlichen, tatsächlich in der WebUI genehmigten Plan. -Browserautomatisierung darf nur die vorhandene, sichtbar simulierte -dev/test-Grenze bedienen; keine API-/DB-Genehmigung. Vor Genehmigung bleiben -Jobs/Outbox/Startgrants/Wirkung null. Neue Versuche benötigen neue Genehmigung; -Redelivery darf keine zweite Wirkung erzeugen, unklare Wirkung bleibt `unknown`. - -## TrustedClock: belegte Möglichkeiten, offene Qualifikation - -Die Spezifikation verlangt bei unklarer Uhrabweichung `CLOCK_UNTRUSTED`; -Telemetrie darf weiterlaufen. `Utc::now()`, laufender W32Time-Dienst, jüngster -Eventlogeintrag oder ein frischer Grant beweisen keine vertrauenswürdige Uhr. -`GetSystemTimeAdjustmentPrecise` beschreibt Regelungsmodus und Frequenz, keinen -Synchronisierungsstatus: [Microsoft-API](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtimeadjustmentprecise). - -Microsoft dokumentiert für lokales `w32tm` Administratorrechte. Deshalb ist ein -erfolgreicher Administratoraufruf kein Nachweis für den tatsächlichen -LocalService-Agenten. Lokalisierte CLI-Texte sind außerdem kein strukturierter -Produktvertrag: [W32Time-Werkzeuge und Rechte](https://learn.microsoft.com/en-us/windows-server/networking/windows-time-service/Windows-Time-Service-Tools-and-Settings). - -Der dokumentierte strukturierte Weg ist MS-W32T `W32TimeQueryStatus`, Opnum6, -Interface-UUID `8fb6d884-2388-11d0-8c35-00c04fda2795`, Version4.1. Es handelt -sich um einen RPC-/IDL-Vertrag, keinen hier nachgewiesenen einfachen SDK-Import. -`W32TIME_STATUS_INFO` liefert `ulLcState`, `qwLastSyncTicks`, -`tpTimeLastGoodSync`, `toSysPhaseOffset`, `tpRootDispersion`, `nStratum`, -`eLeapIndicator` und `eLastSyncResult`: -[Methode](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/7e80a465-f5f4-4c3c-87ef-12f76e45f8d1), -[Statusstruktur](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/f60ebce0-df96-4c96-b40b-fdbd34a2c936), -[vollständiges IDL](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/5793e908-22ef-4cea-962f-fca8a72c485a). - -`SYNC=2` bezeichnet Synchronisierung; `UNSET`, `HOLD`, `SPIKE` sind kein -gleichwertiger Beleg. Synchronisierungszustand allein garantiert keine bestimmte -Genauigkeit. `TSF_Authenticated` zeigt gesondert die Verwendung der -MS-SNTP-Authentifizierungserweiterung an, nicht bloß einen erfolgreichen lokalen -RPC-Aufruf: -[Zustände](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/b4abb4b0-6d6e-41e4-bd41-d54980d0598a), -[Zeitdienstelemente und Einheiten](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/1da649d7-3edf-4a9a-98c2-907ecacd1633). - -Eine eigene RPC-Anbindung müsste lokal den authentifizierten Endpunkt -`\\PIPE\W32TIME_ALT` verwenden und jede automatische Rückstufung auf das -unauthentifizierte `\\PIPE\W32TIME` verweigern. Der Zugriff unter LocalService -ist **nicht nativ geprüft**: -[Transport](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/e0803f6b-e175-4b87-ba63-bbcf51175655), -[Sicherheitsbetrachtung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-w32t/22d6e8df-0195-476f-8e8e-d81e700f4474). - -### Kleinste Readinessprobe: geplant, nicht ausgeführt - -1. Im tatsächlichen LocalService-Dienst Token-SID und fehlende Elevation prüfen; - keine erfolgreiche Administrator-SSH-Probe als Ersatz verwenden. -2. Ausschließlich einen festen lokalen Statusabruf mit Zeit-/Ausgabelimit - qualifizieren. Keine Resynchronisierung, Clock-/Service-ACL-Änderung oder - zusätzliche Administratorberechtigung. Ein fester CLI-Zugriffsversuch kann - die Rechtefrage eingrenzen, ersetzt aber keinen robusten Statusvertrag. -3. Nur begrenzte numerische Statusfelder/Fehlercodes veröffentlichen; - `unsupported`, `permission_denied` und `unsynchronized` ausdrücklich melden. - Keine Peer-Adressen oder vollständigen Rohdaten veröffentlichen. -4. Vor Jobfähigkeit eine dokumentierte Genauigkeitspolitik implementieren und - nativ prüfen: gültiger Syncstatus, frischer erfolgreicher Abgleich, - begrenzte Dispersion/Phasenabweichung und monotone Wallclock-Abweichung. - Konkrete Grenzwerte sind hier noch nicht beschlossen oder qualifiziert. - Fehler, veraltete Daten oder unbekannte Felder schließen das Startgate. - -Der dokumentierte RPC-Weg ist ein Implementierungskandidat. Ob er mit den -vorhandenen Buildtools und ohne zusätzliche Rechte zuverlässig unter LocalService -verwendbar ist, bleibt offen. Bis zur Qualifikation bleiben Windows-Jobs gesperrt. - -### Signierter Serverzeitanker: Alternative, nicht beschlossen - -Ein kryptografischer Zeitanker wäre ein eigener expliziter Vertrauensvertrag. -Aktuell benötigt bereits `ClientSync.prepare()` eine vertrauenswürdige Uhr; -`verify_response()` prüft ebenfalls die Zeit. Eine signierte Syncantwort darf -diesen Kreis nicht stillschweigend umgehen. `ServerHello` enthält im aktuellen -Protobuf nur Generation und Nachrichtenlimit, obwohl die Spezifikationstabelle -zusätzlich Serverzeit nennt. Weder eine erfundene Hellozeit noch HTTP-`Date` -beheben diese Lücke. - -Ein gegebenenfalls gesondert spezifizierter Zeit-Bootstrap müsste zunächst ohne -Startwirkung bleiben: frische Zufallschallenge, eigener signierter Domain-Tag, -Identitäts-/Generations-/Boot-/Channelbindung, begrenzte monotone Roundtripzeit -und konservatives UTC-Unsicherheitsintervall. Nur wenn das gesamte Intervall im -gültigen Grantstartfenster liegt, wäre ein Start zulässig. Kein Verlängern eines -Grants, kein Wiederverwenden alter Antworten nach Prozess-/Bootwechsel; Suspend -müsste ebenfalls qualifiziert oder der Anker verworfen werden. Rust garantiert -keine plattformübergreifend konstante Suspendbehandlung von `Instant`: -[Rust-Primärdokumentation](https://doc.rust-lang.org/std/time/struct.Instant.html). -Das ist ausdrücklich **keine** implementierte oder genehmigte Clock-Ausnahme. - -## Gemeinsamer Sicherheitskern statt zweiter Sync-State-Machine - -Geplant ist ein kleiner plattformneutraler Kern gemäß der vorgesehenen -`agent-core`-Grenze: `AuthBinding`/`Request` mit unveränderter Serde-Struktur und -Bytekodierung, bestehender `ClientSync` samt Checkpoints, Replay, konkreten ACKs, -Unknown-Behandlung und Gate-Schließung. Unix-Dateischutz, Helper-IPC und -Linux-`NativeClock` bleiben Plattformadapter. `SyncClock` existiert bereits als -Port. Windows darf keine Unix-Helper-Abhängigkeiten oder kopierte abweichende -Sync-State-Machine benötigen. - -Ed25519-Verifikation kann einen kleinen gemeinsamen Verifier-Port erhalten: -Linux zunächst unverändert OpenSSL, Windows das bereits im Lockfile vorhandene -`ed25519-dalek 2.2.0`. Dessen `verify_strict` ist nicht automatisch verhaltensgleich -mit OpenSSL; Regeln für schwache Schlüssel/nichtkanonische Signaturen müssen -bewusst geprüft werden: -[Dalek2.2.0-Verifikation](https://docs.rs/ed25519-dalek/2.2.0/ed25519_dalek/struct.VerifyingKey.html#method.verify_strict). - -Notwendige gezielte Qualifikation, **noch nicht ausgeführt**: Codec-Goldenbytes -vor/nach Extraktion; gültige/manipulierte Permit-/Syncsignaturen mit beiden -Backends einschließlich Grenzfällen; bestehende Sync-Replay-/Checkpoint-Tests -auf gemeinsamem Kern; additive Windows-Journalmigration mit erhaltener Identität, -monotoner Sequenz und bytegleichen unbestätigten Ereignissen. Kein Reset oder -neues Enrollment für den Übergang zum Jobjournal. - -Die derzeitige `telemetry.sqlite` ist noch kein vollständiges Jobjournal. -`crates/agent-windows/src/journal.rs` begrenzt die Queue auf acht Ereignisse mit -je höchstens512KiB, prüft aber noch kein explizites SQLite-`page_size`/ -`max_page_count`. Vor dem Jobport ist zusätzlich das endliche Datenbankbudget -gemäß Spezifikation1.15 zu übernehmen und nativ mit Erhalt von Sequenz, konkreten -ACKs und Datenbank-Geräteidentität zu qualifizieren. Die Queuegrenze allein ist -kein Nachweis eines begrenzten Datenbankfiles; kein Löschen für Platzgewinn. -Diese offene Voraussetzung verändert weder den aktuellen Transportbuild noch -die weiterhin fehlenden Windows-Jobcapabilities. - -## Erste Hello-Strecke: Voraussetzungen vor Capability und Wirkung - -- Domain, Server und WebUI additiv um plattformgebundene Interpreterpläne - ergänzen. Derzeit ist `run_script` auf `posix_sh|bash` beziehungsweise Linux - beschränkt. Windows PowerShell5.1 (`powershell`) und PowerShell7 (`pwsh`) sind - getrennte Fähigkeiten, kein stiller Fallback. Windows-/Linux-Mischungen, - unbekannte Interpreter und fehlende Capability bleiben an allen relevanten - Plan-/Genehmigungs-/Startgrenzen verweigert; bestehende Linuxfälle erhalten. -- Eindeutige Windows-Variante, exakte UTF8-Skriptbytes/Argumente, Hash, - Zielidentität und `agent_service` vor Genehmigung binden. Erst nach echter - Bereitschaft Script-/Interpreter- und `rmm.sync.v1`-Capabilities anbieten; - Clock-, frischer Sync-, Permit- und dauerhafter Einmalverbrauch gemeinsam nötig. -- Tatsächliches LocalService-Token vor Ausführung prüfen. Kein Administrator- - oder SYSTEM-Fallback. Maschinen-/Gruppenrichtlinie, WDAC/AppLocker nicht - abschwächen; keine versteckte `ExecutionPolicy Bypass`-Ausnahme. Der frühere - prozessbezogene Bootstrap-`RemoteSigned`-Aufruf ist keine Jobfreigabe. -- Festen kanonischen PowerShellpfad verwenden, geschützte neu erzeugte `.ps1` - ohne Reparse-Points und strukturierte Argumente. Keine Shellverkettung oder - nachträgliche BOM-/Encoding-/Prologänderung an genehmigten Bytes. WinPS5.1- - Encodingverhalten nativ qualifizieren; die erste ASCII-Hello-Fixture beweist - noch keine beliebige Unicode-Skriptausführung. -- Netzwerk/Heartbeats dürfen nicht am Kindprozess blockieren. Begrenzte parallele - Rohbyteausgabe mit Truncation, Timeout/Cancel und vollständiger Prozessbaum- - Beendigung über qualifiziertes Windows-Job-Object; kein unbeschränktes - `Command.output()` für freien Jobcode. Keine vererbten Gerätekey-/DB-Handles. -- Startverbrauch vor Kindstart dauerhaft speichern, Ergebnis bis konkretem ACK - behalten. Absturz nach möglicher Wirkung bleibt `unknown`, keine automatische - Wiederholung. Der Hello-Nachweis prüft genau seinen gebundenen Exit/Output; - eine dokumentierte CRLF/LF-Textnormalisierung ersetzt keine Rohbyteerhaltung. - -SYSTEM-/NamedPipe-Helper, MSI, Paketverwaltung und Windows-Reboot sind nicht Teil -dieser ersten unprivilegierten Hello-Strecke. Dieses Dokument wurde ausschließlich -aus Quellcode und den verlinkten Primärquellen erstellt; keine Produktänderungen, -Builds, Tests oder VM-/Serverkontakte für diese Planung durchgeführt. diff --git a/docs/windows-kvm-clock-contract-proposal.md b/docs/windows-kvm-clock-contract-proposal.md deleted file mode 100644 index 537e013..0000000 --- a/docs/windows-kvm-clock-contract-proposal.md +++ /dev/null @@ -1,53 +0,0 @@ -# Windows auf KVM: konkreter Zeitvertrag zur Entscheidung - -Stand2026-11-15. **Vom User ausdrücklich angenommen: „Ja, dieses begrenzte Zeitprofil umsetzen“. Normativ Spezifikation1.23; noch nicht nativ aktiviert.** Ergänzt die [Kalibrierungsbewertung](windows-signed-clock-calibration-assessment.md) für die inzwischen identifizierte Plattform. Kein Kalibrierungswert, keine VM-/Konfigurationsänderung und kein Gatewechsel. Der konservative [Frischefix](time-attestation-freshness-results.md) ist ein getrennter bereits implementierter Quellschritt. - -## Bestätigte Plattform und Recherchegrenze - -Root hat mit ausdrücklich erlaubten lesenden Hostabfragen `qemu:///system`, die laufende Domäne `win11-test`, KVM/QEMU6.2.0 und libvirt8.0 bestätigt. Gemeldet sind `pc-q35-6.2`, `host-passthrough` mit `migratable=on`, RTC-Lokalzeitoffset/`catchup`, PIT-`delay`, HPET aus und Hyper-V-Clock an. Die Hyper-V-Konfiguration enthält relaxed/vapic/spinlocks; im XML steht keine VMGenID. Diese Angaben stammen aus Roots tatsächlichem Nachweis, nicht aus einer hier nochmals ausgeführten Hostabfrage. Ganze XML-/VNC-/Schlüsselkonfigurationen wurden hier nicht gelesen. Keine QMP-Abfrage oder zusätzliche VM-Erhebung war für die fehlende numerische Zusicherung nötig. - -## Was die passenden Primärquellen zusichern - -Die **QEMU6.2.0**-Dokumentation beschreibt `hv-time` als Bereitstellung von Hyper-V-Referenzzähler und Reference-TSC-Seite je Gast. Das ist ein Schnittstellen-/Performancevertrag, keine numerische SI-Fehlerschranke. Die dort beschriebene Migration/Re-enlightenment-Unterstützung hängt zusätzlich von TSC-Frequenz/-Skalierung ab. `hv-relaxed` beeinflusst Watchdogverhalten und ist keine Genauigkeitsqualifikation. [QEMU6.2.0, ursprüngliche Hyper-V-Dokumentation](https://raw.githubusercontent.com/qemu/qemu/v6.2.0/docs/hyperv.txt). - -KVMs PVclock-Vertrag definiert Hostmonotonie einschließlich Schlafzeit, Umrechnung aus TSC und optionale Stable-/Pausedflags. Er gibt keinen universellen maximalen relativen Frequenzfehler für diesen Host vor. Er beschreibt zudem eine andere verfügbare Schnittstelle; daraus folgt nicht, welchen internen Pfad Windows tatsächlich für alle drei Precise-Getter gewählt hat. [KVM-MSR-Vertrag](https://docs.kernel.org/virt/kvm/x86/msr.html). - -Die KVM-Zeitvirtualisierungsdokumentation behandelt Hardware-/Frequenz-/Virtualisierungsrisiken und nötige stabile Referenzen. Eine konfigurierte virtuelle Zeitquelle ersetzt keinen konkret belegten numerischen Fehlerbound. [Linux-KVM: Timekeeping Virtualization](https://docs.kernel.org/virt/kvm/x86/timekeeping.html). - -libvirt warnt bei `host-passthrough` vor Migration zwischen unterschiedlichen Plattformen; `migratable=on` beseitigt dieses Risiko ausdrücklich nicht. Timer-Tickpolicies beschreiben den Umgang mit verzögerten Ticks, keine physikalische Genauigkeitsgarantie. [libvirt: CPU model and topology / Time keeping](https://www.libvirt.org/formatdomain.html). - -Die Microsoft-Unterscheidung zwischen OS-Zeitdarstellung, Auflösung und tatsächlicher Frequenzgenauigkeit bleibt damit relevant. Die für Gäste vorausgesetzte korrekte Hypervisorimplementierung ist eine Vertrauensannahme, kein automatisch gewonnener numerischer Kalibrierungswert. [Microsoft: Acquiring high-resolution time stamps](https://learn.microsoft.com/en-us/windows/win32/sysinfo/acquiring-high-resolution-time-stamps). - -**Ergebnis:** Auch dieses konkretisierte Profil liefert keinen harten numerischen `base_error_ns`. Weder „Hyper-V-Clock an“, ein CPU-Featureflag, nominelle Frequenz noch die128 tatsächlichen Roh-Captures rechtfertigen eine erfundene Zahl. Eine weitere QMP-CPU-Modellexpansion könnte Verfügbarkeit beschreiben; sie würde die physikalische Fehlerschranke nicht liefern. Eine Aussage über tatsächlich vorliegende Hardwaregenauigkeit, alle Hostpatches oder den gewählten Windowsinternen Getterpfad wurde hier nicht behauptet. - -## Kleinster expliziter MVP-Vorschlag - -Der bisherige Vertrag bleibt ohne Entscheidung unverändert gesperrt. Für einen praxistauglichen, klar begrenzten MVP wäre als **neue ausdrückliche Produktentscheidung** folgendes Profil möglich: - -> Für diese Windows-KVM-Testumgebung vertraue ich den dokumentierten Windows-Zeit-APIs und einer korrekt laufenden Hardware-/KVM-/QEMU-Zeitbasis als nomineller Intervalluhr. Eine zusätzliche unabhängige physikalische Frequenzkalibrierung ist für dieses Profil keine Voraussetzung. Die tatsächlichen Software-Capturebrackets bleiben begrenzt und werden konservativ gerechnet. Die UTC-Qualifikation kommt weiterhin ausschließlich vom getrennt signierten, tatsächlich qualifizierten Server. Dieses Profil gilt nur im aktiven Betrieb ohne VM-Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend. Solche Betriebsereignisse sind während laufender Agent-/Helperprozesse nicht unterstützt. Vor einem erneuten Betrieb nach einem solchen Ereignis sind beide Prozesse zu beenden und frisch zu starten; eigene neue Challenges und normaler unabhängiger Sync bleiben Pflicht. Keine dieser Maßnahmen erfolgt durch die vorliegende Entscheidung automatisch. - -Diese Zustimmung wäre bewusst **keine Behauptung gemessener physikalischer Genauigkeit**. Der Fehlervertrag würde explizit auf dem Vertrauen in die korrekte nominelle OS-/Hardware-/Hypervisor-Zeitskala beruhen. Das ist eine gegenüber der bisher zusätzlich verlangten unabhängig numerisch qualifizierten Timerschranke geänderte Annahme und braucht die Entscheidung des Users. Eine reine Betriebszusage „kein Suspend“ allein löst den numerischen Nachweis nicht. - -Der genehmigte Plan, WebUI-Genehmigung, unabhängiger SYSTEM-Helper, Geräte-/Tenantbindung, CSPRNG-Nonces, Boot-/Prozess-/Connectionfences, tatsächliche Serverqualität, vollständiges UTC-Intervall, maximale1s/100ms-Frische und50ms-Softwarecapturebudget bleiben erhalten. Ihre physikalische Konservativität wäre ausdrücklich **bedingt durch diese angenommene korrekte OS-Zeitskala**; das Profil darf sie nicht als unabhängig nachgemessene SI-Garantie darstellen. Beobachtete Rückwärts-/Schlaf-/Wallstepdiskontinuitäten bleiben sperrend. Ohne VMGenID wird keine lückenlose automatische Erkennung eines gespeicherten und wiederhergestellten laufenden Gastzustands behauptet. - -## Nötiger enger Implementierungsschnitt nach einer Zustimmung - -Ein solches Profil darf nicht durch Eintragen einer beliebigen positiven Zahl in das heutige `Calibration.base_error_ns` vorgetäuscht werden. Die geschützte Windows-Zeitkonfiguration müsste es als eigenen versionierten Qualifikationsmodus ausweisen, etwa `trusted_os_active_guest`, statt „physikalisch kalibriert“. Rollen-/Imagehash, tatsächliche Plattform-/Rohbelegreferenz und Betriebsannahmen müssen gebunden sein. Die vorhandene Konfiguration darf diesen neuen Modus nicht ohne explizite Version/Opt-in akzeptieren. Es gibt keinen automatischen Producer oder aktuell ausgerechneten Installationswert. - -Unter diesem Modus würde der Code nur die tatsächlich eigenen vollständigen Capturebrackets und exakte ganzzahlige Umrechnung im vertrauten OS-Zählerraum budgetieren; eine nicht nachgewiesene Restunsicherheit dürfte nicht als gemessene Konstante hinzugefügt werden. Das verändert den bisherigen Loadervertrag und benötigt deshalb Quellreview und neue Linux-first-/Windows-Nachweise. Ob und wie ein nachweisbarer diskreter/API-Zuordnungsrest als eigener Term nötig ist, muss dabei gegen den explizit angenommenen OS-API-Vertrag geprüft werden. Eine körperliche Genauigkeit folgt nicht aus100ns-Darstellung. Bis zur Entscheidung und dieser Prüfung wird kein Konfigurationsfile erzeugt und kein Codepfad geöffnet. - -Wer den bisherigen unabhängig numerischen Vertrag beibehalten möchte, braucht stattdessen einen passenden Hersteller-/Plattformfehlervertrag oder eine unabhängige Referenzqualifikation mit ausdrücklich begrenzter Stabilität und Gültigkeit. Dieser Nachweis liegt derzeit weiterhin nicht vor; zusätzliche interne Samples ersetzen ihn nicht. - -## Konkrete Entscheidungsfrage für den User - -„Darf ich für unsere aktive Windows-KVM-Test-VM ein ausdrücklich gekennzeichnetes Profil verwenden, das den dokumentierten Windows-/KVM-Zeit-APIs vertraut und keine unabhängige physikalische Timerkalibrierung behauptet? Pause, Save/Restore, Snapshot-Rückkehr, Migration und Host-Suspend sind dabei mit laufenden Agent-/Helperprozessen nicht unterstützt. Signierter Serververgleich, kurze Fristen, getrennte Helperprüfung und jede WebUI-Jobgenehmigung bleiben bestehen. Erst nach deiner Entscheidung würde ich den engen Profilvertrag implementieren und real abnehmen; aktuell bleibt alles geschlossen.“ - -Tatsächlich ausgeführt wurde in diesem Schritt ausschließlich die Prüfung der passenden Primärquellen und das Erstellen dieses Vorschlags. Keine eigene virsh-/QMP-/VM-Aktion, kein Build, keine Gitaktion und keine Änderung am eingefrorenen passiven Paarcontroller `bea5384c…`. - -## Tatsächliche Entscheidung - -Der User nahm am2026-11-15 die konkret oben beschriebene aktive Variante -ausdrücklich an. Spezifikation1.23 und Projektentscheidungen sind fortgeschrieben. -Die oben stehende Analyse bleibt als Begründung erhalten. Umsetzung, neuer -Loadervertrag und tatsächliche Linux-/Windowsnachweise folgen separat; eine -Zustimmung ist kein gemessener Zeitnachweis und keine RMM-Jobgenehmigung. diff --git a/docs/windows-midl-native-codegen.md b/docs/windows-midl-native-codegen.md deleted file mode 100644 index 456eb37..0000000 --- a/docs/windows-midl-native-codegen.md +++ /dev/null @@ -1,40 +0,0 @@ -# Microsoft-MIDL-Codegen tatsächlich auf der Windows-VM bestanden - -Der separate Bootstrapfall `149bafe2-3469-4580-b133-988812bcc3db` führte -ausschließlich die zwei festen Microsoft-SDK-Codegentools auf der Windows-VM -aus. Keine Installation, kein RPC-Aufruf, keine Produktdienst-/Registry-/PATH- -Änderung und kein RMM-Job. Die originale Quelle -`deploy/windows/midl_codegen.py` bleibt mit SHA256 -`078bf2303979dbeccdb7eb84e116325e7f155146d93d0dc0fff6b3e6bdd1b2eb` -unverändert. - -Vor dem Toolstart wurden beide Dateien tatsächlich nativ zugelassen: -AuthenticodeValid und OnlineChainValid, Microsoftsigner mit Thumbprint -`B835FC295FFB94EA2FCA23B0E9C1EDA3FBA4E07D`, Dateiversion8.1.628.1. -Der Zulassungsbeleg hat SHA256 -`4b10a0639cf8f77f9cf0a9c5031b708fe4d2d73344673fba2eecd92cd0a78cc2`. -Diese vorherige Prüfung führte die Tools noch nicht aus. - -Der anschließende eigene Codegenprozess wurde einmal unter den vorbereiteten -JobObject-/Handle-/Zeit-/Dateigrenzen ausgeführt und meldete `complete=true`. -Danach wurden die vier festen Ausgabedateien separat im selben Fall nur lesend -zurückgelesen, Base64/Länge/SHA geprüft und bytegleich privat gespeichert. -ReadbackSHA256: -`0dc2373825f7f8f224cda04ecd5c521dd3c37a6e712bc3ed83bc4fa6d0d89c8c`. - -| Tatsächliche Datei | Bytes | SHA256 | -|---|---:|---| -| `w32time.h` |3779|`db5dbe5b335eaa58a6512d4abfda44e7273f3aa8a43077dcb0719e4b97ee2bde`| -| `w32time_c.c` |18866|`d806adb431f16724c8afdea0c0751588a4bc6f82b6f0b8391d4d189d6a6f4a38`| -| `stdout.txt` |125|Im privaten vollständigen Readback gebunden; Meldung64Bit-Verarbeitung der festen IDL| -| `stderr.txt` |0|Leere tatsächliche Fehlerausgabe| - -Die erzeugten Dateien bleiben unverändert. Der nächste getrennte Build darf -diese tatsächlichen Microsoftoutputs als explizite hashgebundene Inputs -verwenden. Kein Patch bereits erzeugter OUT_DIR-Dateien, keine erfundenen -RPCNDR-Header-Versionen und keine manuell korrigierten NDR-Bytes. Frühere WIDL- -Kandidaten/1783-Berichte bleiben erhalten. - -Dieser Nachweis qualifiziert ausschließlich den Codegeneratorlauf. Noch keine -erfolgreiche Statusabfrage, TrustedClock-Qualifikation, Systemscriptausführung -oder Windows-MVP-Abnahme. Das Produktgate bleibt `ADAPTER_QUALIFIED=false`. diff --git a/docs/windows-msi-contracts.md b/docs/windows-msi-contracts.md deleted file mode 100644 index 8db42ef..0000000 --- a/docs/windows-msi-contracts.md +++ /dev/null @@ -1,83 +0,0 @@ -# Gemeinsame MSI-Verträge: Linux-first-Unitpack - -Der neue Runner `deploy/windows_msi_contract_acceptance.py` gehört zum isolierten -Worktree `rust-discovery-windows-msi-integration`. Historische M3-, Profil- und -NoStart-Runner sowie ihre ursprünglichen Manifeste bleiben unverändert. - -Dieser Pack prüft gemeinsame Daten-/Autorisierungs-/Ledger-/Syncverträge und die -bestehenden selbstisolierten Unixhelper-Dateiguards. Er installiert kein MSI, -startet keinen RMM-Dienst, verändert keine Produktjournale oder Identitäten und -erzeugt keine Jobs oder Genehmigungen. Insbesondere ist er kein tatsächlicher -SYSTEM-, Clock-, Cache-, Download-, Installer- oder WebUI-Wirkungsnachweis. - -## Exakte Listen und Quellen - -Die zunächst tatsächlich lokal aus den Release-Testprogrammen ermittelten -Linuxlisten enthalten Domain20, Corecontracts8, Helpersync26, Agentsync26 und -Unixhelper21: insgesamt101 Fälle. Der zusätzliche MSI-Corevertrag heißt -`historical_msi_nonstart_keeps_full_signature_binding_and_never_becomes_root_authority`. -Die Windowsliste ist bis zur tatsächlichen nativen Ausgabe ausdrücklich -**erwartet**:20+7+26+26=79. Nur der Unix-OpenSSL-Vergleich und die gesamte -Unixhelper-Dateiguardsuite entfallen dort. Es gibt keine Mindestzahlen oder -Überspringen/Filtern von Fällen zur Erfüllung dieser Zahlen. - -Das Manifest bindet68 Quellen einschließlich vollständiger Domain-/Core-/ -Unixhelper-/Linuxadapterquellen, Cargo-/Protoinputs, eng benötigter Fixtures, -des neuen Runners und seiner Bootstraptransportquellen vor/nach dem Build. -Die13 separat geprüften Domain-/Backend-/SQL-Pins sind exakt an den lokalen -Qualifikationsbeleg `b7bced0a341ffb88af8b584cbe8355ff1021add541004347f609f6136a684b74` -gebunden. Diese Backendpins sind ausschließlich Quellenbindung: der Unitpack -führt weder PostgreSQL noch einen Server aus. Webquellen sind kein Compilerinput -und gehören zum unabhängigen UI-Nachweis ihres Owners. - -## Tatsächlich lokal ausgeführt - -Linux- und Windows-GNU-Clippy der ausgewählten Pakete mit allen Targets und -`-D warnings`, Release-Linken der fünf Linux- und vier Windows-Testprogramme, -Prüfung beider Dateiformate und der unveränderten Original-Links waren erfolgreich. -Alle fünf tatsächlichen Linux-Lieferdateien wurden mit vollständiger Liste und -101 erfolgreichen, ungefilterten Tests im isolierten Offlinecontainer geprüft. -Alle Linux-Dateien referenzieren maximal GLIBC2.34. Nur Auslieferungskopien wurden -von Debuginformationen befreit; `.linked`-Originale bleiben separat erhalten. - -Python-Syntax und PowerShell-AST sind geprüft. Enge lokale Driverguards verweigern -fehlende/doppelte/fremde Listen und übersprungene/gefilterte Resultate. Ein -Mocklauf ohne Zielaufruf verlor die Antwort nach dem alleinigen Ausführungsaufruf; -der nachfolgende gleichnamige Readback lud keine Artefakte erneut hoch und -startete keinen Test erneut. Beide Plattformen verlangen sämtliche tatsächlichen -Listen vor irgendeinem Unitfall. Teilbelege bleiben create-only erhalten. - -Geschütztes lokales Buildmanifest: -`devstate/windows-msi-contracts/build-484a3761-6c84-426f-968d-25a638e9c6f7/manifest.json`, -SHA256 `2d96a07be72f3d71a8097510eb5f647ced6577086a45417c599b772018c29a53`. -Die reine lokale Listenerhebung davor sowie Compiler-/Fehlerausgaben bleiben -privat erhalten. Es wurden durch diesen Arbeitsschritt keine VM-/SSH-Aufrufe, -Upload-, Server-, Dienst-, Registry- oder Installeraktionen ausgeführt. - -## Noch geplante native Abnahme - -Nach unabhängiger Prüfung führt Root zuerst dieselben Lieferdateien auf der -tatsächlichen Linux-VM aus. Erst deren erfolgreicher, unveränderlich an dasselbe -Manifest gebundener Beleg erlaubt die Windows-Unitphase. Native Ausführung ist -ein ausdrücklicher CLI-Schritt mit dem ursprünglichen Main-`--access-root` nur -für den vorhandenen gepinnten SSH-Transport. Zugangsdaten und Main-`devstate` -werden weder kopiert noch verlinkt; alle neuen lokalen Belege bleiben im Worktree. - -Beide Zielseiten erhalten eigene create-only Bootstrapfälle unter -`windows-msi-contracts`. Vor Tests müssen alle fünf beziehungsweise vier -nativen Listen exakt stimmen. Antwortverlust erlaubt ausschließlich denselben -Fall zu lesen, auch bei fehlenden oder unvollständigen Ergebnissen; kein Retry -oder automatisches Resume. Unter Linux laufen die Units zusätzlich in einem -neuen Netzwerknamespace mit begrenztem Prozess-/Ausgabebudget; ihre temporären -Dateien gehören zum eigenen Bootstrapfall. Windows läuft ehrlich als -Bootstrapadministrator, nicht als Produkt-LocalService oder SYSTEM-Executor. - -Auf der tatsächlichen Cloud-Linux-VM anschließend alle101Prüfungen ohne Skips -bestanden: Fall `d015f861-e459-4b82-8ce5-460c3e4c570c`, gemeinsames Manifest -`2d96a07be72f3d71a8097510eb5f647ced6577086a45417c599b772018c29a53`, -Linuxproof-SHA256 -`09fa24e32cd3f3563e80e91265c6cc7c612321b0fdd1febe7aef3ab6de53cf2a`. -Windows79 weiterhin **geplant, nicht nativ ausgeführt**. Der Linux-Unit-PASS -ist keine Installation-/Upgrade-/Noop-Abnahme: jede tatsächliche -Paketwirkung benötigt weiterhin ihren eigenen unveränderlichen Antrag und die -Genehmigung in der WebUI. diff --git a/docs/windows-msi-fixture.md b/docs/windows-msi-fixture.md deleted file mode 100644 index 0cbacf3..0000000 --- a/docs/windows-msi-fixture.md +++ /dev/null @@ -1,52 +0,0 @@ -# Windows-MSI-Fixture: Paketbau, noch keine Installation - -**Fortschreibung 16. November:** Auch das feste Upgrade-MSI 1.1.0 wurde auf der -Windows-VM gebaut, unabhängig zurückgelesen und heruntergeladen/gehasht. -Eine dabei belegte falsche Annahme über die Tabellenreihenfolge ist im Builder -korrigiert; alle Zeileninhalte bleiben strikt geprüft. Noch keine Installation. -[Aktuelle Ergebnisse](windows-mvp-completion.md). - -Stand 2026-11-14. Der feste Builder -[`Build-MsiFixture.ps1`](../deploy/windows/Build-MsiFixture.ps1) hat auf der -Windows-11-x64-VM ein kleines MSI1.0.0 erstellt und unabhängig nur lesend wieder -geöffnet. Fall `48291dbe-88e2-4221-954a-37a0c8faf04e`, Builder-SHA256 -`0465be3b43ffb8f9b9233eb402e64a4a585945609c72546b2e1b1d97b7a079cf`. - -Das tatsächlich heruntergeladene und erneut gehashte Artefakt umfasst20480Bytes, -SHA256 `2204dc823fe84f69df54b63662e7c4f14042799c2c9f4938eaec69ebc6c79e57`. -Es enthält genau eine33Byte-Nutzdatei und einen eingebetteten CAB-Stream. -Tabellen, feste Produkt-/Komponentenkennung, Version, Machine-/x64-Kontext, -Summary und CAB-Hash wurden nativ zurückgelesen. Es gibt keine CustomActions, -Serviceinstallation, Registrytabelle oder Upgradetabelle. Die tatsächliche -PowerShell-Rezeptserialisierung wurde danach lokal mit dem Rust-Vertrag samt -kanonischem Rezepthash geprüft: bestanden. Dieser Rustlauf war kein nativer -Windows-Installationsnachweis. - -Zwei vorherige Fälle bleiben fehlgeschlagen und erhalten: - -- `4ea41b17…`: COM-Aufruf beim Erstellen der Datenbank fehlgeschlagen; - zu diesem Zeitpunkt war die genaue Ursache noch nicht belegt. -- `24da513c…`: derselbe Aufruf mit zusätzlicher begrenzter Diagnose meldete - `0x80020005` (`DISP_E_TYPEMISMATCH`). Eine separate CLR-Probe zeigte danach, - dass ein von `Join-Path` kommender Wert im verschachtelten Argumentarray als - `PSObject` statt als CLR-String ankam. Die COM-Wrapper entfernen jetzt nur - diesen ETS-Wrapper; Pfad, Werte, Dispatchart und Create-Modus3 bleiben gleich. - -Der Builder schreibt ausschließlich einen neuen privaten Bootstrapfall, prüft -Microsoft-signierte lokale MakeCab-/MSI-Werkzeuge und behält Fehlerbelege. -Er ruft weder `msiexec` noch `InstallProduct` oder `OpenPackage` auf. Es wurden -keine Produkte installiert, Dienste geändert, Reboots angefordert oder -Vertrauensspeicher verändert. Die vorhandene Bootstrap-Prozessrichtlinie -`RemoteSigned` wurde verwendet; daraus folgt keine Richtlinienentscheidung für -spätere RMM-PowerShell-Jobs. - -Geschützte Rohbelege liegen unter -`devstate/windows-client/msi-fixture-authoring/48291dbe-88e2-4221-954a-37a0c8faf04e/`; -alte Fälle und gehashte Quellstände bleiben separat erhalten. Artefakte, -Zugangsdaten und private Rohbelege werden nicht ins Git übernommen. - -**Offen:** Registrierung als unveränderliches Tenantartefakt/Rezept, Integration -in Plan/UI/Helper, native Erstinstallation und Noop sowie1.1-Upgrade und der -getrennte EXE-Provider. Jede tatsächliche Installation benötigt einen festen -Antrag und die interaktive WebUI-Genehmigung. Dieser Paketbau ersetzt keinen -dieser Nachweise. diff --git a/docs/windows-msi-integration.md b/docs/windows-msi-integration.md deleted file mode 100644 index ad1aa8f..0000000 --- a/docs/windows-msi-integration.md +++ /dev/null @@ -1,90 +0,0 @@ -# Windows-M4: Domain und Backend - -Stand2026-11-14, Spezifikation1.19. Implementierter und unabhängig geprüfter -Quellenschnitt im Branch `codex/windows-msi-integration`; **kein Clouddeployment -und keine native Paketabnahme**. Die folgenden Teile ergänzen die getrennten -[MSI-Providerquellen](windows-msi11-source.md). - -`ensure_package` erhält das optionale, bei Vorhandensein strikt objektförmige -`windows_msi_manifest`. Intern Box, auf dem Draht unverändertes flaches -Rezeptobjekt; fehlend ausgelassen. Explizites Null, unbekannte Felder und -Objektformen der String-Enums werden verweigert. APT und MSI schließen sich aus. -Nur `msi`/`rmm-windows-msi-fixture`/`x64`/`machine`/SYSTEM mit exakt gebundener -Rezept-ID/-Version und gewünschter Produktversion. Alte Linux-Goldenbytes bleiben -erhalten. MSI-Jobrahmen10–120Sekunden und1024–65536Ausgabebytes. - -Eigener unveränderlicher Windows-MSI-Katalog mit Migration0014, FORCE-Tenant-RLS, -zusammengesetztem Tenant-/Artifact-ID-/SHA-/Längen-FK und bestehenden interaktiven -Katalogrechten. Import/List sind vom APT-Katalog getrennt. Pro MSI-Job/Versuch -wird genau eine Artefaktreferenz automatisch aus dem Rezept abgeleitet; freie -`artifact_ids` sind hier verboten. Fehlende, zusätzliche oder doppelte Artefakte -und abweichende gesamte Rezeptmengen werden bei Planung, Revalidation, -Zustellung, Permit und Geräte-mTLS-Download verweigert. Linux-Artefaktpfade -behalten ihre bisherigen Verträge. - -SYSTEM-Policyversion2 verlangt die eigene explizite Allowlist von höchstens -zwei vollständigen MSI-Rezepthashes, bestehende Geräte-/Principal-/Helperpins, -`system:execute` und getrennte Paketcaps. Schema1 bleibt SCM-only und verweigert -MSI. Die historische Core-Nichtstartprüfung kennt nur den zusätzlichen exakt -validierten MSI-Actiontyp; keine Missing-Row-/Signatur-/Lineageausnahme, -Installer- oder Cachewirkung durch Abandon. - -Tatsächlich lokal bestanden:118betroffene Domain-/Core-/Servertests, danach -gezielter Test der verschärften vollständigen Rezeptmenge; isolierter realer -PostgreSQL-Fall mit Migration/RLS/Tenant-FK/Immutabilität/Planreferenzmutationen -und `pending_approval` mit0Jobs/Outbox/Permits. Fehlendes `system:execute` -verweigert. Fünf bestehende Serverfälle bleiben ausdrücklich ignoriert. -Linux-Clippy einschließlich Agent/privilegiertem Helper und WindowsGNU- -System-helper-Alltargets sowie Format-/Diffprüfung bestanden. - -Der erste PG-Lauf belegte einen unnötigen `FOR SHARE`-Lock, der zusätzliche -UPDATE-Rechte erfordert hätte. Ausschließlich der Lock wurde entfernt; -Unveränderlichkeit/SELECT-/INSERT-Rechte bleiben erhalten. Fehlversuchslog -privat unverändert. Der erfolgreiche PG-Fall nutzte ausdrücklich opake -Metadaten-Testbytes, kein tatsächlich geprüftes oder installiertes MSI. -Lokaler Beleg `devstate/windows-msi-integration/local-qualification.json`, -SHA256 `b7bced0a341ffb88af8b584cbe8355ff1021add541004347f609f6136a684b74`, -bindet13Quelldateien. Unabhängiger Quellenreview ohne weiteren konkreten Blocker. - -Weiter offen: Windows-Nativevertragsnachweise, tatsächliche WebUI-Abnahme, -Windowsdownload und geschützter SYSTEM-Cache, Helper-/Runtimeverdrahtung und -jeweils echte WebUI-genehmigte Installation/Upgrade/Noops. Keine Capability, -Helperpolicy oder Clock-/Jobkonfiguration auf der VM wurde geöffnet. Die -vorherige UI verweigerte SYSTEM-Nicht-SCM-Pläne bis zum folgenden separaten -Schnitt. Quellen/Units sind keine Paketfreigabe. - -## Getrennter WebUI-Quellenschnitt - -Feste SYSTEM-MSI-Auswahl und eigener kleiner Katalogbereich implementiert; -APT bleibt getrennt. Anzeige enthält Product-/Upgrade-/gegebenenfalls1.1- -PackageCode, Version, Artifact/Rezept/Nutzdateihashes, Vorgänger, feste Argumente -und No-Reboot-/Budgetvertrag. Sie stammt aus kopierter typisierter Projection -hashgeprüfter gespeicherter Planbytes. Alle Preview-Aliase und spätere Änderungen -werden vor Anzeige sowie erneut vor Submit/Genehmigung geprüft. Keine neue -Genehmigungsabkürzung oder Policy-/Capabilityveröffentlichung. - -Rootreview fand einen echten Codecfehler: die erste UI-Fassung erwartete -`apt_manifest:null`, Rust lässt `None` tatsächlich aus. Die ursprünglichen -TS-Fixtures spiegelten diesen Fehler. Eng korrigiert: gespeicherte MSI-Actions -verlangen das fehlende Feld; nur das Formular akzeptiert fehlend/null, kein -APT-Objekt. Zwei echte, vom unveränderten Rust-Domaincodec erzeugte synthetische -PlanPayload-Goldens1.0/1.1 werden nun im bestehenden Webtest verifiziert und -gerendert. Keine Signer, realen Geräte oder Nativewirkungen in diesen Fixtures. - -Abschließend42Webtests, Typecheck und Build bestanden; fünf Webdateien und -sämtliche Webinputs vor/nach gebunden, Rust13 unverändert. Neuer privater Beleg -`devstate/windows-msi-ui/wire-fix-955acab2-35af-4507-bb2b-d7cd1fa49347/qualification.json`, -SHA256 `f84d4962ab9a6ef64ef0327fcf7c524efb0bd4064d2416f174a9dfffb524a8a1`. -Der ursprüngliche `fe02…`-Beleg bleibt historisch und ist ausdrücklich wegen -des Codecfehlers abgelöst. Kein Clouddeployment, Browser-Nativlauf, Installer- -oder tatsächlicher WebUI-Freigabenachweis durch diese Quelltests. - -## Tatsächlicher Linux-first-Vertragsnachweis - -Auf der tatsächlichen Cloud-Linux-Test-VM bestanden anschließend alle101 -ungefilterten Prüfungen ohne Skips: Domain20, Corecontracts8, HelperSync26, -AgentSync26 und Unixhelper21. Fall `d015f861-e459-4b82-8ce5-460c3e4c570c`, -Manifest `2d96a07b…`, Proof `09fa24e3…`. Nur eigene isolierte Unitprogramme, -kein RMM-Job, Dienst-/Agentdeployment, Produktjournal-/Schlüsselzugriff oder -Cloudserver-/MSI-/WebUI-Nativnachweis. Windows79 sind weiterhin erwartet und -noch nicht nativ ausgeführt. [Genauer Runnervertrag](windows-msi-contracts.md). diff --git a/docs/windows-msi-runtime-units.md b/docs/windows-msi-runtime-units.md deleted file mode 100644 index 1257af4..0000000 --- a/docs/windows-msi-runtime-units.md +++ /dev/null @@ -1,84 +0,0 @@ -# Getrennter MSI-Runtime-Unitpack - -`deploy/windows_msi_runtime_acceptance.py` ergänzt ausschließlich die Units der -aktuellen Windows-Runtime. Er verändert keine historischen Runner oder -Manifeste. Der vorhandene Common-Pack bleibt mit seinen tatsächlichen -Linux101-/Windows79-Belegen separat gebunden; dessen gemeinsame Core-/Domain-/ -Proto-/Cargoquellen sind zur Runtime identisch. Er wird nicht als Runtime-Test -umetikettiert. - -## Tatsächliche lokale Qualifikation - -Der eingefrorene Runtime-Quellenbeleg -`17f3eb2258773a22be26afd9681d271f69136cfb52dbda31aac2a0ef577b3816` -bindet82 Compilerinputs und die unabhängig geprüften acht Runtimeänderungen. -Seine bestandenen Windows-GNU-Clippy-Läufe sowie seine unveränderten Windows- -Library-/Binary-Testdateien und Original-Links werden direkt wiederverwendet. -Es findet keine erneute Windows-Kompilierung oder Strip-Operation statt. - -Zusätzlich gebaut und ausgeführt wurden nur die fehlende Linux-Release- -Library-Lieferdatei sowie deren Clippyprüfung. Die vollständige tatsächliche -Liste enthält10 Fälle: vier Journal-, drei Eventlog-Vertrags- und drei MSI- -Klassifikations-/Nachbedingungsfälle. Alle10 Lieferbyte-Tests bestanden ohne -Skip, Filter oder Fehler im isolierten lokalen Offlinecontainer. Die Datei -benötigt maximal GLIBC2.34; der unveränderte Original-Link ist archiviert. - -Für Windows sind35 Library- und7 Binaryfälle **erwartet**, insgesamt42. -Die Namen wurden aus dem vorhandenen nativen23er-Profil und den additiven -kompilierten Testfällen vollständig aufgelöst und in den qualifizierten -Windowsbytes gefunden. Das ist kein ausgeführtes Windows-`--list` und kein -nativer42er-PASS. Die echte vollständige Liste muss vor dem ersten Windows- -Unitfall exakt übereinstimmen. Neue Testfälle wurden dafür nicht geschrieben. - -Das neue Manifest bindet85 Inputs: die82 unveränderten Compilerinputs, den -neuen Runner und seine zwei Parser-/Bootstrapquellen. Python-Syntax, -PowerShell-AST und gezielte lokale Driverguards sind geprüft. Ein reiner -Mocklauf mit verlorener Antwort erlaubte nachfolgend nur den gleichen -Readbackfall; es erfolgte kein erneuter Upload oder Ausführungsaufruf. - -Geschütztes Buildmanifest: -`devstate/windows-msi-runtime-units/build-9458b2f4-3e1b-4931-ae68-f9306993ce12/manifest.json`, -SHA256 `620255bcc57de32044cf23331511937565ac3415514f6ce4d953dad7c5286250`. - -## Getrennt geplante native Schritte - -Nach Root-Review wird zuerst ausschließlich die neue Linux-Library auf der -Cloud-Test-VM geprüft. Erst deren unveränderlicher gleiches-Manifest-PASS erlaubt -den neuen Windows-Unitfall. Beide Windowslisten müssen vor irgendeinem -Testfall stimmen. Die Vorgängerbelege Linux101/Windows79 bleiben dabei erhalten. -Alle neuen Bootstrapfälle, Listen und Resultate sind create-only; Antwortverlust -oder fehlende Teilresultate erlauben ausschließlich gleichnamigen Readback, -keinen Retry oder automatisches Resume. Prozess- und Ausgabe-Nachwartezeiten -sind begrenzt. Linux verwendet einen eigenen Netzwerknamespace und temporäre -Dateien; Windows läuft ehrlich als Bootstrapadministrator. - -Native Ausführung liest den expliziten ursprünglichen Main-`--access-root` -ausschließlich für den vorhandenen gepinnten SSH-Transport. Keine Credential- -oder Main-`devstate`-Kopien/Symlinks. Neue Belege gehören zum isolierten -Runtimeworktree. Produktdienste, Journale, Identitäten, Schlüssel, Capabilities, -Clock- und SYSTEM-Policies werden nicht verändert. - -Die unten belegte Linux10-Phase ist inzwischen nativ bestanden; die -Windows42-Phase bleibt **geplant, nicht ausgeführt**. Der Pack -belegt keine LocalService-/SYSTEM-Ausführung, keinen Cache-/PERSIST-Datei- -Parallelzugriff, keinen MSI-Installations-/Upgrade-/Noop-Job und keinen -vertrauenswürdigen Windowsclockadapter. Diese Abnahmen bleiben getrennt und -unterliegen vor jeder tatsächlichen RMM-Wirkung weiterhin der WebUI-Grenze. - - -## Tatsächlich auf der Cloud-Linux-VM bestanden - -Root führte nach unabhängigem Driverreview dieselbe Lieferdatei auf der -permanenten x86-64-Linux-VM aus. Alle10Tests ohne Skips/Filter bestanden, -Fall `050c33bd-026e-4f89-83e5-d84b1d468827`, ManifestSHA256 -`620255bcc57de32044cf23331511937565ac3415514f6ce4d953dad7c5286250`, -LinuxproofSHA256 -`679ac094e60f6a5f18c2e461d55ef0a447517287c3eb80f2d9a1b9a5a5fe31dd`. -Die exakte vollständige native Liste wurde vor irgendeinem Test geprüft; -eigenes Bootstrap-Scratchverzeichnis, leere Prozessumgebung und neuer -Netzwerknamespace. Keine RMM-Dienste, Produktdaten, PKI oder Paketstände geändert. - -Windows35+7 bleiben **erwartet, noch nicht nativ ausgeführt**. Der befristete -Entwicklungszugang war abgelaufen; Serverhälfte separat erneuert, konkrete -Konsolenrecovery durch den Benutzer noch offen. Kein Ersatz des Windowsbelegs -und keine Paket-/SYSTEM-/Clock-/Jobcapability aus dem Linux-PASS ableiten. diff --git a/docs/windows-msi-runtime.md b/docs/windows-msi-runtime.md deleted file mode 100644 index 4b6607c..0000000 --- a/docs/windows-msi-runtime.md +++ /dev/null @@ -1,89 +0,0 @@ -# Windows MSI runtime: implementierter, noch nicht nativ abgenommener Schnitt - -Stand 2026-11-14, isolierter Zweig `codex/windows-msi-runtime`, Basis `66c1855`. -Dies ist ein Quellen-/Lokalnachweis. Es wurde damit kein Windows-Installer, -RMM-Job, Dienstwechsel oder Bootstrap am Ziel ausgeführt. Die nativen -Domain-/Backend-Nachweise des vorhergehenden M4-Schritts ersetzen die folgenden -noch offenen Runtime-Nachweise nicht. - -## Implementierte Grenze - -Der Network-Agent lädt ausschließlich das im genehmigten Originaljob gebundene -MSI-Artefakt über den bestehenden mTLS-Client und den festen Agent-Endpunkt. -Es gibt keine Installer-URL, Weiterleitung, Bearer-Abkürzung oder abgeschaltete -TLS-Prüfung. Länge und SHA-256 sind auf das Manifest und höchstens 256 KiB -begrenzt. Das Staging liegt unter dem festen Agentzustandsverzeichnis. - -Der SYSTEM-Helper nimmt weiterhin nur die originale signierte Request an, -keinen Callerpfad und keine Installerbytes. Settings-Schema 1 bleibt SCM-only; -Schema 2 kann höchstens zwei genaue Recipe-SHA-256 freigeben. Fehlende neue -Settings-Felder werden beim Serialisieren ausgelassen; vorhandenes `null` ist -kein erlaubter Recipe-Allowlistwert. Die lokale Allowlist begrenzt ausschließlich -und ersetzt weder Plan, Startgrant, Clock noch signierten Sync. - -Vor einer SYSTEM-Cachekopie persistiert der Helper den atomaren Originalstart -mit Verbrauch. Die Kopie verwendet den manifestabgeleiteten SHA-Pfad, prüft -Nicht-Reparse, Elternhandles, File-ID, Länge, Hash und die SYS/Admin-Cachegrenze. -Neue Cacheeinträge werden ohne Ersetzen bestehender Dateien veröffentlicht. -Cache/Staging müssen vorher eingerichtet sein; der Runtimecode repariert weder -ACLs noch Verzeichnisse. Der Provider hält eigene Archiv-/Prozesshandles. - -Ein originales monotones Laufzeitbudget umfasst SYSTEM-Cacheaufbereitung, -MSI-Metadaten, unabhängige Bestandsprüfung, Noopentscheidung und Installerlauf. -Die festen Argumente und MSI-Tabellenprüfungen bleiben erhalten. Erfolg benötigt -unabhängige Product-/Family-/PackageCode-/Payload-Nachbedingungen; `3010` bleibt -als Rebootbedarf sichtbar, `1641` unklar, `1618` ein fehlgeschlagener eigener -Start. Noop hat keinen Installerexitcode. Weder automatischer Reboot noch -allgemeines `msiexec`-Kill oder automatischer Wiederholungsstart sind enthalten. - -Die vorhandene Intentzeile besitzt zusätzlich eine dauerhafte, ausschließlich -verweigernde Abbruchmarkierung. Sie ist nur von 0 nach 1 änderbar; Originalbytes, -Grant und `may_have_dispatched` werden dabei nicht zurückgesetzt. Eine eng -geprüfte additive Migration akzeptiert nur die bisherige genaue Tabellen- und -Triggerdefinition. Der Helper liest die vollständige Originalbindung über eine -jeweils frische gewöhnliche Read-only-Verbindung vor Noop/Start und während der -Beobachtung. Fehlende, fehlerhafte oder gesperrte Beobachtung verweigert. Dies ist -keine zusätzliche Ausführungsautorität. Zwischen letzter Prüfung und OS-Start -bleibt das übliche kleine Rennen; es gibt kein behauptetes Rückgängigmachen. - -Nach unklarem Timeout oder Beobachtungsfehler hält der Helper den eigenen Child, -Archivhandles und Originalgrant-/Requestbindung in einem ungeklärten Slot. -Weitere MSI-Starts werden bis zur Beobachtung desselben Prozessendes verweigert. -Ein späterer Exit ändert das bereits persistierte `unknown` nicht. Nach einem -Helperabsturz bleibt die ursprüngliche Ledger-Sperre bestehen. Intent, Abandon, -RawMirror und signierter Core-Sync behalten ihre strengen Originalbindungen; -keine Missing-row-Regel wurde gelockert. - -## Tatsächlich lokale Prüfung - -Der private Fall `qualified-ee6681c7-8d9d-4af9-8947-5325e1ea2e0f` unter -`devstate/windows-msi-runtime/` bindet 82 Compiler-/Manifestquellen vor und nach -allen qualifizierten Prüfungen identisch. Qualification-SHA-256: -`17f3eb2258773a22be26afd9681d271f69136cfb52dbda31aac2a0ef577b3816`. - -- Linux-Container: 10 Bibliothekstests ausgeführt, 10 bestanden, 0 ignoriert. -- Windows-GNU: Default- und SYSTEM-Feature-Alltargets-Clippy mit `-D warnings` - bestanden. -- Windows-GNU: Lib-/Agent-Bin-Unittests gelinkt, nicht ausgeführt. -- Windows-GNU: beide Releasebinaries gelinkt; AMD64-PE geprüft. Originale und - mit `--strip-all` bearbeitete Auslieferungsdateien sind getrennt erhalten. -- `git diff --check` bestanden. Keine Domain-/Core-/Server-/Web- oder - Root-Cargo-/Lockänderung. - -Release-Auslieferung Agent: -`7d9b1221ccb3587437d0866296472330947a16445c4e40069981fc4197242d83`. -Release-Auslieferung Helper: -`96589d53d366a0ccbd60c301fd3d1f03cd4d9f93d85bdcb3ce9b7f4647afc273`. -Die Zwischenbelege vor der ergänzten laufenden Abbruchbeobachtung bleiben -historisch erhalten und sind nicht die finale Qualification. - -## Noch offen - -Die Windows-Unitbinaries, Cache-/Staging-ACLs und gehaltenen Handles, tatsächliche -PERSIST-Migration mit konkurrierender Deny-Lesung, Installer 1.0, MajorUpgrade -1.1, beide Noops und die Abbruch-/Unklarheitsfälle müssen auf der Windows-VM -nachgewiesen werden. Installerjobs benötigen jeweils die reale WebUI-Grenze. -Capabilityliste bleibt passiv, Clock-Gate unqualifiziert, Job-/Effektdefaults -bleiben geschlossen. Diese Implementierung behauptet weder native MSI-Abnahme -noch Windows-MVP-Abschluss. EXE, WinGet, allgemeine Installerargumente oder eine -neue Rebootstrecke gehören nicht zu diesem Schnitt. diff --git a/docs/windows-msi11-source.md b/docs/windows-msi11-source.md deleted file mode 100644 index b680ffd..0000000 --- a/docs/windows-msi11-source.md +++ /dev/null @@ -1,44 +0,0 @@ -# Eigene MSI-Fixture1.1: Quellenstand - -Stand2026-11-14: drei unexportierte Quellen im isolierten Branch -`codex/windows-msi-provider` erweitert und unabhängig geprüft. Keine Änderung -an produktiven Cargo-/Action-/Helper-/Serverpfaden und keine Capability oder -Paketfreigabe. MSI1.1 wurde noch nicht gebaut, registriert oder installiert. -Der tatsächliche alte MSI1.0-Artefaktbeleg bleibt unverändert erhalten. - -Neues festes Rezept `rmm-windows-msi-fixture-upgrade-1.1`, ProductCode -`{D42BD387-079B-4BBF-A134-0DA7B7A97011}`, gleicher UpgradeCode wie1.0. -Das vollständige Rezept bindet zusätzlich den konkreten neuen PackageCode und -genau den bekannten1.0-Vorgänger samt Version/33-Byte-Nutzdateihash. Alte1.0- -Rezeptbytes bleiben durch am Ende angefügte, bei None ausgelassene Felder gleich. -Kein Fresh1.1, Repair, Downgrade oder beliebiger Vorgänger. - -Provider und Builder verlangen feste Upgrade-Tabelle, LaunchCondition und -Ausführungssequenz, keine CustomActions. Vorheriger Machine-Produktzustand, -Familie und Nutzdatei müssen passen. Nachher1.1 exakt installiert und1.0 entfernt; -ein eigener Noop verlangt denselben konkreten1.1-PackageCode. Ein anderes neu -gebautes1.1-MSI erhält keine implizite Neuinstallationserlaubnis. - -Zwei Quellenfehler wurden korrigiert: spät beobachteter Installerexit oder -Nachzustand wird nicht rückwirkend erfolgreich; zusätzlich beginnt das eine -Verifikations-/Installationsbudget vor allen synchronen Prüfungen und umfasst -auch Noop samt frischem Fence und erneuter Abbruchprüfung. Timeout bleibt -Unknown, kein globales Installerkillen oder Retry. `Run::Noop` kann dadurch -auch eine Unknown-Observation enthalten; spätere Aufrufer müssen deren State -auswerten und dürfen die Enumvariante nicht pauschal als Erfolg behandeln. - -Tatsächlich lokal bestanden: fünf gezielte Harness-Tests ohne Skips, -Linux-/WindowsGNU-Harness-Clippy mit Warnungen als Fehler und PowerShell-AST. -Der Harness bindet explizit diesen Worktree und exportiert keine Produktmodule. -Originaler Quellenbeleg `devstate/windows-package-msi11/local-source-qualification.json` -(`0b562dc2…`) bleibt historisch; enger Folgebeleg -`noop-deadline-qualification.json` (`23ed1175…`) bindet den korrigierten Stand. -Finale Packagequelle `617b2a73…`, Domain `070a8dfa…`, Builder `6365ac16…`. -Im Builder wurde anschließend nur ein überflüssiges Leerzeichen entfernt: -PowerShell-Parse erfolgreich und vollständige Tokenliste vorher/nachher -identisch; vorheriger Builderquellenbeleg `2d63eaba…` bleibt historisch. - -Offen sind Linux-first-Vertragsintegration, Tenantkatalog, geschützter -Artefakttransport/Cache, typisierte SYSTEM-Paketerlaubnis und tatsächliche -WebUI-genehmigte Installation/Upgrade/Noops auf der Windows-VM. Lokale Tests -und Crossbuilds sind keine native Installerabnahme. diff --git a/docs/windows-msvc-reboot-maintenance-plan.md b/docs/windows-msvc-reboot-maintenance-plan.md deleted file mode 100644 index 67f62b1..0000000 --- a/docs/windows-msvc-reboot-maintenance-plan.md +++ /dev/null @@ -1,68 +0,0 @@ -# Geplante Windows-Neustarts für MSVC und MVP-Abnahme - -16. November 2026. **Zwei reguläre Neustarts ausdrücklich vom Betreiber freigegeben; -noch keiner davon ausgeführt.** Ausschließlich die vorhandene Windows-Test-VM, Asset -`a176520e-8a91-4e93-a78b-8e7620f430e0`. Weder Entwicklernotebook noch Cloudserver -oder Linux-Test-VM werden neu gestartet. - -## Tatsächlicher Grund - -Die lesende Windowsprüfung vom 16. November, 13:50 UTC, fand kein nutzbares -Visual-Studio-/Windows-SDK-/Rust-MSVC-Toolset. CBS und Windows Update melden -einen ausstehenden Neustart; sechs PendingFileRename-Einträge wurden nur -gezählt, nicht inhaltlich gelesen. Der gemeldete tatsächliche Boot stammt vom -14. November, 12:26:49 UTC. Der vorhandene Buildtools-Bootstrap verweigert -bereits die Vorbereitung bei diesen Markern. Sie werden nicht entfernt, -ignoriert oder als erledigt dargestellt. - -Das vorhandene native Windows-Buildpack ist wahrheitsgemäß GNU. Der bestehende -signierte Windows-Releasevertrag verlangt dagegen MSVC. GNU-Dateien werden -nicht unter einem MSVC-Target signiert. Für den tatsächlichen kompatiblen -Windows-Selbstupdater ist deshalb ein echter MSVC-Build mit nachweisbaren -Microsoft-Werkzeugen nötig. Der gepinnte Buildrunner wurde nur lesend durch -den tatsächlichen PowerShell-Parser geprüft; keine Installation gestartet. - -## Konkret vorgesehene zwei Neustarts - -1. **Ein regulärer Bootstrap-Neustart vor der MSVC-Installation.** Erst nach - ausdrücklicher Zustimmung und nach Abschluss der gerade vorbereiteten - SYSTEM-Skriptabnahme. Vorher null offene Ausführungen/Installer belegen, - beide RMM-Dienste normal stoppen, ursprüngliche Prozessbeendigungen und - erhaltene Journale prüfen. Dann den Gast über seinen bestehenden - Administrator-SSH-Zugang normal neu starten, ohne Force-Option oder - erzwungenes Schließen von Anwendungen. Bereits wartende Windowsänderungen - können beim normalen Neustart abgeschlossen werden; es wird vorher kein - zusätzlicher Windows-Updatelauf angestoßen. -2. **Ein späterer regulärer RMM-Reboottest.** Erst mit qualifiziertem - Rebootadapter und eigenem festen MCP-Plan: alter Boot, Ziel, kurze begrenzte - Neustartfrist und Wiederanmeldefrist stehen vor dem tatsächlichen sichtbar - simulierten WebUI-Genehmigungsklick fest. Vorher wieder null sonstige offene - Ausführungen. Der ursprüngliche Grant darf genau einmal verbraucht werden; - nach Rückkehr neuer Boot, mTLS, unabhängige Zeitbelege und ursprünglicher - Rebootabschluss. Keine automatische Wiederholung bei unklarer Wirkung. - -Der erste Neustart ist kein RMM-Job- oder Rebootadapter-Nachweis. Der zweite -ersetzt keine vorherige MCP-/WebUI-/Grantgrenze. Für beide wird unmittelbar -vorher eine kurze Statusmeldung im Chat gegeben. Die Zustimmung gilt nur für -diese zwei regulären Gastneustarts innerhalb der laufenden MVP-Wartungssitzung; -weitere unerwartet nötige Neustarts sind dadurch nicht genehmigt. - -## Nachlese und Stopkriterien - -Der dauerhaft konfigurierte SYSTEM-SSH-Task und die RMM-Dienstregistrierungen -werden vorher geprüft. Nach dem Boot müssen eine neue strikt gepinnte -SSH-Verbindung, tatsächlicher neuer Boot, Agent/Helper und ihre erhaltenen -Identitäten/Journale gelesen werden. Der eigene Helper soll bis dahin -Automatic sein; ein späterer Boot ist sein erster echter Autostartnachweis. -Ausstehende Neustartmarker erneut lesen. Bleiben sie bestehen oder ist eine -Wirkung unklar, keine Installerphase und kein weiterer blinder Neustart. -Neue Zeit-/Jobbereitschaft entsteht nur durch den regulären signierten Ablauf. - -## Ausdrückliche Betreiberfreigabe - -Der Betreiber hat in dieser Wartungssitzung auf die konkrete Frage geantwortet: -„Ja, diese zwei Neustarts freigeben“. Damit sind genau die oben bezeichneten -Gastneustarts unter ihren Leerlauf-/Ankündigungs-/NoForce-Bedingungen erlaubt. -Der erste bleibt zeitlich **nach** der SYSTEM-Skriptabnahme; eine bloße -Vorbereitung oder Policydaten-Erzeugung erfüllt diese Voraussetzung nicht. -Die Freigabe ersetzt keine echte WebUI-Interaktion beim späteren RMM-Reboottest. diff --git a/docs/windows-mvp-completion.md b/docs/windows-mvp-completion.md deleted file mode 100644 index a90c237..0000000 --- a/docs/windows-mvp-completion.md +++ /dev/null @@ -1,324 +0,0 @@ -# Fortsetzung des Windows-MVP - -**Aktueller Einstieg vom 16. November, 18:11 MEZ:** -[Bestandsaufnahme und Abschlussplan für Agents](mvp-completion-plan.md). -Allgemeine LocalService-Skripte sind inzwischen tatsächlich bestanden; -SYSTEM bleibt Unknown, beide RMM-Dienste sind gestoppt. Die nachfolgenden Abschnitte -sind datierte Einzelstände und kein Beleg aktueller Betriebsbereitschaft. - -Der Betreiber hat am 16. November 2026 die Fertigstellung der offenen -Windows-MVP-Arbeiten ausdrücklich beauftragt, möglichst parallel. -Die vorangegangene [PowerShell-Einzelabnahme](windows-profile-acceptance.md) -bleibt ein begrenzter LocalService-Nachweis. Sie ist keine Abnahme beliebiger -Skripte, von SYSTEM-Aktionen oder Agentupdates. - -Die Arbeiten betreffen allgemeine genehmigte Skriptwartung einschließlich -SYSTEM, zuverlässigen Jobbetrieb, MSI-/Dienstaktionen, Zertifikatslebenszyklus -und den zusätzlich beauftragten Agentupdater. PTY/ConPTY, RustDesk, -Hypervisorintegration, HA und produktiver OIDC-Betrieb bleiben außerhalb. -WebUI/MCP bleiben auf Server-Loopback; Ziel ist weiterhin die eigene Windows-VM, -nicht der Notebookhost. Jeder Ausführungsauftrag braucht seinen festen Plan -und die tatsächliche, sichtbar simulierte WebUI-Genehmigung. - -## 16. November: Wartungstransport tatsächlich wiederhergestellt - -Um 09:41 Uhr MEZ bestätigte der Server frische Windowskontakte, dieselbe -Boot-ID und keine Restore-/Sequenzsperre. Der frühere SSH-Tunnel hatte keinen -Listener mehr. Seine ursprüngliche Serverfreigabe war abgelaufen. - -Über die bereits vom Betreiber bereitgestellte Administrator-VM-Konsole wurde -[Open-DevelopmentAccessWindow.ps1](../deploy/windows/Open-DevelopmentAccessWindow.ps1) -gestartet. Es nutzt ausschließlich den vorhandenen Tunnelkey, die bestehende -Hostpinprüfung und den festen Reverse-Forward -`127.0.0.1:22240:127.0.0.1:22222`. Auf dem Server wurde ausschließlich die -Ablaufzeit des vorhandenen Keys geändert; Einschränkungen, Account und Key -blieben erhalten. Keine neue öffentliche Portfreigabe. - -Die native SSH-Nachprüfung um **09:46:07 MEZ** bestätigte Administratorzugriff, -den Agentdienst unter LocalService und den Helper unter LocalSystem, beide -laufend. Das neue Fenster endet **16. November 2026, 13:39:52 MEZ**. Der -Konsolenprozess beendet seinen eigenen SSH-Kindprozess und stellt anschließend -die ursprüngliche Accountablaufzeit wieder her, sofern sie zwischenzeitlich -nicht geändert wurde. Keine dauerhafte Aufgabe oder permanente Schlüsselkopie -wurde angelegt. Die ursprüngliche Windows-DVD wurde wieder eingelegt. - -Unabhängige native Hashnachlese bestätigte die unveränderte passive -Konfiguration `7c9f6f3642ef84337c3cd761d8a4788c4babe81522fdd987a3eb9b819bc8d851`, -Agent `742257bfb86ff3ccb5b7c04371471afbdf3c26c5d5cf73ea7bf6d0a51586e80f` -und Helper `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e`. -Private Nachweise: `devstate/windows-client/mvp-closeout-20261116/`. - -Dieser Schritt qualifiziert nur den Entwicklungstransport. Er erzeugt keine -RMM-Jobs, Genehmigungen oder neue Laufzeitbereitschaft. Die allgemeinen -Windows-Abnahmen stehen weiterhin aus. - -## 16. November: MSI-Upgradepaket nativ gebaut - -Der erste neue 1.1-Build stoppte bei der unabhängigen Tabellenprüfung, vor jeder -Installation. Eine anschließend ausschließlich lesende COM-Abfrage zeigte -beide erwarteten Upgradezeilen, jedoch in der umgekehrten Reihenfolge zur -Annahme des Builders. Die Prüfung vergleicht jetzt jede vollständige Zeile -über ihren eindeutigen `ActionProperty`-Schlüssel. Anzahl, alle sechs Felder, -NULL-Grenze, LaunchCondition und feste InstallExecuteSequence bleiben geprüft. -Der unvollständige erste Fall wird erhalten und nicht als Installationsartefakt -verwendet. - -Mit dem korrigierten Builder -`33b96471471af9ff593b47e706c6b41546e32bf0853528377e5796757657deab` -bestand der neue native Fall `b3ecf5ae-0897-44fe-96e7-4fc1fc8d0860`. -Das feste Machine-/x64-MSI 1.1.0 wurde erstellt, einschließlich eingebettetem -CAB und unabhängiger Tabellen-/Summary-/Nutzdateiprüfung. Separate Nachlese und -Download bestätigten **20480 Bytes**, SHA-256 -`9dc6b9a50ba48deefaf285dbc9dd0e87104c85c6e0152985351119a5b7f71bba`. -Der Builder meldet `build_only=true`, `product_changes=false` und -`native_installation_tested=false`. - -Dies ist eine tatsächliche Paketbauabnahme, weiterhin keine Installation, -kein Upgrade des installierten Agenten und kein erfolgreicher MSI-Ausführungsjob. -Installation 1.0, Noop, Upgrade 1.1 und dessen Noop brauchen jeweils ihren -eigenen WebUI-genehmigten Plan. Private Originalberichte einschließlich des -fehlgeschlagenen Falls: `devstate/windows-client/mvp-closeout-20261116/`. - -## Zertifikatsschutz und Abschlussvertrag: native Vertragsprüfungen - -Die aktive Zertifikatserneuerung wurde im Quellstand um eine Leerlaufprüfung -erweitert. Offene oder unklare Aufträge, fehlende Wirkungsbelege und laufende -Helperübergaben verhindern die Erneuerung. Der ursprüngliche CSR und der -belegte Leerlaufkontext werden gemeinsam gespeichert. Eine erneute Anfrage -nach Antwortverlust darf nur denselben erhaltenen Kontext nutzen; anschließend -ist ein neuer regulärer signierter Abgleich erforderlich. - -Sieben gezielte Zertifikatstests bestanden zuerst auf der Cloud-Linux-VM -als UID 65534 ohne Netzwerk und mit `no_new_privs`, danach auf Windows 11 -im separaten Administrator-Bootstrapfall. Linux: 7 bestanden, 0 Fehler, -19 gefiltert. Windows: 7 bestanden, 0 Fehler, ein ausdrücklich ignorierter -Administrator-Dateitest, 45 gefiltert. Der ignorierte Fall wird nicht als -bestanden gezählt. Bereitstellungsbinary Windows: -`e64a1506343f19687431cc7dbc6323328dd09e403d177a2dcd119f76ced0974e`. -Dies sind native Vertragsprüfungen; die echte Online-Erneuerung einer -separaten Identität unter LocalService ist weiterhin ein eigener offener Test. - -Der historienerhaltende Abschluss des zusätzlichen Echo-Scopes bestand -ebenfalls zuerst auf der Cloud-Linux-VM und danach nativ auf Windows: -jeweils 1 bestandener gezielter Test, 0 Fehler. Er prüft Originalsignaturen, -exakten erfolgreichen Verbrauch, unveränderte Historie und unveränderliche -Abschlusszeilen. Windows-Binary: -`a902c17334a1ca26fe1caac1863f1ba42b1d74ef56ee7abda2bd71d7df961bf9`. -Die separate PostgreSQL-Vertragsprüfung bestand mit 3 Fällen, einschließlich -fehlender Browserbestätigung, unverändertem Job-/Grantbestand, Idempotenz und -unveränderlichen alten Scopes. Ein dabei reproduzierter Unterschied zwischen -Nanosekunden in JSON und PostgreSQL-Mikrosekunden ist vor der Signatur durch -einheitliche Mikrosekundenpräzision behoben. - -## Serverbereitstellung für den Abschlussdialog - -Der eingefrorene Quellstand mit 249 Inputs und die WebUI bestanden -Windows-GNU-Clippy mit `-D warnings`, Releasebuild und alle **62 WebUI-Tests**. -Der Server wurde auf dem permanenten Cloudserver nativ für ARM64 offline -gebaut. Image `c4c869114a60292c666f2077a77ffeaf968f7f49f8f54417192960affaf682de`, -Serverbinary `aa93af099225af204b913e6737aa595fce0e86b8e0a7eca325839f422cb89f45`. -Quellmanifest: -`aa7bf5b63081b29269712eb565d7519b886e6ce206f27a992c5af27a97ebde96`. - -Migration 19 wurde angewandt und ausschließlich die API mit diesem Image -neu gestartet, am 16. November um **10:18:59 MEZ**. Die zugehörige WebUI ist -bereitgestellt. Gateway- und Datenbankcontainer blieben unverändert. -Job-, Grant- und Autorisierungsbestände blieben bei der Bereitstellung erhalten; -es wurde kein Auftrag angelegt oder genehmigt. - -Die erste Nachprüfung des Entwicklungsrunners stoppte wegen unterschiedlicher -Reihenfolgen der Docker-Mountlisten, später auch der geordneten Konfigurations- -darstellung beim Containerwechsel. Die tatsächliche Konfiguration wurde gegen -den bereits vor diesem Schritt erhaltenen normalisierten Releasebeleg separat -vollständig verglichen: identisch. Originalbelege bleiben erhalten. Weder -Migration noch Containerwechsel wurden zur Korrektur blind wiederholt. - -Für weitere Compose-Aufrufe zu den bestehenden Overlays zuletzt -`/opt/rust-discovery/devstate/windows-mvp-7560235e1adc/mvp-images.compose.yaml` -hinzufügen. Der Abschlussdialog ist damit implementiert und bereitgestellt; -die tatsächliche interaktive Bestätigung und native Anwendung auf die -Windows-Historie sind noch gesondert auszuführen. - -## Passiver Dienstwechsel und tatsächlicher WebUI-Abschluss bestanden - -Der neue Agent `9651b2e518b315029cebfa432261a57f0a305aeddde29c56ac22a5ccbc417b32` -wurde auf der Windows-VM zunächst passiv installiert. Der Helper blieb -`59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e`. -Der vorhandene native Stop-/Swap-/Start-Vertrag erhielt Geräteidentität, -Zertifikat, Schlüsselmetadaten, alle Journaldateikennungen und ACLs. Die -ursprüngliche passive Konfiguration blieb bytegleich. Der Fall -`dc7d79db-7f7e-4b17-be17-849605d8ab56` veröffentlichte anschließend -Zeitprofilrevision 5 aus tatsächlichen unabhängigen Prozess-/Imagebelegen. - -Nach dem Dienststart am 16. November um **10:34:37 MEZ** bestätigten beide -Rollen eigene signierte Zeitvergleiche, Verbindungsgeneration 198, mit -verschiedenen Nonces und Verifier-Inkarnationen. Die Nachlese prüfte tatsächliche -PIDs, Prozessgeburt, Imagehashes, DACLs und Rohbyteshashes. Dies sind -Zeitbelege der angegebenen Aufnahme, keine dauerhafte Bereitschaftslease. - -Die native, nur lesende Prüfung aller Originale und die tatsächliche WebUI -lieferten denselben Abschlusszeugen, einschließlich Ergebnisdigest -`c754d56823979b66fef3d8c34c11bdbe1fdf402a52fe0101eafaf78c2f84ea66`. -Der sichtbar simulierte Browserprüfer bestätigte den administrativen Abschluss -in der WebUI. Die signierte Quittung -`dbd51443-135e-4070-b8af-52d3048a4488` wurde um **10:38:25 MEZ** ausgestellt, -mit Ablauf um 10:48:25 MEZ und weiterhin -`ready=false`, `helper_ready=false`, `unlock=false`. - -Der unabhängig prüfende native Operator -`6710d2e8aebaf7f6ab4da7438fd3c4da55e407d769edea07efc6c9d283516f86` -wendete sie bei gestoppten Diensten erfolgreich an, Exit 0, um -**10:40:09 MEZ**. Danach liefen beide Dienste wieder im passiven Modus. -Eine separate native Nachlese bestätigte dieselben Originalsignaturen, -Verbräuche, Ergebnisbytes und Bootbindung. Die alte Scopezeile ist erhalten; -die zusätzliche Einschränkung wurde über einen unveränderlichen Abschluss -beendet, nicht durch Löschen oder Zurücksetzen der Historie. - -Die serverseitige unabhängige Nachlese bestätigte unverändert 32 Jobs, -28 Grants und 32 Autorisierungen im gesamten Testbestand, davon weiterhin -genau einen Windowsjob. Es existieren genau ein alter Scope und ein neuer -Abschluss. **Kein neuer Ausführungsjob wurde durch diesen Schritt angelegt -oder genehmigt.** Allgemeiner Jobbetrieb benötigt weiterhin neue unabhängige -Zeit-/SignedSync-Prüfungen sowie jeden neuen festen WebUI-genehmigten Plan. - -## Native Updater-Vertragsprüfungen auf beiden Test-VMs - -Am 16. November wurden vier portable Vertragsprüfungen zuerst auf der -Cloud-Linux-VM mit UID 65534, isoliertem Netzwerk und `no_new_privs` ausgeführt: -**4 bestanden, 0 fehlgeschlagen**. Anschließend liefen dieselben vier -Prüfungen nativ auf der Windows-11-VM: **4 bestanden, 0 fehlgeschlagen**. -Der Windowslauf verwendete den abgestimmten administrativen Bootstrapzugang -für Unitprüfungen; er war kein RMM-Job. Es wurden keine Produktdienste -angehalten, keine Zieldateien ersetzt und kein Update ausgeführt. - -Geprüft wurden originale Boot-/Zeitbudgets, geschlossene Windows-Dateirollen, -die unveränderte Bindung vorhandener Policybytes sowie die Zurückweisung -geänderter Zeitvertrauensdaten, wiederverwendeter Qualifikationen und -ungebundener Pins. [Rohresultate und genaue Binär-/Quellhashes](evidence/windows-updater-native-contracts-20261116.json) -beziehen sich auf den separat eingefrorenen Stand -`e77d4b5c-221f-47aa-aa7a-f821e56c65f9`; laufende Weiterentwicklungen wurden -damit nicht nachträglich qualifiziert. Die tatsächlichen Update-, Neustart- -und Rollbackpfade bleiben offen. - -Der erste allgemeine Mehrzeilen-PowerShellplan -`5fd346f9-5ab2-4934-82ad-feeeda3fe283` wurde inzwischen über MCP eingereicht -und mit tatsächlichen UI-Interaktionen im sichtbar simulierten Testprofil -genehmigt. Job `0a50aae9-a784-4535-b62f-ef24c301d546` wurde angenommen. -Zum Zeitpunkt dieser Zwischenprüfung gab es weder Grant noch Prozessstart -oder Ergebnis. Wiederholte signierte Abgleiche bei intaktem lokalen Journal -werden untersucht; ein erfolgreicher allgemeiner Skriptlauf wird noch nicht -behauptet. Der unveränderliche Startschluss liegt bei 11:20:06 MEZ. - -Der anschließende **lesende native OS-Preflight ist fehlgeschlagen**: -`windows-updater-preflight.exe`, SHA256 -`2761451888cf146d85d6cad5ed649d3638d933008d6136b3609ae5a05299e754`, -endete auf der Windows-VM mit Exit 1 und `PRIVATE_PATH_BROAD_ACL`. -Die produktiven Dateien besitzen ausdrücklich benötigte Service-SID-Leserechte; -die Übereinstimmung des Probe-Lesepfads mit diesem ACL-Vertrag wird geprüft. -Es wurden weder Rechte geändert noch die Prüfung gelockert. Dieser Fehler -bedeutet: **keine erfolgreiche native Updater-OS-Abnahme und keine -Apply-Capability**. Die vier vorherigen portablen Verträge bleiben davon -getrennte, erfolgreiche Prüfergebnisse. - -## Schedulerfehler eingegrenzt, Korrektur nativ geprüft - -Die bisherige Windows-Schleife startete bei jedem vorübergehend nicht mehr -frischen 100-ms-Zeitbeleg einen vollständigen neuen SignedSync, bevor sie -angenommene Jobs auswählte. Das kann den Jobstart verdrängen. Die Korrektur -erneuert den signierten Abgleich nur bei tatsächlichem Bedarf beziehungsweise -Ablauf und prüft wartende Arbeit alle 20 ms ohne Tick-Rückstau. Der -100-ms-Vertrag und sämtliche frischen Start-/Permitprüfungen bleiben Pflicht; -ein vorhandener SignedSync macht einen veralteten Zeitbeleg nicht gültig. - -Zusätzlich ging beim Schließen eines Gates der Besitzer eines bereits -ausgesandten Helper-Apply verloren. Der neue Ablauf behält diesen begrenzten -Originalworker und lässt ihn beim kontrollierten Schließen auslaufen, ohne -Apply zu wiederholen oder aus einem alten Kanal Bereitschaft abzuleiten. -Eine begrenzte passive Statusdatei zeigt künftig die tatsächlichen -Sperrgründe; ihr Inhalt ist niemals Eingabe einer Genehmigung oder Freigabe. - -Am 16. November bestand die gezielte Schedulingprüfung zuerst nativ auf der -Cloud-Linux-VM (1/1). Auf Windows bestanden anschließend die Schedulingprüfung -und die Originalworker-Besitzprüfung (je 1/1). Das isolierte Windows-GNU- -Clippy lief für alle Targets mit `-D warnings` erfolgreich. -[Exakte Quellen, native Resultate und Binärhashes](evidence/windows-job-scheduling-20261116.json). -Diese Ergebnisse sind **noch kein erfolgreicher allgemeiner Skriptlauf und -kein Nachweis eines bereits erfolgten Dienstwechsels**. - -## Korrigierter lesender OS-Preflight bestanden - -Der ACL-Fehler lag im **Lesepfad des Updater-OS-Ports**: Dieser verwendete -eine ausschließlich für Agentleser geeignete Prüfung, obwohl die festen -Updaterdateien zusätzlich legitime Helper-Service-SID-Leserechte benötigen. -Die korrigierte Prüfung verwendet den bereits gehaltenen Datei-Handle und -die festen erlaubten Serviceleser; Schreib-, Lösch-, Eigentümer- und -DACL-Rechte bleiben ausschließlich bei SYSTEM/Administratoren. -**Es wurde keine ACL auf der VM verändert.** - -Am 16. November um **11:31:51 MEZ** bestand der korrigierte Preflight auf -der tatsächlichen Windows-VM mit Exit 0. Er prüfte beide laufenden -SCM-Prozesse samt Image-/Geburtsbindung und alle fünf festen Dateien: -Agent, Helper, Einstellungen, Peerpin, Zeitprofil. -[Native Originalmetadaten, Quellen- und Lieferhashes](evidence/windows-updater-readonly-preflight-20261116.json). -Die konkrete gestrippte Lieferdatei hat SHA256 -`a6e19d2412a8b6f96374e20ea3036fc640565b9b02895a1fbb3c223227c7d5cb`; -der Original-Linkhash ist davon getrennt dokumentiert. -Der Lauf blieb rein lesend und meldete ausdrücklich -`native_apply_tested=false`, `job_created=false`, `capability_qualified=false`. - -Die separate MCP-Nachlese des ersten allgemeinen Skriptjobs meldete nach -dessen unveränderlichem Startschluss **`expired`, Revision 0, kein Ergebnis**. -Der unabhängige Gatebeleg bestätigte genau einen angelegten Job und -**null Grants**, keine offenen Wirkungen. Der alte Antrag wird weder -verlängert noch als erfolgreicher Skriptlauf gewertet. - -Ein vorbereiteter regulärer Agentstopp mit Journalreservierung brach um -11:32:39 MEZ vor jedem Stopaufruf mit -`QUIESCENT_HEAD_NOT_OBSERVED_NO_STOP` ab. Innerhalb der begrenzten -Aufnahmefrist konnte kein exakt gemeinsamer signierter Agent-/Helperstand -belegt werden. Kein Dienst wurde durch diesen Versuch gestoppt, keine -SQL-Datenzeile geändert, kein Job gestartet. Eine gesonderte rein lesende -Diagnose untersucht die abweichende Vorbedingung. - -## Signierte Antworten behalten; ergänzte native Prüfungen bestanden - -Die lesende Laufzeitdiagnose bestätigte denselben letzten angewandten -Entscheidungsbeleg in Agent und Helper, während neue vorbereitete -Anfragecheckpoints weiterliefen. Es gab keine neuen Verbräuche, Grants, -Helperintents, offenen Ausgaben oder gespeicherten Faults. Die Diagnose -erteilte weder Bereitschaft noch eine Reparaturfreigabe. - -Die ergänzte Korrektur authentisiert genau eine Antwort gegen ihren -Originalrequest und Kanal, behält sie begrenzt und wartet auf einen frischen -100-ms-Zeitbeleg sowie das Erreichen ihres signierten Ausstellungszeitpunkts -durch die lokale Uhr. Danach werden beide normalen Commitphasen weiterhin -unabhängig geprüft. Ein bloß vorübergehend unbrauchbarer Zeitbeleg verwirft -nicht mehr die Antwort oder den bereits erfolgreichen ersten Commit. -Keine ursprüngliche Gültigkeitsfrist wird verlängert. Auch der Helper wartet -vor seinem ersten Dispatch feiner; eine unklare Antwort löst keine -Execute-Wiederholung aus. - -Tatsächlich bestanden zuerst zwei gezielte Tests auf der Cloud-Linux-VM -und danach dieselben zwei nativ auf Windows: **je 2/2, keine Fehler**. -Die Coreprüfung verwendet beide echten SQLite-Commitphasen mit demselben -signierten Reply und vorübergehend ausfallender Uhr. Sie erzeugt keine Jobs, -Grants oder Zielwirkung. Der genaue eingefrorene Windows-GNU-Quellsatz -bestand zusätzlich alle Targets mit Clippy `-D warnings`. -[Native Resultate und exakte Quellen-/Binärhashes](evidence/windows-deferred-sync-20261116.json). - -Der korrigierte Wartungsstopp erfasste am 16. November um **11:55:25 MEZ** -den gemeinsamen Originalstand und die exakt erhaltene, noch unbeantwortete -reine Syncanfrage unter einer bestehenden SQLite-Schreibreservierung. -Dadurch konnten weder Antwortanwendung noch neue Permitreservierung committen. -Der Agent wurde genau einmal regulär gestoppt; keine SQL-Zeile, Identität, -Signatur, Anfrage oder Ergebnis wurde geändert oder gelöscht. Der Helper -blieb erhalten. Der vorherige erfolglose Fall wurde nicht überschrieben. - -Danach wurde ausschließlich die bytegleiche ursprüngliche passive -Konfiguration wieder eingesetzt und die alte Version passiv gestartet. -Der reguläre geprüfte Nachfolgerwechsel installierte um **12:06:57 MEZ** -Agent SHA256 `b24a248e1ebc7d9039c789965413c164b5f83d0f20d34f56d11d8485915905ca` -bei unverändertem Helper `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e`. -Alle Geräte-/PKI-/Journal-Dateikennungen blieben erhalten. Der zugehörige -Fall ist `969d319a-d1a0-41fb-b1af-afc17a26d775`. Zeitprofilveröffentlichung -und aktiver neuer Skriptlauf sind weiterhin gesondert nachzuweisen. diff --git a/docs/windows-passive-time-closeout.md b/docs/windows-passive-time-closeout.md deleted file mode 100644 index e482e2b..0000000 --- a/docs/windows-passive-time-closeout.md +++ /dev/null @@ -1,190 +0,0 @@ -# Lesender Abschluss zweier passiver Windows-Zeitbeobachtungen - -Der Collector `deploy/windows/passive_time_closeout.py` ist lokal vorbereitet -und ausführbar. Der native Abschluss über den auf dem Server laufenden Empfänger ist unten dokumentiert. Die -V2-Profileinrichtung und ihr ausdrücklich gemeldetes Zeitfenster stehen vor -dem Aufruf. Tunnel-/Zugangserneuerung, Profileinrichtung und Dienstwartung sind -keine Aktionen dieses Collectors. - -Der unabhängige Quellreview von `cc821246ccd98ee6d3dc5c1b12c7303d3010e8a7` -fand im engen Veröffentlichungsdelta keine konkrete Regression. Der Agent hält -pro Verbindung den ersten Vergleich je Rolle erst nach erfolgreichem eigenen -`complete` bzw. authentifiziertem Helper-`TimeCompleted` fest. Nur der aktuelle -Verbindungsowner schreibt beim Heartbeat. Ein verworfener Worker erhält keinen -Publikationspfad. Die JSONs sind historische Beobachtungen, keine aktuellen -Clockleases, Jobfreigaben oder unabhängig erneut verifizierbare Signaturpakete. - -Auf der Windows-VM liest der Collector ausschließlich die Inhalte von -`C:\ProgramData\RustDiscovery\state\agent-time-sample.json` und -`helper-time-sample.json`, jeweils höchstens8192Bytes, durch gehaltene Handles. -Singlelink, Nicht-Reparse, Dateigröße, native FileID/LastWrite und die -SYSTEM-/Administratoren-/Agent-Service-SID-DACL werden geprüft. Die -Verzeichnis-DACL und Dateisicherheit müssen während des Reads gleich bleiben. -Reparse-Vorfahren werden verweigert. Keine privaten Schlüssel-, Journal- oder -Konfigurationsinhalte werden gelesen. Kurze gehaltene Lesehandles können einen -gleichzeitigen atomaren Reporttausch vorübergehend verweigern; der bestehende -Publisher behält den Sample für einen späteren Heartbeat. - -Vor und nach diesem Read werden ausschließlich öffentliche CIM-/SCM- und -native Prozessmetadaten geprüft: beide festen Dienste Running, richtige -Konten/Startarten/Kommandos, Agent-/Helper-PID und Geburt, tatsächlicher -Prozessimagepfad und erwartete öffentliche Binaryhashes. Der Boot wird aus -demselben festen CIM-LastBootUpTime-Vertrag wie im Agenten abgeleitet. Es wird -kein Agent-, Helper-, SQLite-/Statusprobeprogramm oder IPC aufgerufen. Die -vorhandenen streng gepinnten Bootstraptransporte werden nur lesend verwendet; -C#-Interop enthält lediglich Query-APIs. - -Der bestehende `time_route_context` liest davor und danach ausschließlich den -öffentlichen registrierten Gerätekontext in einer Read-only-SQL-Transaktion -und die feste Gateway-/Serverbootbindung. Die beiden Serverzeugen müssen -identisch sein. Die Capabilitymenge muss exakt passiv bleiben. Beide Reports -brauchen dieselbe positive aktuelle Serververbindungsgeneration und denselben -aktuellen Windows-Boot; ihre Agent-PIDs müssen dem aktuellen Agentprozess -entsprechen. Rollen, Feldschema und Datentypen sind exakt; doppelte JSONkeys -werden bereits beim Rohparse verweigert. Verifier-UUID, Request- und -Response-SHA256 müssen zwischen den Rollen verschieden sein. - -Die Beobachtung muss nach der von Root belegten V2-Einrichtung und nach der -aktuellen Agentgeburt liegen. Beobachtungs- und Dateialter sind höchstens180s; -Publikationsverzug höchstens90s bei2s Zukunftstoleranz. Der aktuelle Windows- -UTC-Read muss höchstens10s vom lokalen Operatorzeitpunkt abweichen. Dies sind -Akzeptanzgrenzen für historische Daten, keine behauptete native Zeitgenauigkeit. -Fehlende/stale Belege und ein Generationenwechsel erlauben nur neue Readversuche. -Das Wartefenster beträgt180s; ein bereits begonnener vollständiger Readsatz -hat zusätzlich höchstens105s Transportbudget. Ein Timeout erzeugt einen -unvollständigen eigenen Beleg, niemals eine erfolgreiche Abnahme. - -Lokale private Fälle entstehen unter `devstate/windows-passive-time-closeout/`. -Rohantworten stehen vor ihrer Validierung auf dem lokalen Datenträger; -Acceptancereceipts binden die aktuellen Native-/Serverzeugen per SHA256. Die -Befehlsparameter für den späteren Aufruf sind die tatsächlich installierten, -qualifizierten Agent-/Helperhashes und Roots UTC-Untergrenze nach der -V2-Einrichtung. Keine frei wählbaren Guestpfade, Aktionen oder Abfrageprogramme. - -**Geplant, nicht ausgeführt:** - -```text -python3 deploy/windows/passive_time_closeout.py collect \ - --agent-sha256 \ - --helper-sha256 \ - --profile-after -``` - -Tatsächlich lokal ausgeführt und bestanden: - -```text -python3 -m py_compile deploy/windows/passive_time_closeout.py -python3 deploy/windows/passive_time_closeout.py guards -python3 -m unittest discover -s deploy/windows -p test_passive_time_closeout.py -``` - -Sechs lokale Fixtures prüfen aktuelle unabhängige Rollen, falsche PID/Boot/ -Generation/Rolle/Beobachtungsfrist, gleiche Verifier-/Request-/Responsewerte, -doppelte JSONfelder, fehlende Sicherheitsprüfung und fehlenden Helperbeleg. -Der zusätzliche Grenzfall prüft die tatsächlichen sieben .NET- und neun -Chrono-Nachkommastellen. Python3.10s ursprüngliches `fromisoformat` verweigert -diese Formen; dieser konkrete lokale Fehler wurde vor jedem Zielaufruf -behoben. UTC- und FILETIME-Grenzen werden jetzt vollständig mit Ganzzahl- -Nanosekunden verglichen. Ein Sample genau an der Installationsuntergrenze wird -akzeptiert, eine um1ns spätere Untergrenze verweigert dasselbe Sample. Keine -Native- oder Testzeit wird hierfür erfunden. -Danach lokal mit vorhandenem `/tmp/rmm-powershell-parser/pwsh` tatsächlich -ausgeführt: vollständiger Reader-AST ohne Parserfehler und Kompilierung der -C#-Querydefinitionen ohne Methodenaufruf bestanden. `Info` besitzt die -erwartete52-Byte-Interopgröße. Lokale Quittung unter -`devstate/windows-passive-time-closeout-local/receipt.json`; kein nativer -Win32-Aufruf oder VM-Zugriff. Windows-PowerShell5.1-/tatsächliche Win32-Reads -und echte Rollenbelege bleiben offen; lokale Prüfungen ersetzen sie nicht. - -Der konkrete Profileinsatz wurde zusätzlich unabhängig rein im Quellcode -geprüft (`time_profile_config.py`, SHA256 -`36f0451a146ca8dc73d4c66b48f2e65fbaefde5c7643133993d1c136cc3318de`). -Kein konkreter Befund im geprüften Schnitt: getrennte öffentliche Source-/ -Plattform-/Key-/Bindingketten, exakte neue Rollen mit PID/Geburt/Token-/Service- -SID/Image/FileID, SameLive-/Kernel-CAS vor und nach Veröffentlichung, -Intent-vor-ACL/Move, überschreibungsfreier gleichvolumiger Move und ausschließlich -ThisFolderOnly-Leserechte für die zwei Rollen. Die UTC-Untergrenze wird vor -dem ersten privaten Fallintent aufgezeichnet. Noch ungesetzte Paarbeleg- -Konstanten blockieren die Vorbereitung. Der konkrete spätere Rollen-/ -Readbackbinding-Delta und die tatsächliche Veröffentlichung bleiben separat -nachzuweisen. Dieser Review ist keine Profileinrichtung oder native Abnahme. - -Im laufenden Wartungsfenster folgte ein enger unabhängiger Quellreview des -konkreten SCM-ETS-Fixes (Clockoperator-SHA256 -`90c2708c17903e4bc630f6655dba38ff6448251941abd53f5874e991042b0f2c`). -Die tatsächlich gelesenen Int32-SID-Typen trugen PowerShell-ETS-Metadaten und -wurden vom bisherigen `PSCustomObject`-Zweig als Objekt behandelt. Der Fix -behandelt die primitiven CLR-BaseObjects zuerst und rekonstruiert reine -JSONskalare. Stringcase und vollständige Integerwerte bleiben erhalten; -NaN/Infinity werden verweigert. Arrayreihenfolge, Null, Keykollisions-/Tiefe- -und Wirkungs-CAS bleiben unverändert. Keine weiteren konkreten Findings im -geprüften Schnitt. Derselbe vollständige Comparator wurde im Profiloperator -SHA256 `8588241eac3036e665b6010e4bf9fac1547be88d68f95b4c02cb24e425267c68` -per reinem AST-Literalvergleich bytegleich bestätigt. Das ist ausschließlich -Source-Review, kein Zielaufruf oder Beleg einer ausgeführten Wartung. - -Falls Reports fehlen, können die bereits vorhandenen passiven Dateien -`helper-probe.json` und `pipe-last-error.json` getrennt nur lesend bei der -Pipeeingrenzung helfen. Sie enthalten keinen vollständigen Timeworkerfehler; -auch Metadaten vorhandener fester `.agent-time.pending`/`.helper-time.pending` -können eine unterbrochene Publikation erklären. Dieser Collector liest oder -ändert diese zusätzlichen Dateien nicht und löst keine Diagnose aus. - -### Nativer Abschluss am 15. November 2026 - -Der Empfänger auf dem permanenten Server prüfte um **20:41:27 Uhr MEZ** -beide nach der Veröffentlichung des Profils entstandenen Belege. Der Agent -beobachtete seinen Vergleich um `19:40:52.455414900Z`, der SYSTEM-Helper -seinen um `19:40:52.524631100Z`. Beide gehörten zu Verbindungsgeneration 145 -und demselben Windows-Boot. Verifier-UUIDs und die Hashes der beiden -Anfragen und Antworten unterschieden sich. Der Agent hatte PID 4420, der -Helper PID 10264. Die Serverzeugen vor und nach der Lesung stimmten überein. - -Fall `c23245b7-017e-4643-9872-849f262faf21`, Lesung 36. Der SHA-256 des -empfangenen Datensatzes lautet -`40d45a9cb3145f8b1159b7c5da0509dd043355aca23d4bec860f37205e3a8551`, -der des Abschlussbelegs -`f1a79eed223487fa61890ccb274986660b33f2596ae33e1689e9b2afdc7b8884`. -Beim separaten Rücklesen stimmten die zwei ursprünglichen Rollenberichte -mit den validierten Einträgen überein. Der Server führte weiterhin nur -`windows.base/1`, `heartbeat/1` und `agent.update/1`. Für einen späteren -Auftrag muss die Uhr beim Prüfen des Grants erneut die Frischegrenzen erfüllen. - -### Konsolenlesung des nachfolgenden Dienstpaars - -`deploy/windows/Read-JobPairTimeSamples.ps1` bindet den ursprünglichen Leser -mit SHA-256 `d9e2b9344c19af1296b86ec70ba754ef820f369ac5ec897979bd4233e0722d04` -an den Paarfall `49c230d8-fb5d-4c64-96b6-e0edce03ed90`. Vor dem Aufruf -muss die tatsächliche Verbindungsgeneration auf dem Projektserver gelesen -werden. Der Wrapper prüft die aktuelle Profilquittung und die Prozessgeburt -beider Dienste, die Rechte und Dateikennungen anhand der Leserausgabe, -den CIM-Bootbezug, die zwei unterschiedlichen Rollen und die Frische der -ungeschmälerten Originalreports. Bei fehlenden oder alten Beispielen liest -er bis zu zwei Minuten erneut. Für einen bereits laufenden Leseprozess -gilt ein maximales Einzelbudget von 30 Sekunden. - -**Geplanter Aufruf als Administrator auf dem Gast:** -`Read-JobPairTimeSamples.ps1 -Generation `. -Der unveränderte `Read-PassiveTimeSamples.ps1` muss daneben liegen. Die -lokale Quittung entsteht je Aufruf einmalig als -`samples-passive-.json` im Paarfall. Sie enthält die -Originalreports in Base64, ihre SHA-256, Sicherheits-/Dateimetadaten und -Prozesszeugen. Die Konsolenausgabe nennt den SHA-256 der Quittung. Für -die vollständige Abnahme muss der Betreiber danach die identische -Servergeneration und denselben Windows-Boot sowie die Zeit des Reads -unabhängig anhand der Serveruhr bestätigen. Der Wrapper meldet seinen -lokalen Befund, ohne eine serverseitige Prüfung zu behaupten. - -`-AfterRestart` verlangt die Geburt eines später gestarteten Agentprozesses -und aktuelle Belege für genau diese Instanz. Der Build `fcec400` publiziert -die Dateien jeweils beim ersten erfolgreichen Vergleich einer **passiven** -Verbindung. Nach Umschaltung auf Jobbetrieb müssen Job-Sync und -Startgrant die aktuelle Freigabe belegen. Dateien aus einem früheren -Prozess können diesen Nachweis nicht erbringen. - -Lokal bestanden die Parserprüfung, je ein unverändertes Fixture für Agent -und Helper sowie neun Ablehnungsfälle für doppelte Felder, falschen Typ, -PID, Boot, Rolle, Generation, Schema und Zeitgrenzen. Die Boot-ID stimmte -mit dem vorhandenen Python-Prüfer überein. Zeitvergleiche unterschieden -eine Nanosekunde auch bei der neunstelligen Rust-Ausgabe. Die lokale Prüfung -enthielt keine Ausführung des Lesers auf dem Windowsgast. diff --git a/docs/windows-powershell-policy.md b/docs/windows-powershell-policy.md deleted file mode 100644 index e869b61..0000000 --- a/docs/windows-powershell-policy.md +++ /dev/null @@ -1,106 +0,0 @@ -# Windows PowerShell5.1: feste prozessbezogene RemoteSigned-Option - -Stand2026-11-14, Spezifikation1.18. **Userentscheidung als Sourcekandidat im -isolierten Profilbranch umgesetzt und nativ Linux-first vertraglich geprüft.** -Die23 Domain-/Coreverträge bestanden auf der Cloud-Linux-VM; Windows22 und die -tatsächliche genehmigte PowerShellwirkung bleiben offen. Keine Capability-, -Clock- oder Jobkonfiguration aktiviert, kein Deployment. Hauptcheckout und -laufende Windowsartefakte bleiben unverändert. [Tatsächlicher Nachweis](windows-profile-acceptance.md). - -## Autorisierter Umfang - -Der User erlaubt die feste Option `RemoteSigned` für jeden zuvor mit seinem -unveränderlichen Plan in der WebUI genehmigten Windows-PowerShell5.1-Jobprozess. -Der Prozessumfang und die Option müssen bereits vor der Genehmigung sichtbar -und Bestandteil der signierten Originaljobbytes sein. Das erlaubt keine -pauschale Skriptfreigabe, keinen direkten API-/DB-Genehmigungspfad, keine freie -Policyzeichenfolge und keine SYSTEM-/Root-PowerShell. Der erste SYSTEM-Vertrag -bleibt auf seine eigenen typisierten SCM-Fixturen begrenzt. - -Der Executor setzt dafür keine CurrentUser-/LocalMachine-/GPO-Werte, schreibt -keine Registryrichtlinie und verwendet kein `Bypass`/`Unrestricted`. Eine -Gruppenrichtlinie wird nicht verändert oder übergangen. Blockiert sie den -Auftrag weiterhin, wird der tatsächliche Fehler berichtet. Microsoft beschreibt -den Hostparameter als sitzungsbezogen und ohne Registryänderung; Gruppenrichtlinien -bleiben vorrangig. [Windows-PowerShell5.1-CLI](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_powershell_exe?view=powershell-5.1), -[Policybereiche und Vorrang](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1). - -## Kleinster vorgeschlagener Datenvertrag - -Ein optionales, am Ende ergänztes Feld `windows_execution_profile` in -`Action::RunScript` enthält eine endliche typisierte Enum mit zunächst genau -`powershell_51_remote_signed`. Das ist ein technischer Vorschlag zur Prüfung, -noch kein vorhandenes Schema. Der Wert bezeichnet fest Windows PowerShell5.1, -`agent_service` und RemoteSigned im Jobprozess; kein frei übergebbarer -Interpreterpfad, Scope oder CLI-Argumentblock. - -Das fehlende Feld behält die vorhandene Bedeutung `inherited`. Es wird per -Serde-default und `skip_serializing_if = Option::is_none` beim Kodieren vollständig -ausgelassen. Damit bleiben bisherige Linux-/PowerShell-Job- und Plangoldens -bytegleich; vorhandene Pläne erhalten nachträglich keine neue Prozessoption. -Die zusätzlichen Bytes eines neuen RemoteSigned-Auftrags gehen bereits in -`job_payload_hash`, Planhash und den bisherigen signierten Originalgrant ein. -Ein neuer Grantcodec oder ein neues pauschales Genehmigungsrecht ist dafür -nicht nötig. Geänderter Profilwert bedeutet geänderten Plan mit neuer -WebUI-Genehmigung, niemals nachträgliche Anpassung des genehmigten Payloads. - -Nur `interpreter=powershell`, `execution_identity=agent_service`, ein eindeutig -gemeldetes Windowsziel und die konkrete qualifizierte Profilfähigkeit dürfen -den Wert verwenden. Linux, posix_sh/bash, andere Interpreter, gemischte -Plattformcapabilities, Root/SYSTEM und unbekannte Profilwerte verweigern ihn. -Ein gesonderter Profilcapabilityname, beispielsweise -`script.powershell.process_remote_signed/1`, ergänzt `script.powershell/1`; -alte Windowsclients erhalten dadurch keinen unbekannten Auftrag. Die Benennung -und Veröffentlichung bleiben bis Review und tatsächlicher Qualifikation offen. - -## Konkreter Änderungsschnitt nach Freigabe der Quellen - -| Quelle | Eng erforderliche spätere Änderung | -| --- | --- | -| `crates/domain/src/jobs.rs` | Option/Enum, validate/available_for und unveränderte Legacygoldens. Nicht-Windows-/Nicht-PowerShell-Verwendung früh verweigern. Bestehende Konstruktoren erhalten ausdrücklich None ohne Wireänderung. | -| `crates/server/src/jobs.rs` | Feld je `Variant` mitführen: Web-resolve, validate_variants, target_action und Erstvarianten-Konsistenz einschließlich Profil. Gemischte feste Pläne binden das Profil ausschließlich in der Windowsvariante. Typed- und Webeingang gleich prüfen. Vorhandene Submit-/Approval-/Revalidationpfade behalten Hash- und Rechteprüfung. | -| `crates/server/src/job_gateway.rs`, `crates/server/src/synchronization.rs` | Vorhandene zentrale Capability-/Payloadprüfung für Zustellung und Permit prüfen; Erfolgsevidenz bindet angefordertes Profil und Prozessumfang, behauptet ohne Messbeleg keine effektive GPO-Policy. Keine Abschwächung der Grant-, Sync- oder Clockprüfungen. | -| `web/src/api.ts`, `web/src/safety.ts`, `web/src/main.tsx` | Eingabe nur als festes Windowsprofil; keine beliebigen Policyflags. Vor dem Genehmigungsknopf aus hashgeprüften gespeicherten Planbytes je Windowsziel ausdrücklich „Windows PowerShell5.1 · RemoteSigned · nur Jobprozess“ anzeigen. Fehlender/unlesbarer Profil-/Plannachweis blockiert die entsprechende Genehmigung. Alte inherited-Pläne ehrlich als solche zeigen. | -| `crates/agent-windows/src/actions.rs` | Profil prüfen und ausschließlich beim passenden signierten Auftrag `-ExecutionPolicy RemoteSigned` vor `-File` in die festen Einzelargumente aufnehmen. None behält vorhandene inherited-Argumente. Kein Wrapper, keine Prolog-/BOM-/Zeilenendenänderung und keine andere Skriptkopie nach Hashbildung. Evidenz nennt angefordertes Profil/Prozessumfang. | -| `crates/agent-windows/src/runtime.rs` | Neue Profilcapability erst nach separater nativer Clock-/Boot-/Jobpfadqualifikation veröffentlichen. Kein Aktivieren durch den bloßen Codec-/Buildwechsel. | - -Der vorhandene Prozessadapter nutzt bereits einen festen ausführbaren Pfad, -ein minimales eigenes Childenvironment sowie atomare Job-/Handlelisten und -begrenzte stdout/stderr-/Timeout-/Cancelpfade. Diese Verträge bleiben erhalten. -Es wird kein Policywert in die Umgebung des permanenten Agentdiensts übernommen. -Nach `-File` folgen ausschließlich die genehmigten Skriptargumente. Eine -angeforderte Prozesspolicy ist keine Behauptung der tatsächlich effektiven -Policy; bei Bedarf enthält eine separat genehmigte harmlose Abnahme selbst -die unveränderten read-only Get-ExecutionPolicy-Anweisungen als sichtbare -Skriptbytes. Kein stiller Zusatzprozess oder Scriptwrapper zur Liveerhebung. - -## Geplante minimale Nachweise, nicht ausgeführt - -1. Shared Domain-/Grantvertrag lokal prüfen: alte Linux-/PowerShell-Goldens - bytegleich; neues Profil vollständig im Payload-/Planhash; Profilmutation - gegen den Originalgrant verweigert; Linux/anderer Interpreter/Root/SYSTEM/ - unbekannter Wert/fehlende Profilcapability verweigert. Gemischter Plan behält - die unveränderte Linuxvariante und die feste Windowsprofilbindung. -2. Diese gemeinsam betroffenen Vertrags-/Negativfälle zuerst isoliert auf der - tatsächlichen Linux-Test-VM ausführen. Keine tatsächliche Windowsausführung - oder zusätzlich genehmigte Zielwirkung damit vortäuschen. Vorhandene Linux- - Jobhistorie/Grants und Jobzahlen bleiben unverändert; ein Crossbuild ersetzt - diesen Linux-first-Nachweis nicht. -3. Server-/UI-Negativfälle eng prüfen: Option im verifizierten Approvalplan - sichtbar; Mutation, Capabilityverlust und Widerspruch zwischen Variant und - Action verweigert; pending_approval ohne Job/Outbox/Startgrant. Kein API-/DB- - Approval als Testabkürzung. -4. Erst nach den separaten Clock-/Boot-/Jobgates auf der tatsächlichen Windows- - VM einen neuen festen harmlosen PowerShellplan in der WebUI genehmigen. - Prozess, SID, exakte Skript-/Ausgabebytes und angeforderte Option nachweisen. - Falls effektive Policy geprüft wird, stehen diese read-only Befehle bereits - im genehmigten Skript. Persistente CurrentUser-/Maschinen-/GPO-Werte vor/nach - der Abnahme unabhängig lesen und unverändert nachweisen. Kein Reboot für - diesen Skripttest, keine Maschinenpolicyänderung und keine neue Wirkung bei - Redelivery. Browser-Dev/Testsimulation nur sichtbar nach bestehendem Vertrag. - -Der bestehende W32Time darf nach neuer Userfreigabe ohne Startart-/NTP-/ACLänderung -gezielt gestartet werden. Ein späterer manueller VM-Konsolenneustart benötigt -vorher die konkrete Zeitabstimmung mit dem User und ist kein RMM-Reboottest. -Beides ist ein separater Umfang und ersetzt weder eine vertrauenswürdige Uhr -noch die WebUI-Genehmigung eines Skriptjobs. diff --git a/docs/windows-profile-acceptance.md b/docs/windows-profile-acceptance.md deleted file mode 100644 index 14cde7f..0000000 --- a/docs/windows-profile-acceptance.md +++ /dev/null @@ -1,701 +0,0 @@ -# Native Prüfung des optionalen Windows-Prozessprofils - -Stand2026-11-14: implementierter und unabhängig geprüfter Profilvertrag im -isolierten Branch `codex/windows-powershell-profile`. Domain-/Server-/Original- -Grantprüfungen, isolierter PostgreSQL-Fall, beide Windows-Cross-Clippy-Profile, -35Webtests, Typecheck und Webbuild lokal bestanden. Zwei UI-Aliasbefunde und -die zunächst akzeptierte Null-/Objekt-Profilform sind eng korrigiert. - -Anschließend bestanden auf der tatsächlichen Cloud-Linux-VM alle23 Vertrags- -prüfungen ohne Skips, Fall `f463acc9-ab77-4b70-bcfb-a016f40c9410`. -Gemeinsamer Build `005b26fd-8269-40dd-8a35-798fabb024a5`, Manifest-SHA256 -`26247a3a9c187e8ce315250ab3bb3a8b5c1fe681028b15143fb9f193e4af9c80`, -Linuxproof-SHA256 `7ecabd9a3ca8fac20aaa7a185b6e128735ea77f143988f058829ae642ad32d25`. -Danach bestanden alle22 Windows-Vertragstests ohne Skips, Fall -`9abd3e0d-d40f-4d6f-adc8-8fdbbefb98e8`, Windowsproof-SHA256 -`47cee8c9c449a45699641d53c0fca48b89a53a90dd22cfd03a2ab7675c0a348d`. -Der Windowsbeleg bindet denselben Build und den vorangegangenen Linuxproof. -Kein Deployment oder tatsächlicher PowerShell-Job; neue Profilcapability nicht -veröffentlicht. Der Hauptcheckout und seine zuvor qualifizierten Artefakte -bleiben für die ausstehende Komponentenwartung unverändert. - -`deploy/windows_profile_acceptance.py` ist ein eigener Bootstrap-Nachweisrunner, -kein RMM-Executor. Er verwendet ausschließlich zwei feste Unitprogramme: -Domain-Lib16 und Core-Contracts7 auf der Cloud-Linux-VM, danach Domain-Lib16 und -Core-Contracts6 auf der Windows-VM. Nur der Unix-OpenSSL-Paritätstest entfällt -unter Windows. Es werden keine Dienste, Produktjournale, PKI, Policies, -Capabilities oder RMM-Jobs verändert. SQLite-Fixturen entstehen ausschließlich -im eigenen temporären Testverzeichnis. Die Windows-Tests laufen als -Bootstrapadministrator; sie beweisen keinen LocalService- oder SYSTEM-Job. - -Der lokale Build erhält Original-Linkdateien neben den gestrippten Lieferkopien, -prüft beide Clippy-Ziele und führt die tatsächlich lieferbaren Linuxbytes lokal -mit `--list` und ungefiltert aus. Alle Workspace-Cargomanifeste, Lock/Toolchain, -Domain/Core/Protocol/Proto sowie Runner und Bootstraptransport werden vorher und -nachher gehasht. Windows-Testnamen sind bis zur nativen Ausgabe nur erwartet. -Der lokale Linuxlauf ersetzt keinen Linux-VM-Nachweis. - -**Aufrufschema; obige Fälle tatsächlich ausgeführt:** - -```sh -python3 deploy/windows_profile_acceptance.py build-local -python3 deploy/windows_profile_acceptance.py linux --manifest devstate/windows-profile/build-UUID/manifest.json --access-root /ABSOLUTER/PFAD/ZUM/HAUPTREPO --execute-native-tests -python3 deploy/windows_profile_acceptance.py windows --manifest devstate/windows-profile/build-UUID/manifest.json --access-root /ABSOLUTER/PFAD/ZUM/HAUPTREPO --execute-native-tests -``` - -`--access-root` dient ausschließlich dem streng geparsten bestehenden -SSH-Zugang: Cloud-Linux `` bzw. der unveränderten gepinnten -Windows-Reverse-SSH-Kette über Cloud-Loopback22240. Keine Credentialkopien, -Symlinks oder Hostkeyänderung. Alle Artefakte und lokalen Belege bleiben im -isolierten Profilworktree. Linux läuft mit geleerter Umgebung und eigener -Netzwerknamespace. Beide nativen Phasen prüfen vor dem ersten Teststart sämtliche -Testnamen beider Programme. Windows bindet den bereits verifizierten tatsächlichen -Linux-Beleg desselben Manifests über dessen SHA256. - -Jeder Fall hat eigene Create-once-Intents und Startbelege. Eine verlorene Antwort -erlaubt ausschließlich beispielsweise `readback-linux --manifest … --case UUID ---access-root …` bzw. `readback-windows`. Dieser Pfad lädt nichts hoch und startet -keinen Prozess erneut. Er kann `remote_case_absent`, `prepared_without_start` oder -`started_without_result` als unvollständigen Stand berichten. Ein neuer Fall ist -keine automatische Fehlerwiederholung. Originale Readbacks bleiben an das feste -Manifest, Intents und Runner-/Remotescripthashes gebunden; spätere Änderungen an -Produktquellen erzwingen keine neue native Ausführung und verhindern ihren -Readback nicht. Neue Starts benötigen weiterhin die exakt qualifizierten -aktuellen Quellen. Vollständige Ausgaben/Transportfehler bleiben privat, -Standardausgabe enthält nur Status, Fallkennung und Nachweishashes. - -### MCP-Planprüfung nach dem nativen Zeitvergleich am 15. November 2026 - -Um 20:44 Uhr MEZ las MCP die Windows-VM über ihre bestehende Geräteidentität -als online. Sie meldete über WSS weiterhin `windows.base/1`, `heartbeat/1` -und `agent.update/1`. Ein erster lesender Vorabcheck brach vor der Planung -ab, weil er für diese passive Verbindung fälschlich `sync_ready=false` -erwartete. Der Gateway setzt beim Hello ohne `rmm.sync.v1` den Wert -`sync_required=false` und damit `sync_ready=true`. Ein signierter -Job-Sync ist daraus nicht abzuleiten. - -Um 20:44:47 Uhr MEZ wies `operations.plan` für genau diese Windows-VM eine -PowerShell-Ausgabe einer festen Textzeile unter `agent_service` mit dem Profil -`powershell_51_remote_signed` als `UNSUPPORTED_CAPABILITY` zurück. Der -Windows-Agent veröffentlicht weder die Skript- noch die Profilfähigkeit. -Vor und nach der Plananfrage standen Jobs, Outbox-Einträge, Ausführungspermits -und offene Jobs dieses Geräts jeweils auf null. Es erfolgte kein Submit. -MCP-Korrelations-ID `b87605ab-69ce-4697-b9ed-9f5b1eeba22c`, -Beleg-SHA-256 `0df80d11f7e0ef5e300c4c9657dca3850dad839582b3ba945c1e69795fc68ecc`. - -Für die erste erfolgreiche Skriptabnahme braucht der Dienst die an das Gerät -gebundene Jobkonfiguration, qualifizierte Profilfähigkeit, signierten -Auftragsabgleich und beim Start erneut frische Zeitbelege. Darauf folgt der -unveränderliche Antrag mit Genehmigung in der WebUI. - -### Erster LocalService-Auftrag, Stand 15. November 2026, 21:44 Uhr MEZ - -Der gemeinsame Abnahmelauf kennt jetzt den festen Fall `windows_hello`. -Er adressiert ausschließlich die bestehende Windows-Test-VM. Das Skript -`Write-Output 'Zeitprofil-Test'` und die erwartete Ausgabe enden jeweils -mit CRLF. Der Plan bindet `agent_service` und -`powershell_51_remote_signed`. Der Browser prüft diese Angaben am gespeicherten -Plan und die sichtbare Prozessoption vor der Freigabe. Der Ergebnisvergleich -fordert neben Exit 0 und vollständiger Ausgabe auch die LocalService-SID, -den Skripthash und den prozessgebundenen Policybeleg. Die vorhandenen -Prüfungen für das Pending, den Freigabeaudit und die Anzahl der Startpermits -gelten für diesen Fall. - -Lokal bestanden beim Browser-Planvergleich ein positiver und elf negative -Fälle. Der Python-Lauf prüfte den festen Planinput, eine passende -Ergebnisquittung und neun abweichende Ergebnisse. Beim ersten lokalen -Negativlauf fing der Test eine andere Ausnahmeklasse ab als der Prüfer -warf. Der korrigierte Lauf mit dem gemeinsamen Abnahmefehler bestand. - -Tatsächlich ausgeführt wurde -`python3 deploy/cloud_mvp_acceptance.py --case windows_hello --execute-dev-test-ui`. -Der Lauf stoppte vor der Planung bei `actual_vm_capability_required`. -Der gespeicherte MCP-Kontakt um 21:42:59 Uhr MEZ war online, die -Verbindungsgeneration betrug 146. Das Gerät meldete seine drei passiven -Fähigkeiten. Jobs, Outbox, Permits und offene Aufträge standen auf null. -SHA-256 des serverseitig nachgelesenen Zustands im lokalen Beleg -`fd0c9af5f4df03a655fcb491212eb62c7777182f02a4e0a69633e5602985943c`. -Um 21:44:08 Uhr MEZ bestätigte eine lesende Transaktion für dieselbe -Generation `sync_required=false`, `sync_ready=true`, -`helper_sync_ready=false` und null Sync-Checkpoints. Ein neuer Plan, -eine WebUI-Genehmigung und eine Windows-Ausführung stehen aus. - -Der Browser erreichte um 21:46 Uhr MEZ die echte, private WebUI des -Projektservers über deren SSH-Weiterleitung mit TLS-Prüfung. Anmeldung, -sichtbare Kennzeichnung `SIMULIERT` und Abmeldung als -`simulated-testprincipal-a` gelangen. Die Sitzung meldete -`approval_origin=dev_test_browser_simulation` und `testsimulation=true`. -Der Server lieferte das Frontend-Bundle `index-CTgvl2jr.js` mit der -PowerShell-Profilanzeige. Der Browser öffnete und genehmigte bei diesem -Zugangscheck keinen Antrag. - -### Cloud-Linux-Nachweis für die explizite Profilaktivierung - -Am 15. November 2026 um 21:54:37 Uhr MEZ bestand auf der festgelegten -Cloud-Linux-VM der portable Test -`tests::remote_signed_requires_explicit_profile_jobs_and_binding`. -Die Konfigurationsdefinition, die Methode `profile_enabled` und der Test -stimmen als Quelltextabschnitte mit dem Windows-Agent in `fcec400` überein. -Mit dem Buildfeature `system-helper` akzeptiert die Konfiguration das -benannte Prozessprofil nur mit Job-Opt-in und Bindingpfad. Der Test -verweigerte einen fehlenden Opt-in, deaktivierten Jobbetrieb, einen -fehlenden Bindingpfad sowie ungültige Profilwerte einschließlich `Bypass`. - -Die x86-64-Testdatei lief mit UID 65534, ohne ergänzende Gruppen, mit -`no_new_privs` und in einem eigenen Netzwerk-Namespace. Der Aufruf mit -exaktem Testnamen endete mit Exit 0, einem bestandenen Test, null -ausgefilterten Tests und leerem stderr. Der Bootstrap entfernte das -temporäre Testverzeichnis auf der VM. Der Test verwendete lokale -Konfigurations-Fixtures. Windows-Dateirechte, LocalService-Jobbetrieb und -die Genehmigung in der WebUI brauchen eigene Nachweise. - -| Prüfgegenstand | SHA-256 | -| --- | --- | -| Originalquelle `runtime.rs` aus `fcec400` | `4f94cce2c0557436cef4ea5accffb4778af2a3faeb7339cea16592c30872b479` | -| Extrahierte Testquelle | `2f338af46f38ebe72471dbdc81b0416947a20000bfad18be5b2f626c5c8a5812` | -| Testmanifest | `df3fadfa8e94a710de99546c21b6b74635ac9ea70e8a157583ef7bae05cd76e8` | -| Linux-Testdatei | `2168e5a6c31e2349b67ad81bcc58a711c3e37a0f03b7fecf0ca24281c5b72b6b` | -| VM-Beleg im Fall `28fac5aa-66e4-466f-93fc-f97062031d43` | `ee3a2c99651491a2fd876f1a3463919dc32d9509d9f9ef4eb73a36aa848bb56d` | - -### Native Windows-Profilprüfung des neuen Agenten - -Am 15. November 2026 um 21:56:30 Uhr MEZ bestand auf der Windows-VM genau -`runtime::tests::remote_signed_requires_explicit_profile_jobs_and_binding` -aus dem Release-Testprogramm des Commits `fcec400`. Ergebnis 1 bestanden, -7 gefiltert, Exit 0. Der vor dem Start nachgelesene SHA-256 der EXE war -`7d1715dc105c1eb482405511e1b3abf4437c448e186e73923c43dd3c7938710e`. -Der Konsolencontroller meldete Windows PowerShell **5.1.26100.9818** (x64). -SHA-256 des auf dem Gast erzeugten JSON-Belegs -`48de474d842ebc87550ba2e27b66086e6aa573973f252f4b8e19ac7b12b75a63`. -Für die Übertragung diente ein temporäres schreibgeschütztes Testmedium. -Der Test lief in der bereitgestellten Administratorkonsole. Er prüfte die -Profilwahl im neuen Build. Die Ausführung als auftragsverarbeitender -LocalService-Dienst muss weiterhin über die normale Genehmigungsstrecke folgen. - -Im selben Gast wurde der neue Agent mit SHA-256 -`df80b00fc2119b973d690053b9f9e4bdedd8fbc211f67599c3301eeb42e7702f` -in das geschützte Bootstrap-Verzeichnis kopiert und dort erneut gehasht. -Im Wartungsfall `49c230d8-fb5d-4c64-96b6-e0edce03ed90` bestätigten die -beiden Controller ihre Vorbereitung. Sie prüften den laufenden Vorgänger, -seine öffentliche Bindung und die Dateirechte und legten die Kandidaten und -Rückkehrkopien an. Die Dienstkonfiguration blieb dabei passiv. - -Beim passiven Dienstwechsel stoppte der Controller Agent und Helper. Vor -dem ersten Dateitausch scheiterte das Öffnen der Arbeitskopie für -`FlushFile` mit „Zugriff verweigert“. Der erste diagnostische Leseaufruf -verwendete einen falschen Fallverzeichnisnamen. Der korrigierte Aufruf las -den ursprünglichen Fall und bestätigte bei Agent, Helperkonfiguration -und Gegenstellen-Pin jeweils ursprüngliche FileID, Hash und ACL-Hash. -Beide Dienste waren gestoppt. Es gab die Vorbereitungs- und Stoppbelege, -aber keinen Ersetzungsbeleg. Quelle und Arbeitskopie waren 23.541.484 -Bytes groß, hatten den erwarteten SHA-256 des neuen Agenten und trugen -das vom Installationsmedium übernommene Windows-Dateiattribut `ReadOnly`. - -Die native Nachprüfung zeigte genau einen Dateilink für die getrennte -Arbeitskopie. Der Reparaturcontroller entfernte ausschließlich an dieser -Kopie das `ReadOnly`-Attribut. Er setzte den begonnenen Austausch fort -und las beide Dienstrollen nach dem Start zurück. Der neue Agent meldete -sich um 22:07:50 Uhr MEZ per WSS mit derselben Geräte- und Zertifikatsidentität -in Generation 147. Beide Dienste liefen, der Helper blieb bytegleich und -die drei gemeldeten Fähigkeiten blieben passiv. Jobs, Outbox und Permits -betrugen jeweils null. MCP-Nachweis -`81a748d9c9ee54dc6bc25d5db469f57c8fedb4fc09ce98ac4115fb13957d51d8`. - -Die getrennte Nachlesung beider laufenden Dienste bestätigte das neue -Agentimage und den unveränderten Helper. Auf der VM entstand daraus der -Nachfolgerentwurf des öffentlichen Zeitprofils im selben Wartungsfall. - -Der Controller veröffentlichte Revision 2 auf der Windows-VM. Der Server -sah um 22:08:59 Uhr MEZ dieselbe eingeschriebene VM mit denselben drei -passiven Fähigkeiten in WSS-Generation 148. Der unabhängige MCP- und -Serverbeleg hat SHA-256 -`54fda5e0935609d084b89e475b3ad612ff1730d8b2f341b33989cd249fe59486`. -Jobs, Outbox und Startpermits standen jeweils bei null. Die erste native -Auswertung der Rollenmessungen brach vor dem Schreiben eines Belegs ab. -In Windows PowerShell 5.1 war die .NET-Assembly für den JSON-Leser im -frischen Prozess noch nicht geladen. - -Nach dem expliziten Laden der .NET-Assembly startete ausschließlich der -passive Windows-Agent neu. Beide Dienste liefen. Der Windows-Leser prüfte -zwei unabhängige signierte Rollenmessungen vom 15. November um -21:13:49 UTC und schrieb den Beleg -`a1959583-44f4-47db-aff4-f0229468a15b`, SHA-256 -`34fe01eb8413c37f7e5269e1465d764bf730aa46b1a6cc371f113c7f9d285c9a`. -Der Server bestätigte WSS-Generation 149 und Boot-ID -`a9ad0895-5a96-8f2c-8fb6-cfdc2d5225ea`. Vor der Aktivierung -zählte er null Jobs, Outbox-Einträge, Permits und signierte -Job-Sync-Entscheidungen in dieser Verbindung. - -Um 21:15:36 UTC erreichte der neue LocalService-Agent den Server im -befristeten Jobmodus. MCP meldete erstmals für diese VM gleichzeitig -`run_script`, `script.powershell/1`, -`script.powershell.process_remote_signed/1` und `rmm.sync.v1`. -Für Verbindung 150 lag eine signierte Sync-Entscheidung vor, -`sync_required` und `sync_ready` waren wahr. Der Server meldete keinen -Restore-Block und weiterhin null Jobs, Outbox-Einträge und Permits. - -Die erste Entscheidung in Generation 150 um 21:15:39 UTC lautete -`CONSISTENT` (Agent-Checkpoint 6755, Helper-Checkpoint 1). Um 21:15:42 -UTC verweigerte der Server beim nächsten Abgleich die Freigabe mit -`HELPER_CHECKPOINT_REQUIRED` (6756/1). Der zweite Request enthielt bei -bereits serverseitig bekanntem Helperjournal keine bestätigte -Vorgängerentscheidung des Helpers. `restore_blocked=true` und -`sync_ready=false` blieben auch bei weiteren Heartbeats sichtbar. -Der End-to-End-Lauf brach an `signed_sync_gate_required` vor -`operations.plan` ab. Es entstanden weder Antrag noch WebUI-Genehmigung, -Job oder Startberechtigung für das Testskript. - -Die lesende SQLite-Diagnose auf der VM fand in beiden Journalen die -ablehnende Entscheidung `0633a4de-7e52-4e5d-a2a1-59fb134817fe`. -Der Agent hatte zwei Abgleichanfragen, keinen ausstehenden Request und -den dauerhaften Fehler `HELPER_CHECKPOINT_REQUIRED`. Der Helper hatte -eine gespeicherte Entscheidung und keinen eigenen Journalfehler. -Der Controller schloss das Jobfenster. Um 21:20:24 UTC meldete -sich der Agent wieder mit ausschließlich passiven Fähigkeiten in -Verbindung 151. Gerätezertifikat, Einschreibung und Zuweisung -blieben erhalten. Der Server zählt für die VM null Jobs, Outbox-Einträge, -Startpermits und ungeklärte Jobs. Er führt die Wiederherstellungssperre -weiterhin. MCP-/Serverbeleg -`3e646d8d8366e7b84456ec4739e6b640ca4211485929e341452a7d11cc2069ef`. - -Eine zweite native Lesung korrelierte beide Request- und Entscheidungs-IDs -mit den drei SQLite-Journalen. Der Agent speicherte beide Antworten und -übernahm beide in sein Verbrauchsjournal. Der Helper speicherte allein -die zweite, ablehnende Antwort. Damit liegt die Unterbrechung nach dem -lokalen Commit der ersten Antwort und vor deren dauerhaftem Helper-Commit. -Die Daten geben den genauen Fehler dieses ersten IPC-Aufrufs nicht her. -Die ursprüngliche passive Konfiguration war um 21:20:22 UTC wieder aktiv, -SHA-256 `7c9f6f3642ef84337c3cd761d8a4788c4babe81522fdd987a3eb9b819bc8d851`. -Die native Dienstabfrage bestätigte beide Dienste als laufend. - -### Entscheidung zur Wiederherstellung dieser Testinstallation - -Spezifikation Kapitel 0, Version 1.10, regelt einen ungesendeten -Sync-Request. Hier speicherte der Server beide Requests und signierte -beide Entscheidungen. Der vorhandene Reparaturpfad für -`CHECKPOINT_CHAIN_MISMATCH` deckt diesen Befund nicht ab. - -Zur Entscheidung steht ein eigener, auf diesen wirkungslosen -Entwicklungsfall begrenzter Wiederherstellungsnachweis. Er soll die -erhaltenen Originaljournale einschließlich beider signierten Antworten, -den gemeinsamen Ablehnungsstand und die Abwesenheit von Jobs und Grants -belegen. Die Geräteidentität und die Historie sollen erhalten bleiben. -Erst ein anschließender regulärer signierter Abgleich beider Rollen -kann die Bereitschaft herstellen. Der PowerShell-Auftrag braucht weiterhin -seinen eigenen MCP-Antrag und die WebUI-Genehmigung. Dieser Vorschlag -wurde auf der VM nicht ausgeführt. - -Der Betreiber hat der historienerhaltenden Wiederherstellung für diese -eine Windows-Testinstallation zugestimmt. Die anschließende lesende -Nachprüfung auf dem Projektserver zeigte den Unterschied zwischen -Entscheidungshistorie und gültigem Vorgänger. Die Historie enthält -die beiden Entscheidungen 6755 und 6756. In `agent_sync_state` steht -weiterhin **6755** mit Entscheidung -`b6a3101f-68ad-41c8-be4e-4c7c2bc963d6`. Die signierte Ablehnung 6756 -im Audit ist kein gemeinsamer gültiger Ausgangspunkt. Um 21:33:43 UTC -sah MCP dieselbe Geräteidentität online mit passiven Fähigkeiten. -Jobs, Outbox, Permits und ungeklärte Jobs standen bei null. Der -zusammengefasste lokale Beleg hat SHA-256 -`90c5ba5f01985266d7e2d41f62c0d975fbcb0d967a9cb6c02789744849aca16c`. -Die bestehende WebUI bietet für diesen Befund keine Wiederherstellung -an. Die vorhandene CLI behandelt den anderen Fall eines ungesendeten -Requests. Der native PowerShell-Auftrag bleibt offen. - -Der Helper erstellte Checkpoint 1 um 21:15:37,560764600 UTC. Der -signierte Ausstellungszeitpunkt der ersten Entscheidung lag bei -21:15:39,528352853 UTC. Die Entscheidung folgte damit rund 1,968 Sekunden -auf die Erfassung. Eine zeitlich vor der Erfassung ausgestellte Antwort -scheidet für diesen Fall aus. - -### Vorbeugende Korrektur im Windows-Abgleich - -Nach dem lokalen Speichern einer signierten Entscheidung wartet der -Windows-Agent auf die zugehörige bestätigte Helper-Antwort. Solange diese -aussteht, kann er keinen Folgeabgleich mit leerem Helper-Vorgänger senden. -Nach einem Prozessneustart prüft er den gemeldeten Vorgänger gegen sein -dauerhaftes Journal. Bei belegter Belegung vor dem IPC-Versand kann er -denselben signierten Inhalt innerhalb der bestehenden Frist zustellen. - -Die lokale Prüfung bestand mit 28 Reconcile- und 31 Helper-Reconcile-Tests -sowie Windows-Cross-Clippy mit `system-helper` und `-D warnings`. -Der neue Regressionstest reproduziert fehlende und fremde Vorgänger nach -dem ersten lokalen Commit und akzeptiert den später bestätigten richtigen -Vorgänger. Die bestehende Sperre der VM bleibt im Journal archiviert. - -Am 15. November 2026 um 21:28:50 UTC bestand auf der tatsächlichen -x86-64-Cloud-Linux-VM genau der Regressionstest -`windows_unconfirmed_helper_head_cannot_replace_a_committed_decision`. -Er verwendete zwei temporäre SQLite-Datenbanken, einen Fixture-Schlüssel und -einen simulierten SYSTEM-Helper. Er prüfte, dass nach einem Neustart bei -fehlender oder fremder Vorgänger-ID weiterhin genau ein Request im Journal -steht und die Startfreigabe geschlossen bleibt. Mit der bestätigten -Vorgänger-ID ließ er den Folgeabgleich zu. - -Der Prozess lief als UID 65534 ohne ergänzende Gruppen, mit -`no_new_privs` und eigenem Netzwerk-Namespace. Ein Test bestand, 27 wurden ausgefiltert. -Der Prozess endete mit Exit 0 und leerem stderr. Das Fixture-Verzeichnis war nach dem -Test leer. Der Bootstrap entfernte anschließend das temporäre Testprogramm -und sein Verzeichnis. Die Windows-IPC-Zustellung und der bereits -gesperrte Zustand der Windows-VM benötigen eigene Nachweise. - -| Prüfgegenstand | SHA-256 | -| --- | --- | -| Agent-Core `src/reconcile.rs` | `d924e3cfd1f782169f3dee4dd7875cd5fba493fbaecb64e13abcb16729be9f74` | -| Fixture `tests/reconcile.rs` | `e0ba24b22b3259b7b39727ed227612b75deaf6904bc9a563da2ad9709f6d4d79` | -| Linux-Testprogramm | `9d66dfbcc5edb87c530c730e50ac187a3558a97895394f194e1b9f9ae2a72bc0` | -| VM-Beleg im Fall `76b4ff2a-c07d-4af5-944a-a1392081b86b` | `8e694af5cc007c7db8b935f78b084510c481a6830732280d78cc723a7fdff91c` | - -Anschließend bestand derselbe Regressionstest auf der tatsächlichen -Windows-11-VM mit dem GNU-Windows-Testprogramm, SHA-256 -`31fcf0d9d933fc797c7abf2bdeaaf7a3daf3e9ea4c95db82a978bfe924b9f3b3`. -Die native Konsole meldete einen bestandenen Test, null fehlgeschlagene -und 27 gefilterte in 0,13 Sekunden. Die SQLite-Daten lagen im eigenen -temporären Testverzeichnis. Diese Prüfung betraf den Agent-Core. -Der erste vom installierten Agenten ausgeführte WebUI-genehmigte -PowerShell-Auftrag steht aus. - -Der abschließende Windows-Runtime-Build hält nach dem Wiederverbinden -auch weitere lokale Helper-Erfassungen an, sobald er den unbestätigten -Vorgänger erkannt hat. Formatprüfung und Windows-Cross-Clippy für alle -Targets bestanden. Die GNU-x86-64-Releaseprogramme mit `system-helper` -wurden gebaut. Agent-SHA-256 -`aaf626cda6e1d89c3fd97c824bbcf2d10f7e5c156229a068fa15f08cfecf366e`, -Helper-SHA-256 -`19c7f53ef168d7128674464c721d9eaf77fce60a53682889600f13e470f45faa`. -Der installierte passive Dienst verwendet weiterhin den in der -ursprünglichen Zeitprofilprüfung nachgewiesenen Build. - -### Lesende Prüfung der gespeicherten Originalsignaturen - -Am 15. November um 21:35:08 UTC wurden die zwei ursprünglichen signierten -Entscheidungen auf dem Projektserver in einer einzigen lesenden -PostgreSQL-Transaktion erfasst. Der Prüfer verglich sie mit der bereits -vor dem Vorfall gebundenen öffentlichen Geräte-/Jobkonfiguration und -verifizierte beide Ed25519-Signaturen über die Originalbytes. -Schlüsselkennung `4338aabe7e7ba77428e969750a7a5323d7b7349aa52ef7e1a5f24c90be12ca7a`. - -| Checkpoint | SHA-256 der Entscheidungsbytes | SHA-256 der Originalsignatur | -| --- | --- | --- | -| 6755 | `5806d49eed772c4f460ddb97388e8a51ec19df705ac2a55e54114a382aef62f3` | `f6cbfee524e287e59130220f33a4e6f3469ee1a817e69235560e7a53f4cc6d6e` | -| 6756 | `c6ad2a8016a2b2997f934ad5e2daabc1d585b45d07b94d7d4ed146a10ed303f3` | `96caf5401915ca4f8f28ee21ecb8dbfdc3d705c3b89bd40160ff15dbb75a2d08` | - -Beide Entscheidungen betreffen dieselbe Geräteidentität, Boot-ID und -Verbindung 150. Beide enthalten null Jobversuche. Der mit den -Ausführungszählern erfasste Prüfbeleg hat SHA-256 -`7ad17c48c74638a015bb62caae16365c6ff44a70f3b1a5a7357b28de7686b3da`. - -Zwei lokal veränderte Kopien derselben zweiten Serverlesung dienten als -Negativproben. Der Prüfer verwarf eine ersetzte Signatur und ebenso -einen fälschlich als gültigen Vorgänger eingetragenen Checkpoint 6756. - -Auf der Cloud-Linux-VM prüfte das Fixture -`tests::verifies_two_originals_and_rejects_changed_history` die -Journalgegenprüfung am 15. November um 21:38:31 UTC. Beide -Originalsignaturen der Testdaten bestanden. Das Fixture wies einen -fremden Schlüssel und eine veränderte Verbrauchsquittung ab. Ein Test -bestand mit Exit 0 als UID 65534 im eigenen Netzwerk-Namespace. -Fall `97130142-3ac3-4d7d-b086-f366e99d9a30`, SHA-256 des Belegs -`36368fb6325448e4d0e66e431542ac98e8ccc1d722e2ec32720daf0bba4e6870`. - -Der native Leser lief danach auf der Windows-11-VM, EXE-SHA-256 -`89051f44c5329e3f2ee980c65b1b7966e9c33c787ae3302d7e5695ca9fdaf54e`. -Er öffnete die drei bestehenden SQLite-Journale lesend und verifizierte die -Originalsignaturen anhand der dort installierten öffentlichen Bindung. -Schlüsselkennung, beide Request-Hashes und alle vier oben aufgeführten -Entscheidungs- und Signaturhashes stimmten mit dem unabhängigen -Serverbeleg überein. Beide lokalen Rollen führen die Ablehnung 6756 -als letzte Entscheidung. Der Helper hat genau eine Entscheidung. Der -Agent meldete `HELPER_CHECKPOINT_REQUIRED`, null Jobs und null -verbrauchte Grants. SHA-256 des privaten Konsolenbelegs -`045adc0363ae91d1aea6dae33940a8df9b45c9090089bf8e5cfb37f9d868151e`. - -Nach der Prüfung lag wieder das ursprüngliche VM-Medium im Laufwerk. -Um 21:39:57 UTC bestätigte der Server weiterhin die passive Verbindung -151, dieselbe Boot-ID und die aktive Wiederherstellungssperre. -Der Fall ist diagnostisch bestätigt. Die Installation ist für Jobs -weiterhin gesperrt und es liegt keine PowerShell-Abnahme vor. - -### Administrativer WebUI-Wiederherstellungsweg in Entwicklung - -Die neue WebUI zeigt für die bestehende Windows-Testinstallation den festen -Historienbeleg mit Serverhead 6755 und lokalem Ablehnungshead 6756. Vor der -Bestätigung prüft sie den kanonischen SHA-256 des gespeicherten Belegs. -Die administrative Bestätigung verlangt eine persönliche OIDC-Sitzung und -die eigene Berechtigung `recovery:confirm`. Sie erzeugt eine befristete -Quittung zur unabhängigen Prüfung auf dem Gast. Das ist eine zusätzliche -menschliche Bediengrenze des neuen Wiederherstellungswegs. Die bisherige -simulierte Jobabnahme bestätigt diese Recovery nicht. - -Typecheck, Produktionsbuild und alle 59 Webtests bestanden lokal. Die vier -gezielten Recovery-Verträge prüften feste Belegbindung, manipulierte Daten, -Sitzungs-/Rechtegrenzen und vollständig gespeicherte Bestätigungsdaten. -Die WebUI ist noch nicht auf dem permanenten Server veröffentlicht. -Die aktuelle Liveauskunft `/auth/config` lieferte HTTP 200 mit -`oidc_configured=false` und `dev_login_enabled=true`. Die Angaben zum -tatsächlichen Identitätsanbieter sind beim Betreiber angefragt. - -Der dazugehörige Serverweg besteht aus lesbarem Prüfantrag, einer separat -berechtigten menschlichen Bestätigung und dem Download der signierten Quittung. -Er ist ausschließlich im Entwicklungsprofil registriert. Ein simuliertes -Principal oder ein Bearer kann die Bestätigung nicht auslösen. Die Bestätigung -prüft die zwei historischen Originalsignaturen und den gegenwärtigen -Geräte-/Serverstand erneut. Der gültige Kontrollhead wird monoton auf 6756 -übernommen, ohne Bereitschaft oder Ausführungsjobs zu erzeugen. - -Zwei isolierte PostgreSQL-Tests bestanden. Eine frische Datenbank erhielt alle -Migrationen 0001 bis 0017. Die zusätzliche Upgradeprobe erhielt den zuvor unter -0016 gespeicherten Fremdtenant-Assetmarker; Mitgliedschaften erhielten keine -implizite neue Berechtigung. Geprüft wurden unter anderem Simulation, Bearer, -fehlendes Recht, deaktivierte OIDC-Identität, manipulierte Signatur, falscher -Beleghash, Fremdtenant, idempotente Wiederholung und Null-Jobartefakte. -Das positive Fixture verwendete eine synthetische menschliche Sitzung. -Es ist keine tatsächliche Betreiberfreigabe. Fixture-Protokoll SHA-256 -`ee854f4fa2d26af9fd0b1e06335b5c1d2f9285359fc62fcc1251fbcb4114cc14`. -Server-Clippy mit `--all-targets -- -D warnings` bestand lokal. - -Der Transaktionskern des Gastwerkzeugs bestand am 15. November um -22:24:08 UTC auf der tatsächlichen Cloud-Linux-VM als UID 65534 in einem -eigenen Netzwerk-Namespace. Der Test -`local::tests::archived_human_review_preserves_both_journals` prüfte drei -synthetische SQLite-Journale, gültige Archivierung, idempotenten Replay, -Archivabweichungen, fremde/simulierte Quittungen sowie die Verweigerung bei -fremden Jobs und Triggern. Ein Test bestand mit Exit 0, leerem stderr und -entferntem Scratch. Beleg SHA-256 -`d3ddc49227e9d45a47f564e928d0fb41e6afa6cd3b65f769bd4a4054e57b08e1`. - -Derselbe Transaktionstest lief anschließend nativ auf der Windows-11-VM. -Das x86-64-Testprogramm hatte SHA-256 -`c21e3a04424431baa0eca8c024538607059b0888b990e5493ee523a3a5f1894d`. -Die Konsole meldete einen bestandenen Test, null fehlgeschlagene und null -gefilterte in 0,01 Sekunden. Alle SQLite-Daten waren synthetische -In-Memory-Fixturen. Die tatsächlichen Agentjournale wurden dabei nicht -repariert. Das ursprüngliche VM-Installationsmedium wurde wiederhergestellt. - -Das echte Windows-Operatorprogramm wurde anschließend über seinen regulären -lesenden Einstieg `read` auf der bestehenden VM ausgeführt. Es bestätigte -`verified contracted history; fault=HELPER_CHECKPOINT_REQUIRED`. Dabei las es -die vorhandenen drei Journale und beide geschützten Schlüsselbindungen. -EXE-SHA-256 -`6ea40e8e85dc0d01927c4be5a01bc7a18afce1d3313ebbf080713a621188d558`. -Release-Build und Windows-Clippy mit `-D warnings` bestanden. Der normale -Apply-Einstieg ist vorbereitet und verlangt die unabhängige menschliche -Quittung, gestoppte Dienste, beide gehaltenen Prozesslocks, die unveränderten -Originaljournale und den passenden passiven Konfigurationsstand. Er wurde -auf dieser Installation nicht ausgeführt. - -Der API-Build lief danach nativ auf dem ARM64-Projektserver mit der -vorhandenen qualifizierten Buildstufe und ohne Netzwerkzugang. Das Paket -prüfte den ursprünglichen API-Binärhash vor der Änderung. Ergebnis Exit 0, -Image `fb1a33cbdf76999585588426d1c507c26903f2b4cb11887665b372f5cb8e6b6d`, -neuer Serverbinärhash -`93e895d29e11c2a192e532da0ead446854707524a7f376331b17cb02d9053d90`. -Das Source-/UI-Paket hat SHA-256 -`80f21a49e73621a3652085c3dfe520667c514e8f3b653694f28a2dc0d9881666`. -Der Build startete keine neue API- oder Gatewayinstanz. - -Migration 0017 wurde auf dem permanenten Projektserver erfolgreich über den -regulären SQLx-Migrationspfad ausgeführt. Beide neuen Tabellen erzwingen -Mandantentrennung per RLS. API, Gateway und PostgreSQL liefen während dieses -Schritts mit ihren vorherigen Prozess-/Containeridentitäten weiter. Die -Vorprüfung korrigierte zuvor ausschließlich ihre Mount-Metadatenabfrage: -Docker stellt den Broker als `RW=false` dar und lässt das Textfeld `Mode` -leer. Die tatsächlich schreibgeschützte Bindung war vorhanden. - -Die API wurde am 15. November um 22:29:24 UTC auf den ARM64-Build gewechselt, -anschließend wurde die geprüfte WebUI veröffentlicht. Nachprüfung bestätigte -Image-/Binärhash, unveränderte API-Konfiguration, dieselben laufenden Gateway- -und PostgreSQL-Container und die unveränderte schreibgeschützte Zeitbrokerbindung. -Sechs bisherige Webassets blieben erhalten. Die API antwortete anschließend -über echtes MCP. Die Windows-VM war online, Jobs/Outbox/Permits/ungeklärte Jobs -blieben jeweils null. `/auth/config` bestätigte weiterhin ausschließlich den -vorhandenen Entwicklungslogin und `oidc_configured=false`. - -Bei weiterer Verwaltung der API ist zum bestehenden Compose plus -Zeitbroker-Overlay das private Release-Overlay -`/opt/rust-discovery/devstate/human-review-e19a9c80d438/package/review-images.compose.yaml` -hinzuzunehmen. Es bindet API und Migrationsdienst an den neuen Build. - -Der echte Browserlauf auf der veröffentlichten Oberfläche bestand mit -normaler TLS-Prüfung und dem sichtbar simulierten Testlogin. Er öffnete das -Inventardetail der exakten Windows-VM und hinterlegte den Prüfantrag -`2d9ace19-bf64-4c31-91ed-03ed8b3ad6ff`. Der Browser prüfte die festen -Belegbytes und die sichtbaren Journalstände. Die administrative Bestätigung -war für diese Sitzung nicht verfügbar. Ein früherer Lauf wartete wegen -asynchronem Laden zu früh auf die Anzeige; der korrigierte Lauf las den -persistierten Stand und endete erfolgreich um 22:31:27 UTC. Beleg-SHA-256 -`46738cf3a1dc4df183a334ee6fccaf8c767ae7a6acbf57db76ec760ad8c02fdd`. -Die anschließende SQL-Lesung ergab einen Antrag, null Quittungen und -weiterhin Serverhead 6755. Die Windows-VM meldete sich passiv weiter; -der Server führte um 22:32:07 UTC weiterhin die Wiederherstellungssperre. - -Für die tatsächliche Bestätigung fehlt die persönliche OIDC-Anmeldung des -Betreibers mit explizitem `recovery:confirm`. Diese Trennung wurde beim neuen -Administrationsweg bewusst zusätzlich zur bisherigen simulierten Jobabnahme -umgesetzt. Die Angabe zum vorhandenen Identitätsanbieter ist noch offen. -Native Apply und erster genehmigter PowerShell-Job sind deshalb weiterhin -nicht abgenommen. Nach Bestätigung sind der Gast-Apply, der korrigierte -Agentcode mit neuer Profilbindung, frische Zeit-/Syncbelege und der eigene -MCP-/WebUI-Skriptplan die nächsten Schritte. - -### Fester PowerShell-Test ohne OIDC, Version 1.25 - -Der Betreiber verlangt die selbst bediente Testgenehmigung im lokalen -Entwicklungslogin. Die zusätzliche WebUI bindet dafür den regulär gespeicherten -PowerShell-Antrag an genau einen Testscope mit Plan-, Job- und Versuch-ID, -Payload-/Skripthash, LocalService, 60 Sekunden und 65536 Ausgabebytes. -Die Review-Ansicht prüft den kanonischen Scopehash sowie den unveränderten -historischen Witness. Ihre Bestätigung ist sichtbar simuliert. Die -anschließende eigentliche Jobplangenehmigung bleibt ein separater WebUI-Schritt. -Der gezielte UI-Test verwarf geänderten Interpreterinhalt, SYSTEM-Identität, -geänderte Limits und fremde Ziel-/Antragsbindung auch bei neu berechnetem -Scopehash. Typecheck und Webbuild bestanden lokal. Der neue Testpfad ist zu -diesem Zeitpunkt noch nicht veröffentlicht oder nativ ausgeführt. - -Der neue Gast-Scope-Test bestand am 15. November um 22:48:38 UTC auf der -Cloud-Linux-VM als UID 65534 mit `no_new_privs` und eigenem Netzwerk-Namespace. -`local::tests::scoped_echo_preserves_journals_and_rejects_other_offers` prüfte -die erhaltene Historie und die Ablehnung fremder Jobangebote. Ein Test bestand, -einer wurde gefiltert, Exit 0 und leeres stderr. Beleg-SHA-256 -`54aa6430c0b1eb2415ee3f888b015c05faa536d07d96f4bacf01152f1236b7db`. - -Die getrennte serverseitige Echo-Review-Strecke bestand drei isolierte -PostgreSQL-Fälle einschließlich Migration bis 0018. Sie akzeptierte die -exakten Outbox-/Lease-/Permitdaten des gebundenen LocalService-Auftrags und -wies abweichende SYSTEM-Daten auch über die Datenbankgrenze ab. Unmittelbar -nach der simulierten Review-Bestätigung blieben Jobs, Jobgenehmigungen und -Startpermits null, die normale Restore-Sperre blieb gesetzt. Erst der -reguläre spätere Sync und die separate Jobplangenehmigung sind dafür zuständig. -Server-Clippy einschließlich betroffener Tests bestand mit `-D warnings`. - -Der neue Gasttest bestand danach auf Windows 11 nativ mit einem bestandenen -und einem gefilterten Test in 0,01 Sekunden. Testprogramm-SHA-256 -`ae35c1b9b36683efa9718572d3c6ad3e0321df1226639fa608234a435a787100`. -Die gegenwärtige Mitgliedschaft des vorhandenen simulierten Principals wurde -auf dem Projektserver lesend als `test_human`, nicht widerrufen und mit -`plans:approve` bestätigt. Neue zusätzliche Anmeldedaten sind für diesen -begrenzten Testpfad nicht erforderlich. - -Der abgeschlossene Gastbuild hat Agent-SHA-256 -`78c16dcaee53fe9a04d4d84c7a1475330c5a1af30c104f8f9d6f56b5b7408513`. -Der native Operator hat SHA-256 -`72996a5714b29ed96a607cf8516d10a6bc9778e59d8f77a690a863ecbd0cac45`. -Windows-Release und Cross-Clippy mit `-D warnings` bestanden. Der öffentliche -Buildbeleg hat SHA-256 -`44ac22b926b4f860da2280dbcefe0d2b3f22fb07c3ad37e856e435296a75a6b3`. -Die drei unverändert aus dem Referenzcommit eingebundenen Transportmodule -sind ergänzend durch Beleg -`9bb9aa28b9b02e2a05a90546ef0208757ff2c856c848fd1ed33b64a2a313b0ef` -erfasst. Der Windows-Fixture-Nachweis für den passiven Medienbau ist ausdrücklich -eine protokollierte Konsolenablesung mit Foto-/Testbinaryhash, SHA-256 -`4228c05aafb3cbf5d0cbbc06cb211bfb82b0d084e8c509db3afea159bef82c7f`. - -Der passive Nachfolger wird im eigenen Fall `0d0179bf-cd40-4c05-b3c2-537aebd0c8ed` -installiert. Das Medienmanifest hat SHA-256 -`7c331501e40c57597624ed889ea12f34a9b16d8d10f41a2a5a73d8b7d01280a1`. -Elf Eingaben wurden gehasht, eine unabhängige Neuassemblierung war bytegleich. -Abweichender Windowsbeleg und Überschreiben eines vorhandenen Medienverzeichnisses -wurden verweigert. PowerShell-Parser und der Pintransformationscheck bestanden -lokal. Die native Dienst-/ACL-/Zeitabnahme ist der nachfolgende Schritt. - -Der API-Nachfolger wurde nativ auf ARM64 gebaut und mit Migration 0018 auf -dem Projektserver veröffentlicht. Image -`d5fd32ff157c297824d9d23d2fbd0f3aba0a470ea457f8245532cc6d8ea2d639`, -Serverbinary -`3d2b5550a1a94895b39519f96ae46e6e0280f42abd205d1f748998769c7529c1`. -API-Start um 22:55:56 UTC. Gateway, PostgreSQL und Brokerbindung wurden vor -und nach dem Wechsel als identisch geprüft. Die WebUI ist veröffentlicht. -Für weitere API-Compose-Aufrufe zusätzlich zu den bisherigen Overlays das -private `devstate/echo-probe-1b8acf06ea84/package/review-images.compose.yaml` -auf dem Server verwenden. - -Der neue passive Agent wurde auf der Windows-VM installiert. Die native -Gegenprüfung beider Rollen erzeugte den Entwurf für Zeitprofilrevision 3. -Der tatsächlich versiegelte Medienfall heißt -`1d61d88b-ab17-49b1-9a8d-2427348313b4`; die zuvor genannte UUID -`0d0179bf-cd40-4c05-b3c2-537aebd0c8ed` war eine frühere Planungskennung. -Die Geräteidentität und ursprünglichen Journale wurden erhalten. - -Zeitprofilrevision 3 wurde auf der VM veröffentlicht. Beide neu gestarteten -Rollen erzeugten unabhängige signierte Messungen um 22:58:42 UTC. -Der native Lesebeleg `92911196-1bda-4ba0-83ad-11427e24a902` wurde um -22:59:26 UTC geschrieben, SHA-256 -`454ddfee4477b9c19f70dea593196c108687ac5db59e8cd04150faf0c2bc62aa`. -Die unabhängige Serverlesung vor und nach der Prüfung bestätigte Generation -154 und die bisherige Boot-ID. Die bestehende Sperre blieb aktiv. - -Der erste echte MCP-Testplan wurde als `pending_approval` gespeichert, -Operation `9073663a-35b3-4bf5-a91a-b4b5f2a1b929`, Job -`645ad11b-9ecd-4efe-8f92-8ad2fb6ed5cf`, Versuch -`e2ee25cd-0e23-4c3c-aaa2-3048d232622a`, Startfrist 23:18:00 UTC. -Die zusätzliche tatsächliche WebUI-Testbestätigung stellte die auf exakt -diesen Plan gebundene Quittung `75b10ac8-2272-4e05-822d-bef164ec56b9` -aus. Herkunft `dev_test_browser_simulation`, Testprincipal -`simulated-testprincipal-a`. Das native `echo-apply` archivierte diese -Quittung und die ursprüngliche Sperre erfolgreich. Die spätere eigentliche -Jobgenehmigung wurde noch nicht erteilt; die Zähler standen weiterhin bei null. - -Beim anschließenden Reconnect zeigte sich ein passiver Capabilityfehler. -Der eng begrenzte Echo-Modus hatte `agent.update/1` nicht angekündigt, -aber weiterhin reguläre Updatebeobachtungen erzeugt. Die native lesende -Queueprüfung bestätigte genau eine unquittierte ursprüngliche -`agent.update`-Beobachtung, ID `30a748a1-2dcb-44e6-9439-24fe5abf341f`, -Sequenz 7084, ursprüngliche Verbindung 155. Das Gateway wies die nicht -angekündigte Beobachtung ab, bevor der neue Sync möglich war. -Die Meldung wurde erhalten und nach Rückkehr zum passiven Profil regulär -übertragen. MCP sah um 23:12:53 UTC wieder einen frischen Kontakt. - -Die Korrektur kündigt die implementierte passive Updatebeobachtung auch -im Echo-Modus an. Die zusätzlichen Schranken für Offers, Grants und -Ausführung bleiben bestehen. Windows-Release und Clippy bestanden für -Binary `742257bfb86ff3ccb5b7c04371471afbdf3c26c5d5cf73ea7bf6d0a51586e80f`. - -### Erfolgreicher tatsächlicher PowerShell-Auftrag - -Nach der bestätigten Capabilitykorrektur wurde Agent `742257bf…` passiv -installiert und das unabhängig erzeugte Zeitprofil auf Revision 4 erhöht. -Der Medienfall `c62d698d-d044-4815-acbe-3eeb383d44d5` bindet den tatsächlichen -Revision-3-Vorgänger, seine Rollen-/Installationsbelege und den Buildbeleg -`49392de4bfa92dffc4adcf27d5b1e0c9700e23ad8624db1f20971579071a7a22`. -Die historischen Kernfixtures sind ausdrücklich Vorgängerbelege. -Der reproduzierbare R4-Mediengenerator liegt unter -`deploy/windows/prepare_passive_revision4_media.py`; seine Ausgabe wurde -lokal bytegleich mit dem tatsächlich eingesetzten Medium verglichen. - -Um 23:17:21 UTC bestätigte der Server für Verbindung 185 den regulären -signierten Sync, `sync_ready=true` und `restore_blocked=false`. -Die zusätzliche dauerhafte Bindung an genau einen Testauftrag blieb aktiv. -Anschließend wurde der gespeicherte Plan in der tatsächlichen WebUI über -Checkbox und den sichtbar simulierten Genehmigungsknopf genehmigt. Es gab -keine direkte API-/Datenbankfreigabe des Jobs. - -| Gegenstand | Tatsächliches Ergebnis | -| --- | --- | -| Operation | `9073663a-35b3-4bf5-a91a-b4b5f2a1b929` | -| Plan | `b7991fe6-01a5-4cc3-bcf2-e607f48bfa62` | -| Plan-SHA-256 | `873e75523face254bfc8b193a06c8e16d432807dad589ec670dd205c217f666c` | -| Job / Versuch | `645ad11b-9ecd-4efe-8f92-8ad2fb6ed5cf` / `e2ee25cd-0e23-4c3c-aaa2-3048d232622a` | -| Jobgenehmigung | `89cc8868-2a0b-4948-a518-e1fdc0cafec4` | -| Startgrant | `fd09719f-69a9-48e6-901b-6c250ef9bb0f`, ausgestellt 23:17:47.093175 UTC | -| Zustand | `succeeded`, Revision 2, Exit 0 | -| Ausgabe | exakt `Zeitprofil-Test` mit gebundenem CRLF, stderr leer, nicht abgeschnitten | -| Prozess | PowerShell, `S-1-5-19` (LocalService), `powershell_51_remote_signed` | -| ExecutionPolicy | `RemoteSigned` ausschließlich Scope `process` | -| Audit | `dev_test_browser_simulation`, `testsimulation=true`, `simulated-testprincipal-a` | -| Zentrale Einmaligkeit | 1 Job, 1 Outbox, 1 Permit, 0 ungeklärte Jobs | -| Native Einmaligkeit | `consumed=1`, `evidence=1` für exakt diesen Job und Versuch | - -Der kombinierte verifizierte MCP-/Auditbericht hat SHA-256 -`c99b5378d3ba58c6b1a4abe0d02dec2c8e38196953eaf9ccbc6c97168e2cbf53`. -Die unabhängige native Ledger-/Dienstnachlesung hat Konsolenbeleg-SHA-256 -`e100634a1fc192d4c1c6285f18992a6693abddb523f983d57ecda2fb8353b2f3`. - -Die automatische Rückkehr stellte die ursprüngliche passive Konfiguration -am 15. November um 23:19:06 UTC wieder her. Beide Dienste liefen danach. -Konfigurationshash unverändert -`7c9f6f3642ef84337c3cd761d8a4788c4babe81522fdd987a3eb9b819bc8d851`. -Die letzte Servernachlesung um 23:22:11 UTC sah die VM online mit einem -frischen Kontakt und ohne Wiederherstellungssperre. Die temporären optischen -Medien wurden entfernt und das ursprüngliche Installationsmedium eingelegt. -Dieser Nachweis betrifft genau den unprivilegierten Testauftrag. Allgemeine -Windows-Skripte, SYSTEM-Vollwartung, weitere Paket-/Fehlerabnahmen und der -Agent-Selbstupdater sind damit noch nicht als vollständig abgenommen erklärt. diff --git a/docs/windows-raw-capture-completion.md b/docs/windows-raw-capture-completion.md deleted file mode 100644 index ee62dd3..0000000 --- a/docs/windows-raw-capture-completion.md +++ /dev/null @@ -1,252 +0,0 @@ -# Begrenzte Finalisierung des ursprünglichen Rohcapturefalls - -Die neue lokale Generierung -`deploy/windows/signed_clock_capture_completion.py prepare` bindet weiterhin -ausschließlich den Zielfall `efd17b43-7e04-49a7-9bd4-862d13365eec` und dessen -unveränderten Originalcontroller89c19138…/Manifest806c062b…. Sie besitzt keine -SSH-/Übertragungs- oder Zielfunktion. Der vorhergehende tatsächliche SYSTEM- -Repair ist über Response-SHA256 -`b87746dc066fc255d2cbf1871698811203d38410e27c8d6d51d2d38ea7752c96` -und Preservation-SHA256 -`a1bb8a42e22f2d0263dc381bd675134effe6555867b57b7f4fae28eb6f319ad6` -gebunden: eigener SYSTEM-Dienst erzeugt und gestoppt, Setup noch unvollständig, -keine Rollenstarts. Die vorherigen Originaldateien und Marker bleiben erhalten. - -## Zwei ausdrücklich getrennte Quellen - -`SignedClockCaptureCompletion.ps1` besitzt ausschließlich die noch fehlenden -Setupwirkungen: Base-/Case-Reader-ACLs für genau zwei tatsächlich ermittelte -eigene Service-SIDs, zwei create-only Rollenverzeichnisse mit jeweils eigenem -Writer-SID und eine create-only Kopie der ursprünglichen EXE601c27a4… mit -8566784Bytes. Seine native Klasse enthält ausschließlich gehaltene SCM- -Queryhandles und Statusreads. Kein CreateService, Start, Stop, Delete oder -Prozessabbruch. Ein neuer eigener `setup-repair-attempt.json` muss vor den -ACL-/Dateiwirkungen vorhanden sein. Der Originalfall muss vorher beide -unveränderten gestoppten Dienstdefinitionen einschließlich originalem LS- -Createdbeleg und neuem SYSTEM-Repaircreatedbeleg beweisen; sämtliche weitere -Rollen-/Startmarker oder vorhandenen Zielobjekte verweigern. - -Erfolg schreibt ausschließlich `setup-repair-complete.json` mit beiden SIDs, -eigener tatsächlich ausgeführter Controlleridentität, ursprünglicher Manifest-/ -Controllerbindung, Repaircontrollerhash und EXEhash/-größe. Alter Setupfehler -und fehlender Original-`setup-complete.json` werden nicht umgedeutet. Fehler -erhalten einen eigenen Failmarker. Vorhandener Versuch, Teilzustand oder -verlorene Antwort bedeutet ausschließlich eigenen Originalfall-Read, keine -automatische Wiederholung oder generische Resume-Engine. Ein Read kann die -eigenen partiellen ACL-/Dateischritte zeigen, vollendet sie aber nicht. - -`SignedClockCaptureDelta.ps1` ist eine separate, exakt aus den Originalbytes -abgeleitete Quelle für die fünf nachfolgenden Phasen: `start-local-service`, -`start-system`, `read`, `cleanup-local-service`, `cleanup-system`. Er besitzt -eine eigene Profile-/Scriptpfad-/Hashbindung und verlangt den konkret -erzeugten neuen Completioncontrollerhash sowie ursprüngliche Hashbezüge. -Die ursprüngliche Setupverzweigung, `NewDir` und nativen Servicecreate-/ -Config2-/DACL-Set-/CreateOncepfade wurden tatsächlich aus der Quelle entfernt; -sie werden nicht bloß als unerreichbar bezeichnet. Es bleibt keine EXE-Kopie. - -Nur der SYSTEM-Createdbezug wird auf den echten Repaircreatedbeleg umgestellt, -einschließlich Readausgabe. LS bleibt an seinen ursprünglichen Createdbeleg -gebunden. Das ursprüngliche Rollenstart-/Read-/Watchdog-/gestopptes-Cleanup- -Verhalten bleibt bestehen: je Rolle eine eigene create-only Startabsicht vor -StartService; SYSTEM erst nach eindeutig erfolgreichem LS-Ergebnis; PID/Birth/ -Token/Service-SID/Image/CLI über gehaltenen Prozess prüfen; bei Timeout nur -denselben erneut nachgeprüften eigenen Prozesshandle beenden. Ein Delete braucht -vorher eigene Deleteabsicht und eindeutig gestoppten, unveränderten eigenen -Dienst. Unklare Wirkung ist kein neuer Versuch. Keine freie Service-/Datei-/ -Accountwahl und keine RMM-/WebUI-Genehmigungsschnittstelle. - -Die native Statusreadänderung entfernt ausschließlich die unzulässige -`pcbBytesNeeded`-Gleichheit auf Erfolg. Die erfolgreiche BOOL-Rückgabe bestimmt -den Read; Statusfelder, vorhandene Handle-/Prozess-/Zeitgrenzen und Fehlerpfade -bleiben erhalten. Rohcapturecode und die EXE selbst sind unverändert; ihr -tatsächlicher früherer Linux-first-Fünferbeleg bleibt genau diesem Artefakt -zugeordnet. Diese Bootstrapänderung qualifiziert weder die physikalische -Timerabweichung noch einen späteren signierten Clock-/Jobgateanschluss. - -## Tatsächlicher lokaler Stand - -Generator SHA256 -`65dbbd148e4a7d24843167b984c0d3c8ad5a8a065cff7d47dfd5516d9c97cde6`. -Privater neuer Artefaktfall -`devstate/windows-signed-clock-capture-completion/ccba6d8f-c58f-4d2d-a51c-1efb3bfbabdf`: - -- Completion16673Bytes/SHA256 - `a36f318fb549071765bd92aa405c2ea3cf16b3696151afe857c4f601e36f624c`. -- Delta23306Bytes/SHA256 - `2240d7846c82a56e2e13a48bed2c836fae3c836ce89d585c3390540fef76ef14`. - -Tatsächlich lokal bestanden: Python-AST, ursprüngliche Fall-/Repairbelege und -Paket-/Controllerhashes, entfernte Setupcapabilities, getrennte Phasenumfänge -und Absicht-vor-Start/Delete-Quellprüfung. Keine lokale PowerShell-/C#- -Compilerprüfung verfügbar. Keine native Parser-/Compile-/Controllerausführung -oder sonstige Zielaktion durch diesen Worker; solche Rootoperatorbelege sind -gesondert zu ergänzen. Kein RMM-Job, Clockready-Flag oder signierter Zeitbeweis -wird aus der bloßen Finalisierung oder einer Rohcapture abgeleitet. Der MVP -bleibt bis zu den echten Rollen-/Zeitquellen- und Runtimeabnahmen offen. - -## Tatsächliche getrennte native Syntax-/Compileprüfung - -Root führte anschließend auf der Windows-VM je Controller einen eigenen -PowerShell5.1-Parserlauf und C#-Compile-only aus. Beide aktuellen Originalbelege -nennen ASTfehler0, `csharp_compiled=true`, `controller_executed=false`, keine -Dienstaktionen, keine RMM-Jobs und keinen Clocksetter: - -- Completion: `syntax-result-6e5d4891-8b76-4180-ae85-dc5b2b90966b.json`, - SHA256 `603b50fe5f0125fb6439e928496cf3b86650808898a5e1bfbeef3a35e2b32d8e`. -- Delta: `syntax-result-1ed996b5-f9ee-443f-adb6-d08eec38d086.json`, - SHA256 `d85845abb5e48413d870c3f6e91c3c087e9c6eb31e45660cac068c0ed8247853`. - -Ein vorheriger gemeinsamer Aufruf mit ReadToEnd lief nach60s in einen -Transporttimeout. Sein Originalbeleg -`syntax-failure-f6f0ff0f-5bce-4e7b-bad0-02631136d1c5.json`, SHA256 -`6afc716191fb32a0c18b3efbc5d02ce3e7ce5f950479e3c5f9db75e834f88015`, -bleibt fehlgeschlagen/ohne abgeschlossenen Receipt; die fehlende Antwort wurde -nicht als Erfolg ausgegeben. Die separaten Belege ersetzen ihn nicht rückwirkend. -Der unabhängige Quellenreview beider Controller meldete PASS. Diese Prüfungen -führen weder die Completion noch einen Rollenstart aus. - -## Dünner Operator und sein enger Linknachweis - -`deploy/windows/signed_clock_capture_completion_acceptance.py` bietet nur -`stage`, `complete`, `read`, die zwei expliziten Rollenstarts und die zwei -expliziten Cleanups. Paket/Hashpfade sind fest; Payloads werden aus der gewählten -CLIaktion im Code erzeugt. Kein Payloadfile wählt eine andere Aktion. Jede -Mutation hat einen create-only Intent, und die unveränderte kanonische Antwort -wird vor Erfolgsauswertung gespeichert. Serverclosed-Beleg sowie sechs originale -native Stablefelder und Journalidentität/-schema/-corecounts werden vor/nach -erfasst und mit derselben gespeicherten Rawantwort verknüpft. Reads besitzen -eigene UUIDs, Intents und vollständig gespeicherte Witness-/Preservationlinks. - -Eine erfolgreich abgeschlossene Rolle braucht ausschließlich den ursprünglichen -`validate_role`-Pfad einschließlich tatsächlichem Prozess-/Token-/Image-/ -Report-/End-/KernelExitbeleg. SYSTEM startet erst nach einem solchen positiven -LS-Beleg. Ein späterer verknüpfter Read darf eine tatsächlich vorhandene -unveränderte LS-Ausgabe nach verlorener Antwort prüfen; er erfindet keinen -Startreply, Exit oder Outcome. Fehlende Completionantwort/-Receipts werden -nicht nachgebaut und erlauben keine automatische Folgeaktion. - -Der erste dünne Quellenstand7559… enthielt einen lokalen Linkformatfehler: -`completion_proof` erwartete `response_sha256`, der Writer speichert tatsächlich -`raw_reply{filename,sha256}`. Der unabhängige Review fand dies vor irgendeiner -Stage-/Completionwirkung. Der korrigierte Quellenstand SHA256 -`4216a6f162ea6acb32e54a8be726cc7a5875a295c8f3f5f1646bc93fbc05c06c` -benutzt einen gemeinsamen Guard für Completion- und LS-Belege: Rawdateiname -und alle Witnessnamen gehören exakt zur `operation_id`, jeder Bindingwert -einschließlich action/read_only/operation_id stimmt überein, und Raw-/Server-/ -Native-/Preservationhashes sowie deren Querverweise werden geprüft. - -Tatsächlich lokale, ausdrücklich synthetische Formatfixtures: tatsächliches -Writerformat positiv, falscher RawSHA negativ sowie fremde Witnessoperation -trotz konsistenter neu berechneter Dateihashes negativ: PASS. Beleg SHA256 -`5fea1959792f7915423706ca7293ffa3003b4ea888a7869320eda837fb6b8c3a` -im eigenen Unterfall `operator-link-fixtures-70bfb59a-7b82-4197-83a9-d83654b4fce4`. -Dies belegt lokale Belegbindung, keine native Controllerwirkung. Die beiden -Controller und die ursprüngliche EXE wurden durch den Operatorfix nicht geändert. - -## Tatsächlich finalisierte native Messfixture - -2026-11-15: Root führte nach Quellenreview, separatem nativen Parser-/C#- -Nachweis und dem vor Wirkung korrigierten Receiptvalidator den festen -Operator4216a6f1 aus. Staging beider exakt gehashten Controller erfolgreich, -Stage-Receipt-SHA256 -`b73a26a19b5990738315ce2e4cceb3ec3c4dbd5dbeaa2491cb5208a5f81d0db8`. -Die einmalige Completion im Originalfallefd17b43 war erfolgreich; Receipt -`abaa549d0e0a2a4c1748a3cd857d89f12e3ec88729c5e8ba10f0622b6890349d`. -Die zwei Rollenverzeichnisse, gebundenen Reader-/Writer-ACLs und die unveränderte -EXE601c27a4 wurden angelegt. Beide SCM-Dienste blieben tatsächlich gestoppt; -kein Start/Stop/Delete, RMM-Auftrag, Zeitsetter, Clockpin oder Readywechsel. - -Separater nativer Originalfall-Readback vollständig, -`read-7ce8c3e7-3aba-4a2e-a5e8-c635b1dfc1a8-receipt.json`, SHA256 -`048e995fbeea173b7021180434adbb5c6a80011b9c08da66991aa3e445a14304`. -Stage, Completion und Read enthalten jeweils die vollständigen unabhängigen -Server-/Native-Vorher-/Nachherzeugen sowie ihre Rawreply- und Preservationlinks. -Diese bekannten RMM-/Journal-/Serverbindungen sind unverändert. -`completed_roles=[]`: Es wurde noch keine Rohcapture-Rolle ausgeführt. -Originalsetup, dessen fehlgeschlagene zweite Erstellung und Reparatur bleiben -getrennte historische Belege; sie wurden nicht wiederholt oder umgeschrieben. -Die beiden einmaligen Rollenstarts samt exakten Prozess-/Kernelexitbelegen -und abschließendem explizitem Cleanup bleiben offene Abnahmeschritte. - -## Tatsächlich ausgeführte LocalService-Rohcapture - -2026-11-15: Genau ein Rollenstart `start-local-service` im Originalfall -efd17b43 bestanden. Receipt-SHA256 -`10dd411be265d018489bf9477747ce2d5846ac04128f583425aec4b3c9d5252b`. -Die unveränderte EXE601c27a4 lief nach tatsächlich aktiviertem eigenen -Dienst-SIDnachweis als S-1-5-19. PID1744 und Prozessgeburt134392023559500186 -sind an den gehaltenen Kernelhandle und dieselbe feste Kommandozeile gebunden. -Tatsächlicher Kernelprozess-Exit0 und SCM-Stopped/Exit0/SpecificExit0 beobachtet, -kein Timeout. Originale Probe-Intent/Report/End und Reporthash stimmen überein. - -Gemessen:128 Samples; Monotonic127007900ns, Interrupt126994100ns; maximaler -Capturebracket20500ns; maximale interne Interrupt-/Unbiased-Differenz18100ns; -maximale Wall-/Interrupt- und Interrupt-/Unbiased-Differenz jeweils15700ns. -Dies sind Rohmesswerte dieser Serie unter OS-/Hypervisorannahmen, keine -abgeleitete physikalische Absolutgenauigkeit oder fertige Calibration. -`calibrated=false` und `clock_authority=false` bleiben ausdrücklich bestehen. - -Separater vollständiger Originalfall-Readback -`read-7ed0e515-ce1b-4d2e-b7f9-f8b028afc4d5-receipt.json`, SHA256 -`43017933721268c6908c61f96d64e443a8bf79dd07edb8ad617be3392e38e564`. -Er bestätigt genau diese abgeschlossene Rolle, keine SYSTEM-Messung. -Alle sechs vollständigen RMM-/Journalzeugen und aktuellen Serverpolicy-/ -Jobzähler sind vorher/nachher/erneut unverändert; kein RMM-Job oder Clockgate. -SYSTEM-Rohcapture, separate gestoppte Fixturebereinigung und anschließend -echte unabhängige signierte Vergleiche bleiben offen. - -## Tatsächlich ausgeführte SYSTEM-Rohcapture - -2026-11-15: Nach dem positiven LocalServicebeleg genau ein SYSTEM-Rollenstart -im Originalfallefd17b43 bestanden. Receipt-SHA256 -`7409309ea6d586566373f570d6950c60ce2597cf939f261e6d2ea4def004a22f`. -Unveränderte EXE601c27a4, tatsächlicher SYSTEM-User S-1-5-18 und aktivierter -eigener Service-SID; PID7476/Geburt134392026954213177 über gehaltenen -Kernelhandle gebunden. Beobachteter Kernel-Exit0, SCM-Stopped/Exit0/SpecificExit0, -kein Timeout. Beide Rollen melden dieselbe echte Boot-ID. - -128 Samples: Monotonic127008100ns, Interrupt126995700ns; maximaler -Capturebracket24200ns, interne Interrupt-/Unbiased-Differenz21800ns, -Wall-/Interrupt-Differenz19400ns, Interrupt-/Unbiased-Differenz19500ns. -Rohmesswerte dieser Serie, keine physikalische Absolutgenauigkeit, Calibration -oder Zeitautorität. Beide Flags bleiben false. - -Separater Originalread -`read-df2d7729-31d1-4f6e-9411-f972b23512dc-receipt.json`, SHA256 -`75e162285a79f3c5c99613d05af7c0864f1778bb0f3ddad972e75f329a49275c`, -verifiziert beide tatsächlich beendeten Rollen samt originalen Prozess-/ -Report-/End-/Exitbelegen und unveränderten RMM-/Journal-/Serverzeugen. -Keine RMM-Jobs, Uhrstellung, W32Time-Anweisung oder Clockgateöffnung. -Die anschließend getrennte gestoppte Bereinigung sowie echte signierte -Agent-/SYSTEM-Vergleiche und Deadlineintegration bleiben offen. - -## Erste getrennte Fixturebereinigung - -2026-11-15: Nach positiven beiden Rollen ausschließlich den exakt -verifizierten gestoppten LocalService-Messdienst einmal gelöscht, tatsächliche -SCM-Abwesenheit beobachtet. Receipt -`7d2e86a47abeac40829c0cec894480a8e8641770787ac05f26fc19db12d0ef72`. -Separater Originalread02f2f031-31b7-4283-af16-a84cd864a34d bestätigt -Abwesenheit und beide ursprünglichen Rollen-/Exitbelege, Receipt -`03b584dab2aac890e118e53a1b7435c64e4cc26ce65bb65a609b775da4a72575`. -RMM-/Serverzeugen unverändert. Der eigene SYSTEM-Messdienst bleibt bis zum -eigenen Cleanup gestoppt. Dateien/Reports bleiben unverändert erhalten; -kein RMM-Dienst oder Client wurde deinstalliert. - -## Abschließende getrennte Fixturebereinigung - -2026-11-15: Den exakt konfigurierten, bereits gestoppten SYSTEM-Messdienst -nach seinen gebundenen Start-/Prozess-/Kernelexitbelegen einmal gelöscht; -SCM-Abwesenheit tatsächlich nachgelesen. Cleanupreceipt -`62e9e2fd633f3a9a1f76bc379d6d2e0eb731dbc3268458caaa431715ae477faa`. -Separater Originalread2b9fe4f9-4757-49eb-9acd-ccddecaecb3a, Receipt -`eff75fee9d9199cea57d23311be0f21dd8abb17e6fe4a27a826f797e9358805f`, -verifiziert beide ursprünglichen Rollen und explizit die Abwesenheit beider -eigenen Messdienste mit ihren jeweiligen Deletebelegen. Die vollständigen -RMM-/Journal-/Serverzeugen blieben erhalten. - -Kein RMM-Agent/-Helper deinstalliert oder verändert, keine Fall-/Reportdateien -gelöscht und kein erneuter Rollenstart. Die Messfixtureabnahme einschließlich -Cleanup ist damit tatsächlich abgeschlossen. Dies schließt weder eine native -signierte Zeitversorgung noch PowerShell-/SYSTEM-RMM-Jobs oder den Windows-MVP -ab; deren unabhängige Zeit-/Transport-/Deadlineintegration bleibt offen. diff --git a/docs/windows-raw-capture-system-repair.md b/docs/windows-raw-capture-system-repair.md deleted file mode 100644 index a8d2fc9..0000000 --- a/docs/windows-raw-capture-system-repair.md +++ /dev/null @@ -1,171 +0,0 @@ -# Eigener SYSTEM-Reparaturschritt des bestehenden Rohcapturefalls - -Der einzige Zielfall bleibt `efd17b43-7e04-49a7-9bd4-862d13365eec`. -`deploy/windows/signed_clock_capture_system_repair.py prepare` erzeugt nur lokal -einen gesonderten festen Controller. Er enthält keine SSH-/Übertragungs- oder -Ausführungsfunktion. Originalrunner, Originalcontroller, Manifest und sämtliche -alten Marker werden weder verändert noch erneut ausgeführt. - -## Tatsächlicher Befund - -Das ursprüngliche Setup scheiterte auf der zusammengefassten PS-Zeile138. -Der lesende Markerbeleg -`ff8e2eef73139c8350aa0f86c6fed5125fce95f79d535f25224829ce4fa9c565` -enthält `intent.json`, `local-service-create-attempt.json`, -`local-service-created.json` und `system-create-attempt.json`. Der ebenfalls -lesende Servicebeleg findet den exakten LocalService gestoppt/Manual mit -UNRESTRICTED-SID und der eingerichteten Admin-/SYSTEM-DACL; SYSTEM fehlt. -Damit kam der erste `CreateOnce` vollständig zurück und der Fehler liegt sehr -nahe an der zweiten Dienstanlage. Der ursprüngliche NativeErrorCode wurde -nicht gesichert; beispielsweise1057 wird deshalb **nicht** als Messwert behauptet. - -Der konkrete Quellfehlerkandidat ist die Übergabe von PS-`$null` an den -C#-Stringparameter `account`. Für einen echten .NET-null-String sieht PowerShell -den Typ [NullString](https://learn.microsoft.com/en-us/dotnet/api/system.management.automation.language.nullstring) -vor, auch in5.1. [CreateServiceW](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-createservicew) -dokumentiert NULL als LocalSystem-Default; ein leerer Accountstring ist kein -dokumentierter Ersatz. Der Restzustand passt zu diesem Binderfehler, beweist -die verlorene ursprüngliche Nativefehlernummer jedoch nicht. - -Die ursprünglichen SafeHandle-/Disposepfade schließen Handles, löschen aber -keinen Dienst; ihr `ReleaseHandle` gibt nur ein Boolean zurück. Eine solche -Schließung erklärt hier nicht den expliziten `Win32Exception`-Pfad. Separat -wurde eine tatsächliche falsche Erfolgsprüfung gefunden: `Service.Read` verlangt -`pcbBytesNeeded==sizeof(Status)` auch nach erfolgreichem -[QueryServiceStatusEx](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-queryservicestatusex). -Dieser Ausgabewert ist für den Fall `ERROR_INSUFFICIENT_BUFFER` beschrieben; -die Größe darf kein zusätzlicher Erfolgsindikator sein. Die Reparaturklasse -prüft daher nur den tatsächlichen BOOL-Erfolg und sichert einen Fehler sofort. - -Der unveränderte Rohcaptureprozess verwendet Token, Service-SID-Lookup und -gehaltene Dateien. Er ruft nicht `PeerProof::for_service`/`OpenServiceW` auf. -Ein zusätzlicher LocalService-SCM-ACE ist für diesen konkreten Rohcapturepfad -deshalb nicht erforderlich; die gegenwärtige Dienst-DACL wird nicht erweitert. -Spätere installierte Adapterpfade sind gesondert zu beurteilen. - -## Implementierter, noch nicht am Ziel ausgeführter Reparaturumfang - -Lokaler Paketfall -`devstate/windows-signed-clock-capture-system-repair/cff25311-d30b-495a-8b50-e0e28e2e5b48`: -Controller15551Bytes, SHA256 -`ac3da3d86bd93497e8ecfe55369cb228ed0ce30c7f2301afb74463c789bb50ca`. -Generator-SHA256 -`9b44aa1491be2d154fb37fd0431370657f9623a2440649c29e910826beb44d2e`. -Die lokalen Manifest-/Payloaddateien nennen weiterhin ausschließlich den -ursprünglichen Zielfall. Eine neue lokale Artefakt-ID ist kein neuer Zielversuch. - -Vor der einzigen neuen SystemCreate-Operation prüft der Controller: - -- Eigenen tatsächlich ausgeführten Hashpfad sowie Originalcontroller89c19138…, - Originalmanifest806c062b… über den ursprünglichen Setupintent/active-Bezug - und die unveränderte gestagte EXE601c27a4… mit8566784Bytes. -- Geschützte Originalverzeichnisse und exakt erlaubten Markerfortschritt, - beide ursprünglichen Createattempts samt fester CLI und den bereits erzeugten - LocalService anhand seines originalen Createdbelegs, der Service-SIDart, - ACLhash, Startart, Konto, Typ und Abhängigkeiten. Ein gehaltener SCM-Queryhandle - muss ihn als gestoppt melden. -- Noch fehlenden SYSTEM-Dienst und fehlende Repairattempt-/Created-/Failuremarker. - Noch keine Rollenverzeichnisse, installierte Case-EXE oder weitere Start-/ - Setupmarker. Fremde oder weiter fortgeschrittene Zustände verweigern. - -Er schreibt dann ausschließlich einen neuen create-only -`system-create-repair-attempt.json`, legt SYSTEM genau einmal an, setzt SIDart1 -und dieselbe enge Dienst-DACL und prüft den weiterhin gestoppten Zustand. -Name und CLI sind feste C#-Konstanten; **NULL entsteht innerhalb C#**, kein -Accountstring kommt aus PowerShell oder Payload. Nativeaufrufe erhalten feste -Schrittnamen und sofort gesicherte NativeErrorCodes. SafeHandleparameter -halten den SCM-Handle während des nativen Reads gültig. Erfolg und Fehler -erhalten eigene neue Marker, die alten Systemattempts bleiben unangetastet. - -Es gibt nur `repair` und `read`. Nach fehlender Antwort/Fehler ausschließlich -`read` des Originalfalls, niemals erneut `repair` oder Original-`setup`. -Ein nach CreateService fehlgeschlagener SID-/ACLschritt bleibt offen sichtbar; -kein automatisches Delete oder vermeintlicher Erfolg. `read` zeigt die feste -SYSTEM-Definition in einem solchen Restzustand ausdrücklich als unverifiziert. -Keine Starts/Stops/Deletes, Zeitsetter, W32Time-/RMM-Änderung, EXE-Kopie oder -Setupcompletion. Ein erfolgreicher SystemCreate allein bedeutet **keine -Capturebereitschaft**. - -Tatsächlich lokal: Python-AST, Pakethashes, ursprüngliche Fallbindung und -begrenzter Mutationsumfang geprüft. Kein PowerShell-/C#-Compiler ist hier -verfügbar; native Parser-/Add-Type-Prüfung und sämtliche Zielaktionen wurden -durch diesen Worker nicht ausgeführt. Diese Grenzen stehen im lokalen Beleg. - -## Getrennte nächste Finalisierung und Controllerkorrektur: Vorschlag - -Der Originalsetupfehler lag vor Service-SID-Auflösung, Reader-ACLs, beiden -Rollenverzeichnissen, EXE-Kopie und Setupcompletion. Ein weiterer eigener -Originalfallcontroller muss diesen fehlenden Rest explizit abschließen: - -1. Neue create-only Finalisierungsabsicht nach ursprünglicher Fall-/Hashbindung, - originalem LS-Createdbeleg und erfolgreichem neuen SYSTEM-Repaircreatedbeleg. - Beide festen Dienste müssen exakt passende, weiterhin gestoppte Definitionen - haben; beide tatsächlichen `NT SERVICE`-SIDs unabhängig auflösen und prüfen. - Keine Rawrollen-Startattempts/-Intents/-Ergebnisse zulassen. -2. Die bisher rootgeschützten Base-/Case-ACLs auf genau die zwei eigenen - Reader-SIDs ergänzen. Ausschließlich die zwei noch fehlenden eigenen - Rollenverzeichnisse create-only mit dem jeweils eigenen Writer-SID anlegen; - die unveränderte EXE ausschließlich create-only aus dem gesicherten Staging - übernehmen, Hash/Größe und finales ACLprofil erneut prüfen. Kein breites - ACL-Repair, fremdes Objekt oder Überschreiben. -3. Einen **neuen** `setup-repair-complete.json` schreiben. Originales Setup und - dessen fehlender `setup-complete.json` werden nicht rückwirkend erfolgreich - erklärt. Eine partielle neue Finalisierung bleibt als eigener Intent ohne - Erfolg; keine automatische Wiederholung/Resume-Engine. -4. Einen weiteren getrennt gehashten Controller aus den Originalbytes erzeugen: - Original-`setup` dauerhaft verweigern; für nachfolgende Start-/Read-/Cleanup- - Aktionen den neuen Completionbeleg sowie originalen LS- und reparierten - SYSTEM-Createdbezug verlangen. Originalcontroller/Manifesthash zusätzlich - prüfen, eigene Scriptpfad-/Hashprüfung auf den neuen Controller binden. - Die einzige Änderung am nativen Statusread ist das Entfernen der falschen - `pcbBytesNeeded`-Erfolgsgleichheit. Kein Clock-/Capturealgorithmuswechsel. - -Erst ein eindeutiger eigener Rollenstartintent erlaubt anschließend eine einzige -Rohcaptureausführung. LS zuerst, SYSTEM erst nach eindeutig erfolgreichem LS- -Originalergebnis; Prozessgeneration-/Watchdog- und Ausgabebelege bleiben wie im -Originalprofil erforderlich. Cleanup ist separat: nur verifizierte eigene -gestoppte Dienste über gehaltene SCM-Handles und passende originale/reparierte -Createdbelege löschen, niemals ein freier Name, unbekannter Prozess oder blindes -Stoppen. Bei unklarem Start-/Exit-/Deletezustand ausschließlich Originalfall -lesen. Die hier gelieferte SystemCreate-Reparatur implementiert diese spätere -Finalisierung und Cleanupkorrektur noch nicht. - -## Tatsächliche native Reparatur, 2026-11-15 - -Root führte nach unabhängigem Review den unveränderten Reparaturcontroller -`ac3da3d86bd93497e8ecfe55369cb228ed0ce30c7f2301afb74463c789bb50ca` -im Originalfall efd17b43 aus. Zuvor bestätigte die Windows-VM -PowerShell5.1.26100.9818:0 ASTfehler, isolierte C#-Kompilierung bestanden, -Controller dabei nicht ausgeführt. Syntaxreceipt -`f0586ef81853cc942b8043088b9c46336808c41cb89aa6d1afaff0e0b1483b30`. - -Der dünne native Operator `signed_clock_capture_repair_acceptance.py` -(SHA256 `85fa12492c303beec4539fe38fc3fa81455594a4a62722aa8950b1497f4016f8`) -verwendet ausschließlich den bestehenden gepinnten Transport und seinen einen -festen zusätzlichen Stagenamen. Ein unabhängiger Review fand vor Ausführung -die fehlende Bindung lokaler Nutzlastdateien an die ausgewählte CLI-Aktion; -diese wurde durch vollständig im Code festgelegte Nutzlasten behoben. Ein -`read` kann deshalb keine `repair`-Nutzlast aus einer Datei übernehmen. - -Staging erfolgreich, anschließend genau ein Reparaturaufruf erfolgreich: -SYSTEM-Messdienst neu angelegt und tatsächlich gestoppt, LocalService weiterhin -verifiziert gestoppt. `setup_completed=false`, `service_started=false`. -Repairreply-SHA256 -`b87746dc066fc255d2cbf1871698811203d38410e27c8d6d51d2d38ea7752c96`, -zugehöriger Erhaltungsbeleg -`a1bb8a42e22f2d0263dc381bd675134effe6555867b57b7f4fae28eb6f319ad6`. -Die sechs vollständigen nativen RMM-Witnessfelder einschließlich Helpermetadata -und stabiler Journalidentität sowie aktuelle Serverpolicy/Zähler sind vorher -und nachher unverändert. Linux31/31/27/0, Windows0/0/0/0; kein RMM-Job. - -Das ursprüngliche Setup bleibt fehlgeschlagen. Seine Bytes und Marker bleiben -erhalten; ein `setup-complete` oder Rohmessbericht wurde nicht nachträglich -erfunden. Es gab weder Rollenstart noch Clockpin-/RMM-Konfigurationsänderung, -Kalibrierung, W32Time-Anweisung oder Jobfreigabe. Die noch fehlende endgültige -Messfixtureeinrichtung und anschließenden beiden Rollenprüfungen bleiben offen. - -Separater tatsächlicher Original-Readback bestanden: Antwort-SHA256 -`fad16846247eb6d84f352802aeb0dbc368f32cbee1512ca4c4d63b22aedb62b8`, -Erhaltungsreceipt -`336b4ff6cbf718658dd3c459ac716bbaee2e2e82c60bac79ac6a9631ce3e66e7`. -Er liest die ursprünglichen neuen Reparaturmarker, startet und repariert nichts. diff --git a/docs/windows-recovery-download.md b/docs/windows-recovery-download.md deleted file mode 100644 index 38c9e4b..0000000 --- a/docs/windows-recovery-download.md +++ /dev/null @@ -1,68 +0,0 @@ -# Öffentlicher Recoverydownload — ursprüngliches Paket zurückgezogen - -Historischer erster Veröffentlichungsbeleg. Das Paket wurde wegen eines -unbelegten gerundeten Accountzeit-Guards zurückgezogen; maßgeblich ist der -[Korrekturbeleg](windows-recovery-precision-download.md). Die ursprünglichen -Belege und Archive bleiben erhalten. - -Am2026-11-14 im separaten Fall `7f549bc4-cf12-4292-aae6-377ac9ecb2d4` -über den vorhandenen Bootstrap-TLS-Dienst tatsächlich veröffentlicht und von -außen mit normaler CA-/Namensprüfung vollständig heruntergeladen. Exakte -ZIP-SHA256 `7bf4f7bb8336fb50852f72eec2f3e370e96cb7009b14ee15aa7232c025a38ed7`. -Nur drei öffentliche Dateien: Konsole-PS1, öffentliche Parameter und README; -keine privaten Schlüssel, Tokens oder Zugangspasswörter. - -Feste Downloadfrist **2026-11-14T13:53:24+00:00**. Die neue URL wird nur im -privaten Veröffentlichungsbeleg und der konkreten Benutzeranweisung geführt. -Die alten abgelaufenen Bootstrap-/Repair-URLs bleiben404. Aktuelles Mapping -enthält ausschließlich den neuen zufälligen Pfad zum festen Recoveryzip. -Der vorhandene Dienst auf8443 wurde für diese begrenzte Wiederherstellung -gezielt wieder gestartet; kein Port80/ACME, kein neues Zertifikat und keine -Änderung an RMM-Server, Gateway, Datenbank oder SSH durch diesen Publisher. - -`deploy/windows/publish_recovery_download.py` ist vor der Veröffentlichung -unabhängig geprüft und per Python-AST geprüft, SourceSHA256 -`cf49bc0e78ecf35aae9d56885e6e395d1155398de46cee4f309f58549b436c90`. -Read-onlyPrepare verlangte abgelaufene Konfiguration, inaktiven Dienst, -bekannten ursprünglichen Code sowie gültige Host-/CA-Kette und mindestens eine -weitere Stunde Zertifikatsgültigkeit. Der konkrete Publishintent wurde vor -Mutation per SHA gebunden. Originalcode und Konfiguration sind separat privat -archiviert; nur ein festes Dateinamenliteral wurde ergänzt. Kein freies -Dateiserving und keine Veröffentlichung historischer Pakete. - -Eigener systemd-Close-Timer wurde **vor** Firewallöffnung und Dienststart -aktiviert. Er stoppt zur festen Frist den Downloaddienst und schließt8443. -Der HTTP-Handler verweigert darüber hinaus selbst nach derselben Frist jeden -Download. Die tatsächliche spätere Timerwirkung ist erst dann zu beobachten; -Timeraktivierung und App-Ablaufprüfung sind kein schon ausgeführter Portschluss. -TLS-Schlüssel wurden ausschließlich über den vorhandenen systemd- -Credentialmechanismus genutzt, weder gelesen noch übertragen. - -Getrennter Readback bestätigt den aktiven Downloaddienst, vorhandenen -Abschlussbeleg, KonfigurationsSHA -`1aa119f0355754e2ba054e6e1c4276f484c1287750cb853dd73bffe552ef8f93` -und ServercodeSHA -`b4f85778dd356377b95e04d6736b3fb6f4e272a276a9466f28efeaccd6ef1b7d`. -Danach gespeicherte Zentralzähler gelesen: Windows0/0/0/0, -Linux30/30/26/0, Transporttestflags geschlossen. Keine RMM-Jobs gestartet. - -Der gesonderte Serverteil der Konsolenrecovery ist bereits ausgeführt: -[genauer Quellen-/Abnahmestand](https://gitea.incoso.eu/kevin_janssen/rust-discovery/src/branch/codex/windows-pipe-drain/docs/windows-dev-access-recovery.md). -Die Windows-Konsolenphase und der danach notwendige gepinnte SSH-Nachbeleg -stehen weiterhin aus; keine Wiederherstellung allein aus dem Download ableiten. -Content-Disposition des historischen Downloadservers nennt weiterhin -windows-dev-access.zip; die konkrete Benutzeranweisung speichert explizit unter -einem neuen Recoverynamen und prüft vor Ausführung den ZIP-Hash. - - -## Tatsächlicher Rückzug - -Eigener enger Nur-Bootstrap-Controller im Fall -`19f19da3-2b97-451a-a32c-4b968b37e9c5` prüfte vor dem Stopp exakte -Code-/Config-/ZIP-Hashes der ersten Publikation und stoppte ausschließlich den -Downloaddienst. `inactive` bestätigt; ursprüngliche ZIPdatei zunächst erhalten, -keine RMM-Änderung. ControllerSHA256 -`d0c08d92f7f4d748108891eacae7fa1b7dc115877e4c43cdd55cbf1b9612a43a`. -Die spätere korrigierte Publikation archiviert zusätzlich die ursprüngliche ZIP -privat und ersetzt die URLzuordnung. Die alte Benutzerrückfrage wurde ausdrücklich -ersetzt; keine bestätigte Windowsausführung oder Gerätewirkung daraus ableiten. diff --git a/docs/windows-recovery-precision-download.md b/docs/windows-recovery-precision-download.md deleted file mode 100644 index 3a70d98..0000000 --- a/docs/windows-recovery-precision-download.md +++ /dev/null @@ -1,73 +0,0 @@ -# Recovery: exakte Accountzeit und tatsächlich korrigierter Download - -**Abgeschlossen:** Die ursprünglichen Fehler und Korrekturen unten sind Verlauf. -Nach Alias- und Originalbootstrap-Hashkorrektur meldete der Benutzer -Konsolenerfolg; gepinnter SSH-Readbackbb0e2b47 und vollständige separate -Erhaltungsprüfung490e0180 bestätigten den Zugang. Lokale Accessmetadaten erst -danach per CAS erneuert, keine Schlüsselersetzung. Zweites Downloadpaket nach -Aliasfehler gezielt zurückgezogen. Nach tatsächlicher Ablaufzeit zusätzlich -rein lesend bestätigt (b046e30d): Downloaddienstinactive, Closeaktionsuccess, -kein8443Listener und keine8443Allowregel. Kein weiterer Download erforderlich. -Details: [aktueller Stand](parallel-mvp-status.md). - -Der gerundete alte Account-FILETIME-Wert der ursprünglichen Recoveryquelle war -eine unbelegte Annahme. Ein zusätzlicher Quellencheck fand: Microsofts -[LocalAccounts-SAM-Code](https://github.com/PowerShell/PowerShell/blob/v6.0.0/src/Microsoft.PowerShell.LocalAccounts/LocalAccounts/Sam.cs#L2196) -übergibt `DateTime.ToFileTime()` unmittelbar als64Bit. Eine Sekundenrundung ist -in diesem Codepfad nicht enthalten. Der lokale .NET-Roundtrip des ursprünglichen -öffentlichen ISO-Strings ergibt134391345312549990. Dies ist ausdrücklich ein -berechneter Sollwert, **keine gemessene Windows-SAM-Beobachtung**. - -Die neue separat geprüfte Quelle `console_access_precision.py` (Pipebranch, -SHA8b4d14ed…) verändert ausschließlich den Guard und die neue Fallprovenienz: -exakter Sollwert aus der bereits per Hash und ISO-String geprüften alten -Config, `DateTimeOffset.UtcDateTime.ToFileTimeUtc()`, ohne Rundung, Alternative -oder Toleranz. Die frühere Quelle/ZIP und der tatsächliche Server-CAS bleiben -unverändert. Keine weitere Serverexpiryänderung. Windowsausführung durch den -Benutzer noch nicht bestätigt oder nativ nachgewiesen. - -Korrekturfall `5c96d3d8-1657-40c8-a6ec-c00b63a98210`, gleicher vorhandener -Serverlease bis2026-11-15T13:05:58UTC. ZIP-SHA256 -`dbcd5ca863c0b09f89b67eb10eeaeaf89b941bbc5840079f1bb0c36dc6ff3b3e`, -PS1-SHA256 -`4977665fb092723998473f1c4be6685b1d93975176f8957bc3287d7e2f61cb69`. -Der VM-SAM-Wert bleibt unbekannt; Abweichung verweigert vor irgendeiner Wirkung. -Wenn das vorherige Paket bereits wirkte, verweigert der ursprüngliche Config- -Hash den neuen Lauf ebenfalls. Kein Replay oder Reset alter Fälle. - -## Tatsächliche korrigierte Publikation - -Root veröffentlichte ausschließlich den korrigierten öffentlichen ZIP im Fall -`fb433a8e-a11a-4e3a-a9e7-e066fef66af9`. Neuer Publisher -`deploy/windows/publish_precision_recovery.py`, SHA256 -`efb2b0c2ea2d88dabd16138ce871ab7569bf9a69d84b5d9f70540a200f20f889`: -Python-AST und unabhängiger Quellreview bestanden; echte lesende Vorbereitung -mit exakter zurückgezogener Code-/Config-/ZIP-/inaktiver Dienstgeneration. -Original-ZIP/Config zusätzlich privat archiviert; aktuelle Servercodebytesb4f85778… -bleiben gleich. Nur korrigierter ZIP und Mapping auf genau einen neuen -zufälligen URLpfad; alte URL nicht mehr freigegeben. - -Feste Downloadfrist **2026-11-14T14:17:54UTC**. Eigener neuer Close-Timer vor -Neustart aktiviert, danach ausschließlich der alte zu dieser Publikation -gehörende13:53-Close-Timer deaktiviert. Vorher dessen Service-/Timerbytes exakt -geprüft. Getrennt tatsächlich gelesen: neuer Timer active/enabled, nächsteAuslösung -14:17:54UTC; alter Timer inactive/disabled. Die spätere tatsächliche -Timerwirkung bleibt separat zu beobachten. -Derselbe vorhandene TLS-Bootstrapdienst und8443, keine Änderung an80/ACME, -Zertifikaten/Schlüsseln, SSH-Frist, RMM-Server/Gateway oder Geräten durch diesen -Publisher. Der normale Handler prüft unabhängig zusätzlich die feste Ablaufzeit. - -Extern tatsächlich mit normaler CA-/Namensprüfung heruntergeladen; alle -ZIPbytes stimmen mitdbcd5ca8… überein. Getrennter Readback bestätigt aktiven -Dienst, Abschlussmarker und KonfigurationsSHA256 -`5cea6f899f75a6e21b1f2cdffedb0832650ea0a013d0f08ec08a24efaaa5db3b`. -Die neue Rückfrage enthält genau diesen Download, einen neuen lokalen Dateinamen -und ZIP-SHA-Prüfung vor dem Entpacken/gezielten Entsperren der eigenen PS1-Datei. -Sie ersetzt ausdrücklich die alte Rückfrage; bei bereits erfolgter alter -Ausführung wird zunächst deren tatsächliche Ausgabe benötigt. - -Die Veröffentlichung belegt keine Windows-Konsolenwirkung oder erneuten -SSH-Zugriff. Nach der Userphase bleiben gleicher Hostpin, eigene Recoveryreceipt, -Konfig-/Accountfristen, erhaltene Keys/Taskdefinition und getrennte lokale -Accessmetadatenfortschreibung per CAS zu prüfen. RMM-Job-/Clock-/SYSTEM-Gates -bleiben geschlossen; keine direkte API-/DB-Genehmigung. diff --git a/docs/windows-remaining-implementation.md b/docs/windows-remaining-implementation.md deleted file mode 100644 index 55d3be4..0000000 --- a/docs/windows-remaining-implementation.md +++ /dev/null @@ -1,237 +0,0 @@ -# Windows: verbleibende Umsetzung nach der passiven Foundation - -Stand 2026-11-14, Spezifikation1.17. **Umsetzungsplan, keine native Abnahme.** -Linux-M0–M5 bleiben separat abgeschlossen. Der Windows-Testgast ist ein eigenes -Gerät; das Notebook bleibt Entwicklungsrechner. Server bleibt -`discovery.ease-technologies.de`. RustDesk, PVE und M7 werden nicht vorgezogen. -Diese Planung erstellt weder Jobs noch Grants und verändert keine Zielmaschine. - -Die passive Windowsstrecke umfasst bereits LocalService, Enrollment/mTLS, -WSS/HTTPS/Auto-Fallback und gespeicherte Telemetrie. TLS-Negativproben als -Bootstrapadministrator ersetzen keine LocalService-Negativprobe oder Rotation. -Der gemeinsame Agentkern und die additive Plattform-/Interpreterplanung werden -aktuell separat qualifiziert. Keine daraus abgeleitete Windowscapability oder -Jobbereitschaft behaupten. Vor dem ersten Hello gelten weiterhin -[Jobgrenze](windows-job-boundary.md) und [Windows-Gates](windows-gates.md). - -## Reihenfolge mit konkreter Lieferung - -| Schritt | Kleinste lauffähige Lieferung | Eigener nativer Nachweis | -| --- | --- | --- | -| W1 unprivilegierte Jobs | Konfigurierte Signingbindung, TrustedClock, gemeinsamer signierter Sync, erhaltendes Jobjournal und begrenzter PowerShell5.1-Executor unter LocalService. | Fester UI-Hello mit exakten Rohbytes; Live-Inventur; ACK/Redelivery, Offline/Frist/Entzug, Prozessabbruch und gesperrter Wiederanlauf. Keine SYSTEM-Ausnahme. | -| W2 Helpergrenze | Ein lokaler SYSTEM-Dienst ohne Netzwerklistener, wechselseitig authentisierte Named Pipe, eigenes geschütztes Ledger, unabhängige Signatur-/Sync-/Policyprüfung. Zunächst alle Wirkungen verweigert. | Erreichbarkeit aus dem eigenen LocalService, fremde SID/PID, Pipebesetzung, falsche Signatur/Generation/Hash/Frist und volle Journale verweigert; keine Wirkung. | -| W3 Dienst und Logs | Nur eigener ungefährlicher Fixturedienst; SCM-Aktion und begrenzter Event-Log-Provider. | Je eigener UI-Plan für Start/Stop/Nachprüfung und Live-Logfenster, unabhängige OS-Nachprüfung; sensible/fremde Quellen verweigert. | -| W4 MSI und EXE | Je ein geprüftes, kleines Fixture-Rezept, feste Versionen1.0/1.1, eigener Produkt-/Dateinachweis, kein Reboot. | Native Installation, Upgrade und Noop je festem UI-Plan; Paketbestand/Nutzdateien unabhängig prüfen. MSI und EXE sind getrennte Providerabnahmen. | -| W5 Wiederaufnahme und Reboot | Bewahrte Originalaufträge/Marker; genau ein ausdrücklich erlaubter Windows-Reboot mit ursprünglichem Grant und neuer Bootkennung. | Kein blindes Wiederholen nach Wirkung; rechtzeitiger unabhängiger Wiederkontakt, zusätzlicher frischer Verifikationsbeleg und normaler signierter Abschluss. | -| W6 Abschluss der Windowsmatrix | Rotation/Widerruf auf getrennter Testidentität, Windows/Linux-Mischplan AT-15, geprüfte unterstützte Inventarquellen, Windows-Installer-/Signiernachweis. | Keine Ableitung aus Linux-/Cross-Build-/Adminproben. Offene Betriebssystemupdate-/Patchfähigkeiten sichtbar lassen, bis ihr eigener Provider und Umfang geprüft sind. | - -Jeder Schritt endet mit tatsächlichem Bericht und eigenem Commit/Push. Neue -Wirkungsversuche benötigen neue UI-Pläne. Ein fehlgeschlagener Versuch bleibt -fehlgeschlagen, Unknown bleibt gesperrt bis zum gebundenen Abgleich. Die Tabelle -ist keine pauschale Erlaubnis, Installationen oder einen Windows-Reboot auszuführen. - -## Gemeinsamer Nachweisvertrag, Windowsadapter - -Bestehende Bytes von `agent-core::auth::{Binding,Request,Outcome}`, -`ExecutionPermitPayload`, Job-/Planhashes und Signaturdomain bleiben erhalten. -Der Helper erhält denselben vollständigen Request wie der Agent und prüft ihn -selbst: Gerät/Kunde/Zuordnung, genaue Jobbytes, Genehmigungsreferenz, -Signierschlüssel, kurze Startfrist und Clock. Vor Wirkung hält er die eigene -Ressourcensperre und persistiert Grant-/Versuchsverbrauch samt Originalboot und -Originalrequest. Gleicher Versuch mit neuer Grant-ID ist keine neue Erlaubnis. -Ergebnis bleibt bis konkretem ACK; `unknown` und `awaiting_reboot` geben den -Verbrauch nicht frei. Der aktuelle gemeinsame Ledgerkern begrenzt SQLite bereits -auf1GiB/4096-Byte-Seiten und ignoriert keine Kapazitätsfehler. - -`privileged-helper/src/reconcile.rs` und `control.rs` enthalten derzeit weiterhin -Unix-Datei-/Peerzugriff, OpenSSL und Linux-Boot/Clock. Sie sind kein fertiger -Windowshelper. Deren reine Helper-Abgleichregeln werden wie der Agentkern in -einen gemeinsamen Kern mit Ports für Dateisperre/Dateiidentität, Clock, Boot und -Verifier extrahiert; Linuxbytes und vorhandene Goldenfixtures bleiben identisch. -Keine zweite abweichende Syncmaschine, kein lokales `ready=true` als Ersatz. -Windows bindet Volume-/File-ID der offenen Ledger-/Sperrhandles; Unix-`dev/ino` -werden nicht erfunden. Helper-Snapshot/Apply prüfen die ursprünglichen signierten -Entscheidungsbytes und frische Challenge-/Generationsbindung unabhängig. - -Die lokale Windowskonfiguration ist ein neuer, ausdrücklich benannter -SYSTEM-Policyvertrag, kein Linux-Rootpolicyprofil unter anderem Namen. Sie bindet -festes Gerät, Signierschlüssel, Agent-/Helperservice-SIDs, erlaubte Aktionen, -exakte Fixturedienste/Rezepthashes/Logkanäle, Laufzeitgrenzen und -`allow_reboot=false` als Default. Policyhash und Helperbuild müssen im -Readinessnachweis und in der zentralen Zielpolicy übereinstimmen. - -## Named Pipe und Identitäten - -Ein fest benannter lokaler Pipeendpunkt verwendet explizite DACL, -`PIPE_REJECT_REMOTE_CLIENTS`, `FILE_FLAG_FIRST_PIPE_INSTANCE` beim ersten Server- -Handle und zeitbegrenzte Overlapped-I/O. Keine Default-DACL: Microsoft beschreibt -sonst zusätzliche Lesezugriffe für Everyone/Anonymous. Die Agent-SID erhält nur -die konkreten benötigten Daten-/Attributrechte, kein generisches Schreibrecht, -das zugleich die Erstellung weiterer Pipeinstanzen erlauben kann. -[Pipe-Rechte](https://learn.microsoft.com/en-us/windows/win32/ipc/named-pipe-security-and-access-rights), -[CreateNamedPipeW](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-createnamedpipew). - -Der Helper liest zunächst nur einen begrenzten Frame, prüft den tatsächlichen -Client-PID und impersonierten Token: LocalService **und** eigene aktivierte -Service-SID, SCM-Prozess und gehaltenes Prozesshandle/Startidentität. LocalService -allein genügt nicht, da weitere Dienste dieses Konto nutzen können. Der Agent -prüft umgekehrt Server-PID, SYSTEM-Token, erwartete Helperservice-SID, SCM-Bindung -und geschützte Helperbinary. PID allein ist wegen Wiederverwendung kein Beleg. -Diese Kombination ist die vorgeschlagene Projektprüfung, keine Garantie einer -Einzel-API. Fehlgeschlagene Impersonation verweigert; vor Handlerausführung -`RevertToSelf` sicherstellen. Keine Kindprozesse unter versehentlich verbliebener -Impersonation starten. -[Client-PID](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getnamedpipeclientprocessid), -[Server-PID](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getnamedpipeserverprocessid), -[Impersonation und Fehlerfall](https://learn.microsoft.com/en-us/windows/win32/api/namedpipeapi/nf-namedpipeapi-impersonatenamedpipeclient). - -Helperstate und Konfiguration sind SYSTEM/Administrators-geschützt; der -Netzwerkagent kann sie nicht ersetzen. Bestehende Gerätekeys bleiben beim Agenten, -der Helper erhält ausschließlich die provisionierte öffentliche Signingbindung. -Ein eigener Windowshelper-Binarypfad innerhalb der Windowscrate vermeidet -Unix-Abhängigkeiten des Linuxhelper-Binaries. Bereits vor dem ersten autorisierten -Systemjob müssen Pipeauthentisierung und unabhängiger Sync nativ bestanden sein. - -## Minimaler additiver Aktions-/Manifestvertrag - -Vorgeschlagen ist ein optionales `windows_manifest` am `JobPayload` mit -`default`/`skip_serializing_if=None`; Linuxjobs behalten exakt ihre historischen -Bytes. Noch keine neue produktive Schemaversion oder Policyentscheidung. -Manifesttyp `rmm.windows.execution`, eigene Version1, strikte Felder: - -| Feldgruppe | Inhalt/Prüfung | -| --- | --- | -| Ziel und Auftrag | Kunde, Asset, Agent, Enrollment-/Assignmentgeneration, Job, Versuch und Action; müssen exakt dem Job entsprechen. | -| Runtime/Policy | Plattform/Architektur, Manifestversion, Helperpolicyhash und abgenommene Providerkennung. Keine vom Agenten gewählte Policy. | -| Rezept | Bei Paketaktionen unveränderliche Rezept-ID/-Version/-SHA, Produkt/Version/Installationskontext, Artifact-ID/-SHA/-Länge, fester strukturierter Argumentvektor, feste Exitklassifikation und typisierte Nachbedingungen. | -| Systemaktion | Bei Dienst/Log/Reboot ausschließlich die erforderlichen typisierten Felder und Nachbedingungen; kein Paketmanifest als allgemeiner Shellcontainer. | - -Kein `job_payload_hash` innerhalb des Manifests: dieser würde sich selbst -referenzieren. Der Startgrant bindet den Hash des **gesamten** Jobpayloads samt -Manifest. Unbekannte Felder/Provider, widersprüchliche Actionparameter, -abweichende Recipe-/Artifactbytes oder fehlende Nachbedingungen verweigern vor -Verbrauch/Wirkung. Neue Windowsfelder sind Pflicht nur für die entsprechenden -Windowsaktionen; alte APT-Manifeste werden nicht umgedeutet. - -Bestehende Fachaktionen bleiben `ensure_package`, `apply_updates`, -`set_service_state`, `query_logs` und `reboot`. Windowsprovider werden additiv -validiert, mit eindeutiger Plattformbindung. `system` wäre ein neuer expliziter -Ausführungsidentitätswert mit eigenem `system:execute`-Recht und eigener -SYSTEM-Policy; Linux-`root` bedeutet niemals Windows-SYSTEM. Freie SYSTEM-Skripte -sind kein notwendiger Ersatz für typisierte Aktionen. Capabilitynamen und genaue -Manifestfelder erst gemeinsam mit Helper/Server festschreiben; keine -Capabilities anbieten, bevor der tatsächliche Adapter bereit ist. - -Für Windowsrezepte empfiehlt sich eine eigene immutable Tabelle mit Tenant-RLS, -zusammengesetzten Tenant-FKs und getrennten MSI-/EXE-Kennungen. Der aktuelle -APT-Katalog ist auf `architecture='amd64'` und APT-Abfragen beschränkt; seine -Schlüssel dürfen nicht still für Windowsprodukte wiederverwendet werden. -Bestehende Artifactreferenzen/Hashes können erhalten bleiben. Das aktuelle -Artifactlimit beträgt256KiB: kleine Fixtureartefakte zunächst dagegen prüfen; -eine notwendige größere, begrenzte Übertragung wäre eine eigene implementierte -und getestete Vertragsänderung, kein Bootstrap-SFTP als RMM-Paketnachweis. - -## Providerverhalten und überprüfbare Wirkung - -**MSI:** Feste systemweite Installation aus dem Helper-eigenen geschützten Cache; -`msiexec /i /qn /norestart REBOOT=ReallySuppress`, ergänzt nur -um die im Rezept gebundenen Properties. Keine URL, UNC-Quelle, frei gewählte -Transformdatei oder weitere Installerargumente. Nach dem Kopieren erneut hashen, -Pfadkomponenten/Reparsepoints und Schreibrechte prüfen, während der Nutzung -Ersetzung/Änderung verweigern. `0` ist nur ein Prozessresultat; `3010` bedeutet -Neustartbedarf. `1641` meldet bereits eingeleiteten Neustart und verletzt diesen -No-Reboot-Rezeptvertrag; nicht als normale erfolgreiche Abnahme werten. -`1618` respektiert fremde Installation, kein Beenden fremder Prozesse. -[Installeroptionen](https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options), -[REBOOT](https://learn.microsoft.com/en-us/windows/win32/msi/reboot), -[Exitcodes](https://learn.microsoft.com/en-us/windows/win32/msi/error-codes). - -Nachprüfung kombiniert `MsiGetProductInfoExW` im expliziten Machine-Kontext -mit installiertem Produktzustand/Version und eigener Fixture-Nutzdatei samt Hash. -Ein beworbenes Produkt ist nicht automatisch installiert. Keine -`Win32_Product`-Erhebung. MSI-Fehler, Timeout oder verlorener Installerkontakt -belegen keine Abwesenheit einer Teilwirkung: gegebenenfalls Unknown und ein -gebundener Nur-Lese-Abgleich, keine automatische neue Installation. -[Produktinformation und Kontext](https://learn.microsoft.com/en-us/windows/win32/api/msi/nf-msi-msigetproductinfoexw). - -**EXE:** Eigenes, nachvollziehbar gebautes Fixture mit genau dokumentierten -Quiet-/No-Reboot-Argumenten, Hash, Architektur und Exitsemantik. MSI-Codes gelten -nicht automatisch für EXE. Ausschließlich verifizierte feste Rezeptparameter; -kein beliebiges EXE als SYSTEM ausführen. Nachprüfung über eigene Registry- -Produktkennung und Nutzdatei/Version/Hash. No-Reboot-Flags schützen nicht gegen -beliebige bösartige SYSTEM-Customactions: die ausdrücklich geprüfte Herkunft und -der begrenzte Rezeptumfang bleiben erforderlich. Ein Timeout beendet nicht -pauschal einen systemweiten Installationsdienst oder fremde Installer. - -**Dienste:** `OpenSCManager/OpenService` mit benötigten Einzelrechten, -`StartServiceW`/`ControlService`, danach begrenztes Warten und unabhängiges -`QueryServiceStatusEx`. Startannahme ist nicht gleich Running. Zustandsübergänge, -Checkpoint/WaitHint, Dienstexit und fehlende Rechte strukturiert melden. -Abnahme zunächst nur am eigenen Fixturedienst mit festem Binaryhash; nicht am -RMM-Agenten, SSH oder einer fremden Produktionskomponente. -[StartServiceW](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-startservicew), -[Status](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-queryservicestatusex), -[SCM-Rechte](https://learn.microsoft.com/en-us/windows/win32/services/service-security-and-access-rights). - -**Event Log:** Eigener Kanal-/Providerfilter und fixes Zeitfenster; keine freie -Datei, kein roher vom Modell gelieferter XPath. `EvtQuery/EvtNext/EvtRender`, -maximal1000Events/256KiB und Laufzeitlimit. Quelle, EventRecordID, Provider, -UTC-Zeit, Fehlermeldungen und Trunkierung erhalten; fehlender Zugang bleibt -permission_denied. Bookmark erst nach dauerhafter Übernahme/konkretem ACK -fortschreiben. Einzelnes Livefenster ist ein UI-genehmigter Diagnosejob; -gespeicherte Ergebnisse danach tenantgebunden lesen. Kein allgemeiner Zugriff -auf Security-Kanäle durch die Abnahme eines Fixturekanals. -[Eventabfragen](https://learn.microsoft.com/en-us/windows/win32/wes/querying-for-events), -[Bookmark](https://learn.microsoft.com/en-us/windows/win32/api/winevt/nf-winevt-evtupdatebookmark). - -**Reboot:** Nur lokales `InitiateSystemShutdownExW`, fest gebundene Begründung, -keine erzwungene Schließung fremder Anwendungen, eigenes gezielt aktiviertes -Shutdownprivileg im Helper. Dauerhaften Originalverbrauch und Bootbeleg zuerst -speichern. APIannahme ist asynchron und kein Erfolgsnachweis; Anwendungen können -den Vorgang verzögern/verhindern. Konservative zentrale Frist ab Startreservierung -und beide bestehenden Inventarbelege gelten unverändert. Die bisherige -CIM-LastBootUpTime-basierte Windowskennung muss einen tatsächlichen OS-Reboot von -Agent-/Helperneustart und Zeitänderung unterscheiden; aktuelle wiederholte -Abfrage allein beweist das noch nicht. -[Shutdown-API und Einschränkungen](https://learn.microsoft.com/en-us/windows/win32/api/winreg/nf-winreg-initiatesystemshutdownexw). - -## Dateien und Freigaben vor nativer Wirkung - -Geplante Änderungen, **hier nicht umgesetzt**: - -- `crates/domain/src/windows_execution.rs`, `jobs.rs`: strikte Manifest-/Rezept- - und Identitätsprüfung, optionale Jobfelder, erhaltene Linuxgoldenbytes. -- `crates/agent-core`: reiner Helper-Abgleich mit Plattformports; - `crates/privileged-helper`: bestehender Linuxadapter gegen unveränderte Verträge. -- `crates/agent-windows/src/{helper,pipe,service_provider,event_log,package,reboot}.rs` - und eigenes Helperbinary: nur tatsächlich gelieferte Provider anlegen, keine - leeren Stubs; SCM-/IPC-/Datei-/Clockadapter und eigenes Ledger. -- Server `jobs`, `root_policy` oder neue explizite `windows_policy`, `catalog`, - `job_gateway`, `synchronization`: Rechte/Caps an jeder Grenze und unabhängiger - Rebootabschluss; neue RLS-Migration nur für tatsächlich benötigte Windowsrezepte. -- WebUI/Schemas: vollständige unveränderliche Rezept-/Manifest-/Rebootpreview, - keine neue Genehmigungsabkürzung; dieselben Anwendungsfälle für HTTP und MCP. -- `deploy/windows`: erhaltender Helperbootstrap, kleine geprüfte Fixturequelle/ - Rezeptartefakte, geschützte native Nachweisrunner und tatsächliche Requalifikation. - -Reversible Entwicklung, Builds und Bootstrapvorbereitung sind im Auftrag. -Konkrete native Paket-/Dienstwirkungen brauchen jeweils den fertig einsehbaren -festen dev/test-UI-Plan. Ein Windows-VM-Reboot ist eine gesondert konkret zu -vereinbarende Zielaktion; der frühere einzelne Linux-Reboot erlaubt ihn nicht. -Kein pauschales „alles okay“ anfordern: zuerst Artefakt, Rezept, Ziel, Plan, -No-Reboot-Vertrag, Nachprüfung und Wiederaufnahme vorbereiten, dann nur die -wirklich fehlende konkrete Freigabe klären. Ein Installerfehler berechtigt weder -Markerreset noch zweiten Versuch. Nach jedem Abnahmeschritt dokumentieren/pushen. - -Zur vollständigen Windowsabnahme zählen außerdem bisher offene Rotation/ -Widerruf, Installer-/Signierstatus und plattformspezifische Fehlerfälle. -MSI-/EXE-Fixtureupdates sind kein Nachweis von Windows-OS-/Kernelupdates. -Ein WUA-Provider benötigt eigene COM-Threads, versionierte Scan-/Update-IDs, -Updateeinzelergebnisse und eigene Start-/Nachprüfung; solange nicht geliefert -bleibt diese Capability unsupported. Microsofts Beispiele sind keine fertigen -Produktprovider: [WUA-Vertrag](https://learn.microsoft.com/en-us/windows/win32/wua_sdk/using-the-windows-update-agent-api). -Diese Grenzen dürfen bei einem späteren „Windows vollständig“ nicht verschwinden. - -Für diesen Plan wurden ausschließlich Repositoryquellen und die verlinkten -Microsoft-Primärquellen gelesen. Keine neuen Tests, Builds, Dienste, -Installationen, Genehmigungen oder VM-/Serverkontakte ausgeführt. diff --git a/docs/windows-signed-clock-calibration-assessment.md b/docs/windows-signed-clock-calibration-assessment.md deleted file mode 100644 index 6e4c345..0000000 --- a/docs/windows-signed-clock-calibration-assessment.md +++ /dev/null @@ -1,51 +0,0 @@ -# Windows: fehlende numerische Timerqualifikation - -Stand 2026-11-15, Spezifikation1.22. Ergebnis dieser Quellenprüfung: **Mit den bisher vorhandenen Nachweisen lässt sich kein qualifizierter positiver `base_error_ns` erzeugen.** Kein Kalibrierungsproducer, keine provisionierte Zeitkonfiguration und keine Gatefreischaltung wurden daraus gebaut. Dies ist eine präzise fehlende Voraussetzung, keine Behauptung, Windowszeit sei grundsätzlich unqualifizierbar. - -## Was tatsächlich zu begrenzen ist - -UTC-Autorität kommt aus dem unabhängig signierten Serverbeleg, nicht aus einem behaupteten lokalen W32Time-Sync. Die eigene Windows-Wallclock wird gegen das gesamte daraus gebildete Intervall geprüft. Ihr unbekannter UTC-Offset ist deshalb nicht der fehlende Kalibrierungswert. - -Im eingefrorenen Kandidaten `e7ba4730…`/`e71be671…` erfasst `raw_capture` die feste Folge Interrupt-before, Unbiased-before, Wallclock, Unbiased-after, Interrupt-after. `bracket_sample` bildet den gemessenen Interruptbracket in Nanosekunden und addiert `base_error_ns`. Die unveränderte lokale Konfiguration verlangt einen positiven Grundwert von höchstens10ms und genau eine imagegebundene Qualifikation je Agent-/SYSTEM-Rolle. - -Der gemeinsame Verifier verwendet den vollen lokal gemessenen Interruptabstand `R`, nicht `R/2`. Seine drei Capturebudgets werden zu `delta` addiert (höchstens50ms); `delta` vergrößert die obere Server-UTC-Grenze und das geprüfte Quellalter. Damit ein solcher oberer UTC-Endpunkt konservativ ist, muss dieses Budget insbesondere eine mögliche **Unterzählung** des lokalen Intervalls und die Zuordnung der eigenen Wallclock in ihren Capturebracket decken. Die 100ns-Darstellung allein belegt diese Schranke nicht. - -## Offizielle API-Verträge und ihre Grenze - -Microsoft beschreibt `GetSystemTimePreciseAsFileTime` als UTC-Systemzeit mit höchstmöglicher Präzision unter1µs; Intervallmessungen werden getrennt behandelt. Daraus folgt kein belegter UTC-Offset dieses Gasts. [Microsoft: GetSystemTimePreciseAsFileTime](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtimepreciseasfiletime). - -`QueryInterruptTimePrecise` liefert 100ns-Einheiten und liest den Timer direkt. Der auf derselben Seite genannte typische Systemtickbereich beschreibt die gröbere nichtpräzise Variante, keine garantierte numerische Fehlerschranke dieses Precise-Getters auf unserer VM. [Microsoft: QueryInterruptTimePrecise](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise). - -`QueryUnbiasedInterruptTimePrecise` lässt Schlaf-/Hibernatezeit aus und liefert ebenfalls präzisere direkte Timerwerte. Seine Dokumentation liefert keinen numerischen maximalen Frequenzfehler dieses Gasts. [Microsoft: QueryUnbiasedInterruptTimePrecise](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise). - -Der dokumentierte Kernelgetter `KeQueryInterruptTimePrecise` nennt Mikrosekundengenauigkeit gegenüber der Systeminterruptzeit. Der Kandidat ruft diesen Kernel-DDI nicht auf; daraus darf kein nicht dokumentierter numerischer Vertrag für alle drei Usermode-Getter, ihre gemeinsame Zuordnung und den realen Gastoszillator abgeleitet werden. [Microsoft: KeQueryInterruptTimePrecise](https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nf-wdm-kequeryinterrupttimeprecise). - -Microsoft trennt in der QPC-Grundlage Auflösung, Zugriffspräzision, Frequenzgenauigkeit und Stabilität. Hersteller-/Hardwaretoleranzen bestimmen den Frequenzfehler; typische Beispiele sind keine zugesicherte Obergrenze. Die QPC-Frequenz ist zudem nicht notwendig die physische Oszillatorfrequenz. Für Gäste setzt Microsoft einen korrekt implementierten Hypervisor voraus. Ein Wechsel zu QPC oder ein zusätzlicher QPC-Vergleich allein beseitigt die fehlende numerische Plattformschranke daher nicht. [Microsoft: High-resolution time stamps, insbesondere Virtualization und Low-level hardware clock characteristics](https://learn.microsoft.com/en-us/windows/win32/sysinfo/acquiring-high-resolution-time-stamps). - -Auch der Hyper-V-Referenzzählervertrag liefert keine universelle numerische SI-Genauigkeitsgrenze. Er beschreibt konstante Referenzrate und weist auf Zählerstillstand während bestimmter Save-/Suspendzustände hin. Das ist ein Gegenbeispiel gegen die pauschale Ableitung eines physikalischen Bounds allein aus „virtueller konstanter Timer“, kein Befund über den tatsächlich verwendeten Hypervisor dieser VM. [Microsoft: TLFS Timers](https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/tlfs/timers). - -## Warum die vorhandenen realen Rohmessungen nicht reichen - -Root hat beide festen Rollen tatsächlich mit128 Captures geprüft. Diese Belege bleiben unverändert gültige Beobachtungen ihres Brackets und der internen Zählerdifferenzen. Sie enthalten aber keine unabhängige numerisch begrenzte Referenz für die reale Zählrate. Ein gemeinsamer langsamer Oszillator oder eine gemeinsame Virtualisierungsabweichung kann Wallclock-, Interrupt- und Unbiasedwerte zugleich betreffen; interne Übereinstimmung schließt das nicht aus. Aus einem endlichen beobachteten Maximum folgt auch keine Obergrenze für einen folgenden Capture. - -Ein zusätzlicher Schlaf-/Busywait-Test oder ein Vergleich mit `Instant`/Stopwatch würde keinen unabhängigen Maßstab schaffen. Ein tatsächlich signierter Serververgleich kann vergangene Messpunkte eingrenzen; ohne begrenzte Änderung/Stabilität der lokalen Zählrate liefert er allein noch keine garantierte zukünftige Timerfehlerschranke. Eine empirische Qualifikation darf diese fehlende Annahme nicht still durch einen Sicherheitsfaktor ersetzen. - -## Kleinste Ergänzung innerhalb des vorhandenen Vertrags - -Erforderlich ist ein belastbarer aktueller Plattformnachweis, der unter der bereits erlaubten OS-/Hypervisor-Vertrauensannahme mindestens folgende Größen begrenzt: mögliche Timer-Unterzählung über den gesamten kurzen Belegzeitraum; diskrete/API-interne Zuordnungsfehler der verwendeten Getter; sowie den gültigen Betriebskontext einschließlich Pause/Restore/Migration. Das kann ein zur tatsächlichen Plattform passender dokumentierter Hersteller-/Virtualisierungsvertrag oder eine unabhängige Referenzqualifikation **mit explizit begrenzter Stabilitätsannahme und Gültigkeit** sein. Ein geratenes ppm-Limit oder bloßes Modell-/Featureflag genügt nicht. Hypervisorzugang wird hier nicht als neue Produktvoraussetzung eingeführt; derzeit fehlt der Nachweis für diesen konkreten Gast. - -Rechnerisch: Wenn ein belegter relativer Unterzählungsbound `0 <= rho < 1` und ein belegter additiver Endpunktfehler `q` die Ungleichung `R_measured >= (1-rho)*R_real - q` garantieren, folgt `R_real <= (R_measured+q)/(1-rho)`. Für den gesamten zulässigen Bereich muss die daraus resultierende Unterzählung konservativ in `delta` Platz finden. Read-/Wallclock-Zuordnung und Rundung kommen zusätzlich hinzu. Rollenbelegte Bracketmessungen liefern dann die tatsächlich beobachteten Werte, die laufende Implementierung verwirft übergroße Brackets selbst; der dokumentierte Basiswert darf keines dieser nicht erfassten Fehlerglieder auslassen. Ergebnis und Qualifikationsreferenz müssen an **die exakten** Produktimages und die tatsächlichen Rollen gebunden werden, nicht allein an den früheren Diagnose-EXE-Hash. - -Erst mit diesen Eingangsnachweisen ist ein enger Producer sinnvoll: ausschließlich kontrollierte originale Rollenbelege plus nachprüfbarer Plattformvertrag, ganzzahlige aufgerundete Rechnung, Budgetprüfung, genaue Provenienz und imagegebundene Ausgabe. Solange ein Glied fehlt, erzeugt er keine `Calibration`. Ein Producer, der jetzt lediglich eine beliebige Zahl aus diesen Rohdaten berechnet, wäre eine Scheinqualifikation; deshalb wurde er nicht implementiert. - -## Zusätzlicher Frischebefund am unveränderten Verifier - -`evidence_interval` prüft derzeit `elapsed <= 1s` und `age <= 100ms` auf den rohen Interruptdifferenzen. Erst danach wird `delta` für UTC-Obergrenze und Quellalter verwendet. Das sind damit zunächst nominelle OS-Zählergrenzen. **Falls** der geforderte Timerbound auch physikalische Unterzählung beinhaltet, müssen dessen konservative oberen Intervallwerte ebenso vor diesen Frischegrenzen liegen; eine bloße Addition zu UTC-U reicht dann nicht. Eine mögliche enge Umsetzung nach Festlegung des Fehlervertrags ist ein jeweils konservatives `upper_elapsed <= 1s` und `upper_age <= 100ms`. Überbreite Verwendung des gesamten `delta` wäre konservativ, muss aber technisch zur Endpunkt-/Fehlerallokation passen. - -Dies ist ein gezielt gemeldeter offener Sourcebefund, kein hier ausgeführter Fix. Der bereits qualifizierte Codec, Wirebytes, 202-Eingaben-Snapshot und beide Kandidaten blieben unverändert. Eine Umdefinition der Grenzen zu nominellen statt konservativ begrenzten Zeitintervallen wäre eine ausdrückliche Vertragsänderung, keine zulässige stille Kalibrierungsentscheidung. - -## Ausgeführt und offen - -Tatsächlich ausgeführt: offizielle Microsoft-Primärquellen gelesen, Capture-/Codec-/Loaderpfad im vorhandenen Quellcode geprüft und diese Bewertung dokumentiert. Keine neue VM-Diagnose, keine Ziel-/Gitaktion, keine Schlüssel gelesen, keine Werte erzeugt, keine Tests oder Builds wiederholt. Die Linux-first- und Windows-Roh-/Runtimebelege werden dadurch nicht rückwirkend verändert. - -Nächster notwendiger Schritt ist die Entscheidung über einen konkret belegbaren numerischen Plattform-/Fehlervertrag, anschließend dessen enge Rollen-/Imagequalifikation und der dazu passende Frischecheck. Bis dahin bleiben Zeitpins/Kalibrierung und Windowswirkungen gesperrt. Die separate tatsächliche Serverquellqualität bleibt zusätzlich erforderlich. diff --git a/docs/windows-signed-clock-capture-operator.md b/docs/windows-signed-clock-capture-operator.md deleted file mode 100644 index 6724ff7..0000000 --- a/docs/windows-signed-clock-capture-operator.md +++ /dev/null @@ -1,159 +0,0 @@ -# Separater Operator für die Windows-Rohclockprobe - -Stand2026-11-15, Spezifikation1.22. Neuer Quellpfad: -`deploy/windows/signed_clock_capture_acceptance.py`. Dieser Runner ist ein -enger Entwicklungsbootstrap für genau zwei eigene temporäre SCM-Fixtures. -Kein RMM-Job, keine Calibration, kein Zeitpin, kein TrustedClock-/Readybeleg. -Die [Probequelle](windows-signed-clock-capture.md) bleibt unverändert. - -Der ursprüngliche Quellenauftrag führte keine Zielaktion aus. Die späteren -tatsächlichen Operatorphasen und ihre Fehler sind im Ergebnisabschnitt unten -getrennt dokumentiert; geplante Befehle sind kein Erfolgsnachweis. - -## Vorbedingungen und feste Herkunft - -Nur der Rootoperator führt den Runner nach unabhängigem Review aus. Sein -`CaptureAccess` verwendet unverändert `system_pipe_upgrade.Access(MainRoot)` -für den bereits gepinnten SSH- und Serverzugang. Credentials bleiben ausschließlich -im Maincheckout und werden erst durch die tatsächliche Operatorphase gelesen. -Keine Kopie, kein alternativer Host, kein Hostkeybypass und keine Shellauswertung -von Konfigurationsdaten. Zwei neue feste Stagenamen sind ausschließlich -`SignedClockCapture.exe` und `SignedClockCaptureAcceptance.ps1`; alte Allowlisten -werden nicht erweitert oder verändert. - -Vor der lokalen Vorbereitung werden190 gefrorene Inputs, Receiptba9ba8d8, -Inputmanifest2d21da4d und Readonlymanifest91c75ba8 geprüft. Windowsprobe: -8566784Bytes, SHA256 -`601c27a43fb67c662f926f9dc289a23a5c31c7e27f62901a77fc9ceaafaea7fb`. -Die neue vorbereitete Fallkopie verwendet700/600, exklusive Dateien und fsync. -Ein fester lokaler Active-Intent verhindert einen neuen Fall als Ersatz für -einen unklaren Versuch. Es gibt keinen Reset- oder automatischen Retrypfad. - -Pflicht ist der tatsächliche Linux-first-Nachweis des exakt selben Rawquellsatzes: -Originalfall `dcef489d-2a24-47cc-b3ca-6628545cdacf`, Originalread -`read-80f83bff-183b-4697-80b2-9b96a8182e8d.json`, SHA256 -`91a750e4de266f5effccbd418a680c1ba4f5e0aff5082489fc021922bdfcafa3`. -5Guards bestanden,10 ausdrücklich gefiltert,15vorher gelistet; Originalmanifest, -Receipt und unveränderte Before-/After-/Currentwitnesses müssen passen. -Dieser Pflichtbeleg ist kein tatsächlicher Windows-Timernachweis. - -Der angenommene reale Windowsbestand bleibt ausschließlich der akzeptierte -14fb176a-Fall samt originalen Mainindices. Der Runner ruft dessen bestehenden -`finish` ausschließlich lesend auf. Er akzeptiert keine andere Boot-/PID-/ -SCM-Generation und repariert keine Indices oder Identität automatisch. - -## Geplante Phasen, nicht ausgeführt - -Auf dem Entwicklungsrechner, im Clockworktree: - -```text -python3 deploy/windows/signed_clock_capture_acceptance.py prepare -python3 deploy/windows/signed_clock_capture_acceptance.py baseline --case -python3 deploy/windows/signed_clock_capture_acceptance.py setup --case -python3 deploy/windows/signed_clock_capture_acceptance.py start-local-service --case -python3 deploy/windows/signed_clock_capture_acceptance.py start-system --case -python3 deploy/windows/signed_clock_capture_acceptance.py read --case -python3 deploy/windows/signed_clock_capture_acceptance.py cleanup-local-service --case -python3 deploy/windows/signed_clock_capture_acceptance.py cleanup-system --case -python3 deploy/windows/signed_clock_capture_acceptance.py read --case -``` - -`prepare` ist rein lokal. `baseline` liest tatsächliche Serverflags/Zähler und -den unveränderten nativen Windowsbestand. Vor und nach **jeder** mutierenden -Phase werden exakt sechs vollständige stabile Felder verglichen: `files`, -`service`, `helper_service`, `agent_kernel`, `helper_kernel`, `helper_witness`. -`public_metadata` wird nicht ausgeklammert. Zusätzlich bleiben Journaldatei-ID, -Creation, IdentitySHA, Schema und Corecounts gleich; die passive Telemetrie- -sequenz darf nur steigen. Pending-/ACK-Telemetrie wird nicht bytegleich verlangt. -Windows0/0/0/0, Linux31/31/27/0, geschlossene Rootpolicycf15 und deaktivierte -Transportfaults müssen tatsächlich unverändert sein. Historische30er-Zähler -werden nicht übernommen. Unerwartete neue Generation bedeutet Stop und Befund. - -`setup` erzeugt nur seinen neuen eigenen Fall unter -`C:\ProgramData\RustDiscoverySignedClockCapture\`, einen privaten -Controllerbereich und genau die beiden festen Demand-Start-/OWN_PROCESS- -Dienste `RmmSignedClockCaptureLocalService` und `RmmSignedClockCaptureSystem`. -Konten sind LocalService/SID19 und LocalSystem/SID18. Beide eigene Dienst-SIDs -werden eingeschaltet, beide Definitionen entstehen vor dem ersten Rollenstart. -Root/System verwalten Definitionen und Case; Lesen erhalten nur beide eigenen -Fixture-SIDs, Schreiben nur die jeweils eigene SID im eigenen Rollenunterordner. -Keine allgemeine SID19-/Users-Schreibfreigabe. Die EXE wird ausschließlich aus -dem vollständig verifizierten unveränderlichen Staging kopiert. - -Jede Startphase schreibt ihren dauerhaften Attempt vor dem einmaligen SCM- -Start. Der Operator hält tatsächlichen Prozesshandle, PID, native Geburt, -Imagepfad, Account und aktivierte Dienst-SID. Der feste Commandlinevektor muss -zusätzlich passen. Es gibt keinen PID-basierten globalen Kill. Der Watchdog -beobachtet eigene GetTickCount64-Uptime: nach40s nur den weiterhin exakt -gebundenen eigenen Prozesshandle terminieren, anschließend höchstens5s auf -Kernelprozessende warten. Ohne gehaltene exakte Identität bleibt Timeout unklar; -kein Fremdprozess wird übernommen. Der SSH-Controllertransport hat einen -separaten90s-Abbruch. Synchrone Kernel-/SCM-/CIM-Aufrufe und Schedulerstillstand -sind keine harte Echtzeitgarantie. Die feste Boot-CIM-Probe kann vor der -250ms-Rawerhebung bis15s benötigen. Managed Compiler-/Runtime-Temporärarbeit -des festen Add-Type-Interop folgt dem vorhandenen Bootstrapmuster und erteilt -keine RMM- oder beliebige Programmausführung. - -Erfolg verlangt durable Probe-Intent/Report/End, numerische128er-Serie, -ImageSHA601c27, passende Rollen-/Token-/Geburtsbindung und tatsächlich beobachtetes -Kernelprozessende plus SCM-Stopped/Exit0. Ein Timeout oder fehlender Endbeleg -wird nicht durch späteren Zustand geheilt. `calibrated=false` und -`clock_authority=false` bleiben unverändert. Die Antwort enthält nur feste -Rollen, Fall-ID und begrenzte numeric/hash-Diagnosedaten; CLI meldet nur eine -kleine ASCII-JSON-Zusammenfassung. - -Cleanup ist ein eigener expliziter Schritt. Nur dieselbe exakt konfigurierte, -bereits gestoppte eigene Definition darf einmal gelöscht werden. Für einen -begonnenen Start ist der erhaltene native Exitbeleg Pflicht; eine nie gestartete -Definition wird dadurch nicht nachträglich gestartet. Dauerhafter Delete-Attempt -vor DeleteService, danach echte Abwesenheitsprüfung. Sobald Cleanup beginnt, -bleiben weitere Starts geschlossen. Fallverzeichnisse und Rohbelege bleiben -zur Prüfung liegen; keine rekursive Bereinigung. - -Nach verlorenem Reply ausschließlich `read` desselben Originals. Das startet -weder Probe noch Dienste und löscht nichts. Partielle Setupzustände werden -als unvollständig und unverifiziert sichtbar, nicht als Abnahme ausgegeben. -Auch ein erfolgreich beendeter Rohsampler beweist nur beobachtete Timerwerte -unter OS-/Hypervisorannahmen, keine absolute physikalische Genauigkeit und -keinen zulässigen Grundfehler für einen produktiven Clockpin. - -RMM-Dienste, PKI, Datenbanken, Helperpins, Rootpolicy, W32Time und Clocksetter -werden von diesem Controller nicht verändert. Dauerhafte Jobs benötigen -weiterhin ihren unveränderlichen WebUI-genehmigten Plan. Die native Windows- -Ausführung, Grundfehlerbewertung, echte unabhängige Agent-/SYSTEM-Roundtrips -und Runtime-/Deadlineintegration bleiben getrennte Gates. - -## Tatsächliche native Schritte, 2026-11-15 - -Originalfall `efd17b43-7e04-49a7-9bd4-862d13365eec`, Operator-SHA256 -`dd6c575a119751429448e40e6f306cf79efa3a86c49bf2cd32a7783937177770`, -Controller-SHA256 -`89c19138e2804f263f1875c7697a7d53f54f40722101677b4d29538c917196f4`. -Lokale Vorbereitung und lesende native Baseline bestanden. Auf der Windows-VM -bestand PowerShell5.1.26100.9818 die ASTprüfung ohne Fehler und kompilierte -den extrahierten C#-Interop; der Controller wurde dabei nicht ausgeführt. -Syntaxreceipt-SHA256 -`cec5ad635814fba9a6e98932b6df5b5204178b3e39e3c2361ccec211b5676b5a`. - -Die anschließende einmalige Einrichtung scheiterte mit Win32Exception auf -Controllerzeile138. Keine Rollenstartphase wurde aufgerufen. Separater -Originalfall-Readback `3890b0a6-2691-4f6b-8968-c268e031dff9` ist vollständig, -Receipt-SHA256 -`bc2a4be1b27ef02f6111e7ed82e58efab7df40af84e9253c77836675282f70ae`. -Er meldet ausdrücklich `partial_setup=true`: eigener LocalService-Messdienst -vorhanden und gestoppt, eigener SYSTEM-Messdienst fehlt. Die sechs vollständigen -RMM-Witnesses und Serverzähler wurden unverändert nachgelesen. Das ist kein -erfolgreicher Setup-, Capture-, Calibration- oder Uhrbereitschaftsnachweis. - -Eine zusätzliche rein lesende SCM-Abfrage bestätigt LocalService-Konto, -Demandstart, feste Originalkommandozeile, UNRESTRICTED-Dienst-SID und -SYSTEM/Administrators-DACL. Receipt-SHA256 -`ff8e2eef73139c8350aa0f86c6fed5125fce95f79d535f25224829ce4fa9c565` -bindet die separaten Originalmarker: LocalService-created vorhanden, -SYSTEM-create-attempt vorhanden, SYSTEM-created fehlt. Damit scheiterte -die zweite Erstellung; die ursprüngliche innere native Fehlernummer wurde -vom bestehenden Transport nicht erhalten. Ein PowerShell-null/String-Binding -ist ein konkreter Quellenverdacht, noch kein gemessener NativeErrorCode. -Kein Setupretry, neuer Ersatzfall, Dienststart oder Cleanup wurde vorgenommen. -Die gestoppte eigene Fixture bleibt bis zu gesondert geprüfter Reparatur oder -Bereinigung sichtbar erhalten. RMM-Dienste und W32Time bleiben unverändert. diff --git a/docs/windows-signed-clock-capture.md b/docs/windows-signed-clock-capture.md deleted file mode 100644 index 2da44c8..0000000 --- a/docs/windows-signed-clock-capture.md +++ /dev/null @@ -1,197 +0,0 @@ -# Windows: begrenzte Rohbeobachtung der präzisen Uhrgetter - -Stand2026-11-15, Spezifikation1.22. Dieser getrennte Schnitt bereitet die -tatsächliche Timerbewertung des [signierten Zeitvergleichs](windows-clock-attestation-proposal.md) -vor. **Kein Calibrationpin, kein TrustedClock, keine Jobfähigkeit.** Der frühere -6b66612b-Quellenschnitt und sein184-Input-Snapshot bleiben unverändert erhalten. - -## Gemeinsame Getterfolge, keine alternative Clockautorität - -`signed_clock.rs` verwendet jetzt genau eine private `raw_capture`-Funktion für -installierten Verifier und Diagnose. Ihre feste Reihenfolge ist: - -1. `QueryInterruptTimePrecise` vor der Wallclock; -2. `QueryUnbiasedInterruptTimePrecise` davor; -3. `GetSystemTimePreciseAsFileTime`; -4. `QueryUnbiasedInterruptTimePrecise` danach; -5. `QueryInterruptTimePrecise` danach. - -Alle drei APIs sind dokumentierte VOID-Getter. Auf Windows10+ wird ihr -Vorhandensein vorausgesetzt; kein optionaler Lookup, fremder Zielprozess oder -Fallback. Null-/ungültige Werte und rückläufige Getterintervalle verweigern. -[Unbiasedgetter](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise), -[Interruptgetter](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise). - -Nur der installierte Verifier darf die privaten Rohwerte über seinen bisherigen -`bracket_sample`-Pfad mit einem tatsächlich qualifizierten geschützten -Grundfehlerbudget zu einem `Sample` machen. Der Diagnosepfad hat kein solches -Budget und erzeugt kein `Sample`, keine Signatur, Clockinstanz oder Lease. -Er ruft weder den Konfigurationskonstruktor noch eine Ersatzfreigabe auf. -Der Getterrefactor verändert keine Key-, Nonce-, Continuity-, Connection- oder -WebUI-Grenze. Zusätzliche rohe Rangeguards verweigern lediglich. - -Die Diagnose verwendet exakt128 Captures mit festen nominalen1ms-Zielabständen. -Sie wartet nur mit `spin_loop` und eigener `std::time::Instant`-Beobachtung, -höchstens250ms für die Erhebung. Auch die tatsächlich gelesene gesamte -Interruptspanne darf250ms nicht überschreiten. Rückwärtswerte, eine beobachtete -Diskontinuität über1s, unvollständige Serie oder überschrittenes Budget brechen -ab. Ein Schedulerstillstand wird nach Wiederzuteilung als überschrittenes Budget -verweigert; daraus wird keine präzise Prozess-Endegarantie abgeleitet. - -Der kompakte Rohbericht enthält fünf100ns-Spalten je Zeile: Wallclock-FILETIME, -Interrupt vorher, Unbiased vorher/nachher, Interrupt nachher. Er meldet -tatsächliche Bracketbreite und maximale beobachtete Wall-/Interrupt- sowie -Interrupt-/Unbiaseddifferenzen, Stichprobenzahl und beide verstrichenen Spannen. -`calibrated=false` und `clock_authority=false` bleiben fest. Es gibt keine -Deserialisierung als Clockbeleg und keine Caller-Samples in der nativen API. -Der vollständige Diagnosebericht einschließlich Prozessmetadaten bleibt -höchstens16KiB; keine Host-/Benutzernamen, Peers, Schlüssel oder Kundendaten. - -## Enges eigenes SCM-Fixtureprofil - -Das neue Example `examples/signed_clock_capture.rs` installiert oder konfiguriert -keinen Dienst. Nur ein gesonderter Native-Operator darf nach Source-/Binaryreview -die beiden fest benannten temporären OWN_PROCESS-/Demand-Start-Fixtures anlegen: - -- `RmmSignedClockCaptureLocalService` unter LocalService/SID19; -- `RmmSignedClockCaptureSystem` unter LocalSystem/SID18. - -Beide benötigen ihre eingeschaltete eigene Dienst-SID. Sie werden getrennt -gestartet und beobachtet. Der Prozess prüft tatsächlichen Account und aktivierte -eigene Dienst-SID mit der bestehenden Tokenprüfung; Threadimpersonation, -unbekannter Account und aktivierte Administratorgruppe bei SID19 verweigern. -Elevationflag und Elevationtyp sind separate unverfälschte numerische Angaben. -Ein Administratorprozess kann keinen LocalService-Nachweis ersetzen. - -Feste, **geplante und hier nicht ausgeführte** Argumentform: - -```text -SignedClockCapture.exe --service local-service -SignedClockCapture.exe --service system -``` - -Kein frei wählbarer Dienstname, Pfad, Programm, Skript oder anderer Modus. -Der Prozess startet ausschließlich über den SCM-Dispatcher, meldet nur seinen -eigenen Running-/Stopped-Status und akzeptiert keine Fremddienststeuerung. - -Der Operator muss vorab genau diesen eigenen Case vorbereiten: -`C:\ProgramData\RustDiscoverySignedClockCapture\`. Darin liegt exakt -`SignedClockCapture.exe`; der tatsächlich laufende Imagepfad muss dazu passen. -Basis, Case und Image gehören SYSTEM/Administrators und gewähren höchstens den -beiden festen Fixture-SIDs Lesen. `local-service` und `system` sind getrennte -Unterverzeichnisse; nur die jeweilige eigene Fixture-SID darf dort zusätzlich -schreiben. Keine allgemeine LocalService-/Users-Schreibfreigabe. Beide -Fixture-SIDs müssen für die gemeinsame Leserprüfung auflösbar sein; deshalb -beide Definitionen vor der ersten Probe vorbereiten, keine automatische Anlage -durch den Worker. Reparse, fremde ACLs oder ersetzte gehaltene File-IDs sperren. - -Jeder Rollenlauf erzeugt ausschließlich seine neuen `intent.json`, `report.json` -und `end.json`. Vorhandene Marker verweigern Wiederholung. Dateien werden -create-only mit Reparse-/Linkprüfung geschrieben und geflusht. Gehaltene -Verzeichnisse und Image bleiben erhalten. Nach verlorenem Reply ausschließlich -denselben Originalfall lesen; kein Löschen, Überschreiben oder erneuter Start -zur Umgehung eines unklaren Laufs. Fehlender Endbeleg ist kein Erfolg. - -Der Bericht bindet PID, native Prozessgeburt, Imagehash/File-ID und unabhängig -gewonnene Boot-ID. Die bestehende feste lesende CIM-Bootabfrage läuft vor dem -250ms-Erhebungsbudget; kein Benutzer-/Modellskript. Keine RMM-Konfiguration, -PKI, Journale, Consumption, Helperpins oder tatsächlichen RMM-Dienste werden -geöffnet oder geändert. W32Time wird weder abgefragt noch gesteuert. Es gibt -keinen Netzwerkclient und keine neue RMM-Nachricht oder Capability. - -## Nachweise und Grenzen - -Erster lokaler Vorbereitungslauf: fünf gezielte gemeinsame Guardtests bestanden, -zehn übrige Cratetests ausdrücklich herausgefiltert. GNU-Alltargetscheck und -Clippy mit `-D warnings` bestanden. Dies war eine schnelle Sourceprüfung vor -dem folgenden eingefrorenen Artefaktbeleg, kein nativer Timer- oder Rollennachweis. -Der folgende eingefrorene Artefaktbeleg ergänzt diese Vorprüfung. Eine VM-Aktion -wurde durch diesen Sourceworker nicht ausgeführt. - -Eine konsistente128er-Serie belegt nur diese Beobachtungen unter dem aktuellen -OS-/Hypervisorvertrag. Sie liefert **keine absolute physikalische Genauigkeit** -und keinen bewiesenen Grundfehler durch die größte gemessene Bracketbreite. -Auflösung ist keine Genauigkeit; QPC/Interrupt/Wallclock sind zudem keine -vollständig unabhängigen physikalischen Quellen. Korrektes Verhalten von -Windows-Kernel und Hypervisor bleibt eine ausdrücklich genannte Annahme. -Das erforderliche Grundfehler-Assessment, die geschützte Pinprovisionierung, -reale getrennte Agent-/SYSTEM-Signatur-Roundtrips und Runtime-/Deadlineintegration -bleiben eigene offene MVP-Schritte. Auch eine erfolgreiche temporäre -LocalService-/SYSTEM-Probe ist kein Nachweis der produktiven RMM-Dienstrollen. - - -## Eingefrorener aktueller Source- und Artefaktbeleg - -Neuer eigener Fall6bcd72a7-6de7-48e6-9e9b-3ad2cd3d9b09 bindet190 Inputs. -Der alte184-Input-Fall763baf69 bleibt unverändert. Modul SHA256 -`d9dd843db7c17ac4c8f242c9f20063c2a7ce6ad11d3c75826516a22dc5e7685e`, -Example SHA256 -`23f7c8d832bf9042fb89226729aa1cfe2a65ad33b76cda15cc69f8995d5834d0`. -Inputmanifest SHA256 -`2d21da4d137d2efd48cb2679fb791a9055839b042373d0f38c5af8d9ea8c5a8c`, -Receipt SHA256 -`ba9ba8d88ed71952dd8dc803f2e38d5da72edeae392818cd320c6fd532ac7f4d`. - -Tatsächlich lokal mit den eingefrorenen Quellen und festgelegten Offlineimages: - -- Linux-Release-Lib-Testbinary gelinkt; komplette Liste exakt15 Tests, - 0 Benchmarks. Nur die fünf `signed_clock::tests` ausgeführt:5bestanden, - 0failed/ignored;10 übrige Cratetests ausdrücklich herausgefiltert. -- Windows-GNU-Releaseprobe mit `--features system-helper --example - signed_clock_capture --target x86_64-pc-windows-gnu --release` gelinkt. -- Windows-GNU-Alltargets-Clippy mit `-D warnings` bestanden. -- Formatcheck ausschließlich von Modul und neuem Example bestanden. - -Linuxexe `qualified-linux-tests`:3404432Byte, SHA256 -`dceee96d9e58d8b5c3606c724b4d390c2eea6472bf33d317e7a5a9102c0c5e06`. -Windowsprobe `SignedClockCapture.exe`:8566784Byte, SHA256 -`601c27a43fb67c662f926f9dc289a23a5c31c7e27f62901a77fc9ceaafaea7fb`. -Beide Artefakte exklusiv kopiert und auf0500 begrenzt; private Quell-/Belegdateien -0600, Verzeichnisse0700. Keine älteren qualifizierten Binaries überschrieben. - -Der separat lesbare Capabilitymanifest `readonly-capabilities.json` bindet -Binaries, feste Service-/Konten-/Pfadformen, Clockgetter, eigene Prozess-/ -Bootmetadaten, create-only-Ausgaben, Limits und ausdrücklich fehlende -Netzwerk-/RMM-/Zeitsetter-/Fremddienstoperationen. SHA256 -`91c75ba877764345b3267731f3880580d02a72df40420479e3c4b76d37064982`. -Das beschreibt aufgerufene Operationen; ein SYSTEM-Prozess wird damit nicht zur -Sandbox. Unabhängiger Review und Native-Operator müssen diesen konkreten -Quellen-/Binärstand vor Zielaufruf prüfen. - -Sämtliche Rohbelege bleiben gitignoriert unter -`devstate/windows-signed-clock/raw-capture-qualification-6bcd72a7-6de7-48e6-9e9b-3ad2cd3d9b09/`. -**Nicht durch diesen Worker ausgeführt:** neuer Cloud-Linux-Guardlauf, -LocalService-/SYSTEM-Probe auf Windows, Kalibrierung, Zeitpins, signierter -Serveraustausch oder irgendein RMM-Job. Die vollständige Windows-/MVP-Abnahme -bleibt offen; nächster Schritt ist der getrennte Linux-first-/Windowsnachweis. - - -## Tatsächlicher Linux-first-Nachweis des Rohcapture-Quellenstands - -2026-11-15. Neuer unabhängig geprüfter Runner -`deploy/windows_raw_clock_linux_acceptance.py`, SHA256 -`fa0454839b263acc49285a76e468b908b23f3194f9c663d706f5cc01869bb6c4`, -bindet190Originalinputs und das neue Releasebinary. Vor einem einmaligen Lauf -muss die volle15er-Liste exakt stimmen; ausgeführt wird ausschließlich der -feste `signed_clock::tests::`-Filter. - -Originalfall `dcef489d-2a24-47cc-b3ca-6628545cdacf`: tatsächlich prepare, -ein execute und separater read auf der Cloud-Linux-VM. **5bestanden,0ignored, -10andere Tests gefiltert, Exit0**, Rückabruf vollständig. Bekannte RMM- -Prozessgenerationen, Kontrollbytes, Boot und DB-/Lock-Identitäten erhalten. -Keine RMM-Jobs, W32Time-/Produktzeitabfrage, Dienste oder Produktdateien geändert. - -FallmanifestSHA256 -`3a646b8bdab36ef0185c3a1f68d94bdd6ee541ad00d59c2e1fdebe35c3501549`; -ExecuteSHA256 -`1c53605e2db930f4e8328ff030726c4fecec9e10bbc24aa13284f90249962c36`; -ReadbackSHA256 -`91a750e4de266f5effccbd418a680c1ba4f5e0aff5082489fc021922bdfcafa3`. -Der ursprüngliche Dreierbeleg bleibt historisch unverändert. Keine aktuelle -Gesamtworkspace- oder Windows-Kernelqualifikation aus diesem Linuxlauf ableiten. - -Unabhängiger Quellenreview des d9dd843d-/23f7c8d8-Standes bestanden. Das -Erfassungsbudget250ms gilt ausdrücklich nur für die128Getteraufnahmen; -CIM-Bootlesung und eigener Dienst-/Imagebootstrap sind vorgelagert und brauchen -einen separaten Operatorwatchdog samt tatsächlichem Exitbeleg. Noch keine -Windowsausführung, physikalische Zeitkalibrierung oder Root-/SYSTEMjobfreigabe. diff --git a/docs/windows-signed-clock-evidence.md b/docs/windows-signed-clock-evidence.md deleted file mode 100644 index 418aac8..0000000 --- a/docs/windows-signed-clock-evidence.md +++ /dev/null @@ -1,190 +0,0 @@ -# Kurze prozessgebundene Evidenz für native Clockleser - -Dieser Schnitt erweitert ausschließlich den gemeinsamen Zeitcodec und den -noch nicht angebundenen Windowsadapter. Er aktiviert keinen Legacyclock, -Capability, Runtime-/Helper-IPC-Pfad oder Jobgate. Request, Payload, kanonische -Wirebytes und Signaturdomäne bleiben unverändert; das eingefrorene Serverpaket -des Quellencheckpoints `2dfd791` bleibt auf dem Draht kompatibel. - -`Verifier::finish_evidence` konsumiert genau die eigene Challenge und prüft -Nonce-/Kontext-/Keybindung und Signatur einmal. Erst danach erfolgt wie bisher -das eigene finale Capture. Zurück kommen ein opakes `VerifiedEvidence` und -das ursprüngliche sofortige `Interval`. Das bestehende `finish` delegiert -dorthin und liefert unverändert nur dieses Intervall. Evidence besitzt keine -öffentlichen Felder, keinen Konstruktor, Clone, Serialize/Deserialize oder -Timestampgetter. Sie hält private verifizierte Payloadfakten, ursprüngliche -Begin-/Receive-Samples sowie Verifier-ID, Epoche und Kontext; keine Signatur -oder Antwortbytes für spätere erneute Signaturprüfung. - -Jeder spätere `check_evidence` verlangt eine neue eigene native Beobachtung. -Ownership/Epoche/Kontext und Kontinuität werden erneut geprüft. Die gesamte -Zeit seit dem ursprünglichen Challengebeginn bleibt höchstens1s, seit dem -ursprünglichen eigenen Empfang höchstens100ms. Begin-/Receive-/aktuelles -Capturebudget zusammen höchstens50ms. Fehlerintervalle enthalten den gesamten -vergangenen Zeitraum und Capturebudgets, niemals RTT/2. Quellalter samt diesen -Zeiten bleibt höchstens1h; das gesamte neu errechnete UTC-Intervall muss -innerhalb2s der tatsächlich selbst beobachteten Wallclock liegen. Ein Read -erneuert keine Frist und ersetzt die Wallclock nicht durch einen Mittelpunkt. - -Eine neue offene Challenge verändert diese Evidenzepoche nicht. Deshalb kann -die vorherige Evidence während eines Refreshes bis zu ihren ursprünglichen -Fristen weiter verwendet werden. Ihr gewöhnlicher Ablauf darf die nächste -offene Nonce nicht konsumieren. Ein unabhängiger neuer erfolgreicher Vergleich -ersetzt sie; eine verspätete alte Antwort wird dadurch nicht erneut gültig. -Explizite Invalidierung, fremder Verifier, Diskontinuität oder wechselnder -geschützter Kontext sperren die alte Evidence. - -`SignedClock` hält die jüngste Evidence samt Prozess-Globalepoche ausschließlich -privat. `complete` bewahrt seinen ursprünglichen Callback und dessen eigenes -finales Sample/Initialintervall, versiegelt gleichzeitig die Evidence und -erteilt keine zweite Wirkung bei doppelter Antwort. Der neue -`with_current_comparison` liest nur den eigenen Prozess: Rolle/geschützte -gehaltene Dateien und Konfigurationshash, echte Clockgetter, Boot-/Globalepoche -und Connectionhead werden geprüft. Anschließend rechnet der eigene Verifier -das Intervall erneut aus. Nur im Callback sind tatsächlich selbst beobachtetes -UTC-W und frisches Intervall verfügbar. Kein Netzwerk-/Pipe-Rückruf aus diesem -Getter, kein Agentbericht als Helperzeit, kein exportierter Clockready-Boolean. -Fehlende Evidence oder normaler Ablauf sind kein Grund, einen laufenden neuen -Refresh abzubrechen; ein nativer Identitäts-/Kontextfehler schließt den Kontext. - -Die zwei neuen Codec-Guardsequenzen betreffen Originalfristen einschließlich -101ms nach Empfang und mehr als1s seit Beginn, alte Evidence bei gleichzeitig -offener nächster Challenge, erfolgreiche neue Evidence nach Ablauf der alten, -getrennte Evidence-/Antwortdaten sowie falschen Verifier, neue Epoche und -Diskontinuität. Der vorhandene Windows-Prozessfencetest prüft zusätzlich die -Evidenceepoche während einer offenen Challenge und nach Invalidierung. - -Lokale Build-/Testbelege dieses neuen Quellenstandes werden separat erfasst. -Die alten nativen Codec-/Windows-Guard-/Rohcapturebelege qualifizieren diesen -Deltaquellstand nicht nachträglich. Kein nativer Windowsvergleich, keine echte -Rollen-/Timerkalibrierung oder neue Serverqualität wird aus lokalen Tests -abgeleitet. Linux-first-Nachweis der neuen Guards, echte unabhängige Windows- -Rollenproofs und spätere Runtime-/Deadlineintegration bleiben eigene offene -MVP-Schritte. Geschützte Pins oder Baseerror werden hier nicht provisioniert. - -## Tatsächlicher lokaler Nachweis, 2026-11-15 - -Privater neuer Fall -`evidence-qualification-b245fc45-1f03-417d-9275-31f26a22451e`,190 eingefrorene -Inputs, Manifest-SHA256 -`60bab3aeaa3ff65f6046af73645c2bc6736ff946bb88d579622c24aa9ca4c6a5`. -Codecquelle SHA256 -`38009d0393c64d3c9b8db6154210e02cbf349d1a67b25ef2cc58c05f926b2346`, -Windowsmodul SHA256 -`3a0b5985884f74b9ef910af5586fc62ba4d4194ef82483e23d7c220501f478ee`. - -Tatsächlich ausschließlich lokal bestanden: - -- Linux-Release-Link beider Libtestexes; Codec vollständig6 Tests,6PASS, - einschließlich der4 bestehenden Completionregressionen und2 neuen Guards. -- Windows-Linuxlib vollständig15 Namen geprüft; ausschließlich geänderten - Prozessfencetest ausgeführt:1PASS,14 andere ausdrücklich gefiltert. -- Codec-Alltargets-Clippy und Windows-GNU-Alltargets-Clippy mit - `system-helper`, jeweils `-D warnings`, sowie Formatcheck beider Ownerdateien. - -Die Linuxcodec-Testexe hat1543576Bytes/SHA256 -`0eb40face421325822887b2104fe82bd4050621e9c792e1b1d5751547e77208b`; -die Windows-Linuxlib-Testexe4043056Bytes/SHA256 -`f5ee6564fff8abbc0e13eb043060e24bdaa474c6dbbddaffe5b2c3b911783cf4`. -Dies sind vorbereitete Linux-first-Artefakte. Keine native Cloud-Linux- -Ausführung, Windowsausführung oder Rollenqualifikation wurde durch diesen -Worker in diesem Schritt durchgeführt. Die zuvor eingefrorenen Runner und -der Serverquellenpack des Checkpoints2dfd791 bleiben bytegleich erhalten; -sie werden nicht nachträglich auf diesen neuen Quellenstand umgedeutet. - -## Nachtrag: beobachtete Kontextfehler fencen alle Objekte - -Der unabhängige Review fand einen konkreten Wiederherstellungsfall: Ein Fehler -von `begin` beim Nachprüfen geschützter Dateien gab zuvor lediglich `Err` -zurück. Nach kurzfristiger Wiederherstellung des alten Kontexts konnte alte -Evidence innerhalb ihrer Restfrist erneut verwendbar werden. Der zentrale -private `recheck` fencet jetzt bei jedem tatsächlich beobachteten Rollen-/Image-/ -Datei-/Konfigurationsfehler die eigene Evidence, Pendingnonce und den eigenen -Verifier sowie **unbedingt** die gemeinsame Prozess-Globalepoche. Dies gilt -auch ohne eigenen Pendingowner und somit für alte Evidence anderer Objekte. -`open`, `begin`, `complete` und `with_current_comparison` benutzen dieselbe -Prüfung. Gleichgenerationige Wiederherstellung löscht diesen Befund nicht; -erst ein frischer erfolgreicher Vergleich kann wieder neue Evidence liefern. - -Gewöhnlicher Evidenzablauf löscht weiterhin ausschließlich die alte Evidence -und bewahrt die nächste offene Refreshnonce. Normales `close`/Drop behält die -bisherige konditionale Besitzer-/Epochprüfung und fencet nicht blind eine -neuere andere Connection. Kein neuer Provisionszwang, kein Wire-/Codecwechsel. - -Neuer eigener190-Input-Fall -`context-fence-qualification-4d884851-d24b-42e6-82b2-956da3c6a980`, -Inputmanifest SHA256 -`4363d357c01803f381939de28d287eaf323f2701f5e7064bb479833ccc0c0475`, -Modul SHA256 -`7132b914de701a3ed5c35f265dbf7aa8bb4e0621dbc597eb3225165aa7231683`. -Der gemeinsame Codec bleibt bytegleich bei SHA38009d0393c64d3c9b8db6154210e02cbf349d1a67b25ef2cc58c05f926b2346; -die frühere6er-Codecprüfung wurde deshalb nicht unnötig wiederholt. - -Tatsächlich lokal: Release-Testbinary gelinkt, vollständige15er-Liste geprüft, -nur den geänderten Prozessfencetest ausgeführt:1PASS/14filtered. Die Statefolge -prüft jetzt ausdrücklich zwei alte Objekt-Epochen nach einem beobachteten -Kontextfehler ohne offene Nonce, deren Ablehnung nach SameGen-Restore sowie -eine neue zulässige Challenge. Windows-GNU-Alltargets-Clippy mit system-helper/ -`-D warnings` und Modulformatcheck PASS. Testexe4043200Bytes/SHA256 -`89f17cc6ae861f12adb251676b6b5deec664b41979e655dbab79ef1dac19e69d`. -Dies ist ein enger lokaler Delta-/Statemodellnachweis, kein nativer Windows- -Dateirestore- oder Rollenversuch. Alte Receipts/Artefakte bleiben unverändert; -ihre Dokumentfassung wurde als eigener historischer Beleg erhalten. Keine -Zielaktion, neue Clockbereitschaft oder Jobwirkung wurde aktiviert. - -## Nachtrag: Konstruktor erkennt Fork/Rollback ebenfalls prozessweit - -Der weitere unabhängige Review fand denselben Restorefall vor dem abschließenden -`recheck` eines neuen Objekts: `accept_configuration` verweigerte einen positiven -Rollback-/SameGenfork-Befund, ließ dabei aber alte Objekt-Epochen bestehen. -Jetzt invalidiert dieser konkrete Fehlerzweig die gemeinsame Epoche vor dem -Fehlerreturn und übernimmt ausdrücklich keinen neuen Konfigurationshead. -Wiederherstellung des bisherigen Heads heilt keine alte Evidence; eine frische -postErrorChallenge ist weiterhin möglich. Die vorherige zentrale Recheck- -Korrektur allein wurde deshalb nicht als vollständige Invariante übernommen. - -Neuer190-Input-Fall -`config-fence-qualification-304d0520-9882-4ed4-b9e0-634996c07dc6`, Manifest -`b0f317cb59aed20e2faa9cfeef38cc55fceb4bc00faac723bc9ab5bd8d60b87f`, -Modul SHA256 -`9cc43960531a7fbd9899f88eeda4400c04a87a756a188c062bc1865fafd5bc50`. -Einzige geänderte Compilerquelle gegenüber dem vorigen190er-Fall ist das -Windowsmodul; Codec/Wire bleiben bytegleich. Der bestehende Fencetest prüft -Rollback und Fork, Ablehnung alter Epochen auch nach Restore sowie den -unverändert gehaltenen echten Konfigurationshead. Lokal nach Release-Link und -vollständiger15er-Liste:1PASS/14filtered; GNU-Alltargets-Clippy mit system-helper/ -`-D warnings` und Formatcheck PASS. Testexe4046032Bytes/SHA256 -`b390ee90332671a68ab401e713691e3b4072db1ec83b2cff9a6e4dbbe524ec42`. -Der unabhängige enge Source-Re-review meldete für diesen Fehlerzweig PASS. -Keine native Windows-Restore-Abnahme, kein Gate-/Runtimeanschluss und keine -Zielaktion durch diesen Deltaquellstand. Alle bisherigen Fälle bleiben historisch. - -## Tatsächlicher Linux-first-Nachweis des finalen Kontextfences - -2026-11-15: Originalfall `1e179c84-041c-4c49-b730-3a688a495aec` auf -der Cloud-Linux-VM. Vollständige15er-Testliste geprüft; ausschließlich der -geänderte Prozessfencetest lief:1 bestanden,14 ausdrücklich gefiltert, -0 ignoriert. Separater Originalfall-Rückabruf vollständig; bekannte -RMM-Datei-/Prozess-/Dienstzeugen unverändert. Der Test prüft das native -Statemodell, keine Windows-Dateiwiederherstellung oder Windows-Kerneluhr. - -Operator `deploy/windows_context_fence_linux_acceptance.py`, SHA256 -`ec469733415f3cfe5804b507c4cb50911e6f2afdd93bc5bb19c6cbed1cedec4d`. -Originale lokale Qualificationreceipt -`f25dae5d8f9fea185a298014a087424c8b2207dfe15cfe86de38d0773fae9ef4`, -190-Inputmanifest -`b0f317cb59aed20e2faa9cfeef38cc55fceb4bc00faac723bc9ab5bd8d60b87f`. -Genau deren Testartefakt4046032Bytes wurde ausgeführt, SHA256 -`b390ee90332671a68ab401e713691e3b4072db1ec83b2cff9a6e4dbbe524ec42`. -Der Quellenreview bestätigte beide tatsächlichen Kontextfehlerpfade: zentralen -Recheck und Konstruktor-Fork/Rollback, jeweils prozessweite Invalidierung. -Die Codecquelle38009d bleibt bytegleich; ihre sechs Prüfungen liefen separat -im [nativen Codecfall44514778](signed-time-contract-results.md). - -Keine Windowszeitqualität, Calibration, Runtimeintegration oder Jobfreigabe -wird daraus abgeleitet. Eigene gestoppte Windows-Messfixture aus dem partiellen -Setup bleibt separat dokumentiert und wird nicht durch diesen Linuxlauf geheilt. - -Ausführungsreceipt-SHA256 `683935f353110da72178b0da703a33dcd87e48fa3f7a9bec2340a90ce9bcba3c`. - -Separater Rückabruf-SHA256 `0cb31b157ef4c0c55774280529bb27a634ffb945c875508d29896090ec144930`. diff --git a/docs/windows-signed-clock-runtime.md b/docs/windows-signed-clock-runtime.md deleted file mode 100644 index 53d3388..0000000 --- a/docs/windows-signed-clock-runtime.md +++ /dev/null @@ -1,62 +0,0 @@ -# Windows: signierter Zeitvergleich in Agent und SYSTEM-Helper - -Stand 2026-11-15: Quellcode implementiert und lokal geprüft, noch keine native Runtime-Abnahme oder Freischaltung auf der Windows-VM. Die bestehende Genehmigungsgrenze bleibt unverändert: Jeder Wartungsauftrag benötigt seinen persistenten Antrag und die interaktive WebUI-Genehmigung. - -Agent und SYSTEM-Helper besitzen jeweils einen eigenen `SignedClock` mit eigener Challenge, Nonce, geschütztem Kontext und kurzlebiger Evidenz. Zwei getrennte Transportpfade verwenden den wiederverwendeten mTLS-Client zur festen Route `/agent/v1/time-attestation` auf `discovery.ease-technologies.de`. Der Agent transportiert für den Helper ausschließlich dessen Anfrage und signierte Antwortbytes. Er liefert weder Zeitstempel noch einen Readiness-Schalter. Die feste zusätzliche Time-Pipe verwendet dieselbe installierte Peerprüfung; ihr eigener Worker kann keine Ledger- oder Joboperationen ausführen. Ein ausdrückliches `TimeClose` schließt den Helper bei Verbindungsende. Kann dessen Abschluss nicht bestätigt werden, wird das als unbestätigt protokolliert. - -Jede Zeitnutzung erfasst die eigene Windows-Uhr frisch und prüft dieselbe unabhängige Evidenz erneut. Es gelten weiter höchstens 1 s ab Challengebeginn und 100 ms ab nativem Empfang; Nutzung verlängert keine Frist. Agent und Helper prüfen für den Start sowohl ihre eigene Wandzeit als auch die obere Intervallgrenze strikt vor Ablauf der Sync-Lease. Der additive Core-Standard setzt die obere Grenze auf die eigene Wandzeit und erhält damit das bisherige Linux-Verhalten. Verbindungsgebundene Clock-Klone verhindern, dass alte Worker eine neue Verbindung als Zeitnachweis übernehmen. Ein erfolgreicher Skriptabschluss ohne abschließenden eigenen Zeitnachweis wird mit erhaltenen tatsächlichen Ausgaben `unknown`. - -Deklarative Fähigkeiten sind von momentaner Zeitbereitschaft getrennt. Fehlende Pins, Kalibrierung oder Quellqualität bleiben sperrend. Der alte Windows-RPC-Adapter wird nicht als Fallback qualifiziert; `ADAPTER_QUALIFIED` bleibt unverändert geschlossen. Diese Implementierung provisioniert keine Schlüssel, Pins oder Kalibrierung und schaltet keine VM-Gates frei. - -## Tatsächlich lokal geprüft - -Der unveränderliche Compilerfall `runtime-qualification-476c0212-4af9-42d2-92ca-1c488d158d21` hält 202 öffentliche Eingaben fest (Manifest-SHA256 `505008211630e2b7528cdf085a76309328626fe1e51540170eea293052e53272`). Offline-Docker, private Ausgaben, keine Credentials-Mounts und keine Netzwerkverbindung: - -- Linux-Release-Link der beiden betroffenen Core-Integrationsprogramme: PASS. -- Vier gezielte Guards: PASS. Zwei neue Gegenbeispiele verweigern Client-/SYSTEM-Leases bei oberer Grenze genau am Ablauf und danach; zwei bestehende Punktuhr-/Wiederanlaufsequenzen bleiben erfolgreich. Vollständige Listen: 27 beziehungsweise 31 Tests; ausgeführt wurden je zwei, nicht alle 58. -- Windows GNU `system-helper`: All-targets-Clippy mit `-D warnings` PASS. -- Windows GNU ohne Feature: All-targets-Check PASS; fehlende signierte Konfiguration bleibt geschlossen. -- Rustfmt für die zehn geänderten Quellen PASS. Core-All-targets-Clippy war im vorherigen Fall PASS; die einzige Eingabedifferenz zum finalen Fall ist der Windows-EventLog-Kindpfad und betrifft keine Core-Abhängigkeit. - -Ein anfänglicher unvollständiger 190-Eingaben-Snapshot scheiterte an zwei frisch aus Main übernommenen Core-Modulen. Dieser fehlgeschlagene Beleg bleibt erhalten; erst die vollständigen 202-Eingaben-Fälle lieferten die genannten Erfolge. Cross-Checks und lokale Guards ersetzen die vorgeschriebene tatsächliche Linux-VM-Ausführung und anschließende Windows-Runtime-Abnahme nicht. Ein Windows-Candidate-Link wurde in diesem Schritt noch nicht ausgeführt. - -## Konkret offen - -Die nächsten Abnahmen sind die vier Guards auf der Cloud-Linux-VM, der native Windows-Build/Pair-Upgrade und der unabhängige Agent-/Helper-Zeittransport gegen den tatsächlichen Server. Tatsächliche Server-Quellqualität, getrennte geschützte Zeitpins und die Beurteilung des absoluten nativen Zeitfehlers müssen separat nachgewiesen werden. Roh-Capture-Konsistenzmessungen allein sind keine physikalische Kalibrierung. - -Der strukturierte EventLog-Kindprozess besitzt noch keinen unabhängigen signierten Kindadapter. Er bleibt ausdrücklich deny-only (`EVENT_LOG_SIGNED_CHILD_CLOCK_NOT_CONFIGURED`) und wird nicht als Fähigkeit beworben. Dies ist eine konkrete offene Windows-Aufgabe, keine abgeschlossene Abnahme. Die ausdrücklich genehmigte PowerShell-Skriptkonsole soll währenddessen die gewünschte Wartung einschließlich `Get-WinEvent` abdecken; auch diese native Skript-/SYSTEM-Strecke bleibt bis zu ihren tatsächlichen Abnahmen offen. Windows ist damit noch nicht vollständig abgeschlossen. - -## Vorbereiteter Linux-first-Operator - -`deploy/windows_time_runtime_linux_acceptance.py` bindet beide exakten Release-ELFs und alle 202 Quellen an denselben lokalen Beleg. Erst nach vollständiger Prüfung beider Testlisten führt er die vier festen Einzeltests aus; die übrigen 112 Testauswahlen bleiben transparent gefiltert. Bestehende Linux-Agent-/Helper-Prozesse, deren Identität, geschützte Kontrolldateien und die Identität ihrer Zustandsdateien werden vorher und nachher verglichen. Rust-Fixtures erhalten ausschließlich das eigene Fall-TMPDIR. Der Operator führt keine Produktzeitabfrage, RMM-Jobs, Grantvergabe oder Dienststeuerung aus. - -Lokal wurden Python-AST, einmalige Vorbereitung und erneute Fall-/Hashprüfung tatsächlich geprüft: PASS. Der vorbereitete Fall ist `75a4ee16-1e58-4c37-a798-39d94c5bc9db`. **Geplant, nicht ausgeführt:** unabhängiger Operatorreview, einmalige Cloud-Linux-Ausführung und separater lesender Originalfall-Nachweis. Nach verlorener Antwort ist ausschließlich `read` desselben Falls erlaubt; keine erneute Ausführung. - -## Tatsächlich Linux-first: vier gezielte Cloud-VM-Guards - -2026-11-15: Originalfall75a4ee16-1e58-4c37-a798-39d94c5bc9db auf -der tatsächlichen Cloud-Linux-VM, beide vollständigen27-/31-Testlisten vor -dem ersten Test geprüft. Genau vier --exact-Ausführungen bestanden: -Client-upper-Deadlineguard, SYSTEM-Helper-upper-Deadlineguard sowie zwei -bestehende Linuxpoint-/Ready-/Reopenregressionen. Zusammen112 andere -Testnamen gefiltert, keine zusätzlichen Featuretests oder Skips. Alle -Rustfixtures liefen unter eigenem Fall-TMPDIR, keine Produktzeitabfrage, -RMM-Jobs, Grants oder Dienststeuerung. Bekannte Runtimezeugen unverändert. - -Separater vollständiger Originalfall-Readback bestanden. Runner-SHA256 -`39d49fa3494133aed5c2aed7edc860abb59896871026ef109d46fff1d8c46e2c`, -Manifestb465a3d1f6db0cc50a3aa2fa59b960a9e7b2d7b13616b8ec854e6ecc888ee44a; -202-Input-Quellenqualification8e219d37fef9f1495225b817a62418a4dab240442c0b08724954237e282d1c13. - -Ein unabhängiger Quellenreview bestätigte die eigene Nonce-/Generation-/ -Prozess-/Boot-/Pinbindung beider Rollen, strikte ownWall/upper-Leasegrenzen, -beidseitige Timepipe-Peerbindung, deny-only Close und geschlossene fehlende -Pin-/Quellqualitätspfade. Diese Quellen-/Vertragsnachweise ersetzen keine -native Windows-Runtime-/Serververgleichs-/Kalibrierungsabnahme. -Kein VM-Deployment, produktiver Zeitpin, Clockgate oder Windows-RMM-Job -wurde durch diesen Schritt aktiviert. Der strukturierte EventLog-Kindadapter -bleibt ausdrücklich offen und unbeworben; PowerShell-Skriptkonsole hat Vorrang. - -Native Ausführungsreceipt-SHA256 `3ad9e2bc7d0e8c3725b12c0de3e7cd041e09ed858252e5a523220b0ee98985df`. - -Separater Originalread-SHA256 `40b1f918838fb1a93789031c720bbd9112eb142c267cb04cc9259c0ab357e068`. diff --git a/docs/windows-signed-clock-source.md b/docs/windows-signed-clock-source.md deleted file mode 100644 index eba06c2..0000000 --- a/docs/windows-signed-clock-source.md +++ /dev/null @@ -1,214 +0,0 @@ -# Windows: unabhängiger signierter Zeitvergleich, erster Quellenschnitt - -Stand2026-11-14, Spezifikation1.22. Der User hat diese alternative Trustsource -ausdrücklich angenommen; [Vertrag](windows-clock-attestation-proposal.md). -Dieser Schnitt implementiert den unabhängigen Windows-Verifier. Er ersetzt -noch keinen laufenden Agent/Helper und öffnet keine Windows-Jobfähigkeit. - -`crates/agent-windows/src/signed_clock.rs` ist additiv registriert. Sein -installierter Adapter wird ausschließlich unter Windows mit dem vorhandenen -`system-helper`-Feature gebaut; die zwei plattformneutralen Guardtests laufen -auch unter Linux. Die bestehende RPC-Clock und `ADAPTER_QUALIFIED=false` bleiben -unverändert. Kein neuer `SyncClock`, Cache, Netzwerkclient oder Jobpfad. - -## Tatsächliche Bindung und enge API - -Agent und SYSTEM-Helper öffnen jeweils selbst die geschützte bestehende -Helperkonfiguration, prüfen ihre tatsächliche eigene SCM-Prozessgeneration, -Token-/Dienstrolle und gehaltene Imageidentität mit dem vorhandenen PeerProof. -Ein Agent kann die Helperrolle dadurch nicht nur im Request behaupten. -Die vorhandene feste lesende CIM-Bootabfrage läuft unabhängig in jedem Prozess -vor Beginn der Challenge. Ihre potenziell längere Laufzeit wird nicht aus einem -bereits laufenden Einsekundenbudget versteckt. - -Der zusätzliche feste öffentliche Pinpfad ist -`C:\ProgramData\RustDiscoverySystem\time-attestation.json`, maximal16KiB. -Seine Datei und das geschützte Elternverzeichnis werden mit bestehenden -PinnedFiles und restriktiven ACL-/File-ID-/Reparseprüfungen gehalten. -Alle ursprünglichen Helperkonfigurationshandles bleiben ebenfalls erhalten. -Der Pin bindet die exakte bestehende Gerätebindung, Serverinstanz, Zeitkey- -Generation, bis zu acht Publickeys und genau eine Kalibrierungsreferenz je -Agent-/Helperimage. Nur SYSTEM/Administrators schreiben; die beiden -Dienst-SIDs dürfen lesen. Keine Keys aus einer Serverantwort oder Workerdatei. - -Ein anschließender enger Sourcefix verweigert zusätzlich jeden Zeitpublickey, -der nach tatsächlicher Hexdekodierung dem vorhandenen Jobpublickey entspricht. -Abweichende Groß-/Kleinschreibung umgeht die Rollentrennung nicht. Eine neue -gezielte Negativprobe prüft diesen Fall. Dieser Fix ist noch nicht Teil des -unten erhaltenen180-Input-Belegs; seine neue kohärente Qualifikation folgt nach -dem neuen gemeinsamen Agentpfad-/Linuxnachweis im184-Input-Nachtrag unten. - -Die Kalibrierung muss die tatsächliche Binary per SHA256 und einen separat -gewonnenen Qualifikationsbeleg binden. Das positive Grundfehlerbudget liegt -höchstens10ms je Capture. Dies ist **keine gemessene Genauigkeit**: Aktuell -existiert aus diesem Schritt kein bereitgestellter Pin oder Kalibrierungsbeleg. -Ein solches JSON darf nicht mit geratenen Werten als qualifiziert installiert -werden. Der dauerhafte monotone Konfigurationsweg über Prozessneustarts bleibt -vor Runtimeaktivierung gesondert zu provisionieren. Der Loader selbst sperrt -innerhalb desselben Prozesses niedrigere Generationen und unterschiedliche -Rawbytes bei gleicher Generation; er erzeugt kein neues Floorjournal. - -Eine zufällige Prozessinkarnation sowie ein prozessweit gehaltener Continuity- -Head bleiben unabhängig von Objektkonstruktoren erhalten. Höchstens eine -Challenge ist pro Prozess offen. Bootwechsel, rückwärts laufende Zähler, -Wallstep oder Schlafdifferenz über1s verwerfen sie. Überlauf erschöpft den Head -dauerhaft; ein weiterer Aufruf öffnet ihn nicht wieder. Erst eine neu erzeugte -Challenge nach einer beobachteten Diskontinuität ist verwendbar. - -Im anschließenden Reviewfix hält derselbe globale Head auch die höchste -Verbindungsgeneration: Ein neues Adapterobjekt mit höherer Generation -invalidiert alte offene Challenges, alte Objekte können keine neue Anfrage -unter ihrer niedrigeren Generation eröffnen. Ein Generationwechsel am -vorhandenen `begin` schließt dessen eigene alte Anfrage. Die gezielte -Continuityprobe ergänzt diese Negativfälle; auch dieser Fix gehört zum -folgenden neuen Quellenbeleg, nicht zum ursprünglichen180-Input-Snapshot. - -Der native Capture umfasst präzise Interruptzeit, Unbiasedzeit, Wallclock, -nochmals Unbiasedzeit und Interruptzeit. Beide präzisen Interruptgetter sind -gemäß Microsoft **VOID**-APIs; kein fingierter BOOL-Erfolg und keine optionale -Fallbackquelle. Zeitwerte sind100ns-Einheiten. Der gesamte gemessene Bracket -wird zusätzlich zum ausdrücklich qualifizierten Grundfehler konservativ -berechnet. Auflösung wird nicht mit Genauigkeit gleichgesetzt. -[Präzise Unbiasedzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise), -[präzise Interruptzeit](https://learn.microsoft.com/en-us/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise). - -`begin` liefert ausschließlich den gebundenen Transportrequest und hält die -opaque Challenge selbst. `complete(bytes, callback)` nimmt nur begrenzte -Antwortbytes entgegen, keine fremden Zeiten. Der Adapter erfasst Empfang -selbst vor dem JSON-Decode und die Schlussmessung nach der vollständigen -Signaturprüfung. Der gemeinsame Codec prüft Signatur, Originalrequest und -Kontext, vollen RTT,100ms-Empfangsalter und die ganze UTCspanne. Am Ende müssen -auch prozessweiter Owner und Epoch noch identisch sein. - -Nur der unmittelbar aufgerufene Callback erhält eine geliehene Comparison mit -der geprüften Spanne und der tatsächlich selbst beobachteten Windows-Wallclock. -Keine gespeicherte Comparison, kein Midpoint als angebliche lokale Uhr, keine -automatische neue Challenge nach einem Fehler. Abschluss/Abbruch konsumiert die -ursprüngliche Anfrage. Runtimeintegration muss diese API an ihre tatsächlichen -Start-/Syncgrenzen binden; sie wird hier nicht durch einen scalar `now()`-Stub -vorgetäuscht. Die bestehenden zusätzlichen Job-/WebUI-/Ledgergates bleiben nötig. - -## Tatsächlich lokal geprüft - -Eingefrorener Sourcefall30bb330a-d285-4d15-ab8d-8ce36a760524,180 Inputs; -Inputmanifest SHA256 -`7f56d21680a1345f514ac98fd187a3bea376414215ba1d5773f682690a8ae214`. -Windowsmodul SHA256 -`f1fed304ebda3f48f38aba38f8ad5e1811c566abd740dffce318f4b07beac3ca`. -Receipt SHA256 -`ad5e35ac1c63f0cbc8e3559c338b183ca5793e7219543a9f43794cc75542402b`. -Der vollständige private Snapshot und Logs bleiben unter gitignoriertem -`devstate/windows-signed-clock/qualification-30bb330a-d285-4d15-ab8d-8ce36a760524/`. - -Tatsächlich bestanden, ausschließlich Offline-Docker auf dem Entwicklungsrechner: - -- Zwei gezielte Linux-Guardtests: Bracketbudget/Counterfehler sowie erhaltener - Prozessfence, Bootsubstitution, Generation/Fork und erschöpfter Epochcounter. - 2bestanden,0failed/ignored;10 übrige Cratetests ausdrücklich herausgefiltert. -- Windows-GNU-Alltargetscheck sowie Clippy mit `-D warnings` für den - `system-helper`-Build. Erster Clippylauf verweigerte drei verschachtelte - if-Blöcke; diese wurden ohne Unterdrückung korrigiert und erneut geprüft. -- Windows-Lib-Testbinary tatsächlich gelinkt,75326709Byte, SHA256 - `29c037f6ca13fc91806312a16dde0923fcaa1d5a0d16d057362bf112f3875da6`. - **Nicht auf Windows ausgeführt**, kein nativer Testcount daraus abgeleitet. -- Formatcheck ausschließlich der neuen Moduldatei bestanden. - -Die relevanten Cargoaufrufe benutzen `--locked --offline`; Linux-Testfilter -`signed_clock::tests`, Windows `--target x86_64-pc-windows-gnu --features -system-helper --all-targets`. Das Linken verwendet `test --lib --no-run`. -Der eingefrorene gemeinsame Codec enthält zu diesem Zeitpunkt noch die alte -`/api/agent/v1/time-attestation`-Audience. Der geplante korrekte Agentpfad -`/agent/v1/time-attestation` benötigt einen neuen gemeinsamen Quellenbeleg; -dieser ursprüngliche Snapshot wird dafür nicht verändert. - -## Offene reale Nachweise - -Keine Cloud-Linux-Ausführung dieser beiden neuen Guardtests und keine native -Windowsausführung in diesem Schritt. Keine tatsächliche Timerkalibrierung, -Pinprovisionierung, Serverantwort im echten Geräte-mTLS-Kontext oder parallele -Agent-/SYSTEM-Roundtrips. Keine Runtime-/IPC-/HTTP-Anbindung und keine Wirkung. -Der Servercodec besitzt eigene getrennte Nachweise; diese qualifizieren nicht -automatisch den Windowsadapter. Zuerst Linux-first, dann unabhängig auf dem -Windowsgast prüfen. Erst danach kann eine gesonderte WebUI-genehmigte -Windows-Skript-/SYSTEM-Abnahme folgen. W32Time-Konfiguration, Dienste, -Geräteidentitäten, PKI und Journale wurden durch diese lokale Arbeit nicht -angefasst. - -## Aktueller kohärenter Nachtrag nach URI- und Reviewfix - -Der neue separate Fall763baf69-10b1-4307-9c99-6942c0f8945f bindet184 Inputs -einschließlich des gemeinsamen Codecs mit der korrigierten Audience -`/agent/v1/time-attestation`. Der ursprüngliche180-Input-Snapshot bleibt -unverändert. Der unabhängige Source-Review von updater_review meldete für das -aktuelle Windowsmodul PASS; dies ist ausdrücklich kein nativer Rollennachweis. - -Aktuelles Modul SHA256 -`6b66612b7a53377c91bc8e41864ac8fb9393ad40b0a6a98aa6ce746fce091ddb`, -Inputmanifest SHA256 -`eb4609c5fca6a32ddb8ebf364775efdb59cd89f99a24b3b731212da08eac6a6e`, -Receipt SHA256 -`e013738caed2d8e02b98ffd1b41e47a80840c44d3dbf895e9a3952b4311ce927`. -Private Belege: -`devstate/windows-signed-clock/qualification-763baf69-10b1-4307-9c99-6942c0f8945f/`. - -Tatsächlich lokal auf den eingefrorenen Bytes bestanden: - -- Release-Linux-Testbinary gebaut und dessen vollständige Liste von13 Tests - und0 Benchmarks geprüft. Nur die drei neuen `signed_clock::tests` ausgeführt: - **3bestanden,0failed/ignored,10 übrige Tests ausdrücklich herausgefiltert**. - Hinzugekommen ist die konkrete Job-/Zeitkey-Rollentrennung auch bei anderer - Hexschreibweise; der Fencetest prüft nun auch den Connectionhead. -- Windows-GNU-Alltargetscheck und Alltargets-Clippy mit `-D warnings` bestanden. -- Windows-Lib-Testbinary aus genau denselben184 Inputs tatsächlich gelinkt. -- Formatcheck der neuen Moduldatei bestanden; keine Unterdrückungen ergänzt. - -Der erste Windows-Linkversuch dieses Falls scheiterte ausschließlich lokal am -Schreibschutz der früher qualifizierten Testexe im wiederverwendeten Target. -Der frühere Pfad und SHA29c037f6 blieben erhalten. Der unveränderte neue -Sourcesnapshot wurde danach in einem neuen eigenen Windowstarget erfolgreich -gelinkt; der ursprüngliche Fehlerbericht bleibt101 und wird nicht überschrieben. -Keine Lockerung des Readers oder der alten Artefaktrechte. - -Die qualifizierte neue Linuxexe hat3374576Byte, SHA256 -`0896a3098f493b67b48e774de5cfe9bca682d2a19ff10971c62c9c7b9681ec14`. -Der Native-Operator muss zunächst exakt die vollständige13er-Liste verlangen -und anschließend ausschließlich die drei neuen Namen auswählen; kein erneutes -Ausführen der zehn alten Fälle oder Verschweigen ihrer Filterung. Dies ist der -vorbereitete Linux-first-Nachweis, **hier durch diesen Worker nicht auf der -Cloud-VM ausgeführt**. - -Die neue Windows-Testexe hat75360791Byte, SHA256 -`3421368eff990d197889da58aa09463e00eff40e1cfebfcfdf1e9b9382e10f03`. -Sie wurde hier nicht auf Windows ausgeführt. Bauen, Linken und Source-Review -eröffnen weiterhin keine Capability. Sämtliche zuvor genannten tatsächlichen -Timer-, Rollen-, Provisionierungs-, Transport- und Runtimegates bleiben offen. - - -## Tatsächlicher Linux-first-Nachweis der drei Guards - -Root führte den unabhängig geprüften Runner -`deploy/windows_signed_clock_linux_acceptance.py`, SHA256 -`70b029a441d27814f646a75cfb69ff9e5af356776027a7f836a252964a29aafd`, -im Originalfall `6ea36dec-254e-4a82-8d1c-c72a1f959ed2` auf der Cloud-Linux-VM -aus: **3bestanden,0ignored,10andere Tests gefiltert, Exit0**. -Die vollständige13er-Liste musste zuvor exakt stimmen. Separater lesender -Originalfall-Readback vollständig; bekannte drei RMM-Prozessgenerationen, -Kontrollbytes, Boot und DB-/Lock-Dateiidentitäten erhalten. Kein RMM-Job, -Produktzeitquery oder Dienststeuerung; Full weiter Autostart disabled. - -Tatsächlich prepare, einmal execute und read mit obigem Originalfall ausgeführt. -FallmanifestSHA256 -`cc83d7bc455dfaa2e0c7b0305b5713452a74ad0b60730c6058132a761aa5f157`; -ExecuteSHA256 -`0a86c11133bce801c86d3af8bd7e1eadfeacdf49456f4ae17291e7281b8ade1f`; -ReadbackSHA256 -`81138562175bf71bc14c0f5cf9ddc37b434c8d7751196b12c90140db5c29e9f1`. -Private184Inputs und ursprüngliche Qualifikationsbelege bleiben unverändert. - -Der veröffentlichte erste Modulstand entspricht exakt6b66612b. Die -`lib.rs`-Modulregistrierung wurde danach ausschließlich alphabetisch gemäß -rustfmt geordnet; die ursprünglichen Compilerinputs werden dadurch nicht -nachträglich geändert. Kein erneuter Semantiktest für diese reine Formatierung. -Nachfolgende Rohcapture-/Runtimeänderungen sind eigene Quellenstände und -werden durch diesen nativen Dreierbeleg nicht mitqualifiziert. Native Windows- -Timer und tatsächliche Zeitquelle bleiben weiter offen; Legacyclock bleibt zu. diff --git a/docs/windows-signed-clock-upgrade-plan.md b/docs/windows-signed-clock-upgrade-plan.md deleted file mode 100644 index a609925..0000000 --- a/docs/windows-signed-clock-upgrade-plan.md +++ /dev/null @@ -1,461 +0,0 @@ -# Windows: geplanter erhaltender Zeit-Runtime-Paarupgrade - -Stand 2026-11-15. **Planbeleg, nicht auf der VM ausgeführt.** Der Quellcode bleibt auf dem geprüften 202-Eingaben-Snapshot `runtime-qualification-476c0212-4af9-42d2-92ca-1c488d158d21` eingefroren. Root hat dessen vier eng ausgewählte Core-Guards auf der tatsächlichen Cloud-Linux-VM bestanden; der getrennte lesende Abschluss wird von Root dokumentiert. Dies ist noch keine Windows-Runtime- oder Jobabnahme. - -## Tatsächlich gebauter Kandidat - -Neuer privater Buildfall `runtime-candidate-link-b3e51c10-1c19-4dc3-b534-fce0a2286324`, Receipt-SHA256 `3005379c01bbe71268a3b26d26f69131055cae4b8fd793e35f231e95099a1e8b`. Nur die beiden Produktbinärdateien wurden mit `system-helper` offline für `x86_64-pc-windows-gnu` im Releaseprofil gelinkt: Exit0. Alle 202 Quellinputs wurden vorher und nachher unverändert geprüft. Dockerimage `sha256:1b2fd985d2c1fcc3545ace602405dc68fa899201bd8a73fa319ff96377203fa9`, Quellen nur lesbar, kein Netzwerk und keine Credentials-Mounts. Keine weitere Testausführung oder Zielaktion. - -| Artefakt | Bytes | SHA256 | -| --- | ---: | --- | -| `rmm-agent-windows.exe` | 22244863 | `e7ba47304c686d58964c2a48dfa2a59a7e9e9b2622022579824ad3b04895a247` | -| `rmm-helper-windows.exe` | 13054732 | `e71be67185eb4bf6a3557c8e865d6a62d6859e41c26c28a758344eb4cad34e6d` | - -Die separaten Übergabedateien sind jeweils regulär, haben genau einen Hardlink und Modus0500; beide PE-Header weisen AMD64 aus. Buildlog-SHA256 `c29b83c3326d99ea5c1e5218fddbf428b74adc348cc698312cfdaaeda8baf886`. Cross-Link ist kein nativer Ausführungsnachweis. - -## Erhaltungsgrenze und Voraussetzungen - -Die erwartete bisherige VM-Generation ist Agent `f10c78dd738e7fb277e0c4d24fadf0f61ae3269458399b9224570ba5e66abc2c` und Helper `5f8c62fab6bc8ea1bbb009166b3d0e741c034c36690a4e32ea4e3cb2d7729a79`. Ihr erfolgreicher vorheriger Paarupgrade gehört zum unveränderten Originalfall `14fb176a-f653-4573-a8d7-6f9fe47a3020`; dessen Originalbelege und Main-Runtimeindizes bleiben erhalten. Ein neuer Upgradefall benötigt eine frische CAS-Prüfung dieser tatsächlichen Baseline und seiner eigenen unveränderlichen Kandidaten-/Planbytes. Ein abweichender Stand wird nicht überschrieben. - -Vor **jedem tatsächlichen Upgrade** sind die echte Root-Broker-/Provider-Quellqualität auf dem permanenten Server, die getrennte Zeit-Signaturrolle, der tatsächlich dort erzeugte öffentliche Zeitkey und der sichere mTLS-Routenpfad nachzuweisen. Private Signierschlüssel verbleiben ausschließlich geschützt auf dem Server. Der Zeitkey muss von dem vorhandenen Jobkey verschieden sein; weitere bekannte Rollenkeys werden bei der Provisionierungsprüfung ebenfalls getrennt gehalten. Fehlgeschlagene Chrony-/Quellqualitätsproben werden nicht als Qualität umgedeutet. Vor diesen Nachweisen wird dieser Kandidat nicht auf die Windows-VM installiert. - -Keine Neueinschreibung, keine neue PKI, kein Ersetzen oder Kopieren der produktiven DB-/Lockdateien. Bootidentität, Dienstkonten/Service-SIDs, Transport-/Tenantbindung und Enrollment-/Assignmentgeneration bleiben erhalten. Vorher/nachher: dieselben PKI-/DB-/Lock-Datei-IDs, ursprüngliche Historie und originale Intentleaves, vorhandene Journal-/ACK-Fortschritte, geschlossene Serverpolicies/Testflags und keine laufenden oder unklaren Wirkungsaufträge. Passive Fortschritte dürfen sich regulär erhöhen; deshalb keine unveränderlichen DB-Inhaltshashes behaupten. - -## Geplante Reihenfolge — noch nicht ausgeführt - -1. Root veröffentlicht den tatsächlichen separaten Linux-Lesebeleg und hält den unabhängigen Runtime-/Operatorreview sowie die beiden Kandidatenhashes fest. Separat liefert der Serverpfad echte Provider-/Broker-/Namespace-/mTLS-Qualitätsnachweise und ausschließlich den öffentlichen Zeitpin samt Serverinstanz und Generation. -2. Ein neuer create-only Wartungsfall bindet Originalbaseline, beide neuen EXEs und die neu erzeugten geschützten Dienst-/Peer-Pindateien. Keine Wiederverwendung des abgeschlossenen 14fb-Controllers als neuer Auftrag. Quelle, Operator, Pfadallowlist, Wirkungsumfang und Erhaltungswitnesses werden vor Zielausführung geprüft. Alte Mainindizes werden vorher weder umgeschrieben noch als neuer Stand ausgegeben. -3. Separater Kalibrierungsplan: Die bisherigen Roh-Captures von LocalService und SYSTEM belegen Konsistenz und begrenzte Erfassung, aber weder absolute physikalische Genauigkeit noch automatisch die Kalibrierung dieses Kandidaten. Eine begründete Plattform-/API-Fehlerbewertung muss einen positiven `base_error_ns` für beide Rollen rechtfertigen und ihren eigenen Qualifikationsbeleg an die exakten neuen Produktimages binden. Keine Ableitung allein aus beobachtetem Maximum, Timerauflösung oder einem frei gewählten JSON-Wert. Solange dieser Nachweis fehlt, bleibt die Zeitkonfiguration unprovisioniert und Zeitbereitschaft gesperrt. -4. Erst nach den Servervoraussetzungen: Root führt einen neuen erhaltenden Paarupgrade als eng begrenzte Bootstrapwartung aus. Beide vorhandenen Dienste bleiben während EXE-/Peer-Pin-Austausch gestoppt; originale Dateien und eigene Backups bleiben erhalten. Keine Paketinstallation, kein OS-Update und kein Reboot. Die SYSTEM-Startart bleibt Manual und der Agent LocalService/Auto. Ein unklarer Antwortverlust führt ausschließlich zum Lesen desselben Falles, ohne erneute Mutation oder automatische Rücksetzung. -5. Zunächst nativer Start mit geschlossenen Wirkungsgates und bei Bedarf fehlender Zeitkonfiguration: Helper öffnet den bestehenden Ledger/Lock, startet seinen eigenen Timeworker und hält `sync=None`; Agent meldet sich mit seiner erhaltenen mTLS-Identität an. Der erste passive Witness verwendet SCM-/Prozess-/Dateiidentitäten und die vorhandene authentifizierte `Probe`, nicht einen clockpflichtigen `Snapshot`. Fehlende Zeit liefert geschlossen/false, darf passive Heartbeats und gespeicherte Inventarübermittlung aber nicht verhindern. Dies ist ein eigener tatsächlicher Erhaltungsnachweis. -6. Root provisioniert die **neue eigene** Datei `C:\ProgramData\RustDiscoverySystem\time-attestation.json` nur aus den getrennt geprüften öffentlichen Zeitpins, exakter bestehender `Binding`, Serverinstanz und monotoner Schlüsselgeneration. Die Datei enthält genau zwei rollen-/imagegebundene Kalibrierungen und keine privaten Schlüssel. SYSTEM/Administrators behalten Schreibhoheit; die beiden installierten Service-SIDs erhalten nur die erforderlichen Leserechte nach dem vorhandenen `PinnedFile`-Vertrag. Vorhandene Konfiguration wird nicht still überschrieben; ihre Änderung ist ein eigener geprüfter Fall. -7. Die geschützte Agent-Opt-in-Konfiguration für den Runtimepfad wird nur in diesem expliziten Prüfprofil aktiviert; Serverpolicies und effektive Jobgrants bleiben geschlossen. Nach dem authentifizierten `ServerHello` startet der Agent beide unabhängigen Zeit-Refreshpfade. Helper-`TimeBegin` benötigt nur den bewiesenen installierten Agentpeer und eigenen geschützten Kontext, keine bereits bereite Sync-Lease oder vorherige Snapshotfreigabe. Agent und Helper erzeugen eigene Nonces, prüfen ihre Antworten selbst und messen bei jeder Nutzung frisch. Erst **danach** darf ein eigener frischer Helper-Snapshot dessen `HelperSync` erzeugen. Damit verlangt der Bootstrap keinen Zeitnachweis, für dessen Gewinnung er zuvor denselben Snapshot benötigen würde. -8. Native Transportabnahme: beide Rollen unabhängig, echte API-/Signatur-/Kontext-/Fristprüfung, mTLS-/Tenantbindung, Verbindungswechsel samt ausdrücklichem `TimeClose`, fehlende/abgelaufene Evidenz deny-only. Keine Callerzeitstempel, Zeitsetter, RPC-Fallbacks oder künstlichen Readyflags. Nicht bestätigter Helper-Close bleibt unbestätigt; alte Antworten und Worker dürfen eine neue Generation nicht öffnen. -9. Erst nach eindeutigem passivem Abschluss und separatem lesendem Witness veröffentlicht Root neue Runtime-/Komponentenindizes per CAS mit erhaltenen Vorgängern. Neue Skript-/SYSTEM-Wirkungsabnahmen folgen als eigene persistente Anträge mit unveränderlichen Plänen und ausschließlich interaktiver WebUI-Genehmigung. Kein Bootstrapaufruf ersetzt einen RMM-Auftrag oder eine Freigabe. - -Jeder Teilbeleg bleibt getrennt: Quellcode, Cross-Link, native Installation, passiver Erhalt, Zeitqualifikation und genehmigte Wirkung sind unterschiedliche Aussagen. Die genaue Kalibrierungsbewertung, tatsächliche Windows-Zeit-Runtime-/Skript-/SYSTEM-Abnahme und der unabhängige strukturierte EventLog-Kindadapter sind weiterhin offen. Windows und der gesamte MVP sind dadurch noch nicht abgeschlossen. - -## Nachtrag: neue Frischefix-Generation und passiver Controller - -Dieser Abschnitt ergänzt den ursprünglichen Plan append-only. Sein vorheriger Text (SHA256 `434a166a07f8fdf4a7792b37ce976bb804e8e6902fa8fb2dc00e81d5d69356db`) und das damalige Paar `e7ba…`/`e71b…` bleiben als ursprüngliche Planversion erhalten. Das neue Releasepaar enthält zusätzlich den konservativen Frischefix aus [time-attestation-freshness-results.md](time-attestation-freshness-results.md): Agent `751657ee873c4f4d013abc4ea6daaa4641fea2fe55838fb1c701e6a71b57c192`, Helper `acf1e3f3b1609a97e0d5e88a43a421bed530a09a236bfc0dec1b1abbb22d4413`, Buildreceipt `2abf7fe56633e68864469de2ff9ded21888301bdc737e53211d024cfd044e22e`. Weder der frühere Kandidat noch der abgeschlossene14fb-Fall werden umgedeutet oder erneut ausgeführt. - -`deploy/windows/signed_clock_pair_upgrade.py` bereitet ausschließlich lokal einen neuen Controller und neue geschlossene gegenseitige Peerpins vor. Ausgangspunkt sind exakt die beiden Mainindizes `e49231e7…`/`005317e6…`, der Original14fb-Resultat-/Intentbeleg und die dort bereits qualifizierten unveränderten read-only Journalwitnesses. Nur die beiden Imagehashes in den öffentlichen Helper-/Agent-Pins wechseln. Agentkonfiguration bleibt das ursprüngliche passive Profil mit sechs Feldern ohne Jobopt-in; Helperwirkungen, Reboot und erlaubte Dienste bleiben geschlossen. Die Zeitpindatei muss fehlen; sie wird weder erzeugt noch adoptiert. Kein neuer `base_error_ns`, keine Kalibrierung, kein Zeitsetter und kein RMM-Auftrag. - -Der neue PowerShellcontroller hat eigenen Namen, Payloadtyp, Klassen- und Fallnamespace. Die bereits geprüften Kernelprozess-/Datei-ID-/DB-/Lock-/PKI-Witnesses und die sichtbare Reihenfolge bleiben erhalten: beide ursprünglichen Prozesse anhand gehaltener Kernelhandles stoppen; vier Originalbackups vollständig sichern; beide EXEs und beide Peer-Pindateien per frischem Datei-ID-/Hash-/ACL-CAS mit expliziten nativen Originalbackups wechseln, während beide Dienste gestoppt sind; anschließend Helper und Agent jeweils genau einmal starten. Keine automatische Rücknahme oder wiederholten Starts. Ein Verlust der Antwort erlaubt ausschließlich Originalfall-Readback/Finish. Mainindizes werden durch diesen Controller nie publiziert. - -Die erste passive Nachbeobachtung verwendet die vorhandenen lesenden Zustandswitnesses und die vom tatsächlichen LocalService-Agenten erzeugte authentifizierte `Probe`, keinen clockpflichtigen Helper-`Snapshot`. Der neue Helper darf mit `sync=None` und eigenem Timeworker starten; bei fehlenden Pins bleiben Jobs gesperrt. Die native Wirkung dieser konkreten Generation ist damit noch nicht bewiesen. - -**Die Ausführung ist ausdrücklich noch gesperrt.** Ein endgültiger tatsächlicher Serverqualitäts-/Broker-/öffentlicher Zeitkey-/mTLS-Routenbeleg ist diesem Entwurf noch nicht gebunden. Im erzeugten PS verweigert `enter` deshalb fest mit `SERVER_TIME_QUALIFICATION_NOT_BOUND`. Weder eine Callerboolean noch eine lokale Datei kann diesen Schalter öffnen. Erst ein konkret vorliegender, unveränderlicher Beleg und eine separat überprüfte neue Sourcegeneration dürfen diese enge Bindung ergänzen. Ein späterer dünner Root-Operator muss auch aktuelle geschlossene Servergates und die frisch einzeln geprüfte VM-Baseline vor jeder Wirkung binden. Die hier verfügbare CLI bietet ausschließlich lokale `guards`/`prepare`, keine SSH-/Stage-/Zielaktion. - -Tatsächlicher aktueller Vorbereitungsfall: `b24d5e88-a863-4a61-a595-74ae8955a20b`, Manifest `856d23fd1bb88df6a9f1935e13759394178c2412ccc6a87eaf6b0877411d5866`. Generator `bea5384c26b9a1a8a9a8f25207d0b9e0f70245e43282158067f07eb6fe87f09f`; PS `d5e6ff2b01919a2b2c7964a21f3099b2ccd319e646290ece3ff799f576d0ec13` (38288Bytes). Neue geschlossene Helperpolicy `68dac44172fedbda2589d54eb675e88207ed61c8c23280afd59b4ebd3daeb45c`, Agentpeerpin `d435de30c78a9c0694f8edb6aec5b244dcd2d18a907499bc2ac896604b4723fe`. Python-AST, enge Quellen-Scopeguards und lokale Vorbereitung PASS. Eine Klassenbenennung im ersten rein lokalen Entwurf wurde vor jedem Zielaufruf korrigiert; der erste Entwurf bleibt als unqualifizierter Vorbereitungsfall erhalten. - -**Geplant, nicht ausgeführt:** unabhängiger Controllerreview, tatsächlicher Windows-PowerShell-AST-/C#-Compile-only-Nachweis, endgültige Servergatebindung, neuer einmaliger Root-Operator, frische native Baseline und der eigentliche erhaltende Paarupgrade samt separatem Lesebeleg. Keine VM-Datei, Dienstkonfiguration, PKI, DB-/Lockdatei oder Mainindex wurde in diesem Vorbereitungsabschnitt geändert. - -## Nachtrag: P1-Aktionsgrenze vor jeder Wirkung korrigiert - -Der unabhängige Source-Review fand vor irgendeiner nativen Ausführung einen konkreten P1-Fehler im Entwurf `bea5384c…`/Fall `b24d5e88…`: Die geerbte PowerShell-Aktionswhitelist war case-insensitive (`-notin`), die Branches und frühe `enter`-Sperre aber case-sensitive. Dadurch konnte etwa `ENTER` die frühe Sperre umgehen und bis zur impliziten Wirkstrecke durchfallen. Die vorherige pauschale Aussage, dieser alte Entwurf sei für alle Eingaben sicher gesperrt, war deshalb falsch. Dieser Entwurf bleibt unverändert historisch erhalten und darf nicht ausgeführt werden; keine VM-Aktion wurde daraus vorgenommen. - -Die neue Generation prüft zuerst eine tatsächliche Stringaktion mit strikt case-sensitiver Whitelist (`-cnotin`). Zusätzlich stehen unmittelbar vor dem gesamten Wirkungs-Fallback nochmals die Forderung exakt `enter` und eine **unbedingte** feste Serversperre. Die ursprüngliche frühe exakte `enter`-Sperre bleibt als zusätzliche Grenze bestehen. Es gibt keine Callerboolean, Configdatei oder unbekannte Aktion, die diesen noch fehlenden tatsächlichen Serverqualifikationsbeleg ersetzt. Die gültigen lesenden Branches kehren vor der Wirkstrecke zurück. Zeitprofilentscheidung und Kalibrierung bleiben weiterhin ausstehend; keine Änderung an Runtime oder Kandidatenpaar. - -Neuer Generator-SHA256 `77fb42fa98b05f5e73412404f4c777583ff6581fdbe0385e2f4bd7de494c5cf6`; neuer lokaler Fall `ff52778d-f297-4546-859f-62351bdd92cc`, Manifest `178d7c71a47a21a893f07f2cd1cd4473a626966f99675fca3e5ce79a2749d461`. PS-SHA256 `eef6c1b75a3eb871df5526442de76a933059541e3c7d42a3731fb5eb45ec05e7`. Python-AST, lokale Source-Scopeguards und neuer create-only Prepare PASS. Vierzehn reine Sourcefixtures prüfen `enter`/`ENTER`/`Enter`/gemischte Schreibweise, unbekannte/leere/nichtstringförmige Aktionen sowie die exakten und abweichend geschriebenen Readbranches; keine Sourcefixture erreicht den Wirkungszweig. Receipt `6226fddc16ff9c0692a656d53af94b3ed8d24096b9cfbec4820292f7dbd0533c`. - -Zusätzlich liegt ein enger PowerShell-Fixtureblock vor (SHA256 `1ab3014522777aef8bce18a9f276410d2fb9df8047801356c1a515d4ec140204`): nur die tatsächlich extrahierten Aktionsguards, feste lesende Branch-Stubs und erwartete Eingabevarianten, ohne SCM-/Datei-/Netzwerk-/Nativeaufrufe. **Nicht ausgeführt:** dieser native Guardblock sowie vollständiger PS-AST-/C#-Compile-only-Nachweis und unabhängiger Fixreview. Die lokalen Sourcefixtures sind ausdrücklich kein Ersatz dafür. Keine Zielaktion, Gitaktion oder Änderung an alten Fällen, Mainindizes, Zeitpins oder Kalibrierungen. - -## Tatsächlich native Prüfung des korrigierten passiven Controllers - -Originalfall `pair-native-source-check-5ee9f545-e818-4e25-a842-710f8d2e6d36` -auf der Windows-VM: Controller-AST0Fehler und extrahiertes C# tatsächlich unter -PowerShell5.1.26100.9818 kompiliert, keine Controllerfunktion ausgeführt. -14 reine Aktionsfixtures einschließlich enter/ENTER/Enter/unbekannter Typen und -aller Lesezweige bestanden; diese Fixtures rufen keine Native-/SCM-/Datei-/ -Netzwerkfunktion auf. Unabhängiger Quellenreview des korrigierten77fb-Generators -bestätigt den geschlossenen Wirkungspfad. Der frühere bea-Entwurf bleibt als -fehlgeschlagener Quellenstand erhalten und wurde nicht ausgeführt. - -Compile-Result-SHA256 -`040dbb6d2d1108c7ded16427eb379e6dde251ae61212a71db187764015e67c45`, -Fixture-Result-SHA256 -`af28c390e64b56e91b961e23ec8e21e0f2b65ab2c945c3ed72fb1531fc2508f6`, -verknüpfter Receipt -`c3cdd90dd180ff9dd82ee8fd3ff9e060ab4216919455ee803a9e3d8f2478359b`. -Separate Vorher-/Nachherzeugen bestätigen alle sechs nativen RMM-Bereiche, -Journalidentität/-Schema/-Corecounts bei monotoner passiver Sequenz und -identische geschlossene Serverzeugen. Kein Service gestoppt, keine EXE, -Peerpolicy oder Zeitkonfiguration ersetzt, keine RMM-Wirkung. - -Die Kandidaten751657ee/acf1e3f3 gehören zum Frischefix. Der anschließend -ausdrücklich angenommene Zeitmodus aus Spezifikation1.23 ist noch in Umsetzung; -er benötigt neue Produktartefakte und eigene Nachweise. Der vorbereitete -Controller wird nicht allein aufgrund dieser AST-/Fixtureprüfungen aktiviert. - -## Nachtrag: neues aktives Profilpaar, weiterhin geschlossenes ENTER - -Nach der ausdrücklichen Userentscheidung für das begrenzte aktive OS-Zeitprofil wurde das Produktpaar erneut gelinkt: Agent `26dc9d2f6928c5a41050ac9324e041c065e7a9ae52324416f3bb6222c002ae6b`, Helper `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e`, unveränderlicher Buildreceipt `04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d` und Qualifikationsbeleg `96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d`. Die früheren Plan-/Kandidatengenerationen bleiben erhalten. - -Der korrigierte P1-Aktionsvertrag wurde für genau diese neue Kandidatengeneration beibehalten. Neuer Generator `bbdd0ef4649c97e0fe48e11d3eb8ccdaf7a7e78f9f5614720249ec5fcf8f44af`, lokaler Vorbereitungsfall `2dc20d01-d19e-4d7c-bce9-44f8904f2620`, Manifest `a8f2a39e3a64a0df56ebc45ccab85c7499e63ced44d9f6b17c34bb6a3b6fa904`, PS `ca7478fb61ca46f2c47952a818ea93b43ea522e29b36cbefc4bc15f460286796`. Änderungen gegenüber dem P1-fixierten77fb-Schnitt: nur neue Kandidaten-/Belegpfade und Hashbindungen sowie der tatsächliche Feldname im neuen Linkreceipt. Neue geschlossene Helperpolicy `aed124bfd6eaf84e10f9dfa1da4d403826331a6d3a64ff8182cfead35067cc8a`, Agentpeerpin `27c38c6b7e1985174018a009de5708f5171f585dcab74500a4f4d333f4d8aa76`. - -Python-AST, dieselben Sourceguards und lokale create-only Vorbereitung PASS; keine Zielaktion oder neue native Controllerqualifikation. Beide festen Serversperren und die strikt typisierte/case-sensitive Aktionsgrenze bleiben erhalten. **ENTER bleibt geschlossen**, bis tatsächliches Gateway-/Brokerdeployment und der noch folgende native mTLS-Zeitroutebeleg konkret gebunden und unabhängig geprüft sind. Die [neue feste Routefixture](windows-time-route-fixture.md) ist ausschließlich für diesen passiven200/403/409-Endpunktnachweis vor dem Upgrade gebaut; sie erzeugt keine Dienstrollen-/Clock-/SyncReady-/Jobfreigabe und noch keine V2-Zeitkonfiguration. - -## Native Vorbereitungsprüfung des aktuellen Profilpaarcontrollers - -Der bestehende Controller für26dc/5967 (ca7478fb61ca46f2c47952a818ea93b43ea522e29b36cbefc4bc15f460286796) -wurde nach ausdrücklicher Rootdelegation auf Windows ausschließlich im Speicher -geparst und seine genau eine feste C#-HereStringdefinition kompiliert. -PowerShell5.1.26100.9818, AST0, C#compile-onlytrue, Controller nicht ausgeführt. -Keine Stage-, Stop-, Start-, Swap-, Konfigurations- oder Jobaktion. Original14fb- -Lesewitnesses vor/nach bewiesen dieselben sechs stabilen nativen Felder, -Journalidentität und monotone Sequenz. Fall3962b83b-c194-4318-8925-83e86c840b7f unter -`devstate/windows-time-route-native-readonly/`, Receipt -69d221997f247c2c291f0c7c079a79f2bae2c943628032835e49955af1ef7289. -Das ersetzt nicht die noch fehlende Quellenbindung des tatsächlichen positiven -Zeitroutebelegs vor der weiterhin gesperrten Enterphase. - -## Tatsächliche Route bestanden, Paarwechsel noch nicht ausgeführt - -Die passive HTTP-Abnahme68b841a5… ist einschließlich separatem Read tatsächlich -bestanden (200/signature/context,403,409, Exit0). Der bestehende Paarcontroller -bindet nun direkt die geschützten tatsächlichen Report-/Exit-/Kontext-/Probe-/ -öffentlichen Pin-Dateien dieser VM; der alte Harddeny-Entwurf bleibt historisch. -Die strikte Aktionsgrenze steht weiterhin vor jeder Wirkung. Jobflags/Policies -bleiben geschlossen, keine Zeitkonfiguration wird als Teil dieses Austauschs -erstellt oder übernommen. - -Stagingversuch0406dd40-c3c4-464b-8cc6-c9b98365d12a: neues Helperimage5967… -tatsächlich vollständig im separaten Bootstraphashpfad vorhanden. Der vorhandene -kleine lesende Agent-Staging-Prepareaufruf antwortete nach180s nicht. Noch kein -Agentupload und kein Controllerinvoke mit Enter, kein ServiceStop/Start/Swap. -Dieselbe sporadische SSH-/Commandantwortstörung betrifft damit auch eine kleine -Vorbereitung und ist nicht allein dem alten Upgrade-finish-Reader zuzuordnen. -Der konkrete Ursprung dieser sporadischen Transportstörung ist noch offen. - -Eine danach begrenzte20s-Statusablesung antwortete tatsächlich: ursprünglicher -Agent `RmmDiscoveryWindows` weiterhinRunning5528 mit unverändertem Servicepfad, -ursprünglicher SYSTEM-Helper weiterhinRunning9464, neuer Agentbootstrapfile -absent, neuer Helperbootstrapfile13143052Bytes vorhanden. Tatsächliche VM-UTC -12:59:46, Kontoablauf13:05:58UTC. Der sichere Gesamtpuffer war unterschritten; -daher wurde bewusst keine erste Dienständerung begonnen. Beide ursprünglichen -laufenden Komponenten sind erhalten. Belege unter dem ursprünglichen0406-Fall: -`stage-agent-preflight-timeout.json`, `final-no-stop-status.json`. - -Für das nächste ausdrücklich autorisierte Zeitfenster wurde die alte feste -Ablaufzeit aus der Generatorquelle entfernt. Prepare liest ausschließlich -`expires_at` aus der aktuellen geschützten lokalen Zugangskonfiguration und -verlangt mindestens420s Gesamtbudget vor Vorbereitung. Der konkrete Wert wird -unveränderlich im neuen Payload/Manifest gebunden. Auf der VM muss er vor Wirkung -mit **beiden** vorhandenen tatsächlichen Ablaufzeiten übereinstimmen: Konto -`rmm-dev` und geschützt gelesenes `bootstrap-public.json`. Vor erster Wirkung und -Agentstop420s; vor dem anschließenden Helperstop300s Restbudget, damit gewöhnlicher -Zeitablauf nicht denselben hohen Grenzwert erneut unterschreitet. Unmittelbare -Service-/Kernel-CAS bleiben auf beiden Stops. Dieser Code ändert Konto, Tunnel, -Schlüssel oder deren Konfiguration nicht und schafft kein neues Zugangsfenster. - -Pythoncompile und vorhandene Quellguards bestanden. Kein neuer Preparefall mit -dem abgelaufenen knappen Fenster, keine weitere Zielaktion nach dem kleinen -abschließenden Statusread. Quellenbindung/neue Baseline und tatsächlich einmalige -Paarwartung samt Readback bleiben für das nächste bestätigte Fenster offen. - -Nach Ablauf des SSH-Wartungsfensters meldete das gespeicherte MCP-Inventar -den Windowsgast weiterhin als `online`. Der Agent hatte den permanenten Server -am 15. November 2026 um 14:06:34 MEZ kontaktiert. Die Daten wurden ausschließlich -über `inventory.get_device` gelesen. Beleg -`003f000e16e53ce3ff8799694e7138e014689e741f69be6577519c616aee6bab`. - -## Neues bestätigtes Fenster: Staging und Baseline tatsächlich bestanden - -Nach erneuter ausdrücklicher Freigabe, tatsächlicher Konsolenbestätigung beider -ursprünglichen Dienst-PIDs und Konto-/Konfigurationsablauf15:30UTC entstand der -neue Fall5c627d08-aff0-42a1-a922-dcf7eebccb15. Der alte0406-Stagingversuch bleibt -unverändert als unvollständiger Versuch ohne Dienständerung erhalten. - -Tatsächlich native Stagingprüfung bestanden: Helper5967… (bereits eigener -Bootstraphashpfad), Agent26dc… und fester Controller -`d808f47b5de8563e7e32d49dc5a0ad83c988c7de12cc286f1814b3a69e7e27a6`. -Danach vollständige native Baseline ohne Timeout: Config-/PKI-/Datei-/ACLbindung -und tatsächlicher Helper-DB-/Lock-/Intentzustand stimmen mit dem angenommenen -ursprünglichen14fb-Beleg überein. AgentRunning5528, HelperRunning9464. -BaselineSHA `cc876073b87086021ba449748deebff8309e06977438bb1854565f5d58cbba88`. -Geschlossene Serverflags und Job-/Outbox-/Permitzähler unverändert. -Bis zu diesem Beleg kein ServiceStop/Start/Swap, kein Job, kein Zeitprofil. -Die anschließende einmalige Enterphase ist ein gesonderter noch offener Schritt. - -## Erste Enterphase vor jeder Wirkung verweigert; Ursache nachgewiesen - -Im Fall5c627d08… wurde Enter genau einmal aufgerufen und mit -`Preserved identity config or ACL` verweigert. Kein erneuter Enteraufruf. -Die feste unabhängige Originalfallnachlese bestätigt: Fallordner absent, -active-intent absent, sämtliche Intent-/Stop-/Swap-/Startmarker absent; -ursprüngliche Dienste weiterhinRunning5528/9464. Es gab keine Dienständerung. -Der erste Versuch bleibt fehlgeschlagen und wird nicht nachträglich geheilt. - -Eine frische vollständige native Baseline bestätigte alle betroffenen Werte -semantisch exakt identisch. Der konkrete Fehler lag im bisherigen PS-`JsonEqual`: -Er verglich JSON-Texte einschließlich Objektmemberreihenfolge. Die Python- -kanonisch sortierte gespeicherte Baseline und die native PS-Ordered-Ausgabe -ordnen `public_hashes`, `identity_acls` und `private_key_metadata` anders an. -Das war ein falscher Unterschied trotz unveränderter Werte, kein ACLwechsel. - -Der enge Quellfix normalisiert nur Objektmember für den Inhaltsvergleich; -Arrayreihenfolge sowie Null gegenüber leeren Arrays bleiben unterschieden, -Tiefe bleibt auf40 begrenzt. Tatsächlich fünf native In-Memory-Gegenfälle -bestanden: umgeordnetes Objekt akzeptiert, Scalaränderung, umgekehrtes Array, -Null gegenüber leerem Array und Null-Element gegenüber leerem Array verweigert. -Keine Dienste, Produktdateien oder Jobs wurden vom Guard verändert. Unabhängiger -Quellenreview läuft getrennt; noch keine neue mutierende Controllerausführung. - -Inzwischen behebt Main656102b die passive Zeitprüfung ohne Jobopt-in. Weil das -ursprüngliche Paar nachweislich noch unmutiert ist, wird26dc nicht mehr installiert: -Root qualifiziert zuerst das notwendige neue Agentimage; Helper5967 bleibt -unverändert. Danach neue feste Image-/Controllerbindung und neue Baseline vor -**einem** tatsächlichen Paarwechsel. Der fehlgeschlagene5c-Versuch wird dabei -weder wiederholt noch als Erfolg ausgegeben. - -## JsonEqual-Korrektur eng geprüft und nativ belegt - -Der unabhängige Quellenreview fand im ersten Normalisierer einen zusätzlichen -Randfehler: ein case-sensitives IDictionary mit `A` und `a` hätte beim Kopieren -in eine case-insensitive OrderedDictionary einen Wert verlieren können. Beide -Objektzweige verweigern nun vor dem Einfügen Nichtstringkeys oder bereits -vorhandene kollidierende Namen. Bestehende feste Native-State-DTOs erzeugen -solche Kollisionen nicht; der zusätzliche Pfad ist trotzdem geschlossen. - -Unabhängiger enger Re-review der Quelle -`4ef8c6787fd3defdd8416401b3b40dd63be0e3afffc195736eed0ce350286201` -ohne weiteren konkreten Befund. Nativ anschließend sechs feste In-Memory-Guards -bestanden: ursprüngliche fünf Fälle plus case-kollidierendes -`Dictionary(StringComparer.Ordinal)` wird verweigert. ResultSHA -`2429b869792854ac799c403422e26561df2b2c5310b408e6a7287751129c2a94` -im erhaltenen5c-Fall, `comparison-collision-guard-result.json`. -Pythoncompile und bestehende Quellguards ebenfalls PASS. Kein Service-/Datei-/ -Jobeffekt und weiterhin keine26dc-Installation. Der folgende Agentkandidat wird -separat durch Root qualifiziert; Controller-/Payloadbindung und neuer echter -Baselinebeleg werden erst mit dessen endgültigem Artefakt erzeugt. - -## Ein Austausch mit passiver Zeitprüfung - -Nach der Verweigerung vor dem ersten Dienststopp wurde der ursprüngliche -202-Dateien-Quellstand erneut gegen sein Manifest geprüft. Nur drei Quellen -haben sich für den Installationskandidaten geändert: Zeitabfrage im Agenten, -Auswahl des Abfrageintervalls und Schreiben der zwei historischen -Dienstbelege. Die Änderungen kommen aus den Commits `656102b` und `cc82124`. -Das Manifest dieser 202 Inputs hat den SHA-256-Wert -`11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4`. -Der isolierte Offline-Releasebuild für AMD64 ergab das Agentbild -`0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c`. -Für den Helper wird das bereits qualifizierte Image `59675a3c…` verwendet. -Der Agent-Zwischenbuild `34b7458d…` wurde nicht installiert. - -Die neun gezielten Zeitprüfungen aus diesem konkreten Quellstand bestanden auf -der Cloud-Linux-VM als UID 65534, Exit 0. SHA-256 der Ergebnisquittung -`333f8d2dba3b35dcd79faafd8faf5c88da321942c9672c0a80f1f2c8fceb24a3`. - -Anschließend bestanden die gleichen neun Tests auf der Windows-VM aus dem -separat gebauten AMD64-Librarytestbinary desselben Release-Quellstands, Exit 0. -Die Ergebnisquittung hat SHA-256 -`7700096145afdca74e7473e56c6dd2e65651252e889a696f84bb1fc2441ff513`. -Nach erneutem Abgleich aller 202 Quelldateien, des PE-Headers und des Helperhashs -wurde das Buildreceipt -`f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446` -für den einmaligen Dienstwechsel erstellt. Der Windows-Testprozess hat weder -einen Dienst ausgetauscht noch einen Agentjob ausgeführt. - -Der exakt gebaute Quellstand für das neue Agentbild liegt in Gitea auf -`codex/windows-passive-time-candidate`, Commit -`c6c4037d072a96d62136264066d0257782c7a932`. Alle 202 Build-Inputs wurden -byteweise mit dem Release-Manifest abgeglichen. Der Ausgangsstand der -ursprünglichen Qualifikation entspricht für dieselben 202 Dateien -`b8ca8266bbb3b4806f4d20a3039f25196638804e`. - -## Endgültiger passiver Agent und erneute Transportverweigerung - -Root qualifizierte für genau den beobachtbaren passiven Stand cc82124 den -Agent0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c. -Tatsächliche Linux9-/Windows9-Guards und Release-Link sind im Receipt -f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446 gebunden, -Sourceinputs11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4. -Helper5967… bleibt aus dem ursprünglichen04ed-Produktreceipt unverändert. -Der Generator bindet diese beiden getrennten tatsächlichen Artefaktquellen, -keinen nochmals eingebauten26dc-Agenten. Der öffentliche neue lokale Receipt -war zunächst0664; nur sein Modus wurde auf0600 gehärtet, Bytes/SHA unverändert. - -Neuer unveränderlicher Fall570c7a86-6509-49e6-b95e-8f0df74b18bf, -Controller67d2fb1f9fdfec05b08f53a37be9a7df4cc3bb39f6cde8f950a226286474fd45, -bindet das bestätigte15:30UTC-Fenster. Sein allererster kleiner Stage-Read wurde -jedoch bereits beim SSHtransport verweigert: return255, stdout0, stderr89Bytes. -Ein einzelner begrenzter Statusversuch klassifizierte CONNECTION_TIMEOUT, -keinen Authentifizierungs-/Hostkeyfehler. Kein neuer Agenttransfer, kein Enter, -keine Dienständerung oder Wiederholung unklarer Wirkung durch diesen Fall. - -Root belegte danach Notebook-System-Suspend13:48:24–14:39:01UTC und einen nicht -mehr antwortenden alten Forwardingkanal. Damals existierte weiterhin keine -V2-Konfiguration/Zeitauthorität; beide ursprünglichen Produktdienste waren passiv. -Root beendete ausschließlich den separat kernelgebundenen alten Bastionforwarder -und forderte kontrolliertes Neuöffnen desselben Fensters an. Dieser Wartungsagent -änderte weder Tunnel, Konto, Schlüssel noch SSHkonfiguration. Seit Roots Sperre -keine weiteren VM-Aufrufe bis bestätigtem Transportreadback. - -Abschließender lokaler Check: Pythoncompile, bestehende Quellguards, exakte -saved-controller-/Generatorbytes, neues Agentimage, unverändertes Helperimage, -Source-/Native-Receipt und geschützte15:30-Payloadbindung PASS. Beleg -74ca4c2572872eb64cecc250aefd4bbffa5d8e4dc9b3729b5b83c19ac07a670f, -`final-local-check.json` im570c-Fall. Neue native Baseline, tatsächlicher -Paarwechsel und unabhängige Nachlese bleiben offen. Es wird kein Windowsabschluss -oder funktionierender installierter Zeitvergleich behauptet. - -## Transport wieder bestätigt: endgültiger570c-Stand nativ bereit - -Nach Roots tatsächlichem Konsolen-/Transportreadback15:04:25UTC wurde ausschließlich -der vorhandene570c-Fall fortgesetzt, unverändertes Ende15:30UTC. Tatsächliche -Stagebestätigung für Helper5967…, endgültigen Agent0549… und Controller67d2… -bestanden. Volle neue native Baseline bestätigt ursprüngliche Running-PIDs5528/9464, -unveränderte config/PKI/ACLs und vollständigen bisherigen Helper-DB-/Lock-/Intent- -zustand. BaselineSHA -b1a7928f89ad2bb9c63720dedea6f343d644c9882052877b5144dc200537f5e7. -Geschlossene Serverflags und Windows0-/Linux31/31/27-Zähler unverändert. -Noch keine Dienständerung bis zu diesem Baselinebeleg. Nächster Schritt ist die -genau einmalige, an diese neuen tatsächlichen Bytes gebundene Enterphase. - -## ETS-Skalartypfehler vor erster Wirkung behoben - -Die einmalige570c-Enterphase verweigerte `Original SCM invariant`. Die reine -Nachlese zeigt erneut eigenen Ordner/active-intent und alle Stopmarker absent; -Originaldienste laufen5528/9464. Keine Enterwiederholung und keine Dienstwirkung. -Isolierter Vergleich aller sechs SCM-Felder inklusive CLR-/Basistyp und Wrapping -belegt ausschließlich `sid_type`: Baseline und live beide System.Int32=1, aber -der ETS-wrapped Registrywert erfüllt zusätzlich `-is[pscustomobject]` und wurde -irrtümlich zu `{}` normalisiert. Die anderen fünf Felder stimmten exakt überein. - -Der Vergleich rekonstruiert jetzt JSON-Skalare aus ihrem CLR-Basiswert vor dem -Objektpfad (primitive Strings/Bool/Integer/finite Double/Decimal), ohne ETS-Notes -als fachlichen Objektinhalt umzudeuten. Echte JSON-Objekte behalten alle Keys; -Casekollisionen/Arrayreihenfolge/Null/Tiefengrenze bleiben geschützt. Unabhängiger -enger Review der Quelle90c2708c… ohne weiteren konkreten Befund. - -Tatsächlich anschließend auf derselben VM: vollständiges originales -`SameOriginal` gegen gespeicherte Baseline und frischen LiveState bestanden. -Zusätzlich native ETS-Add-Member-Fälle für Integer/String/Bool gleich, -Scalaränderung/Arrayumkehr/Null gegenüber leerem Array weiterhin verweigert. -Result82c4ebe75bff95005ebd946ae99e206ec69648bec93adb17cf683c46fc46212a, -`typed-full-pre-effect-comparison.json` im570c-Fall. Weiterhin keine Ordner/active- -Marker und keine Dienständerung. Neuer Controllerfall folgt getrennt;570c bleibt -als fehlgeschlagene Vorwirkungsphase erhalten. - -## Neuer typkorrigierter Fall4887 nativ bereit - -Fall4887940a-4c9c-4807-aaf2-6fbc94faad46 bindet unverändert Agent0549/Helper5967, -denselben echten Quell-/Linux9-/Windows9-Beleg und das unveränderte15:30-Fenster. -Controller66ca45e15e8f790c4614db74dd491137d5e28104e2d28ee658cc287debcd021f. -Alle festen Stagebytes erneut nativ bestätigt; volle frische Baseline einschließlich -ursprünglicher PIDs5528/9464, config/PKI/ACLs und Helper-DB/Lock/Intents bestanden. -Baseline00bf31bd5355dc77e0aadd73d2ab57ea32410956ef764f3f2aeb195bd218479e. -Geschlossene Servergates unverändert, bis hier weiterhin kein Serviceeffekt. -4887 besitzt noch keinen Enterversuch;570c bleibt getrennt vor Wirkung verweigert. - -Nach dem tatsächlichen Dienstwechsel bestätigten SCM und MCP zunächst beide -laufenden Dienste und die bisherige Geräteidentität. Der letzte Kontakt blieb -dann bei 16:17:32 Uhr MEZ stehen. Um 16:21:38 Uhr authentifizierte der Agent -sich weiterhin erfolgreich. Die drei serverseitigen Sperren für Restore, -Sequenzregression und Sync-Recovery waren alle aus. Der neue Agent meldet -`agent.update/1` und sendet eine passive `not_configured`-Beobachtung. Auf -dem Server ließ der CHECK von `observations.source_id` ausschließlich -`linux.base` und `windows.base` zu. PostgreSQL protokollierte seit dem Wechsel -15 Verletzungen genau dieses CHECKs. Der erste Online-Status war damit kein -Nachweis für fortlaufende Heartbeats. - -Die Geräteansicht selektiert im geänderten API-Quellstand gezielt den neuesten -Basisdatensatz. Die aus dem Produktcode extrahierte LATERAL-Abfrage lieferte in -einer lesenden PostgreSQL-Prüfung auf dem Server die erwarteten Windows- und -Linux-Werte sowie NULL für ein Gerät mit ausschließlich Updatebeobachtungen. -Auch Mandant und Seitenstichtag wurden im Datensatz gegengeprüft. - -## Tatsächlicher einmaliger Paarwechsel, Abschluss nur lesend wiedergewonnen - -4887 führte den tatsächlichen Paarwechsel genau einmal aus: beide ursprünglichen -Prozesse kontrolliert beendet, vier Originaldateien gesichert, Agent/Helper und -reziproke geschlossene Settings/Pins vollständig ersetzt, danach Helper und Agent -jeweils einmal gestartet. Neue tatsächlich laufende Kernel-/Serviceinstanzen: -Agent0549… PID4420, Helper5967… PID10264. Der ursprüngliche Enteraufruf meldete -allerdings beim abschließenden Schemaerhaltungscheck einen Fehler; er wurde -**nicht** erneut aufgerufen. Originalmarker belegen alle vier Replacements und -beide tatsächlichen Starts; `entered.json` wurde wegen des Nachprüfungsfehlers -nicht geschrieben. Der erste Postcheck bleibt fehlgeschlagen. - -Der exakte Nachbefund: Telemetriedatei-ID, Creation und Geräteidentitätshash sind -identisch. Alle bisherigen Schemaeinträge/Trigger sind bytegleich erhalten; -ausschließlich `update_health_inventory` wurde additiv angelegt. Deren komplette -DDL entspricht der tatsächlich qualifizierten eingefrorenen Quelle -`agent-core/src/update_health_inventory.rs` (Sourceinputs11717fab…). Dies ist -keine globale Lockerung des Schemaerhalts: der Abschlussleser verlangt exakt -einen zusätzlichen Eintrag, exakt diesen Typ/Namen/DDL und unveränderte übrige -Einträge. Die neue Tabelle wurde nicht auf Zeileninhalt abgefragt; es wird keine -solche Prüfung behauptet. Bestehende Job-/Reconcilezähler bleiben vollständig0, -Serverjob-/Outbox-/Permitgates ebenfalls unverändert geschlossen. - -Eine erste reine Abschlusslesung verweigerte fälschlich wegen PowerShell- -Pipelineflattening der Schema-Tupel; nach Beschränkung auf explizite Listen -bestand derselbe ausschließlich lesende Originalfallvergleich. Keine weitere -Service-/Datei-/Jobmutation war Teil dieser Recovery. Der Reader prüft zusätzlich -Originalintent/active-Bindung, vollständigen Config-/PKI-/Privatekeymetadaten-/ -DB-/Lock-/Helperrowerhalt sowie exakte beiden gespeicherten einzelnen neuen -Service-/Kernelstarts. Native tatsächliche Zeitquelle/Clockfreigabe wird dadurch -nicht behauptet. - -Anschließend unabhängiger zweiter Originalfallread: dieselben neuen Prozesse, -Images und Dateiidentitäten, sämtliche Erhaltungsbedingungen erneut bestanden. -Belege im4887-Fall: - -- `completion-readback.json`:13448d833b32dedfb5e07cb4e76f046e666522488ffabbb3a38a57d2d485d1b8 -- `independent-readback.json`:63e453fb915cadee028407a6aeaa8c7d209ae88ed12a6d4d4307d4fd25e4c539 -- `intent.json`:40e9cd557225504429b51dcecd4322b32d7f0973bcbb8e2a2e52516917907b85 -- `bound-payload.json`:074a13fd3e4cdefd85aedb5a9fc17d247994e0e515b71e4e0925f713d37774f7 -- `result.json`:2898a72b4b0d84159cc11d80765cbfa4206faf7038d0e860429c8b1a57538ee2 - -Das Resultat kennzeichnet ausdrücklich `recovered_postcondition_read=true` und -`original_enter_postcheck_failed=true`. Es meldet keine erfundene erfolgreiche -ursprüngliche Enterantwort. Kein Jobmodus, Effektgate, VM-Reboot, Enrollment, -Gerätezertifikatswechsel oder Zeitprofil wurde durch diese Wartung aktiviert. - -Getrennt offen: Parent bestätigte einmaligen korrekten neuen Hello/Identität und -unverändertes Gerätezertifikat/Enrollment/Assignment, jedoch noch keine zwei -fortlaufenden Heartbeats; gespeicherte Präsenz wurde später stale. Die zusätzliche -Capability `agent.update/1` stammt aus dem konkret installierten passiven -not_configured-Schema. Heartbeatkontinuität und installierte Clockautorität -bleiben im Resultat ausdrücklich **nicht bewiesen**. Windows-MVP damit nicht -vollständig abgenommen. Wichtige spätere Werkzeugverbesserung: erwartete additive -Schemaentwicklung vor Wartung aus dem qualifizierten Quellstand planen; hierfür -jetzt keinen allgemeinen Migrations-/Resumeframework bauen. - -## Serverkorrektur für die passive Telemetrie am 15. November 2026 - -Nach SQLx-Migration 16 wurde um 16:39:24 Uhr MEZ ausschließlich der -API-Container auf dem permanenten Server neu gestartet. Sein ARM64-Image -`6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7` -enthält die Änderung an der Basisinventarabfrage und die Migration. -Gateway und PostgreSQL behielten Container-ID und Startzeit. - -Der erste Nachvergleich schlug beim direkten Listenvergleich der -Containerkonfiguration fehl. Eine separate lesende Prüfung verglich die Mounts -nach Zielpfad. Docker lieferte sie in anderer Reihenfolge. Quelle, Ziel, -Modus und übrige Mountattribute stimmten vollständig mit dem vorherigen -Container überein. API-Umgebung und Startkonfiguration entsprachen Compose -und Image. Verifiziert wurden zudem die Loopback-Bindung, UID/GID 10001, -Read-only-Rootfs, CapDrop ALL und no-new-privileges. Es gab genau einen -API-Wechsel. Die weitere Prüfung erfolgte am laufenden Container. - -### Erneute Abnahme über MCP - -Zwei getrennte, nach Beginn der Prüfung eingegangene Kontakte des Windows-11- -Agenten wurden am 15. November um 16:39:46 und 16:40:17 Uhr MEZ aus -`inventory.get_device` gelesen. Beide hatten Präsenz `online`, dasselbe -Gerät, dieselbe Agent-ID, Zuordnung, Enrollmentgeneration und dasselbe -authentifizierte Zertifikat wie vor dem Paarwechsel. Der Agent meldet -`heartbeat/1`, `windows.base/1` und `agent.update/1`. -Beleg-SHA-256 `837c7580b9e7cd68de09533f50d91622272c2f2bc288da70d8b4624d2f6a747e`. - -Die MCP-Geräteansicht lieferte das gespeicherte Windows-Basisinventar mit fünf -Bereichen und für die Cloud-Linux-VM den Datensatz `linux.base`. Das -Windows-Basisinventar stammte von 16:16:59 Uhr MEZ. Die Kontaktzeiten wurden -unabhängig davon aktualisiert. PostgreSQL speicherte die separaten -Updatemeldungen des Windowsagenten um 16:38:43, 16:39:45 und 16:40:50 Uhr MEZ. -Der zuletzt gelesene Updatezustand war `not_configured`. Die Windows-Jobtabelle -enthielt für dieses Gerät null Aufträge. Die Prüfung las gespeicherte -Telemetrie über den permanenten Server nach Ablauf des SSH-Fensters. diff --git a/docs/windows-sync-alignment-205-implementation.md b/docs/windows-sync-alignment-205-implementation.md deleted file mode 100644 index 4fd169d..0000000 --- a/docs/windows-sync-alignment-205-implementation.md +++ /dev/null @@ -1,207 +0,0 @@ -# Administrativer Kontrollabschluss für Verbindung 205 - -Stand 16. November 2026. Grundlage ist die ausdrückliche Userentscheidung in -Spezifikation 1.28 und der [konkrete Fall](windows-sync-alignment-205-proposal.md). -Dieser Text dokumentiert Quellen und lokale Prüfungen. Eine native Anwendung -oder tatsächliche WebUI-Bestätigung wird damit nicht behauptet. - -Der neue Domainvertrag `windows_sync_alignment` bindet ausschließlich den -bekannten Tenant, Asset, Agent, Boot und Verbindung 205: Agententscheidung -`2af359c5-5b5c-4992-b445-1c00e271a288`, Helperentscheidung -`1a4758ad-0b39-449e-8551-16846851b09a`, Agentcheckpoint 10137. Der tatsächliche -Helpercapturecheckpoint muss mindestens 148 sein und wird im Zeugen exakt -gebunden; er darf bei der Anwendung nicht auf den historischen Applycheckpoint -135 zurückgesetzt werden. Beide ursprünglichen Requests und signierten -Antworten bleiben als vollständige Originalbytes erhalten. - -Der streng typisierte native Zeuge enthält außerdem beide Journalidentitäten, -sechs konkrete Datei-/Lockrollen mit unabhängig gemessenen Windowsdatei-IDs und -Hashes, beide geschützten Bindings und den öffentlichen Verifikationskey, -drei kanonische vollständige Inventarhashes sowie feste Zähler. Er enthält die -ursprünglichen Echo-Offer-/Start-/Outcome-/Resultbytes, die signierte vorhandene -Echo-Abschlussquittung und das abgelaufene Offer ohne Grant. Der Zeuge ist keine -OS-Fernattestierung: der Server prüft seine gespeicherten Originale; der native -Operator muss Dateien, Datenbankinhalte, Locks, geschützte Bindings und alle -Inventare selbst erneut prüfen. Keine Schlüsselbytes gehören in den Zeugen. - -## WebUI und Server - -Der nur im expliziten Entwicklungsprofil registrierte Pfad ist -`/api/v1/tenants/{tenant}/windows-sync-alignment`: - -- `POST` reicht einen unabhängigen Zeugen ein und prüft ihn gegen die - Serverhistorie. Dies erzeugt ausschließlich einen unveränderlichen - administrativen Prüfantrag. -- `GET` liest den gespeicherten Antrag samt letzter Quittung. -- `/{request}/confirm` erfordert eine tatsächliche CSRF-geschützte - Browsersitzung des sichtbar simulierten Testprincipals. Die aktuelle aktive - Testhuman-Mitgliedschaft mit `plans:approve` bleibt bis zum Commit gesperrt. - MCP-/Automation-Scopes oder eine fehlende Sitzung verweigern die Bestätigung. -- `/{request}/receipt` liefert ausschließlich eine gültige signierte - administrative Quittung für exakt diesen Zeugen. - -Die separate Geräteansicht zeigt den vollständigen Zeugen und seinen -kanonischen Hash vor der ausdrücklichen Checkbox-/Buttonbestätigung. Jede -Quittung gilt höchstens fünf Minuten. Ein weiterer tatsächlicher Bestätigungsklick -kann eine neue befristete Quittung für denselben unveränderten Zeugen anfügen; -kein automatischer Refresh und keine Ersetzung alter Quittungen. Jede Quittung -und ihr Audit tragen `dev_test_browser_simulation`, den Testprincipal und -`testsimulation=true`. `ready`, `helper_ready` und `unlock` sind immer falsch. - -Der Server hält dieselbe Kontrollsperre wie der reguläre Abgleich und prüft -aktuelle Identität/Boot/Verbindung sowie den gespeicherten zweiten Head. Beide -ursprünglichen Entscheidungen werden kryptografisch gegen denselben aktuellen -gepinnten Job-Verifikationskey, ihre exakten gespeicherten Bytes und die -kanonisch dekodierten ursprünglichen Proto-Requests geprüft. Ausstellungszeit -wird nur für die **historische** Profilprüfung verwendet; es erfolgt kein -normaler Apply einer abgelaufenen Lease. - -Genau zwei vorhandene Jobs müssen zu den bekannten abgeschlossenen Versuchen -gehören: der erfolgreiche Echoauftrag mit genau einer ursprünglichen -signierten Startfreigabe und die abgelaufene Anfrage ohne Grant. Serverjobbytes -und Angebote müssen mit den unveränderlichen damals genehmigten Planbytes -übereinstimmen. Echo-Consumption/Start/Outcome werden mit der vorhandenen -signierten Abschlussquittung und dem gespeicherten Serverergebnis verbunden. -Ein weiterer Job/Grant, ein anderes Outcome oder abweichende Originale verweigern -diesen Weg. Der noch offene neue Skriptplan wird hierdurch weder genehmigt noch -verlängert. - -Migration 0020 fügt ausschließlich zwei neue Tabellen hinzu: unveränderliche -Prüfanträge und angefügte Quittungen. Beide verwenden erzwungene Tenant-RLS; -der Anwendungsrolle werden nur SELECT und INSERT erteilt. Immutable-Trigger -verweigern UPDATE/DELETE; der Quittungstrigger bindet Nutzlast, gespeicherten -Zeugen, fünfminütige Frist und alle drei falschen Bereitschaftswerte. Keine -alte Tabelle, Jobgenehmigung, Outbox oder reguläre Abgleichentscheidung wird -über diesen Pfad verändert. - -## Tatsächlich lokal geprüft - -- Domain und Server: `cargo clippy --locked --offline -p rmm-server -p - rmm-domain --all-targets -- -D warnings` erfolgreich im vorhandenen isolierten - Linuxbuilder, ohne Netzwerk und mit lesendem Source-Mount. -- Zwei Domainprüfungen bestanden: andere Vorfälle/Verbräuche/veraltete Captures - werden verweigert; Quittungen können keine Bereitschaft oder echte menschliche - Genehmigung behaupten und überschreiten ihre feste Fünfminutengrenze nicht. - Der Codecfixture ist ausdrücklich kein kryptografischer Nativenachweis. -- Ein Servertest bestand: Bestätigung erfordert die echte Browsersitzungsform; - fehlende CSRF/Sitzung, Automationsscopes und unpassender Principalstatus werden - verweigert. -- Web-Typecheck sowie zwei gezielte UItests (neuer Fall 205 und bestehender - Echoabschluss) bestanden. Der neue Test verweigert veränderte Geschichte, - erhöhte Wirkungszähler, andere Verbindung, Bereitschaft, unsichtbar behauptete - menschliche Genehmigung und verlängerte Quittungen. -- In einem separaten lokalen PostgreSQL-16-Container ohne Netzwerk oder - veröffentlichten Port wurden alle 20 Migrationen erfolgreich angewandt. - Beide neuen Tabellen haben erzwungene RLS, die App nur SELECT/INSERT und - die erwarteten drei Unveränderlichkeits-/Validierungstrigger. Danach standen - null Jobs und null ausgestellte Quittungen. Der Testcontainer wurde entfernt. - Beleg: `devstate/windows-sync-alignment-local/a54b4e41-4e95-48e7-84de-f6a9ecd6588c`. - -Noch separat nachzuweisen sind der unabhängig erzeugte native Originalzeuge, -seine tatsächliche serverseitige Prüfung, die echte simulierte WebUI-Interaktion, -die einmalige geschlossene native Anwendung bei gestoppten Diensten und -gehaltenen ursprünglichen Locks sowie der anschließende neue reguläre Abgleich -beider Rollen. Diese lokalen Prüfungen ersetzen keinen dieser Schritte. - -## Tatsächlicher nativer ARM64-Build, weiterhin ohne Bereitstellung - -Ein neuer öffentlicher Quellsatz samt gebauter WebUI wurde anschließend unter -`devstate/server-build-only/a48f78614e2e` eingefroren. Er enthält 398 öffentliche -Compiler-/Test-/Frontenddateien. Die 205-Domain-/Serverquellen und Migration 0020 -sind mit ihren oben geprüften Bytes enthalten. Mitkopierte Windowsquellen -stellen keinen Windows-Abnahmenachweis dar; spätere Windowsänderungen verändern -diesen bereits eingefrorenen Serverbuild nicht. - -Der Build lief tatsächlich auf dem ARM64-Server ausschließlich unter -`/opt/rust-discovery/devstate/server205-a48f78614e2e`. `docker build` verwendete -`--network=none --pull=false` und den zuvor unabhängig aus Docker-Metadaten als -ARM64/Linux bestätigten vorhandenen Builder -`sha256:30ae3d90753bc39b0a98a897784c662aff9598ffab7a98a6298e8aa79145c2ec`. -Dort bestanden Server und Zeitbroker `cargo clippy --locked --offline ---all-targets -- -D warnings`; beide Releaseprogramme wurden erfolgreich gebaut. -Die Programme wurden aus dem Image extrahiert, als tatsächliche AArch64-ELFs -geprüft und mit den im Image gemessenen Hashes verglichen. - -| Gegenstand | Tatsächlicher SHA-256 | -|---|---| -| Quellen-/Webmanifest | `7594ab8eda6cd3e75852ed03ed7033da32e8997898dce05b1b7584f8c14c12ff` | -| Übertragenes Paketarchiv | `10110359967db1cca67b879a6620f196f5449e187f8cf24d687867baeefaaf38` | -| Image `rust-discovery-server:server205-a48f78614e2e` | `a7fc4243fee414ab6c85c5f4d207b6428005b77ab06903916138a83b4b74e1d4` | -| `rmm-server`, 27.061.568 Byte | `ef88115eb0184af83738f90fd4c9fd1e96d50eda128bc959909a623c47396559` | -| `rmm-time-broker-linux`, 1.072.816 Byte | `da8e6644b221f012322ce26f8a58c0ad4e7e8980d0648f5037d6ea99d8be599a` | -| Nativer Buildbeleg | `a00c38fe68d01928167fbb0116c5e904aed29e89fa8d920ac89e833d2d8275f5` | -| Nativer vollständiger Buildlog | `1c5e3ab12a4c734d93d5c0dbd658bb1b0bf3fcb226a3ca0009dc7b7ea7b6c085` | - -Die Rohprogramme liegen auf dem Server unmittelbar im genannten Fallverzeichnis; -Quellen und Webartefakte unter `package/`. Öffentliche Originalbelege und Logs -sind zusätzlich lokal als `native-build.receipt.json`, `native-build.log` und -`native-build-worker.py` erhalten. Der Controller ist -`deploy/server_build_only.py`. Er führt weder Compose noch SQL aus und startet -kein Anwendungsprogramm. Nur `sha256sum` lief kurz in einem abgeschotteten -Artefaktcontainer. Die tatsächlichen API-, Gateway- und PostgreSQL-Container -hatten vor und nach dem Build dieselben IDs, Images, Startzeiten und -Restartzähler; `runtime_unchanged=true` ist separat gespeichert. Kein Brokerpfad, -Pin, Dienst, Mount oder Loopbackvertrag wurde geändert. Das neue Image und die -WebUI sind damit **gebaut, noch nicht durch diesen Schritt bereitgestellt**. - -Der vorangegangene erhaltene Fall `server205-68a4e912fe1c` endete mit Exit 101: -Der erste Paketfilter hatte die per Rust-`#[path]` eingebundene Datei -`tests/backend_root_logs.rs` nicht aufgenommen. Der vollständige öffentliche -`tests/`-Baum wurde ergänzt und ein neuer unveränderlicher Fall gebaut. Kein -Testtarget oder Clippyfehler wurde unterdrückt; der fehlgeschlagene Originalbeleg -bleibt erhalten. Das erfolgreiche Paket verwendet keinen fest codierten alten -Releasepfad und ersetzt keine bereits vorhandenen Rohartefakte. - -## Tatsächlich bereitgestellt: Migration 20, API, Gateway und WebUI - -Der anschließend ausdrücklich beauftragte Deployment-Abnahmeschritt ist -abgeschlossen. Vor jeder Mutation wurde die tatsächliche Composekette der -bestehenden API aus ihren Containerlabels gelesen und mit allen vorhandenen -Overlays erhalten. Eine zusätzliche feste Overlaydatei ändert ausschließlich -die Images von API, Gateway und Migrator auf das oben qualifizierte Image -`a7fc4243…` mit `pull_policy: never`. Das vollständige aufgelöste Composemodell -wurde auf genau diese drei Änderungen verglichen. Container-Environmentwerte -wurden ausschließlich intern verglichen; Protokolle enthalten nur ihre Hashes. -Bei der Vorprüfung wurde Compose-`entrypoint: null` korrekt als Vererbung des -unveränderten Image-Entrypoints normalisiert; es wurde kein Entrypoint geändert. - -Die echte Migration über das qualifizierte Migratorprogramm erhöhte den -geprüften SQLx-Stand von 19 auf 20. Alle bestehenden Migrationschecksummen -entsprachen exakt den eingefrorenen Quellen. Die zwei neuen Tabellen waren -anschließend leer; keine Quittung oder Jobgenehmigung wurde ausgestellt. -Danach wurden ausschließlich API und Gateway mit `up --no-deps --no-build ---pull never` neu erstellt. PostgreSQL, Chrony und der Zeitbroker wurden nicht -neu gestartet; Brokerbinary, -pins und -konfiguration blieben unverändert. - -Beide neuen Container laufen mit dem exakten Image -`sha256:a7fc4243fee414ab6c85c5f4d207b6428005b77ab06903916138a83b4b74e1d4`, -Startzeit 16. November 2026, 12:26:14 UTC, Restartzähler null. Ihre tatsächlichen -Serverbinaryhashes entsprechen `ef88115e…`. UID/GID 10001, vollständige Envwerte, -Mounts einschließlich des nur lesenden Brokersockets, Netzwerknamen, -Loopbackbindungen 127.0.0.1:18443/18444, Readonly-Rootfs, CapDrop ALL und -no-new-privileges wurden vor und nach dem Wechsel verglichen und erhalten. -PostgreSQL hat weiterhin keinen veröffentlichten Port und dieselbe -Containeridentität/Startzeit. Die tatsächlichen Prozess-/Startbelege von Broker -und Chrony sowie die Metadaten der ursprünglichen PKI-, Jobkey- und Policybäume -sind unverändert. - -API und Gateway lieferten tatsächlich HTTPS-Health 200 mit geprüftem CA-Vertrauen -und passendem Servernamen; der TCP-Override für den Gatewaytest veränderte nur -127.0.0.1:18444, SNI/Namensprüfung blieben -`discovery.ease-technologies.de`. Die neue Verwaltungsroute antwortete ohne -Anmeldung mit 401. Die neue WebUI wurde über unveränderliche Assetnamen und -zuletzt atomar ersetzten Index bereitgestellt; die tatsächlich über HTTPS -abgeholten Indexbytes entsprechen dem eingefrorenen Hash `d38d869f…`. - -Vorher und nachher bestanden unverändert 33 Jobs, 28 Grants, 33 Autorisierungen -und 33 Outboxeinträge. Windows blieb bei exakt zwei Jobs/einem ursprünglichen -Echo-Grant sowie Verbindung 205/Checkpoint 10137/Entscheidung `2af359c5…` und -Helperbezug 135. Dieser Schritt startete keinen Windowsdienst und erzeugte -keine Startfreigabe. Die tatsächliche administrative WebUI-Bestätigung und -native geschlossene Anwendung sind separate, anschließend koordinierte Schritte. - -Controller: `deploy/server_deploy_205.py`. Originale und Ergebnisbelege liegen -auf dem Server unter `server205-a48f78614e2e/deployment205-*` und lokal unter -`devstate/server-build-only/a48f78614e2e/local-deployment-*.json`. -Ein kompakter öffentlicher Abschlussbeleg steht in -`docs/evidence/server205-deployment.json`. diff --git a/docs/windows-sync-alignment-205-native-witness.md b/docs/windows-sync-alignment-205-native-witness.md deleted file mode 100644 index 00d3e79..0000000 --- a/docs/windows-sync-alignment-205-native-witness.md +++ /dev/null @@ -1,76 +0,0 @@ -# Verbindung 205: tatsächlicher nativer Originalzeuge - -Am 16. November 2026 wurde auf der Windows-Test-VM der eng auf den -ausdrücklich genehmigten Fall 205 begrenzte native Zeuge erfolgreich erzeugt. -Beide RMM-Dienste waren vorher normal gestoppt und die ursprünglichen Prozesse -nachweislich beendet worden. Sie bleiben bis zum administrativen Abschluss -gestoppt; es wurde kein neuer Hello-/Syncstand erzeugt. - -Der Operator verifizierte die ursprünglichen Request-/Antwortsignaturen, -beide Journalidentitäten und die ursprünglichen Datei-/Lock-IDs, die beiden -geschützten Bindings, vollständige Inventare und die vorhandenen -Consumption-/Start-/Outcome-Nachweise. Agentcheckpoint ist 10137, -der tatsächliche Helpercapturecheckpoint **201**. Der Helper enthält weiterhin -die erste, der Agent die zweite bestätigte Entscheidung. Es bestehen genau -zwei Jobs: der einmalig erfolgreiche ursprüngliche Echojob und der abgelaufene -Skriptjob ohne Grant. Helperwirkungen und SYSTEM-Intents sind null. - -Der finale SDK-Hash lautet -`1b095494785af558ac98ccf795f1d2689be5c621bc27f07624ab4a4c925e6125`; -der kanonische Zeugenhash -`792f2f7f38a83c31cdf7f17bcd40d098df4af6f3745bf422370bd82f6ae65d16`. -[Zähler und genaue Ergebnisbindung](evidence/windows-sync-alignment-205-witness-20261116.json). - -Zwei vorherige reine Lesevorbereitungen wurden korrigiert: zunächst der feste -Pfad zum vorhandenen Intentjournal, anschließend das Lesen der Lockbytes -über denselben bereits exklusiv gehaltenen Handle. Ein zweiter Lesehandle -hatte korrekt einen Sharing-/Lockfehler geliefert. Weder Locks noch ACLs -wurden abgeschwächt. Kein früherer Versuch hat den administrativen Applypfad -aufgerufen oder Journalzeilen verändert. - -Diese Abnahme belegt ausschließlich den Originalzustand. Tatsächlicher -WebUI-Klick, gültige signierte Abschlussquittung, native Anwendung und -anschließender neuer regulärer unabhängiger SignedSync stehen noch aus. -Die exakte historische Ursache der Helperablehnung bleibt unbelegt; eine -Timinghypothese ist kein gemessener Fehlernachweis. Es wird keine alte Lease -verlängert oder mit einer erfundenen historischen Uhr angewandt. - -## Tatsächlicher WebUI-Abschluss und native Anwendung - -Um 12:29 UTC wurde der Originalzeuge über die tatsächliche WebUI eingereicht, -angezeigt und mit der ausdrücklich aktivierten Checkbox-/Buttonbedienung des -sichtbar simulierten Testprincipals bestätigt. Antrag -`84a803a4-2acc-4679-9d6d-a0db404c323a`; -Quittung `5d135f00-70fd-4a6f-840c-fb65753c5805`. Die erste reine -Browserlesung öffnete die eingeklappten Details noch nicht und stoppte deshalb -vor jeder Bestätigung. Der korrigierte Browserlauf öffnete sie über die normale -Oberfläche. Es wurde keine Bestätigungs-API direkt aufgerufen. - -Die heruntergeladene Originalquittung wurde unverändert mit privater -SYSTEM-/Administratoren-ACL am festen Bootstrapziel bereitgestellt. -Der ursprüngliche SDK `1b095494…` wandte sie einmalig mit Exit 0 an -(Archivzeit **12:30:05 UTC**, Abschlussmeldung 12:30:07 UTC). -Eine separat gebaute und um 12:30:23 UTC rein lesend ausgeführte Nachprüfung -`fea0487a…` bestätigte mit Exit 0 die unveränderliche Archivtabelle samt -Triggern, beide Receipt-Signaturen, die ursprünglichen Dateikennungen, -Originalgeschichte und unveränderten Agent-/Consumption-Inventare. - -Der Helper referenziert jetzt ebenfalls die ursprüngliche zweite Entscheidung -`2af359c5-5b5c-4992-b445-1c00e271a288`. Sein Capturecheckpoint bleibt **201**; -keine Rücksetzung auf den historischen Applycheckpoint 135. Alle ursprünglichen -Jobs, Startzeugen und Verbräuche sind erhalten; null Helperwirkungen oder -SYSTEM-Intents. `ready`, `helper_ready` und `unlock` bleiben ausdrücklich falsch. - -Die unabhängige zentrale Nachlese bestätigte einen Prüfantrag, genau eine -administrative Quittung und die zwei dazugehörigen Auditereignisse mit -Testprincipal-/Simulationsbezug. Windows weiterhin zwei Jobs und ein alter -Grant; der ursprüngliche zentrale SignedSync-Head blieb unverändert. -Ein erster reiner SQL-Read benutzte irrtümlich `agent_id` direkt in der -Permittabelle und brach ab; der korrigierte Read verbindet diese über ihre -vorhandene Job-Fremdschlüsselbindung. Keine SQL-Mutation war Teil dieser -Nachlese. Beide RMM-Dienste bleiben vor dem korrigierten Paarwechsel gestoppt. - -[Exakte IDs, Hashes, Zähler und separate Servernachlese](evidence/windows-sync-alignment-205-applied-20261116.json). -Ein neuer regulärer unabhängiger SignedSync und ein neuer tatsächlicher -Skriptauftrag bleiben eigenständige nächste Abnahmen. Dieser administrative -Abschluss genehmigt keinen Job und ist kein Produktions-Freigabenachweis. diff --git a/docs/windows-sync-alignment-205-proposal.md b/docs/windows-sync-alignment-205-proposal.md deleted file mode 100644 index 20451e5..0000000 --- a/docs/windows-sync-alignment-205-proposal.md +++ /dev/null @@ -1,81 +0,0 @@ -# Vorschlag: historienerhaltender Abschluss des Windows-Abgleichs 205 - -Stand 16. November 2026. **Der Betreiber hat diesen konkreten Fall ausdrücklich freigegeben. -Implementierung und tatsächliche Wiederherstellung sind noch offen.** Die bestehenden Starts bleiben geschlossen. - -## Tatsächlich gemessener Fall - -Die reine SQL-Lesediagnose vom 16. November, 12:25:34 MEZ, bestätigte auf -Windows drei identische Aufnahmen: - -| Original | Tatsächlicher Stand | -|---|---| -| Boot | `a9ad0895-5a96-8f2c-8fb6-cfdc2d5225ea` | -| Verbindung | 205 | -| Agent | letzter angewandter Entscheid `2af359c5-5b5c-4992-b445-1c00e271a288`, Checkpoint 10137, Helperbezug 135 | -| Helper | letzter angewandter Entscheid `1a4758ad-0b39-449e-8551-16846851b09a`, ursprünglicher Applycheckpoint 134, Agentbezug 10135 | -| Agentrequests | beide Antworten gespeichert; zweite Anfrage `ed99c355-7621-4846-b8d0-3f534096eed4` verweist auf die erste Entscheidung | -| Bisherige Jobs | ursprünglicher Echojob `645ad11b-9ecd-4efe-8f92-8ad2fb6ed5cf` erfolgreich; allgemeiner Job `0a50aae9-a784-4535-b62f-ef24c301d546` abgelaufen ohne Grant | -| Neue Wirkung | keine neue Startfreigabe, keine SYSTEM-Wirkung; Fehlerflags in beiden Journalen leer | - -Der Agent enthält die zweite Entscheidung, der Helper nur die erste. Das ist -kein reiner Anzeigefehler. Die genaue Ursache der alten Helperablehnung ist -nicht gespeichert; ein fehlender eigener frischer Zeitbeleg ist eine -Quellenhypothese, kein gemessener Fehlercode. Ein Dateiread des vorhandenen -Helper-Transportfehlers meldete keine entsprechende Datei. - -Der nächste Skriptplan `c677d4b6-7067-422e-b03e-9fd8e1d4db04` bleibt -`pending_approval`, mit null Jobs, Outboxeinträgen und Grants vor Genehmigung. -Dieser Vorschlag genehmigt ihn nicht und verändert seine Fristen nicht. - -## Vorgesehener enger Weg - -1. Zunächst die Helperseite korrigieren: innerhalb desselben bereits - authentifizierten Apply-Aufrufs auf den **eigenen** frischen Zeitbeleg - und das Erreichen des signierten Ausstellungszeitpunkts warten. Keine - Verlängerung der Originalfrist, keine Wiederholung nach unklarer Antwort. - Zusätzlich einen begrenzten statischen Ablehnungsgrund speichern. -2. Einen unabhängigen rein lesenden Zeugen aus allen Originalen erzeugen: - beide vollständigen ursprünglichen Requests und signierten Antworten, - beide aktuellen Journal-/Lockidentitäten, Boot/Gerätebindung, - vorhandene Echo-Consumption/Start/Outcome und die abgelaufene Anfrage - ohne Grant. Kryptografische/historische Prüfung ist noch gesondert - auszuführen; die obige Metadatenaufnahme ersetzt sie nicht. -3. Ein neuer administrativer WebUI-Prüfweg bindet genau diesen Zeugen und - erzeugt nach interaktiver Bestätigung einen frischen signierten - Wiederherstellungsbeleg, ausdrücklich mit `ready=false`, - `helper_ready=false`, `unlock=false`. Im Testprofil bleibt die Bedienung - sichtbar simuliert und vollständig auditiert. Kein MCP-/API-/DB-Ersatz - für diese UI-Bestätigung. -4. Bei gestoppten Diensten und gehaltenen ursprünglichen Sperren darf der - native Operator ausschließlich den belegten wirkungslosen Kontrollspalt - schließen. Alle Originalbytes, Signaturen, Requests, Outcomes, Identität, - PKI und bisherigen Zeilen bleiben erhalten. Eine zusätzliche unveränderliche - Wiederherstellungszeile muss die tatsächliche spätere Anwendung und ihren - administrativen Ursprung ausweisen; keine historische Bereitschaft - vortäuschen, keine normale abgelaufene Lease wiederbeleben. -5. Danach müssen beide Rollen einen neuen **regulären** unabhängigen - signierten Abgleich bestehen. Erst ein separat WebUI-genehmigter - unveränderlicher Skriptplan darf anschließend ausgeführt werden. - -Unbekannte Wirkung, neue/unpassende Grant-/Intent-/Jobzeilen, abweichende -Dateiidentitäten, unpassende Originalantworten oder ein anderer Boot verweigern -die Wiederherstellung. Kein Journalreset, keine Neuregistrierung, kein -Zurücksetzen von Sequenzen oder Fälschen eines erfolgreichen Jobs. - -## Warum eine zusätzliche Entscheidung nötig ist - -Kapitel 0, Version 1.24, bindet die frühere Ausnahme ausdrücklich an -„die zwei bereits persistierten und unabhängig verifizierten -Originalentscheidungen der Verbindung 150“ und die Checkpoints 6755/6756. -Der neue Fall ist Verbindung 205 mit bereits abgeschlossener Echohistorie; -die frühere Sonderfreigabe wird darauf nicht stillschweigend ausgedehnt. -Erforderlich ist deshalb eine ausdrückliche Entscheidung für genau diesen -neuen historienerhaltenden Testfall. Ohne sie bleibt dieser Eingriff aus. - -## Entscheidung des Betreibers - -Am 16. November antwortete der Betreiber auf diesen konkreten Vorschlag mit -**„Ja, historienerhaltend wiederherstellen“**. Der begrenzte Vertrag ist in -Spezifikation1.28 festgehalten. Daraus folgt kein bereits erfolgreicher Eingriff, -keine Skriptgenehmigung und keine Ausnahme für weitere Fälle. diff --git a/docs/windows-system-abandon.md b/docs/windows-system-abandon.md deleted file mode 100644 index 95ff71c..0000000 --- a/docs/windows-system-abandon.md +++ /dev/null @@ -1,222 +0,0 @@ -# Windows-SYSTEM: gebundener Nichtstart vor Delegation - -Stand 2026-11-14, **verbindlicher Implementierungsvertrag**, Spezifikation1.17. -Gemeinsamer Kern implementiert und nativ Linux-first qualifiziert; der -Windowsadapter bleibt im Review. Keine Capability, Installation oder tatsächliche -SYSTEM-Jobabnahme dieses Vertrags. -Die normative Präzisierung steht in Spezifikation0.1. Der -Notebookhost bleibt Entwicklungsrechner; Ziel bleibt ausschließlich der eigene -Windows-Testgast am festgelegten Cloudserver. - -## Tatsächlicher Kernnachweis - -Der neue gesonderte Runner `deploy/core_no_start_acceptance.py` bindet59 -Quelldateien und denselben Linux-/Windowsbuild im Manifest -`build-de37ee99-11bf-465b-9519-45ad8f6e5b87` (SHA256 `1bc08203…`). -Lokal bestanden beide Alltargets-Clippy-Ziele und80 Linux-Units. Anschließend -bestanden auf der tatsächlichen Cloud-Linux-VM im Fall -`9d08e552-757c-4bbb-943f-9f0712e442b1` alle80 Prüfungen ohne Skips: -7 Verträge,26 Helper-Sync,26 Agent-Sync und21 Unix-Helperintegration. -Getrennte Netzwerknamespace, leere Prozessumgebung und privates Scratch; -keine RMM-Jobs, Produktdaten, Server- oder Dienständerungen. -Anschließend bestanden auf der tatsächlichen Windows-VM im Fall -`4a260f42-936f-4c03-9250-127c1b954db1` alle58 Prüfungen ohne Skips: -6 Verträge,26 Helper-Sync und26 Agent-Sync. Die tatsächlichen nativen Listen -stimmten vor Ausführung exakt mit dem Manifest überein; der Windowsbeleg bindet -den tatsächlichen Linuxbeleg. Bootstrap-Administrator-Units, kein -LocalService-/SYSTEM-Runtimebeweis und keine Produktdatenänderung. - -Der Kern prüft historische signierte Originalbytes nur für die Verweigerung; -die aktuelle Startprüfung behält das echte Zeitfenster. Der unabhängige -Adapterguard muss unveränderte Helper-/Dateiidentität und den festen -KnownNoDispatch-Store prüfen. Neue Verbrauchs-, Start- und feste Nichtstart- -Outcomezeilen entstehen gemeinsam in einer SQLite-Transaktion und bleiben bis -zum normalen signierten Sync gesperrt. Bestehende Unknowns, fehlende Starts -und kollidierende Requests werden niemals zu bewiesenem Nichtstart umgeschrieben. -Diese Units ersetzen keinen tatsächlichen Windows-Token-/Pipe-/Clocknachweis. - -## Zweck und unveränderte Grenzen - -Ein SYSTEM-SCM-Auftrag besitzt bereits einen WebUI-genehmigten festen Plan und -einen tatsächlich reservierten, signierten Originalgrant. Der Netzwerkagent -darf seinen eigenen Ledgerverbrauch nicht als unabhängigen Helperverbrauch -ausgeben. Insbesondere kann ein lokaler Abbruch vor der Delegation sonst einen -Agentverbrauch ohne zugehörigen Helperversuch erzeugen und den strengen Sync -dauerhaft sperren. - -Der neue lokale Vorgang `Abandon` darf ausschließlich diesen Originalgrant -dauerhaft an einer künftigen Wirkung hindern. Er führt weder SCM-Vorbereitung -noch Dienstöffnung/-änderung, Skript, Prozessstart, Paketaktion oder Reboot aus. -Er erteilt keine Starterlaubnis und öffnet kein Readygate. Alle normalen -Genehmigungs-, Peer-, Signatur-, Clock-, Ledger- und Syncgrenzen bleiben erhalten. -Insbesondere werden keine Missing-Row-Prüfungen im gemeinsamen Kern oder Server -gelockert. Die bestehenden Job-, Grant- und Sync-Codecs bleiben unverändert. - -## Dauerhafter Intent vor jeder Socketübergabe - -Vor einem Execute- oder Abandon-Socketzugriff speichert der Agent einen eigenen -gebundenen Delegationsintent dauerhaft. Dies ist **noch kein** Verbrauch und -kein Nachweis eines Helper-/SCM-Starts. Er enthält mindestens: - -- unveränderte Originalrequestbytes einschließlich exakter Job-/Permitbytes, - Signatur, Planhash und Autorisierungs-ID sowie deren Hash; -- Grant-, Job-, Versuch-, Tenant-, Asset- und Agentbindung, Enrollmentgeneration, - Assignmentversion, SYSTEM-Identität und feste SCM-Aktion; -- ursprüngliche Boot-ID, Agentinstanz, Verbindungsgeneration und den tatsächlich - beobachteten Zeitpunkt der lokalen Intentpersistierung; -- den zuletzt tatsächlich bestätigten Ready-Helperjournal-/Checkpoint-/ - Decisionbezug samt erhaltenem signiertem Syncnachweis und exaktem Requestbezug; -- die provisionierten öffentlichen Binding-, Helperimage- und Policyhashes. - -Die unveränderlichen Intentdaten und alle folgenden Übergangsbelege bleiben -erhalten. Gleicher Grant/Versuch mit abweichenden Bytes ist ein Konflikt, keine -neue Absicht. Ein offener Intent sperrt eine erneute Execute-Delegation und neue -konfliktbehaftete Starts auch dann, wenn noch keine `consumed`-Zeile existiert. -Ein Agentneustart darf diesen zusätzlichen Sperrzustand nicht verlieren. - -Vor Execute muss der Agent atomar einen dauerhaften `may_have_dispatched`- -Übergang festschreiben, **bevor** der Request die Socketstrecke erreichen kann. -Fehlende Persistenz verhindert die Übergabe. Der Abbruchpfad darf einen -dauerhaften `known_no_dispatch`-Beleg nur erzeugen, wenn dieser Übergang noch -nicht existiert; konkurrierende Worker-/Cancelpfade müssen denselben atomaren -Zustandsvergleich verwenden. Nach dem Übergang ist auch ein Absturz unmittelbar -vor dem tatsächlichen Socketaufruf konservativ mehrdeutig. - -Ein nur vorbereiteter Intent wird nach Wiederanlauf nicht ausgeführt. Ein -gegebenenfalls daraus abgeleiteter Nichtstart benötigt den qualifizierten -Nachweis, dass kein Übergabepfad ohne vorangehenden dauerhaften Übergang möglich -war und kein alter Dispatcher weiterläuft. Fehlender oder widersprüchlicher -Nachweis bleibt mehrdeutig. Kein automatischer Execute-Retry. - -## Enger deny-only Helpervertrag - -Abandon wird ein eigener strikt dekodierter IPC-Vorgang, kein Executeflag und -kein frei formulierter Befehl. Er bindet den Originalrequest und dessen Hash, -den konkreten Nichtübergabebeleg sowie den ursprünglichen Helperjournal-/ -Checkpoint-/Decision- und Bootkontext. Der Agent darf ihn nur aus einem dauerhaft -belegten `known_no_dispatch`-Pfad senden. Der Helper prüft unabhängig: - -1. Beidseitige aktuelle SCM-/PID-/Prozessstart-/Image-/Token-/Service-SID-Bindung - über den vorhandenen authentisierten Kanal und die provisionierten Pins. -2. Vollständige historische Originalsignatur und Plan-/Job-/Grant-/ - Autorisierungsbindung, Tenant, Gerät, Generationen und die enge SYSTEM-SCM- - Aktionsform. Historische Verifikation berechtigt ausschließlich zur Prüfung - und Verweigerung; sie erzeugt kein gültiges Startfenster. -3. Unter gehaltenem exklusivem Executor-/Ledgerguard vollständige Ledgeridentität, - erhaltene Verbrauchs-/Signaturhistorie und Journal-Lineage gegenüber dem vor - Übergabe bestätigten Helperkontext. Ein legitimer Fortschritt muss aus den - erhaltenen gebundenen Nachweisen erklärbar sein. Rollback, fehlende Historie, - anderer Journalbezug oder widersprüchliche Generation verbieten Abandon. - Eine bloß fehlende Verbrauchszeile ist kein unabhängiger Nichtstartbeweis. -4. Aktuellen vertrauenswürdigen Clock-/Bootkontext. Dieser erste enge Vertrag - erzeugt bei Bootwechsel oder unklarer Uhr keinen neuen Abandon-Tombstone. - Ablauf des Originalgrants erlaubt niemals Execute; ein nach Ablauf eindeutig - belegter Nichtstart darf ausschließlich als dauerhafte Verweigerung behandelt - werden. Kein Rückdatieren oder Verlängern des Grants. - -Der erste Implementierungsschnitt verlangt zusätzlich dieselbe tatsächliche -Helperinstanz (PID/Prozessgeburt/Image) und dieselben gehaltenen Ledger-/Lock- -Dateiidentitäten wie der ursprüngliche bestätigte Ready-Kontext. Fortschritt -oder Wiederanlauf wird bei fehlendem eindeutigen Lineagenachweis konservativ -verweigert. Der Helper darf nur den dafür eigens vorgesehenen festen Intentstore -gezielt read-only prüfen. Dessen Originalrequests und signierte Grants sind -vertraulich; keine Gerätekeys, Enrollmenttokens oder sonstigen Agentdaten lesen, -keine Request-/Grantdumps in Logs/MCP/Git. Bootstrap muss Eigentümer/Leaf-ACLs, -Dateiidentität, Parentbindung und SQLite-Journalanforderungen konkret absichern; -ein bloßer vom Caller gelieferter Bool/Hash ist kein unabhängiger CAS-Nachweis. - -Historische Prüfung muss im Code eindeutig als deny-only Verifikation erkennbar -sein. Sie darf keinen frei gewählten historischen Zeitpunkt als angeblich -aktuellen TrustedClockwert an den normalen Execute-Pfad übergeben. Live-Execute -behält seine unveränderte echte Clock-/Startfensterprüfung. Auch die atomare -Nichtstartpersistenz darf nach einem Absturz keine verbrauchte Zeile ohne den -zugehörigen No-Effect-Beleg als neu bestätigten Nichtstart ausgeben. - -Existiert irgendein Verbrauch für den Grant oder denselben festen Versuch, -bleiben Request, Verbrauch, Startzeuge und Outcome unverändert. Der Helper gibt -nur den exakt gebundenen tatsächlich gespeicherten Ausgang zurück. Ohne -gespeichertes eindeutiges Outcome oder bei bestehendem Unknown bleibt die Antwort -unknown; Abandon schreibt keinen neuen Nichtstart und klassifiziert keine -bereits mögliche Wirkung um. Abweichende Originalbytes sind ein Konflikt. - -Nur bei nachgewiesener Abwesenheit unter den obigen unveränderten Bedingungen -darf der Helper atomar einen Originalrequest-/Grant-Tombstone mit kanonischem -Nichtstartergebnis persistieren. Der Beleg sagt ausdrücklich `not_started=true` -und benennt den Abandon-Nichtstart, keine erfolgreiche SCM-Nachprüfung. Derselbe -Grant/Versuch kann anschließend auch bei verspätetem Execute keine Wirkung mehr -auslösen. Der Helper darf vor dem Commit keine definitive Antwort senden. - -## Mehrdeutigkeit, verlorene Antworten und Spiegelung - -`may_have_dispatched` mit fehlendem Helperversuch bleibt unknown und benötigt -einen ausdrücklich vorgesehenen Abgleich beziehungsweise manuelle Klärung. -Abandon ist dafür kein Ersatz und darf keinen bequemen No-Effect-Nachweis -erzeugen. Eine nachgewiesene tatsächliche Helperconsumption wird durch ihre -erhaltenen Nachweise behandelt, unabhängig vom Transportausgang. - -Nach verlorener Executeantwort ist ausschließlich ein frischer authentisierter -Helper-Snapshot zulässig, niemals eine erneute Executeübergabe. Eine erneute -Abandonübermittlung kommt allenfalls mit exakt demselben dauerhaft erhaltenen -Nichtübergabebeleg und allen ursprünglichen Bindungen infrage; sie ist idempotent -und darf nur vorhandene Belege zurückliefern oder denselben zuvor ausgebliebenen -deny-only Commit herstellen. Es gibt keinen allgemeinen automatischen Retry. -Ohne eindeutigen eigenen Nichtübergabebeleg bleibt nur Snapshot/Unknown. - -Vor Network-Ledgerspiegelung und `ClientSync.prepare` braucht der Adapter einen -frischen, unabhängig authentisierten **rohen** Helper-Snapshot. Das gilt auch -nach einer Execute-/Abandonantwort; eine Antwort mit bloßem Outcome genügt nicht. -Für den konkreten Versuch prüft er das gesamte Tupel: - -`job_id`, `attempt_id`, `job_payload_hash`, `grant_id`, `authorization_id`, -`plan_hash`, `action`, `execution_identity`, `original_boot_id` und -`original_request_sha256`. - -Der Requesthash stammt aus dem vorhandenen festen Requestcodec mit unveränderten -inneren Job-/Permit-/Signaturbytes. Dazu kommen aktueller Snapshotboot, -Helperjournal-/Checkpoint-/Decision-Lineage und Pinbindung sowie kanonische -Outcomebytes, deren Hash/Zustand und die zum festen Auftrag passenden -Output-/Reboot-/SCM-Nachbedingungen. Kein Hash wird aus einer beliebig -umformatierten JSON-Ansicht berechnet. Unknown bleibt Unknown. - -Erst der passende tatsächliche Helperverbrauch darf den vorhandenen atomaren -`begin_execution`-Pfad im Agentledger speisen; dort entsteht kein zweiter -OS-Start. Die Spiegelung behält den Originalrequest und den tatsächlichen -ursprünglichen Agent-Intentzeitpunkt als lokale Reservierungszeit. Eine separate -Belegangabe `mirror_observed_at` bezeichnet den wirklichen Beobachtungszeitpunkt. -Weder diese Zeit noch `Snapshot.captured_at` werden als unbekannte native -Helper-/SCM-Startzeit ausgegeben. Boot- und Zeitwidersprüche bleiben gesperrt. -Mirror-/Outcome-/Jobjournalpersistenz muss nach Absturz exakt und idempotent -fortsetzbar sein; abweichende vorhandene Originaldaten werden nicht überschrieben. - -Nach der Spiegelung folgen vorhandene dauerhafte Outcome-/Jobjournalpfade und -normaler signierter Agent-/Helpersync. Erst dessen unabhängig bestätigte -Entscheidung darf die Ressourcensperre schließen. Keine unsigned Freigabe, -SQL-Korrektur, Identitäts-/Journalrücksetzung oder Markerbereinigung. - -## Warum Originalgrant und Helperbeleg erforderlich bleiben - -Nach Permitausgabe ist serverseitig `start_reserved=true`. Der bestehende -Jobgateway akzeptiert einen grantlosen Nichtstart nur ohne diese Reservierung. -Der Originalgrant wird daher weder aus Ergebnis noch Intent entfernt; ein -Unknown mit leerem Grant wäre ebenfalls kein zulässiger Ersatz. - -Im gemeinsamen Agentkern bedeutet ein nichtleerer Grant ohne bestätigten -Verbrauch absichtlich `uncertain`, nicht automatisch `unconsumed`. Der -Helperkern verweigert außerdem eine signierte SYSTEM-Versuchsentscheidung mit -Grant, wenn sein eigener entsprechender Versuch fehlt. Die vorgeschaltete -Intent-/Abandon-/Snapshotstrecke erfüllt diese vorhandenen Bedingungen; -sie ändert sie nicht. Laufende Keeper-/Heartbeat-/ACK-Verarbeitung darf durch -IPC oder Nachweisabgleich nicht blockieren. Die einzelne begrenzte Helperlane -und ihre echte Timeout-/Handlelebensdauer bleiben erhalten. - -## Geplante gezielte Qualifikation, nicht ausgeführt - -Notwendig sind enge Fälle für Nichtübergabe mit Originalgrant, vorhandenes -Outcome/Unknown ohne Überschreiben, falsche Request-/Tenant-/Boot-/Lineagebindung, -verlorene Antwort und Absturz an Intent-/Dispatch-/Mirrorgrenzen. Sie müssen -belegen, dass weder eine zweite Wirkung noch eine Missing-Row-Ausnahme entsteht -und dass reservierte Grants samt beiden Journalen durch normalen signierten Sync -geschlossen werden. Der gemeinsame Kern wird weiterhin zuerst auf der echten -Linux-VM geprüft; Windowsadapter, Peerprüfung und SCM-Nichtwirkung benötigen -eigene native Windowsnachweise. Source-/Unit-/Crossbuildnachweise aktivieren -weiterhin keine Capabilities und ersetzen keinen WebUI-genehmigten Job. diff --git a/docs/windows-system-delegation-source.md b/docs/windows-system-delegation-source.md deleted file mode 100644 index 52cf16c..0000000 --- a/docs/windows-system-delegation-source.md +++ /dev/null @@ -1,157 +0,0 @@ -# Windows-SYSTEM-Delegation: Quellenstand - -Stand2026-11-14, Spezifikation1.17. Dies ist ein implementierter **Kandidat zur -Sourceprüfung**, keine native Dienst-/IPC-/SCM-Abnahme. Die produktive Clock- -Qualifikation, Jobkonfiguration, Helperwirkung und veröffentlichten Fähigkeiten -bleiben deaktiviert. Der vorhandene Windowsgast und der endgültige Cloudserver -bleiben die Ziele; der Notebookhost bleibt Entwicklungsrechner. - -## Implementierter Ablauf - -Der Netzwerkagent persistiert vor einer möglichen Übergabe einen eigenen festen -SYSTEM-Intent mit den unveränderten vertraulichen Originalrequestbytes, -Originalgrant, Boot-/Agentinstanz-/Verbindungskontext und dem tatsächlich vom -Helper zurückgegebenen historischen Readyanker. Die Daten werden nicht in -Logs oder MCP-Ausgaben exportiert. Ein Intent ist noch kein Helperverbrauch. - -Dispatcher und Cancellation verwenden dieselbe dauerhafte SQLite-CAS: -`prepared` wird ausschließlich `known_no_dispatch` oder `may_have_dispatched`. -Nach einem May-Marker gibt es weder Execute-Redelivery noch eine Umklassifikation -zu bekanntem Nichtstart. Ein weiterer Start bleibt gesperrt. Lokale Consumption -entsteht nicht mehr vor der SYSTEM-Übergabe. Nach einem IPC-Ausgang wird zunächst -ehrliches Unknown mit dem **Originalgrant** gespeichert. - -Der separate strikt dekodierte Helpervorgang Abandon führt keinen Fixture-SCM- -oder Provideraufruf aus. Die lokale Allowlist wird nur logisch geprüft. Der -geschützte Adapter liest gezielt den tatsächlichen festen Intentstore und dessen -Known-CAS. Der gemeinsame Helperkern prüft unabhängig Signatur, aktuelle echte -Clock, ursprünglichen Boot, exakten alten Readyanker und erhaltene Lineage. -Zusätzlich bindet der Windowsguard eigene Kernel-PID, Prozessstart, Image-Datei-ID -sowie Ledger-/Lock-Datei-IDs. Ein neuer Nichtstart braucht dieselbe Helperinstanz; -neue Instanzwerte ersetzen niemals den alten Anker. Vorhandene Verbräuche und -Outcomes werden nicht überschrieben. - -Ein bereits dauerhaft bekannter Nichtstart darf nach Agentneustart genau einen -deny-only Abandon-Abgleich pro **neuer** Agentinstanz versuchen. Ein eigener -unveränderlicher Resume-Beleg steht vor diesem RPC. Danach folgt immer ein -frischer RawSnapshot. Eine verlorene Antwort erlaubt in derselben Instanz nur -weitere Snapshotabfrage. May-Marker und bloß vorbereitete unterbrochene Intents -bleiben konservativ Unknown/manuell gesperrt. - -## Spiegelung und Crashgrenzen - -Auch eine erfolgreiche Execute-/Abandonantwort ist kein Mirrorbeleg. Der Adapter -verlangt einen frischen unabhängig authentisierten rohen Helpersnapshot und -prüft das vollständige Originaltupel einschließlich Autorisierung, Plan, Aktion, -Identität, Originalboot und Hash des unveränderten Requestcodecs. Dazu kommen -kanonische Outcomebytes/Hash/Zustand, Output-/Rebootgrenzen und bei Erfolg die -exakten SCM-Nachbedingungen. Fehlender Helperversuch wird nicht ergänzt oder -als Nichtstart umgedeutet. - -Die **Helper-Abandontransaktion** schreibt Consumption, Originalstartzeugen und -festen NoEffect-Outcome atomar. Die **Network-Spiegelung** benutzt dagegen die -vorhandenen gemeinsamen APIs: `begin_execution` speichert c+start atomar; -anschließend wird der unabhängig nachgewiesene Outcome persistiert. Ein Crash -dazwischen bleibt gesperrt und wird nur aus einem erneut frisch authentisierten -RawSnapshot fortgesetzt. Eine vorhandene exakt passende Originalzeile wird -idempotent akzeptiert, abweichende Daten werden verweigert. Erst nach vollständiger -Spiegelung darf der unveränderte gemeinsame Sync fortfahren. Keine Missing-Row- -Prüfung wurde für diesen Adapter gelockert. - -Ein tatsächlicher gebundener Helper-Unknown wird vor dem gemeinsamen Sync auch -im Jobjournal kanonisch gespeichert. Ein pauschaler Transport-Unknown darf nicht -neben einem anderen tatsächlichen Unknown im Verbrauchsledger stehen bleiben. -Der Abgleich prüft dafür auch bereits gespiegelte Intents erneut anhand des -frischen RawSnapshot. Beim Startup wird ein schon gespeicherter tatsächlicher -Outcome erhalten; ein identischer terminaler Jobjournalbeleg wird nicht erneut -als Zustandsübergang geschrieben. Der neue enge Regressionsfall bildet Unknown- -Abweichung und wiederholten Startup nach der Mirror-Crashlücke ab. Archivierung -ist keine ACK-Verarbeitung und löscht keine ausstehenden Events. - -Die Network-Reservierungszeit bleibt der tatsächlich gespeicherte Intentzeitpunkt. -`mirror_observed_at` wird separat gespeichert; weder dieser Wert noch der -Snapshotzeitpunkt wird als unbekannte native Helper-/SCM-Startzeit dargestellt. - -## Geschützte Bootstrapgrenze - -`deploy/windows/system_intent_bootstrap.py` wurde nach unabhängiger Sourceprüfung -im Fall `f322a4d2-c537-4842-bf04-658ad8f814b0` tatsächlich auf der Windows-VM -ausgeführt. Quelle SHA256 `7597ac0f…`. Sie erzeugte ausschließlich den festen Ordner -`C:\ProgramData\RustDiscoverySystem\agent-intents` und die beiden vorab angelegten -Leaves `system-intents.sqlite` und `system-intents.sqlite-journal`. SYSTEM/Admins -bleiben Besitzer; der Agent-Service-SID erhält Verzeichnis-RX und auf genau den -Leaves Read/Write/Synchronize, keine Owner-/DACL-/Delete-/DeleteChild-Rechte. -Beide Dateien sind tatsächlich0Bytes lang. Native Owner-/ACLprüfung bestand: -Actor-Maske `0x12019f`, keine Directory-Create-/Delete-/Owner-/DACLrechte. -Ursprüngliche Agent-/Helperprozesse5140/6240, Konfiguration, öffentliche Pins -und private Helper-/Geräteschlüsselmetadaten blieben im Vorher-/Nachhervergleich -erhalten. Keine Dienständerung, Joboperation, SQLiteinitialisierung oder Clockänderung. -Der implementierte Helperadapter soll den Store nur lesend öffnen und gehaltene -Dateiidentitäten prüfen; das ist mit der Dateivorbereitung noch nicht nativ belegt. - -SQLite-PERSIST erhält das vorab angelegte Rollbackjournal, statt dem Actor -Verzeichnisanlage- oder Löschrechte zu geben. WAL und zusätzliche Dateien werden -nicht verwendet. Der Sourceentscheid folgt der [SQLite-PRAGMA-Dokumentation](https://www.sqlite.org/pragma.html#pragma_journal_mode). -Die tatsächliche Verzeichnis-/Leaf-ACL ist jetzt nativ vorbereitet und geprüft. -PERSIST-/Sharing-/Hotjournalfunktion unter dem Agenttoken bleibt separat offen; -zwei leere Dateien sind ausdrücklich kein SQLite-Funktionsnachweis. -Fehlende oder abweichende Provisionierung verweigert die SYSTEM-Strecke; der -passive Standardclient provisioniert oder repariert nichts. - -## Tatsächliche Prüfgrenzen - -Die genehmigte Entwicklungsdiagnose ergänzt im vorhandenen privaten -Agent-Probereport ausschließlich feste Stufen-/Codefelder. Der Helper hält -genau `state/pipe-last-error.json` plus eine feste Pendingdatei und versucht -höchstens einen Schreibzugriff je30Sekunden. Inhalt: PID, UTC-Beobachtungszeit, -statische Stufe/Whitelistcode und optional eine unmittelbar am fehlgeschlagenen -API-Aufruf erfasste numerische Win32fehlernummer. Keine Request-/Binding-/Grant- -oder Tokendaten, kein beliebiger Fehlertext, keine Historie und keine zusätzliche -RMM-/MCP-Inventarfähigkeit. Sicherheitsfehler schließen weiterhin Sync und Pipe; -ein fehlgeschlagenes Revert führt weiterhin zum Prozessabbruch. Ein Fehler der -Diagnostik wird nicht als Sicherheitsausnahme behandelt. - -Im gleichen Kandidaten ist der belegte Source-APIfehler bei OVERLAPPED-I/O -korrigiert: direkte ReadFile-/WriteFile-Bytezähler sind null, tatsächliche -Completionbytes kommen auch bei sofortigem TRUE aus GetOverlappedResult. -Bestehende Deadline-, Cancel- und Pufferlebensdauer-/Abbruchgrenzen bleiben -erhalten. Grundlage: [ReadFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-readfile) -und [WriteFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-writefile). -Dies belegt keine tatsächliche Ursache des früheren nativen Probefehlers. - -Feature- und Defaultprofile wurden lokal für Windows-GNU mit -`cargo clippy --locked --offline --all-targets -- -D warnings` erfolgreich -crossgeprüft; die neue Bootstrapquelle wurde durch den PowerShell-AST-Parser -geprüft. Eine enge neue CAS-Fixture ist implementiert und crosskompiliert. -Windows-Unitlinks wurden erzeugt; dies ist keine native Testausführung. - -Unabhängiger finaler Source-Review bestanden. Ein gemeinsamer Build bindet70 -Quellen, beide Alltargets-Clippy-Profile und sechs erhaltene AMD64-PE-Artefakte: -Agent, Helper, zwei Readonlyprobes und beide Unitprogramme. Manifest -`build-80655271-dbe6-474f-89de-014fd5a67c8d`, SHA256 `71914e2a…`; -private gehashte vollständige Quellenkopie zusätzlich erhalten. -Auf der tatsächlichen Windows-VM bestanden danach23Lib+7Bin-Units ohne Skips, -Fall `5f95361a-5b4e-4fa0-aeeb-414a8dfac613`. Anschließender separater Readback -und Prüfung unveränderter zentraler Zähler/geschlossener Flags bestanden. -Bootstrap-Administrator-Units, kein LocalService-/SYSTEM-Runtimebeweis. - -Der ursprüngliche SSH-Timeout lag nach der Übertragung vor dem ersten Unitstart. -Nur lesend wurden beide vollständigen Binärhashes/-größen und das Fehlen von -Remote-Testfall/Startmarker nachgewiesen. Danach wurde im selben Fall ausschließlich -die erste noch nicht erreichte Testphase mit zusätzlichem dauerhaftem Intent -fortgesetzt; keine erneute Übertragung oder Testwiederholung. Alter Timeout erhalten. - -Noch offen sind die tatsächlichen Agenttoken-/SQLite-/Crash-/Nichtstart-/Mirror- -Nachweise. Die separate positive Agent-/Helper- -Pipeprüfung, TrustedClock und WebUI-genehmigte SYSTEM-SCM-Abnahme bleiben eigene -offene Gates. Frühere native Unit- und passive Transportnachweise werden nicht -als Nachweis dieses neuen Ablaufs umetikettiert. - -Der gemeinsame Kernvertrag ist inzwischen separat nativ zuerst auf Cloud-Linux80, -danach Windows58 Prüfungen qualifiziert; siehe [Abandonvertrag](windows-system-abandon.md). -Die Sourcekorrekturen zu tatsächlichen Helper-Unknowns und wiederholtem Startup -erhalten identische kanonische Ergebnisse samt Originalgrant. Statische private -Pipe-Fehlercodes und der dokumentierte OVERLAPPED-Bytezählerpfad sind korrigiert; -die Ursache des ursprünglichen tatsächlichen Verbindungsfehlers bleibt unbewiesen. -Die neuen Adapterunits sind23Lib+7Bin **nativ bestanden**; eine Installation des -damit gebundenen neuen Agenten/Helpers ist noch nicht erfolgt. diff --git a/docs/windows-system-delegation-upgrade.md b/docs/windows-system-delegation-upgrade.md deleted file mode 100644 index fcb60bd..0000000 --- a/docs/windows-system-delegation-upgrade.md +++ /dev/null @@ -1,150 +0,0 @@ -# Gemeinsames passives Windows-Komponentenupgrade - -Stand 2026-11-14: **Passive Wartung nach separat dokumentiertem ersten APIfehler und -enger Recovery abgeschlossen. Positive Pipeabnahme weiterhin fehlgeschlagen.** -Lokale Guards und PowerShell-Parserprüfung ersetzen weder -die neuen nativen Unitnachweise noch den tatsächlichen Erhaltungs-/Pipebeleg. -Der Notebookhost bleibt ausschließlich Entwicklungsrechner. - -`deploy/windows/system_delegation_upgrade.py` ist eine eigene enge Strecke für -den vorhandenen Agenten `2beed7fa…` und Helper `921cf182…`, zuletzt PID5140/6240. -Die historischen Runtime- und Helperbootstraprunner bleiben unverändert. Sie -eignen sich absichtlich nicht zur erneuten Installation oder zum Neustart eines -bereits vorhandenen Helperjournals. Der Originalfall `59c2fd6f…` bleibt erhalten. - -Die neue Strecke benötigt das gemeinsame Artefaktmanifest und den tatsächlichen -nativen Unitbeleg aus `system_delegation_acceptance.py`. Sie bindet Agent, Helper, -unveränderten `RuntimeStateProbe.exe` und den neuen lesenden `SystemStateProbe.exe`. -Die gemeinsame Core-Qualifikation Linux80→Windows58 ist eine Voraussetzung; -sie ist keine native Windows-Pipe- oder SCM-Wirkungsabnahme. - -Der feste Ablauf speichert vor der Mutation lokale und entfernte Create-only- -Intents. Er hält die tatsächlichen Prozesshandles samt Startzeit, stoppt zuerst -den ursprünglichen Agenten und wartet auf dessen Prozessende; erst danach stoppt -er den ursprünglichen Helper. Beide Dienste müssen während sämtlicher -Dateitausche gestoppt bleiben. Alle vier Originalbackups werden vor dem ersten -`File.Replace` geschrieben und geprüft. Agent-EXE, Helper-EXE, `helper.json` und -`agent-pin.json` erhalten jeweils eigene CAS-/Phasenbelege und ihre bisherigen -Datei-ACLs. Erst nach Prüfung aller vier neuen Dateien darf der Helper einmal, -anschließend der Agent einmal gestartet werden. Die beiden Startbelege binden -PID und Prozessstartzeit auch beim späteren Finish. - -Die beiden öffentlichen Konfigurationen ändern ausschließlich die zwei -Binaryhashes und den daraus berechneten Policyhash. Die sechs Agentconfigfelder, -Geräteidentität, Zertifikate und Schlüsselmetadaten bleiben erhalten. Private -Schlüsselbytes werden nicht gelesen oder übertragen. Dienste behalten Konten, -Startmodi, Service-SID-Typ, Kommandozeilen und Service-ACL-Hashes. Telemetrie und -Helperledger behalten ihre Dateiidentitäten, Erstellungszeiten, bestehenden -Schemas und Zeilenbelege. Zwischen Stopp und Neustart werden zusätzlich ihre -Dateibytes verglichen; danach darf die passive Telemetrie nur regulär fortschreiten. - -Die separat nativ vorbereiteten Intentdateien aus Fall `f322a4d2…` werden über -dessen unveränderten Beleg `c4ef6fed…` gebunden: genau zwei reguläre 0-Byte-Blätter -mit unveränderten Dateiidentitäten und engen ACLs. Der Runner initialisiert sie -nicht und öffnet sie nicht als SQLite. Vorbereitung bedeutet weiterhin keine -PERSIST-/Hotjournal-, Agenttoken-Zugriffs- oder Delegationsqualifikation. - -`enable_jobs=false`, kein Jobbinding, unqualifizierter Produktionsclockadapter, -`allowed_services=[]`, `enable_effects=false` und `allow_reboot=false` bleiben -unverändert. Der Runner führt keine RMM-Jobs, Paket-/Diensttests, Reboots, -Uhränderungen, Freigaben oder Servermutationen aus. Die einzigen Dienstaktionen -sind die ausdrücklich beauftragten Stopps/Starts dieser beiden eigenen -Komponenten. Staging benutzt den bekannten gepinnten SSH-/SFTP-Pfad und feste -hashgeprüfte PowerShell-Dateien mit RemoteSigned, keine freien Befehle oder -ExecutionPolicy-Umgehung. Bereits qualifiziert vorhandene Stageartefakte werden -anhand ihres exakten Hashpointers ausschließlich lesend verifiziert und nicht -erneut übertragen oder überschrieben. - -Diagnosen sind auf den bestehenden Agentbeleg `state/helper-probe.json` und die -zwei festen Helperdateien `state/pipe-last-error.json` sowie deren bekannte -Stagingdatei `.pipe-last-error.pending` begrenzt. Helperdiagnosen sind maximal -1024Byte und enthalten ausschließlich Prozess-ID, Beobachtungszeit und feste -Fehlerstufen/-codes. Sie liefern keinen positiven Pipebeweis. Dieser benötigt -den frischen Beleg des tatsächlichen neuen Agentprozesses mit Challenge, -reziproken Pins und erfolgreich authentisiertem Austausch. - -Bei Antwortverlust ist ausschließlich `readback --id …` zulässig. Dieser liest -auch einen Teilstand und wiederholt keinen Stop, Dateitausch oder Start. Es -gibt keinen automatischen Rollback, Retry, Journalreset oder Markerabbau. -`finish --id …` benötigt beide tatsächlichen neuen Einzelstartinstanzen, -Erhaltungsbelege, frische gespeicherte WSS-Heartbeats/Inventar-ACKs und unveränderte -Windows-/Linux-Jobzählungen sowie Servergates. Erst danach wird der bisherige -Runtimeindex per lokalem CAS um einen neuen Komponentenbeleg ergänzt. Ein noch -fehlgeschlagener Pipebeleg bleibt ausdrücklich fehlgeschlagen; ein erfolgreiches -passives Komponentenupgrade behauptet keine Jobfähigkeit. - -Aufrufvorlagen; tatsächlichen Fallstand unten beachten: - -```text -python3 deploy/windows/system_delegation_upgrade.py upgrade-passive --manifest --qualification -python3 deploy/windows/system_delegation_upgrade.py readback --id -python3 deploy/windows/system_delegation_upgrade.py finish --id -``` - -## Tatsächlicher Fall6d2df065: erster Dateiaufruf fehlgeschlagen - -Originalfall `6d2df065-0877-41c4-983c-2c9fdb6e5437` scheiterte zunächst vor dem -Server-Beforecheckpoint. Nach wiederhergestelltem gepinntem SSH-Zugang wurden -fehlender entfernter Fall/Activeintent und unveränderte Originalprozesse separat -lesend bestätigt. Ein zusätzlicher dauerhafter Fortsetzungsintent führte -ausschließlich die erste zuvor nicht erreichte Phase desselben Falls aus. -Originale Fehlermeldung und Quellen blieben erhalten, kein neuer Enrollment- -oder RMM-Jobkontext. - -Native Stopps beider eigenen Dienste bestanden. Frozenbeleg und sämtliche vier -privaten Originalbackups wurden gespeichert. Beim ersten Dateitausch meldete -`[IO.File]::Replace($candidate,$destination,$null)` eine ArgumentException. -Sofortiger gesonderter Readback: Agent/HelperStopped, vier Zielhashesoriginal, -keine Replaced-/Swapped-/Startmarker. Eine weitere Nur-Leseprüfung bestätigt -Frozen-DBbytes, Zeilen, tatsächliche Dateiidentitäten und PKI-Metadaten erhalten. -Nur der erste Agentcandidate (exakter neuer Hash) und sein ursprünglicher -Replaceversuchsmarker existieren; andere Candidates/Replaceversuche fehlen. - -Eigene native Einbyte-API-Fixture `45a21a07-a115-47ec-93e1-694aa519520a`: -Nullbackupaufruf reproduziert ArgumentException, Quelle/Destination unverändert; -separater Aufruf mit explizitem Backup schreibt erwartete Destination und -Originalbackup. Keine Runtime-Datei wurde durch diese Fixture berührt. Die -genauere interne PowerShell-/Framework-Konvertierungsursache wird daraus nicht -als bewiesen behauptet. - -Der ursprüngliche Enter wird nicht erneut ausgeführt, Originalmarker und -Quellen nicht geändert. Eine separate create-only Recovery muss vor jeder -Fortsetzung diesen konkreten Vier-Dateien-/Frozen-/Nichtstartzustand bestätigen, -den existierenden ersten Candidate hashgeprüft erhalten und einen ausdrücklich -benannten zusätzlichen Nativebackup verwenden. Erst nach allen vier neuen -Datei-/ACL-/Frozenbelegen dürfen die bisher noch nicht versuchten eigenen -Helper-/Agentstarts folgen. Kein automatischer Retry oder Rücksetzen. - -## Tatsächliche enge Recovery und Abschluss - -Neue Quelle `deploy/windows/system_delegation_recovery.py`, SHA `64ced170…`, -Script `65e480f2…`, unabhängig geprüft und lokal Python-/PS-AST geprüft. Originale -Quelle `f8dc1c8f…` unverändert. Recoveryfall -`595dd1da-0d7f-4364-9040-a75e16c6da83` bestätigte separat den vollständigen -Stopped-/Frozen-/Datei-ID-/Candidatekontext und führte einmal vier Tausche mit -expliziten zusätzlichen Nativebackups durch. Alle vier neuen Dateien, ACLs und -Frozen-Datenbanken wurden vor dem ersten Start geprüft. Anschließend Helper, -danach Agent jeweils einmal gestartet; getrenntes Readback bindet dieselben -Phasen. Originalmarker und erste ArgumentException bleiben erhalten. - -Originales `finish` war danach ausschließlich lesend: zwei frische WSS- -Heartbeats, konkretes Inventar-ACK/fortgeschrittene Sequenz, gleicher Tenant/ -Geräteidentität und fremder Tenant verweigert. Journale/Dateiidentitäten/Zeilen, -Konfiguration und PKI-Metadaten erhalten. ZählerWindows0/0/0/0, Linux30/30/26/0 -und geschlossene Flags/Rootpolicy unverändert. Runtime-/Komponentenindex erst -nach diesen Belegen lokal per CAS veröffentlicht. Kein OS-Reboot, kein Job, -kein Binding oder neuer Clock-/Wirkungsgate; Intentdateien weiter0Byte. - -Tatsächlicher Agent `89004ad3…`, LocalService/Auto, PID8108, Geburtswert -`134391259111815072`; Helper `e6aacbdd…`, SYSTEM/Manual, PID2620, Geburtswert -`134391259068713651`. Policy `007adf5f…`, reziproker Pin `126670bc…`. -Privater Originalabschluss `result.json` SHA256 -`ac00411fe1e109b18b28fd9c020245f462c179bb3ac99a37b69c7cff39c38460`; -Recoveryabschluss `acceptance.json` SHA256 -`5ad5925c8928f49cd0f9d48a64f81018281b5b6e3704c799bae64a42898322bb`. - -Die positive Pipeprobe bleibt ausdrücklich fehlgeschlagen: tatsächlicher neuer -Agent meldet `client_read_reply`/`HELPER_PIPE_IO`, Win32233, kein authentisierter -Austausch und kein privater Helperdiagnosebeleg. Dies ist ein erfolgreicher -passiver Erhaltungs-/Wartungsnachweis, kein SYSTEM-Sync-/Job-/Clocknachweis. -Kein erneutes Enter oder Wiederverwenden der ursprünglichen Startbefehle. diff --git a/docs/windows-system-first-job-plan.md b/docs/windows-system-first-job-plan.md deleted file mode 100644 index 55a53ad..0000000 --- a/docs/windows-system-first-job-plan.md +++ /dev/null @@ -1,359 +0,0 @@ -# Erster SYSTEM-Auftrag: Voraussetzungen und eng begrenzte Vorbereitung - -Stand 16. November 2026. **Die spätere tatsächliche SYSTEM-Abnahme wurde -versucht und ist nicht bestanden.** Der einzige genehmigte Versuch bleibt -Unknown; ein Sharingfehler vor der Skriptdateianlage ist nativ belegt. -[Maßgeblicher aktueller Ergebnisstand](windows-system-script-first-attempt.md). -Die folgenden Voraussetzungen dokumentieren die vorherigen Schritte; -LocalService-PowerShell-Ergebnisse bleiben separate Nachweise. - -## Tatsächliche Installation und frische Bereitschaft am 16. November - -Die genau gebundene wirkungslose Fortsetzung des Falles eb285544 bestand um -14:31:06 UTC mit Exit0. Das ursprüngliche Intent blieb erhalten. Installiert -wurden ausschließlich die vier öffentlichen Policy-/Pin-/Qualifikationsdateien; -der bestehende SYSTEM-Helper wurde von Manual auf Automatic gestellt. Identität, -PKI-Metadaten, Originaljournale und Locks, Agentkonfiguration und Zeitprofil7 -blieben erhalten. Der Bootstrap führte keinen Job aus und startete keinen Dienst. -Die unabhängige tatsächliche Dateihash-/ACL-/SCM-Nachlese bestand um14:36:34UTC. - -Um14:39:05UTC wurden beide gebundenen Dienste genau einmal gestartet. Der Agent -lief unter LocalService alsPID8688, der Helper unter LocalSystem alsPID1304; -beide Starttypen Automatic. Eine frische rein lesende Nachprüfung um14:54:50UTC -belegt den echten authentisierten Helperkontakt mit dessen eigener qualifizierter -Uhr, korrektem Image0502d6c8/Policycfd126d3, ursprünglichen Ledger-/Lock-DateiIDs -und allen fünf SYSTEM-Skriptfähigkeiten. Der reguläre SignedSync war in -Generation215 ready/helper_ready, ohne vorbereitete oder unbestätigte Anwendung; -alle acht lokalen offenen Job-/Ereigniszähler waren0. Es wurde keine alte -Syncfreigabe verlängert oder administrativ ersetzt. - -Die frühere Probe14:40 meldete noch clock_qualified=false und keine Fähigkeiten. -Sie ist als eigener negativer Momentbeleg erhalten; ihre Ursache wird damit -nicht nachträglich als behoben bewiesen. Die spätere positive Probe ersetzt -keine durchgehend garantierte Bereitschaft und keinen frischen Jobstartcheck. - -**Noch offen:** zentralen zeitlich begrenzten Scope erst nach erneut frischer -Server-/Clientprüfung aktivieren, eigenständigen MCP-Plan persistent beantragen, -in der echten sichtbar simulierten WebUI genehmigen und genau eine tatsächliche -SYSTEM-Ausführung einschließlich Originalverbrauch/Start/Ergebnis nachweisen. -MSVC-Release und beide ausdrücklich erlaubten VM-Neustarts sind weiterhin -nicht ausgeführt. Die vorhandenen GNU-Binaries sind Entwicklungsartefakte. - -[Öffentliche tatsächliche Nachweise](evidence/windows-system-bootstrap-20261116.json). -Die folgenden Vorbereitungsabschnitte dokumentieren ihre jeweiligen früheren -Stände; obiger tatsächlicher Installationsstand hat für die Übergabe Vorrang. - -## Aktualisierung nach Pair7: konkrete Vorbereitung, keine Aktivierung - -Die späteren tatsächlichen Lesebelege vom 16. November liegen unter -`devstate/windows-system-job-bootstrap/80b99f94-d294-4148-8792-1e2473383963/read-only.json` -und `e29a7b62-2ef6-4add-9de8-518043236972/server-read-only.json`. -Sie ersetzen den unten ausdrücklich historischen Stand nicht: -Agent `d6302aa0…`, PID9084, LocalService/Auto; Helper `0502d6c8…`, PID10052, -LocalSystem/Manual. Originalsettings `3902a7d6…` bleiben Schema1, -`enable_effects=false`; Pin `4e098eb3…`. Der authentisierte reale Helperbeleg -bestätigt SID18, dieselben tatsächlichen Ledger-/Lock-FileIDs und eine eigene -qualifizierte Uhr; er behauptet keine bereits ausgeführte SYSTEM-Aktion. -Serverimage `a7fc4243…` auf beiden Rollen, keine SYSTEM-Flags oder -SYSTEM-Berechtigungen, null SYSTEM-Aufträge und null offene Windows-Aufträge. - -Zunächst bestanden auf der tatsächlichen Cloud-Linux-VM zwei gezielte -Domainverträge für explizite FullMaintenance-Identität/Capabilities und exakte -Skriptbytes. Danach bestanden auf Windows genau zwei bereits vorhandene, -wirkungslose JSON-/Policyverträge: - -- `helper_runtime::script_tests::system_script_success_requires_exact_profile_identity_bytes_and_raw_output`, -- `helper_system::tests::old_settings_omit_new_scope_and_only_v2_exact_recipe_hash_and_budget_allow_msi`. - -Jeder Fall meldete 1 bestanden, 0 Fehler, 0 ausgelassen. Öffentliche Original- -Ergebniszusammenfassungen: [Linux](evidence/windows-system-script-prerequisites-20261116-linux.json) -und [Windows](evidence/windows-system-script-prerequisites-20261116-windows.json). -Der zweite Windows-Test prüft auch die Abgrenzung alter Schema-/MSI-Konfiguration; -er installiert kein MSI und qualifiziert keine MSI-Wirkung. Alle vier Fälle -sind kontrollierte Unitprozesse, keine SYSTEM- oder PowerShell-Aufträge. - -Der aus dem **tatsächlich installierten Quellstand** gebaute Typ-Renderer -`0f5a4dbc…` wurde auf Windows mit ausschließlich öffentlichen Metadaten -tatsächlich ausgeführt. Er erzeugte die neue reine Skriptpolicy -`cfd126d383ec0a948a73270a8362bd835d79341a079be05ce50088f0dbc5791c` -und zugehörigen Pin/Qualifikationsbytes. NativePrerequisiteResult und alle -Originalquellen-/Nachweis-SHAs liegen unter -`devstate/windows-system-job-bootstrap/2fa63669-7e4d-4376-8735-78612a0c5388`. -Der Beleg heißt ausdrücklich `native_prerequisites_only`, -`target_job_executed=false`. Das ist Voraussetzung für einen ersten genehmigten -Test, kein vorweggenommener SYSTEM-Erfolg. - -Der vorbereitete Controller `APPLY_STOPPED` hält beide ursprünglichen nativen -Lebensdauersperren und verlangt gestoppte Originalprozesse, exakte Image-, -Settings-, Pin- und Aktivkonfigurations-CAS. Er erhält PKI-Metadaten, Journale, -ursprüngliche FileIDs und Zeitprofil; private Schlüsselbytes werden nicht -gelesen. Er publiziert ausschließlich die vier exakt gerenderten öffentlichen -Dateien und ändert separat nur den Starttyp des fest gebundenen Helpers von -Manual auf Automatic. Vorhandene Dienstkonten, Kommandos und ACLs bleiben -erhalten. Jeder Teilintent ist create-only; Teilfehler werden gelesen und -nicht blind wiederholt. Er startet keinen Dienst. Tatsächlicher PS5.1-AST- -Parser: null Fehler; die neuen nativen C#-Deklarationen wurden auf Windows nur -kompiliert, weder konstruiert noch ausgeführt. Dateiaustausch, Sperren und -Starttypänderung dieses Controllers sind damit noch nicht nativ abgenommen. - -Nach der koordinierten Anwendung müssen tatsächliche Auto-SCM-Konfiguration, -neue Rollen-/Prozessbeobachtungen, unabhängige Uhren und regulärer signierter -Sync erneut belegt werden. Profil7 bindet unveränderte Pair-Images; seine alten -Rollenbelege dürfen nicht als bereits gemessene Auto-Konfiguration ausgegeben -werden. Erst der neue tatsächliche Nachweis darf die zusätzliche -Starttypänderung bestätigen. Die vorhandene Runtime startet den Helper nicht -selbst; Automatic beseitigt diese konkrete Wiederanlauflücke. - -`deploy/windows_system_scope_server.py` ist ein getrennter, noch nicht -ausgeführter Root-Bootstrap ohne CLI-Dispatch. Er verlangt die exakten beiden -aktuellen Container und ihre erhaltene Compose-Dateikette, bestehende -Actor-/Berechtigungsbytes sowie einen frischen authentisierten Client mit -bereits tatsächlich qualifizierten SYSTEM-Skript-Capabilities. In einer -Transaktion werden nur den zwei fest gebundenen bestehenden Akteuren -`system:execute` hinzugefügt; keine Job-/Autorisierungszeile wird angelegt. -Er erhält alle bisherigen Compose-Overlays, Images, TLS- und Loopbackports; -nur die zwei SYSTEM-Variablen und ein geschützter read-only Policybind werden -additiv auf API und Gateway ergänzt. Die reine Skriptpolicy läuft spätestens -15 Minuten nach Vorbereitung ab. Fremde aktive Jobs verweigern den Schritt. -Teilwirkung bleibt erhalten und verlangt Lesen statt automatischen Retry. - -Das lokale Paket -`devstate/windows-system-job-bootstrap/8cde774e-46b8-40da-baa9-7d4ecdcbf5c1` -enthält vollständige öffentliche CAS-Inputs, beide Controller-SHAs, ro-Overlay, -Berechtigungsintent und den festen 30s-SYSTEM-Skriptentwurf mit Ausgabe -`Windows-System-MVP:S-1-5-18`. Es wurde **kein MCP-Antrag eingereicht**. -Zeitplan und 15-Minuten-Frist müssen beim tatsächlich koordinierten Schritt -frisch vorbereitet werden. Erst danach folgen ein eigenständiger persistenter -MCP-Antrag, echte simulierte WebUI-Genehmigung und native Einzelausführung. - -Die unabhängige Controllerreview verlangte zusätzlich einen vollständigen -Runtime-CAS beim Server-Recreate. Der neue rein lesende Spec-Modus bestand -danach tatsächlich auf dem Cloudserver: aktuelles Compose-Projekt und -Arbeitsverzeichnis wurden aus den vorhandenen Containerlabels übernommen; -User10001, vollständige Umgebungen ausschließlich im RAM, Entrypoint/Command, -Arbeitsverzeichnis, Loopbackports, Mounts/Binds, Netzwerke, Restartpolicy, -Namespaces, Devices und Sandbox stimmen mit der aufgelösten Konfiguration -überein. Die Normalisierung folgt dem bereits eingesetzten Deployment205- -Controller. Der bestehende strikte Gateway-Zeitquellenmount wurde mit seinem -tatsächlichen Long-Mount-Format erhalten (`Mode=""`, ausdrücklich `RW=false`), -nicht als neuer Short-Bind umgedeutet. Nach einem späteren Recreate muss dieselbe -Runtimeform mit ausschließlich zwei zusätzlichen SYSTEM-Variablen und genau -einem neuen read-only Policymount übereinstimmen. Native Lesebelege: -`devstate/windows-system-job-bootstrap/runtime-spec-read-only.json` und -`mounts-read-only.json`. Keine Container wurden dafür verändert. - -Die gleichzeitige tatsächliche lesende Mandantenzählung ergab 25 erfolgreiche, -4 fehlgeschlagene, 2 abgebrochene und 3 abgelaufene Aufträge; keine Unknown- -oder nichtterminalen Aufträge. Der entsprechende Guard wurde nicht gelockert. -Die Windows-Stopped-Prüfung verlangt weiterhin originale PID-/Creationzeugen -und deren beendeten Prozess sowie SCM-Stopped, jedoch keinen SCM-ProcessId0: -dieser Wert ist nach Stopped kein gültiger Prozessbeleg. Die koordinierende -Wartung muss die originalen Prozesshandles mit bestätigtem Exit vor dem -Bootstrapaufruf halten/nachweisen; bestehende Lebensdauersperren werden danach -erneut exklusiv gehalten. Diese Härtungen aktivierten keine Policy und -änderten keine Dienstkonfiguration. - -Vor einem tatsächlichen Apply fand die Rootreview einen Bootstrapfehler: -PowerShell zählt `@($null)` als ein Element. Die alte pauschale MSI-Countprüfung -hätte deshalb das vom echten Rust-Renderer korrekt ausgelassene optionale -Feld verweigert. Der enge Fix prüft zuerst die Propertyanwesenheit: fehlend -oder ein tatsächlich leeres Array sind zulässig, explizites null, String und -nichtleere Rezeptliste bleiben entsprechend dem strikten Rust-Typ verweigert. -Auf Windows bestand ausschließlich die öffentliche Objekt-/Prädikatsprobe: -originales CFD-Settingsobjekt angenommen, leeres Array angenommen, drei falsche -Formen verweigert; Prädikatsparser null Fehler. Der erste überlange Inline- -Prüftransport wurde schon vom SSH-Exec-Kanal abgewiesen; erst die gekürzte -wirkungslose Probe lief tatsächlich. Kein SDK-/Dienst-/Policy-/Datei-Apply -folgte daraus. Öffentlicher Beleg: -[Prädikatsprüfung](evidence/windows-system-optional-msi-predicate-20261116.json). - -Der erste spätere tatsächliche Apply-Aufruf durch den koordinierenden Rootagenten -verlor seine Textantwort wegen einer Decodierungsstörung. Er wurde nicht -wiederholt. Der anschließende tatsächliche Readback bestätigte ausschließlich -`intent.json` im Fall eb285544; Settings3902, Pin4e098, Konfiguration5cd, -Zeitprofil04cc3b58 blieben erhalten, beide Qualifikationsziele fehlten weiterhin, -Helper Manual und beide RMM-Dienste gestoppt. Es war noch kein Kandidat -publiziert oder installiert worden. - -Die enge Ursachenprüfung auf Windows ermittelte: Der siebenparametrige -FileStream-Konstruktor ist vorhanden, aber `FileSystemRights.ReadWrite` ist kein -Enumwert. PowerShell lieferte null beziehungsweise als Integer0. In einem -eigenen privaten Probeordner scheiterte exakt diese alte Konstruktion vor -Dateianlage. `FileSystemRights.Read -bor FileSystemRights.Write` lieferte131487; -derselbe Konstruktor erzeugte und flushte12 öffentliche Probebytes. Tatsächlicher -Owner/DACL entsprachen dem beabsichtigten atomaren Verfahren: BA-Owner, -geschützte DACL, SYSTEM/Administratoren FullControl und beide echten Service-SIDs -ReadAndExecute. Das atomare Anlegen mit FileSecurity bleibt erhalten; kein -alternativer ungeschützter Dateischreibpfad wurde eingeführt. - -Die neue, **noch nicht ausgeführte** Fortsetzung verlangt ausdrücklich -`-ResumeNoEffectEb285544` und ausschließlich den unveränderten Fall -`eb285544-3714-43e4-872e-5e43b75b9794`. Ohne Schalter verweigert ein bestehender -Fall weiterhin jede Anwendung. Nur ein einziges vorhandenes `intent.json`, dessen -rohe SHA256 und die identische erneute PS-Serialisierung des Originalpayloads -`4c3019b04a92dd080590d4b157b7c975f26ae9874b29c6f0dcd75c36d35d9ef5` -müssen übereinstimmen; dazu die festen ursprünglichen Dateien, Schema1/effectsfalse, -Images, Konfiguration, Zeitprofil, beide gestoppten Rollen und ursprünglichen -Lebensdauersperren. Der Bytevergleich mit der tatsächlich gestagten b9a-Datei -bestand nativ lesend. Jede zusätzliche Datei oder Zieländerung verweigert diese -Fortsetzung. Sie erhält das alte Intent unverändert und legt vor Kandidaten -einen neuen einmaligen Resumeintent und einen tatsächlichen -Preservation-Metadatenbeleg an. Es gibt keinen allgemeinen Wiederholungsmodus. - -Künftige Fehler nach Eintritt hinterlassen einen create-only ASCII-Fehlerbeleg -mit festem Code, Phase, Exceptiontyp und HResult, ohne Fehlermeldungsinhalt oder -Geheimnisse. Sie lösen weder Retry noch automatisches Zurücksetzen aus. Der -vollständige neue Quelltext bestand den tatsächlichen PS5.1-AST-Parser mit null -Fehlern; er wurde dabei ausschließlich im Speicher dekomprimiert/geparst, nicht -ausgeführt. Öffentlicher enger Nachweis: -[Konstruktorprobe und ursprünglicher wirkungsloser Fall](evidence/windows-system-filestream-no-effect-20261116.json). - -## Tatsächlich lesend geprüft - -Der bestehende bestätigte SSH-Entwicklungstransport wurde mit -`deploy/windows_system_job_bootstrap.py inspect` ausschließlich lesend genutzt. -Originalbeleg: -`devstate/windows-system-job-bootstrap/db480794-b2f3-47fa-ba8c-d599f09ca50a/read-only.json`. - -- Agent `9651b2e518b3…`, PID 3956, konfigurierte SCM-Anmeldung LocalService. -- Unveränderter Helper `59675a3cbb3a…`, PID 8084, SCM-Anmeldung LocalSystem. -- Tatsächliche `helper.json`: Schema 1, `enable_effects=false`, - `allow_reboot=false`, leere Dienstliste, kein Skriptprofil. -- Settings-Rawhash `4c073cd3d4badb09d8c0f1c270b4cee9df533df416550f68bf3e336e3da7673c`; - Agent-Pin-Rawhash `9d46dffe88f565b8b04554335d9669f5c83211b32419908a579b1cd4560443ec`. -- `system-qualification.json` und `system-native-result.json` fehlen. -- Der tatsächliche Agent-Probenbeleg um 10:37:44 UTC bestätigt die beidseitig - authentisierte Pipe, denselben Agentprozess, Helperimage/Policy, SYSTEM-SID 18 - und bestehende Ledger-/Lock-Datei-IDs. Er meldet jedoch ausdrücklich - `helper_clock_qualified=false`, `helper_ready=false` und keine qualifizierten - SYSTEM-Capabilities. Dies ist kein positiver Zeit-/Jobbereitschaftsnachweis. - -Der getrennte Serverread (`inspect-server`) liegt unter -`devstate/windows-system-job-bootstrap/a39e7b13-bb2d-400a-a0fd-aad3ee460702/server-read-only.json`. -API-Image `c4c869114a60…` und Gateway `422c2c28a91a…` führen das explizite -Developmentprofil mit `https://localhost:18443` als UI-Origin. Beide haben -**keine** `RMM_DEV_SYSTEM_ENABLED`-/`RMM_DEV_SYSTEM_POLICY_FILE`-Freigabe. -Die vorhandene Automation `automation:11111111-1111-4111-8111-111111111111` -und `simulated-testprincipal-a` besitzen `scripts:execute`, aber beide noch -kein `system:execute`. Für den Windowsgast bestehen zwei Aufträge, null -SYSTEM-Aufträge und null offene Aufträge. Der gespeicherte normale Sync ist -bereit; das ersetzt den oben ausdrücklich negativen nativen Zeitbeleg nicht. -Keine Zugangsdaten, Tokens oder privaten Schlüssel wurden gelesen/exportiert. - -## Was die erste Qualifikation besagt - -Der Capabilityvertrag verlangt vor einem SYSTEM-Job einen administrativ -provisionierten nativen Qualifikationsbeleg, tatsächliche geschützte Settings, -einen aktuellen authentisierten Helper und eine qualifizierte Uhr. Dieser -Beleg ist die **Voraussetzung für einen ersten genehmigten Test**, nicht dessen -vorweggenommenes Ergebnis. Die neue Vorbereitung unterscheidet ausdrücklich: - -- `scope=native_prerequisites_only`, -- `source=operator_reviewed_native_units_and_peer`, -- `target_job_executed=false`, -- nur `validated_actions=["run_script"]`, -- genaue tatsächliche Agent-/Helperhashes und ursprüngliche Beleg-SHA-Referenzen. - -`status=passed` darf ausschließlich die tatsächlich geprüften nativen -Unit-/OS-/Peer-Voraussetzungen bezeichnen. Es darf nicht aus einem bloßen Build, -SCM-Kontonamen oder einem noch negativen Zeitbeleg erfunden werden. Die erste -SYSTEM-Ausführung wird später unter eigenem Job-/Versuchs-/Grant-/Auditbezug -nachgewiesen. Aktuelle Uhr und normaler beidseitiger SignedSync bleiben -unabhängige laufende Gates. Ein Qualifikationsfile schafft keine Ready-Lease, -keine Jobgenehmigung und keinen Startgrant. - -## Konkrete neue Quellen - -`crates/agent-windows/examples/windows_system_policy_prepare.rs` liest nur einen -begrenzten öffentlichen JSON-Eingang von stdin. Es deserialisiert die echten -vorhandenen Settings mit dem **tatsächlichen Rust-Typ** `helper_system::Settings`, -prüft den passiven Ausgangsstand und erzeugt Settings/Pin/Policyhash mit dessen -regulärem `validate`, `policy_sha256` und `pin`. Keine PowerShell-JSON-Reihenfolge -wird als kanonischer Policyhash ausgegeben. - -Der einzige erste Zielzustand ist: - -```json -{ - "schema_version": 3, - "allowed_services": [], - "max_runtime_seconds": 30, - "enable_effects": true, - "allow_reboot": false, - "allowed_script_profiles": ["full_maintenance_v1"] -} -``` - -Dies ist ein Ausschnitt; Binding, beide Peeridentitäten und die tatsächlichen -Imagepfade bleiben Bestandteil der vollständig validierten Settings. MSI wird -nicht konfiguriert. Der Agent-Binärpin muss zum tatsächlich installierten neuen -Agenten passen, der Helper bleibt zunächst `59675…`. Der administrative -Qualifikationsbeleg bindet genau diesen Policy-/Code-/Ergebnisstand. - -Der Pythoncontroller bietet lesende VM-/Serverprüfung und lokale -Paketvorbereitung. Die getrennte Konstante `APPLY_STOPPED` ist ein konkret -reviewbarer Bootstrapquelltext, **nicht automatisch vom CLI aufgerufen**. -Sie verlangt bereits quieszent gestoppte Agent-/Helperdienste und den beendeten -ursprünglichen PID-/Creationzeugen, prüft erneut tatsächliche Binär- und -Originalsettings-/Pinhashes und schreibt create-only einen eigenen privaten -Vorgang. Settings und Pin werden unter Erhalt der alten Dateien ausgetauscht; -Qualifikation und natives Voraussetzungsergebnis werden neu angelegt. Nur -SYSTEM/Administratoren dürfen schreiben, die beiden festen Service-SIDs lesen. -Es gibt keine PKI-/Ledger-/Konfigurationsreparatur und keinen Dienststart durch -diesen Quelltext. Bei Teilfehler oder verlorenem Reply ausschließlich denselben -Vorgang nachlesen; kein zweiter Apply und kein blindes Zurücksetzen. -Der Rootkoordinator muss zusätzlich die vorhandenen Journal-/Datei-ID-Zeugen -vor und nach dem Dienstwechsel unabhängig nachlesen. - -Der PowerShell-Parser auf der tatsächlichen VM hat diesen Quelltext geprüft: -**0 Syntaxfehler**, `parse_only=true`, `target_mutations=false`. Er hat den -Bootstrapinhalt dabei nicht ausgeführt. Beleg `controller-parser.json` im -ursprünglichen lesenden VM-Fall. Python-Syntaxprüfung bestand. Der tatsächliche -Windows-GNU-Check des Rust-Renderers bestand; die strengere Clippyprüfung war -zunächst durch noch nicht verbundene parallele Updaterhandler blockiert. -Diese Warnungen werden nicht unterdrückt und nicht als grüner Lauf ausgegeben. - -## Zentrale Begrenzung und tatsächliche erste Ausführung - -Die Vorbereitung erzeugt eine feste Developmentpolicy mit Schema 3, genau dem -vorhandenen Tenant/Asset/Agent, Generation 1/Assignment 1, beiden bestehenden -Prinzipalen, den tatsächlichen Helper-/Policyhashes und höchstens 30 Sekunden -Laufzeit. Die Policy erlaubt nur das explizite Full-Skriptprofil. Dienstliste -leer, keine MSI-Rezepte und kein Rebootfeld. Die separat befristete Policy gilt -15 Minuten und ist weiterhin keine Genehmigung. - -Der Koordinator muss ausschließlich den beiden bestehenden Mitgliedschaften -`system:execute` hinzufügen, alle bisherigen Rechte/Rollen erhalten und der -Automation niemals `plans:approve` geben. Vor jedem SQL-CAS die tatsächlichen -alten Rechte und unveränderte Widerrufszustände prüfen. Diese administrative -Rechteprovisionierung ist getrennt vom unveränderlichen Jobplan und wird nicht -als Jobgenehmigung dargestellt. - -Sowohl API als auch Gateway brauchen denselben geschützten read-only -Policy-Mount und ausschließlich: - -```text -RMM_DEV_SYSTEM_ENABLED=true -RMM_DEV_SYSTEM_POLICY_FILE=/system-policy/policy.json -``` - -Der Dateibesitzer muss dem tatsächlich per `stat` geprüften Besitzer von -`RMM_JOB_KEY_FILE` entsprechen; Modus 0600 und sichere Elternverzeichnisse sind -Pflicht. Dafür wird nur Schlüsselmetadatum gelesen. Bestehende Image-/Zeitbroker- -Overlays, TLS, Loopbackports, Root-/APT-Policies und Datenbank werden erhalten. -Diese Vorbereitung schaltet weder OIDC noch öffentliche Verwaltungsports frei. - -Erst nach tatsächlichem Dienstwechsel, frischen getrennten Zeitbelegen, -normalem SignedSync, authentisierter neuer Helperprobe und den exakt gespeicherten -SYSTEM-Skriptcapabilities wird der erste feste PowerShell-Identitätstest per -MCP beantragt. Er bleibt bis zum tatsächlichen sichtbar simulierten -WebUI-Klick `pending_approval`. Prozessprofil `powershell_51_remote_signed`, -explizite SYSTEM-Identität und `full_maintenance_v1` werden vorher angezeigt. -Danach müssen echte SID 18, exakte Ausgabe, einmaliger ursprünglicher Verbrauch/ -Start, finales Originaloutcome und `testsimulation`-Audit unabhängig gelesen -werden. Erst das ist die erste SYSTEM-Jobabnahme; danach dokumentieren und pushen. - -SCM- und MSI-Qualifikation folgen jeweils als eigene Erweiterung mit wirklichen -Dienst-/Rezeptpins und eigenen WebUI-Plänen. Sie werden weder aus dem -Skriptprofil noch aus einer Paket-Bauprüfung abgeleitet. Ein Reboot ist kein -Nebeneffekt dieses Schritts. diff --git a/docs/windows-system-helper-bootstrap.md b/docs/windows-system-helper-bootstrap.md deleted file mode 100644 index 3aabc65..0000000 --- a/docs/windows-system-helper-bootstrap.md +++ /dev/null @@ -1,97 +0,0 @@ -# Passiver SYSTEM-Helper: Installation und echter Agent-IPC-Nachweis - -Stand 2026-11-14: Featureagent nativ21+6 qualifiziert und erhaltend aktualisiert, -Helper im Fall `59c2fd6f-0503-46fd-88f3-985bca376c51` installiert und einmal -gestartet. Tatsächlich LocalSystem/Manual/PID6240, Helper `921cf182…`, eigene -Service-SID, geschütztes Ledger/Lock, leere Aktionsliste, Wirkungen und Reboot -gesperrt. Der echte unveränderte LocalService-Agent PID5140 meldet jedoch -`HELPER_NOT_AVAILABLE`: `verify-peer` ist fehlgeschlagen. **Kein positiver -Pipe-/Readiness-/Wirkungsnachweis.** Die21 nativen Helper-/Bibliothekstests -bleiben ein getrennter Unit-Nachweis aus dem Administrator-Bootstrap. - -Der optionale Build `system-helper` erkennt ausschließlich die geschützte Datei -`C:\ProgramData\RustDiscoverySystem\agent-pin.json`. Die bestehende sechsstellige -Agentkonfiguration bleibt erhalten. Fehlt der Pin, bleibt der Client passiv. -Ungültige, entfernte oder während einer Operation geänderte Pins schließen die -Sync-/Startgrenze. Die öffentliche Signierbindung im Pin ermöglicht keine -Enrollment-/Jobfreigabe und aktiviert nicht `enable_jobs`. - -Die Probe wird im tatsächlichen Agentdienst ausgeführt. Eine gemeinsame, einzelne -Blocking-Lane begrenzt die Pipeaufrufe auf fünf Sekunden; Probe, Snapshot und -Original-Apply haben separate Taskzustände. Die Session holt nur abgeschlossene -Tasks ab und bedient währenddessen Heartbeats und Nachrichten. Der Pin wird vor -und nach der authentifizierten Operation erneut geprüft. Snapshot und Apply -verwenden die bestehenden unabhängigen Helper-/Agent-Sync-Kerne mit expliziter -Identität `system`, unveränderten signierten Entscheidungsbytes und dem -ursprünglichen protobuf-SyncRequest. Erst `confirm_helper` bestätigt den genauen -angewendeten Checkpoint. Diese Integration enthält keine Execute-Route und -bewirbt keine SYSTEM-Fähigkeit. Die unqualifizierte Windows-Uhr bleibt geschlossen. - -Ein aktueller, höchstens 8 KiB großer Beleg liegt privat als -`state\helper-probe.json`. Er enthält die echte Agent-PID, die gebundene -Helperidentität, Challenge und die vom Helper übermittelten Windows-Datei-IDs von -Ledger und Lock. Ein fehlgeschlagener Aufruf ersetzt einen vorherigen Beleg durch -`authenticated_pipe_exchange=false`. Es gibt kein wachsendes Archiv pro Heartbeat. -Eine einzige create-only Stagingdatei begrenzt auch unterbrochene Schreibvorgänge; -ein Überbleibsel nach Prozessabbruch wird nicht überschrieben. Der Zeitstempel -dient nur der Abnahmefrische, niemals als vertrauenswürdige Jobuhr. - -## Native Reihenfolge und verbleibender Nachweis - -Schritte1–5 wurden tatsächlich ausgeführt. Schritt6 wurde ausgeführt und -scheiterte; der Fehlerbeleg bleibt unverändert erhalten. Neue Diagnosekontrollen -sind eine eigene Quellqualifikation und noch kein erfolgreicher Nachweis. - -1. Einen neuen Agentbuild mit `system-helper` nativ qualifizieren und den - bestehenden Agenten identitätserhaltend aktualisieren. Der maßgebliche - `devstate/windows-client/current-runtime.json` und sein gehashter tatsächlicher - Upgradebeleg müssen beide `system_helper_client_feature=true` ausweisen. - Der bisherige passive Build `f64e8115…` reicht dafür nicht aus. -2. Der Eltern-Orchestrator erstellt aus der öffentlichen Servermetadatenbindung - eine private lokale JSON-Datei mit ausschließlich Tenant-/Asset-/Agent-ID, - Generation, Assignmentversion und öffentlichem Signierschlüssel. Keine Tokens, - Geräte- oder privaten Signierschlüssel übertragen. -3. `deploy/windows/system_helper_bootstrap.py prepare` prüft den aktuellen - Runtimebeleg, die 21 tatsächlich bestandenen Unitprüfungen und das damit - zugeordnete unveränderliche Helperartefakt `921cf182…`. Anschließend werden - ausschließlich diese EXE und der gehashte feste Bootstrapquelltext bereitgelegt. -4. `install --case …` legt genau einmal den eigenen Manual-/OWN_PROCESS-Dienst - `RmmDiscoverySystemHelper` als LocalSystem mit unrestricted Service-SID an. - Public-Policy und Pin sind nur für SYSTEM/Administratoren schreibbar und für - beide Dienst-SIDs lesbar. `state` erlaubt ausschließlich - SYSTEM/Administratoren/Helper-SID; der Netzwerkagent erhält keinen Ledgerzugriff. - Die Policy enthält `allowed_services=[]`, `enable_effects=false` und - `allow_reboot=false`. Keine Fixtures, Time-Service-, Recovery- oder - Agentkonfigurationen werden verändert. -5. `start --case …` startet ausschließlich diesen neuen eigenen Dienst genau - einmal. Der laufende LocalService-Agent entdeckt den Pin selbst; kein zusätzlicher - Agentneustart erfolgt. Unklarer SSH-Ausgang oder Startfehler erlaubt ausschließlich - `readback`, keinen erneuten Installations-/Startversuch und kein Ledgerreset. -6. Nach einer normalen periodischen Agentprobe liest `verify-peer --case …` den - frischen aktuellen Dienstbeleg. Es vergleicht dessen echte Agent-PID mit dem - erhaltenen SCM-Prozess, beide Rollen/Service-SIDs, Helperimage, Policy und - Dateiidentitäten. Die beidseitige Kernel-/SCM-/Token-/Imageprüfung stammt aus - den beiden echten Diensten; ein Administrator-SSH-Pipeaufruf ist kein positiver - Nachweis. Uhr, HelperReady und Systemfähigkeiten müssen weiterhin geschlossen sein. - -Alle lokalen und entfernten mutierenden Phasen schreiben vorher create-only -Intents. Bekannte Belege und private Helperzustände werden erhalten. Der Runner -führt keine Servermutation, RMM-Jobs, Freigabe, Reboots oder Kunden-Dienstwirkung -aus. Die WebUI-Genehmigungsgrenze bleibt für spätere tatsächliche Jobs bindend. - -## Tatsächlich ausgeführte lokale Prüfungen - -- Windows-GNU-Clippy mit `-D warnings`, sowohl Default als auch `system-helper`, - für Bibliothek, Agentbinary und Tests: bestanden. -- Python-Syntaxprüfung und drei fokussierte Guards: bestanden. Abgedeckt sind die - leere passive Policy, der dokumentierte Service-SID-Vektor, das Verbot einer - wiederholten Mutation nach verlorenem SSH-Reply und die Ablehnung fremder, - veralteter oder fälschlich Ready meldender Probe-Belege. -- PowerShell-Parser für Haupt-, Stage-, Launch- und Uploadquelltext: bestanden. -- Keine dieser lokalen Prüfungen ersetzt die oben noch ausstehende native Strecke. - -Der deterministische Service-SID folgt -[MS-LSAT 3.1.1.1.2](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lsat/252cb6b0-2edc-4403-9d75-5b2786ba859e); -nach CreateService prüft der Bootstrap zusätzlich die tatsächliche lokale -Windows-Auflösung. Weiterführende offene Windows-Abnahmen stehen in -[windows-remaining-implementation.md](windows-remaining-implementation.md). diff --git a/docs/windows-system-nonstart-221-progress.md b/docs/windows-system-nonstart-221-progress.md deleted file mode 100644 index 3f7368e..0000000 --- a/docs/windows-system-nonstart-221-progress.md +++ /dev/null @@ -1,129 +0,0 @@ -# Freigegebener SYSTEM-Nichtstartabschluss221: tatsächliche Teilschritte - -**Fortsetzung bestanden, 16. November20:21UTC:** Der native221-Abschluss und -seine getrennteNachprüfung sind mitExit0 bestanden. OriginalUnknown erhalten, -physischesEvent1/aktiveQueue0. KorrigiertesPaar ist jetzt passiv installiert -und beideDienste laufen; noch kein neuerSYSTEM-Auftrag. -[Aktueller genauer S0–S2-Nachweis](windows-system-s0-s2-results.md). -Die folgenden Fehler-/Stopberichte bleiben historische Originalbelege. - -16. November2026. Der Betreiber hat den konkreten Abschluss und anschließend -einen neuen MCP-/WebUI-SYSTEM-Auftrag ausdrücklich freigegeben. Spezifikation1.29 -und [der konkrete Ablauf](windows-system-script-nonstart-221-proposal.md) gelten. - -## Aktuell: zwei Anwendungen zurückgerollt, Abschluss weiterhin offen - -Stand 18:11 MEZ. [Aktueller Abschlussplan](mvp-completion-plan.md) und -[frische reine Leseprüfung](evidence/mvp-status-audit-20261116.json). -Beide Originaldienste sind Stopped, Images `d630…`/`0502…` unverändert installiert; -SSH und Reverse-Tunneltask Running. Zentral ist der Originaljob unknown/Revision 2, -es gibt 1 Review und 2 Quittungen; kein erfolgreicher Zusatzabschluss. - -Nach dem unten beschriebenen erstenRollback wurde eine neue tatsächliche -WebUI-Quittung `6864da37…` um 17:51:30 MEZ bestätigt. SDK `3b4ef6f5…` korrigierte die -Cacheprojektion und prüfte alle Abschlussinvarianten vor dem ersten Commit. -Seine einmalige Anwendung um 17:52:54 MEZ brach mit Exit 1 und -NONSTART_APPLIED_RETAINED_EVENT_PROJECTION ab. Sämtliche drei Transaktionen -wurden zurückgerollt; unabhängiger Zeuge danach erneut exakt `b92a51bb…`, -alle vier Datenbankinventare und sechs physischen Originalhashes/IDs unverändert. -Keine Rolle gestartet und kein alter Grant erneut verwendet. - -Die konkret noch aktive Ereigniszeile ist der ursprüngliche 337-Byte-Platzhalter -mit Message `6844ae6d…`/Envelope-SHA `6907fdbb…`/Revision 1 und -SYSTEM_DELEGATION_REQUIRES_HELPER_SNAPSHOT. Sie ist nicht der endgültige -Helper-Unknown mit Revision 2. Der engere Fix bindet Nachricht, vollständigen -Envelopehash, Metadaten und signiertes Originalinventar; nur die aktive -Queueprojektion wird geschlossen, die physische Originalzeile bleibt erhalten. -Der tatsächliche Cloud-Linux-Vertrag für diesen Fix bestand. SDK `66c156ce…` ist -lokal für Windows gebaut, **noch nicht auf die VM übertragen und dort geprüft**. -Das ältere Paar `fcbc719b…`/`ca5fbbd4…` enthält diesen letzten Fix noch nicht. - -Beide abgelaufenen Quittungen sind privat erhalten; aktive Eingangsdatei -`system-nonstart-221-receipt.json` fehlt. Erst vollständig vorbereitete und -qualifizierte Werkzeuge, dann eine neue tatsächliche WebUI-Quittung, ein -Anwendungsversuch und unabhängige Nachprüfung. Keine Erfolgs-/Readybehauptung. -Dieser Statusabschnitt dokumentiert bereits ausgeführte frühere Schritte; -das aktuelle Audit selbst führte keine Anwendung/Tests oder Zieländerungen aus. - -## Originalprozess und Journale tatsächlich gesichert - -Der tatsächliche native reine Lesezeuge bindet OriginalHelperPID1304, -Start-FileTime134393135436289391, Image0502d6c8 und dessen tatsächliche -SCM-/Kernel-/Token-/Service-SID-Identität jeweils vor und nach der Aufnahme. -Der bestehende Writerhandle ist unabhängig durch ShareRead→Error32 und -ShareRead|Write→Open nachgewiesen. Zustandsverzeichnis-DateiID sowie die exakten -ursprünglichen beiden221Requests, Envelopes, signierten Antworten, beide -Start-/Unknown-Outcomebytes, Intent und Offer sind privat unveränderlich -archiviert. Originalsignaturen wurden nativ geprüft. Beide alten Outcomehashes -bleiben1f284b66…; kein Execute oder neuer Job wurde ausgeführt. - -Um16:45:33MEZ wurden beide Originaldienste kontrolliert gestoppt. Der Bootstrap -hielt die Prozesshandles von Agent8688 und Helper1304 mit ihren exakten -ursprünglichen Startzeiten, prüfte die ursprünglichen Imagehashes und bestätigte -den tatsächlichen Exit beider Prozesse. Keine Force-Option, SQL-Änderung oder -Jobausführung. Beide SCM-Zustände sind Stopped; der separate SSH-Zugang lebt. -Der normale Dienststopp darf eigene Zustandszeilen schreiben; der Bootstrap -schrieb keine Journalzeilen und stellt keine unveränderten ganzen DB-Dateibytes -über einen laufenden Dienststopp hinweg in Aussicht. - -[Öffentlicher Live-/Stopbeleg](evidence/windows-system-nonstart-221-live-stop.json). -Der exakt verwendete [Stopquelltext](../deploy/windows/Stop-OriginalNonstart221Pair.ps1) -bleibt über seinen SHA mit dem tatsächlich verwendeten öffentlichen Payload -gebunden. Keine Zugangsdaten oder privaten Schlüssel wurden exportiert. - -## Server und tatsächliche WebUI bestätigt; erste Anwendung zurückgerollt - -API und Gateway betreiben seit17:23:40MEZ Imagef0f3b791… und Migration21. -Die eingefrorene Closure basiert auf dem tatsächlich vorher betriebenen -Server205-Quellstand mit ausschließlich zehn Änderungen für diesen Fall. -Ein zunächst eingesetzter Standb540… scheiterte bei der UI-Einreichung an -unzulässigen FOR-SHARE-Sperren auf unveränderlichen Tabellen. Drei unnötige -Sperren wurden entfernt. Der tatsächliche isolierte rmm_app-Rollenvertrag -reproduzierte die alten42501-Fehler und bestätigte die korrigierten Lesepfade; -keine UPDATE-Rechte oder Unveränderlichkeitstrigger wurden geändert. - -TLS-/401-Prüfung, tatsächliche Laufzeitkonfiguration, Loopbackports und -Sandbox bestanden. Datenbankcontainer, Chrony, Broker, Schlüssel-/Policy- -Metadaten und sämtliche Job-/Grant-/Autorisierungszahlen blieben unverändert. -Der Nichtstartzeuge wurde tatsächlich in der sichtbar simulierten WebUI -eingereicht und die administrative Quittung4e2fdd7d… um17:29:23MEZ bestätigt. -Sie genehmigte keinen Auftrag und meldet ready/helper_ready/unlock=false. - -Zusätzlich zu den ausgewählten Originalbelegen wurden alle vier Original- -SQLite-Dateien und beide Lockdateien mit exakten Witness-Hashes in ein -separates nur für SYSTEM/Administratoren zugängliches VM-Archiv kopiert. -Die Originaldateien blieben dabei unverändert. Der tatsächliche reine -Receiptvertrag bestand zuerst isoliert auf CloudLinux und danach auf Windows: -valide Signatur und Originaldaten angenommen; falsche Signatur, falscher -lokaler Grant und falsche lokale Originalbytes verweigert. Keine Produktdatenbank -oder Wirkung war Bestandteil dieser Vertragsprüfungen. - -Der einmalige native Anwendungsversuch49b3… endete um17:31:46MEZ mit Exit1/ -ROOT_ROW_CHANGED_WITHOUT_SNAPSHOT: Nach dem abgeleiteten Abschluss war die -interne helper_sync_rows-Projektion noch nicht aktualisiert. Sämtliche drei -Transaktionen wurden zurückgerollt. Ein neuer unabhängiger nativer reiner -Lesezeuge ergab danach wieder exakt denselben kanonischen Witnesshashb92a…, -alle vier Inventare und alle sechs physischen Filehashes und IDs unverändert. -Keine Rolle wurde gestartet und kein alter Grant erneut verwendet. - -Der eng korrigierte Operatorpfad muss die normale abgeleitete Projektion -gezielt aktualisieren und alle Abschlussprüfungen bereits vor dem ersten -Commit bestehen. Die zusätzliche unabhängige Nachprüfung bleibt erforderlich. -Der erste Versuch und seine abgelaufene Quittung bleiben erhalten. Eine neue -Anwendung folgt ausschließlich nach belegtem wirkungslosem Rücklauf, korrigiertem -Werkzeug und neuer tatsächlicher WebUI-Bestätigung für denselben unveränderten -Witness. Die zwei normalen SignedSync-Unlockpfade müssen ebenfalls das signierte -Zusatzresultat lesen und die ursprünglichen Unknownbytes erhalten; bloßes -Maskieren in einem Snapshot reicht nicht. Der entsprechende Runtimezwischenbau -0db51c10/1c334ea8 ist deshalb noch nicht auf der VM installiert. - -[Öffentliche tatsächliche Ergebnisse](evidence/windows-system-nonstart-221-server-ui.json). - - -## Noch nicht als abgeschlossen ausgewiesen - -Die erfolgreiche native Anwendung des administrativen WebUI-Belegs und ihre -unabhängige Nachprüfung stehen noch aus. Ebenso fehlen die Installation des korrigierten -Paares, dessen frische eigene Zeit-/SignedSync-Belege sowie der neue tatsächliche -WebUI-genehmigte SYSTEM-PowerShell-Erfolg. Der ursprüngliche Auftrag bleibt -bis zum belegten Zusatzabschluss Unknown. Andere MVP-Arbeiten bleiben angehalten. diff --git a/docs/windows-system-pipe-drain.md b/docs/windows-system-pipe-drain.md deleted file mode 100644 index d5c315a..0000000 --- a/docs/windows-system-pipe-drain.md +++ /dev/null @@ -1,53 +0,0 @@ -# Windows-Pipe v2: tatsächlicher Unitnachweis - -Dieser Ergebnisnachtrag ergänzt den unveränderten, im Buildmanifest gebundenen -[Framing-/Drain-Entwurf](windows-helper-pipe-drain.md). Der Entwurf bleibt als -historischer Quellenstand erhalten; dieser Nachtrag verändert weder seinen Hash -noch das ursprüngliche Manifest. - -## Tatsächlich auf Windows bestanden - -Root führte im eigenen nativen Fall -`db25cd4a-bfd2-45d5-9f80-1881950853f7` die beiden konkreten Testprogramme des -Pipe-v2-Packs aus. Beide vollständigen nativen Listen wurden vor irgendeinem -Unitfall exakt geprüft. Alle23 Libraryfälle und alle7 Binaryfälle bestanden; -kein Fall war fehlgeschlagen, ignoriert oder gefiltert. Beide Listenprozesse -und beide Testprozesse endeten mit Exit0 ohne Timeout. Die gemeldete Testdauer -betrug2,76s für die Library und0,07s für das Binary. - -| Gebundener Beleg | SHA256 | -| --- | --- | -| Neues Pipe-v2-Buildmanifest | `b2f77713a4f70deddb6472fb1e869a85443ce1028914f62ccee71f8001fbadb4` | -| Tatsächlicher Native-PASS | `19a8ccd95b7225f7e8657a696055bea4b52ed2f80f6caa3f42c9396ce6272713` | -| Begrenzter Unitrunner | `2ac6bd55e608e7dbb0f0cf65cf37e7bbccc42b862d09c50b37e9162f29f4bbdf` | -| Library-Lieferdatei | `3fc2b7314d755f5c5235c8383cf605cbe848180180497bb30540482f4910c2a1` | -| Binary-Lieferdatei | `a3b8f44e87df7af54f82c1d052753217e9a03c495fb28c8a16ba9fe7e1a0af23` | - -Geschützter nativer Beleg im isolierten Pipeworktree: -`devstate/windows-client/native-pipe-v2/db25cd4a-bfd2-45d5-9f80-1881950853f7/passed.json`. -Das zugehörige unveränderliche Buildmanifest liegt unter -`devstate/windows-pipe-drain-build/build-59623db2-15ca-40cd-8728-861f84b2a550/manifest.json`. -Die vorherige Manifestgeneration `928841e7…`, ihre Links und sämtliche früheren -Belege bleiben erhalten. - -## Was dieser PASS belegt - -Die vorhandenen IPC-Codec-/Sicherheits-/Journal-/Runtimefälle liefen tatsächlich -auf Windows als Bootstrapadministrator. Der Beleg weist `no_jobs=true` aus. -Der Unitrunner begrenzt nach einem Timeout die Wartezeit auf das eigene -Testprozessende und auf beide Ausgabe-Tasks; eine verlorene Antwort erlaubt nur -den create-only gespeicherten Fall zu lesen. Das ist keine Änderung des -Produktjob- oder Installerabbruchs. - -`local_service_proof`, `native_pipe_proof` und `clock_adapter_qualified` sind im -Native-PASS ausdrücklich weiterhin `false`. Dieser Unitlauf ist kein -Produkt-LocalService-zu-SYSTEM-Austausch, kein Nachweis, dass Drain v2 die zuvor -beobachtete233-Störung tatsächlich behebt, und keine SYSTEM-/Clock-/Jobfreigabe. -Der bestehende rohe V1-Control ist kein V2-Peernegativnachweis. - -Der erhaltende Paarupgrade, die Bindung an den nach dem Konsolenneustart -vorhandenen tatsächlichen Prozesskontext und der anschließende reale -Agent/Helper-Austausch bleiben gesondert zu prüfen. Vor dessen Ausführung stehen -noch der unabhängige fokussierte Quellreview des neuen Upgrade-Runners und die -explizite Root-Zielaktion. Keine Paket-, SCM-Fixture-, Reboot- oder sonstige -RMM-Wirkung folgt aus dieser Unitabnahme. diff --git a/docs/windows-system-pipe-upgrade.md b/docs/windows-system-pipe-upgrade.md deleted file mode 100644 index ca3207f..0000000 --- a/docs/windows-system-pipe-upgrade.md +++ /dev/null @@ -1,148 +0,0 @@ -# Windows Pipe-v2: erhaltender Paarupgrade nativ bestanden - -Stand: 2026-11-14. Paarupgrade und tatsächlicher authentisierter Austausch des -laufenden LocalService-Agenten mit seinem SYSTEM-Helper sind bestanden. -Die ursprünglichen Vorbereitungsabschnitte unten bleiben Verlauf. RMM-Jobs, -TrustedClock und Helperwirkungen bleiben weiterhin gesperrt. - -Die ursprüngliche quellengebundene -[Framingdokumentation](windows-helper-pipe-drain.md) bleibt unverändert. Diese -separate Datei beschreibt ausschließlich die späteren Upgradevorbereitungen. -Der Notebookhost bleibt reiner Entwicklungsrechner; Ziel ist die eigene -Windows-VM am endgültigen Cloudserver. - -## Geprüfter Kandidat und begrenzter Bootstrapvertrag - -Der neue Runner -[`system_pipe_upgrade.py`](../deploy/windows/system_pipe_upgrade.py) ist mit -SHA `e466576673a0e5c332cfc1613ae88a62f5b526015ced76b1d22473e292a995e0` -eingefroren. Sein frischer isolierter Prüfer bindet den neuen Pipe-Packtyp und -dessen Originalquellen, genaue native Listen mit **23 Library- und 7 -Binarytests** sowie die erhaltenen Linux-first-Corebelege mit 80 Linux- und -58 Windowsfällen. Es gibt keine Umbenennung alter Delegationsmanifeste und -keine Umleitung des eigenen Source-Roots auf Main. - -Der gebundene Pipe-Pack hat Manifest-SHA -`b2f77713a4f70deddb6472fb1e869a85443ce1028914f62ccee71f8001fbadb4`. -Die tatsächlichen 23+7 Windows-Administratorunits bestanden im Fall -`db25cd4a-bfd2-45d5-9f80-1881950853f7`; dessen `passed.json` hat SHA -`19a8ccd95b7225f7e8657a696055bea4b52ed2f80f6caa3f42c9396ce6272713`. -Das sind Unitnachweise, kein LocalService-/Pipe-/Clock-Erfolgsbeleg. - -Die vorbereitete Mutation verlangt eine separat geprüfte frische Baseline mit -SCM-/Kernel-PID und tatsächlicher Prozessgeburt, Konto, aktivem Service-SID, -Imagehash und ACLs. Ein bereits gestoppter Manual-Helper erhält keinen -Vorabstart. Vor der ersten Ersetzung werden vier private Sicherungen erstellt; -jede Ersetzung verlangt zusätzlich einen eigenen zuvor fehlenden nativen -Backupnamen und frische Datei-ID-/Hash-/ACL-CAS-Prüfungen. Beide Dienste bleiben -bis zur vollständigen neuen EXE-/Policy-/Pingeneration gestoppt. Danach sind -Helper- und Agentstart jeweils create-once. Config-/CA-/Identitäts-/Zertifikats- -und Private-Key-Metadaten samt Datei-IDs werden auch nach den Ersetzungen, -vor dem Start und beim Finish unverändert verlangt. - -`readback` ist rein lesend und kann auch einen fehlenden Zielpfad sowie einen -SCM-Pendingzustand ehrlich zeigen. Baseline, Enter und Finish behalten ihre -strengen Identitätsprüfungen. Nach verlorener Mutationsantwort gibt es keinen -automatischen Enter-/Start-/Rollbackretry. Ein Finish benötigt neue passive -Heartbeats und konkrete Inventar-ACKs; es schreibt nur einen lokalen Beleg. -Main-Indizes werden ausschließlich durch Root separat per CAS fortgeschrieben. - -## Tatsächlicher Fall 14fb: Timeout und geprüfte erste Fortsetzung - -Fallverzeichnis: -`devstate/windows-client/system-pipe-upgrade/14fb176a-f653-4573-a8d7-6f9fe47a3020/`. -Der erste `prepare`-Aufruf begann am `2026-11-14T12:39:48.414511+00:00` -und endete nach 180 Sekunden mit `TimeoutExpired` während des ersten -Stagingaufrufs. Zu diesem Zeitpunkt gab es lokal nur den Prepareintent und -Quellkopien, keine Baseline und keinen Enterintent. Die genaue Ursache des -SSH-/Bootstraptimeouts ist nicht nachgewiesen. - -Ein danach gesondert ausgeführter lesender Check bestätigte: beide neuen -EXE-Stagingverzeichnisse, der neue entfernte Komponentenfall und der neue -Active-Marker waren noch nicht vorhanden. Der alte Agent lief, der alte Helper -war gestoppt. Auf dieser Abwesenheit beruhte die explizite create-once -Fortsetzung der tatsächlich noch unerreichten Vorbereitungsphase im selben -Fall; kein neuer Upgradefall und kein wiederholtes Enter. - -| Erhaltener Beleg | SHA-256 | -| --- | --- | -| `prepare-first-stage-timeout.json` | `535faf7c6c4c7b3dba1f8d7b7889bc59acdee09fd51c2830fe397c3c9076f1e9` | -| `first-prepare-readonly-absence.json` | `983b38fcc2cdc8e907436eb3053f32ad2cd131e765a82dd1e9930346e1c6877b` | -| Private Fortsetzungsquelle `continue-first-prepare.py` | `86453aef4a1d59f73e423993b548e58ad0541205961a5952c80807403881cf3b` | -| `continue-first-prepare-intent.json` | `7420622b7866e7b43b34087d5334599444a046b95a89e7f48503aca0f4e03be0` | -| Neue lesende `baseline.json` | `57b79e9c918df6165cac0bb451b33fcd0c207933f15351afcd2ad6c400f4e2d7` | - -Die Fortsetzung erzeugte schließlich den Baseline-/Intentbeleg und die -serverseitigen Vorherbeobachtungen. Das ursprüngliche Timeout und seine -Abwesenheitsmessung wurden nicht überschrieben. - -## Baseline und verbleibende tatsächliche Abnahme - -Die frische Baseline zeigt den weiterhin vorhandenen Agenten `89004ad3…` -unter LocalService (`S-1-5-19`), `Running/Auto`, PID `3172`, mit exakter -Kernel-FILETIME `134391328200102621`. Der vorhandene Helper `e6aacbdd…` -ist `Stopped/Manual`, PID `0`; dafür wird kein laufender Prozess behauptet. -Policy `007adf5f…` und Pin `126670bc…` gehören weiterhin zur alten Generation. -Die Telemetriedatenbank wurde lesend mit `integrity=ok`, Sequenz `2564` und -`pending_inventory_events=0` beobachtet. Ursprüngliche PKI-/DB-/Lock-Datei-IDs, -ACLs und die beiden uninitialisierten Nullbyte-Intentleaves sind im privaten -Baselinebeleg gebunden. - -Vorherige Serverzählungen blieben: -Windows `jobs/outbox/permits/unresolved = 0/0/0/0`, Linux -`30/30/26/0`. Die beobachteten API-/Gateway-Transportfaultflags waren geschlossen; -dies ist eine konkrete Vorhermessung, kein künftiger Nachherbeleg. - -Der vorbereitete Kandidat umfasst Agent `f10c78dd…`, Helper `5f8c62fa…`, -Policy `a3024467…` und Pin `af518db8…`. **Es existiert für diesen Fall noch kein -Enterintent oder tatsächlicher Stop-/Swap-/Start-/Finishbeleg.** Staging ist -keine Installation oder laufende Nutzung der neuen EXEs. Der alte SSH-Zugang -lief anschließend aus; seine getrennte -[Konsolenwiederherstellung](windows-dev-access-recovery.md) ist eine notwendige -Zugangsstrecke und kein Paarupgrade. - -Nach tatsächlicher Wiederherstellung des Zugangs muss Root die Baseline vor -Mutation erneut bewerten. Geänderte PID/Birth-, Datei-, Index- oder andere -gebundene Werte dürfen nicht still übernommen werden. Erst danach können der -einmalige erhaltende Paarupgrade, zwei neue tatsächliche WSS-Heartbeats, -Inventar-ACK, Tenantverweigerung und unveränderte Job-/Policygrenzen geprüft -werden. Ein tatsächlicher authentisierter Austausch des laufenden -LocalService-Agenten mit dem neuen SYSTEM-Helper bleibt offen. Jobfreigabe, -Helperwirkungen und Clockqualifikation bleiben geschlossen. - -## Tatsächlicher Abschluss im selben Fall - -Nach der getrennt verifizierten SSH-Zugangswiederherstellung wurde derselbe -Fall14fb genau einmal betreten. Die frische CAS-Prüfung bestätigte vor der -Mutation die unveränderte ursprüngliche Baseline, beide lokalen Runtimeindizes -und die geschlossenen Serverzähler/Policies. Der bereits gestoppte Helper -wurde nicht vorab gestartet. Beide Dienste blieben während aller vier -Dateiersetzungen gestoppt; Originale und native Backups sind erhalten. - -Das anschließende rein lesende Finish bestätigt: - -- Agent `f10c78dd738e7fb277e0c4d24fadf0f61ae3269458399b9224570ba5e66abc2c` - läuft als LocalService/Auto, PID5528, Geburt `134391415551175930`. -- Helper `5f8c62fab6bc8ea1bbb009166b3d0e741c034c36690a4e32ea4e3cb2d7729a79` - läuft als SYSTEM/Manual, PID9464, Geburt `134391415512591188`. -- Tatsächliche Agentprobe: `authenticated_pipe_exchange=true` und - `client_service_pid_verified_by_helper=true`; Helperkonto/Service-SID und - feste EXE-/Policybindungen geprüft. Der frühere Win32233-Lauf bleibt - fehlgeschlagen; daraus wird keine rückwirkend bewiesene Fehlerursache. -- Zwei neue WSS-Heartbeats, ursprüngliche mTLS-Geräteidentität, - Inventar-ACK/Sequenz2813 und Tenantverweigerung bestätigt. Agent-/Helper- - DB-/Lock-/PKI-Datei-IDs, Historie und leere Intentleaves erhalten. -- Windows0/0/0/0, Linux30/30/26/0, geschlossene Testflags/Policies, - `helper_ready=false`, `helper_clock_qualified=false`, keine SYSTEMcapability - und keine Jobs oder Wirkung. Private Schlüssel wurden nicht gelesen. - -Originaler `result.json`-SHA256: -`d5c4996821911a5bdac5014e9f985c56bbb592b803f2e33411dd28bb986b8eed`. -Er wurde samt Intent/Baseline bytegleich im privaten Main-Evidenzpfad -archiviert. Erst danach veröffentlichte Root lokal beide Indizes per CAS unter -einem gemeinsamen Lock, mit erhaltenen Vorgängerdateien und eigener -Publikationsreceipt. Keine erneute Zielmutation: -Runtimeindex `e49231e72aff7b001189b8507200c6c701f73e47f77c29194116cf1da41ca0c2`, -Komponentenindex `005317e652f50de3e1277be3bc42717318226208015e7c8011e1b73469cc7562`. -Der Nachweis qualifiziert den Pipe-v2-Peertransport und die passive Erhaltung, -keine Clock, SYSTEM-Skriptkonsole oder Paketwirkung. diff --git a/docs/windows-system-policy.md b/docs/windows-system-policy.md deleted file mode 100644 index 646b10f..0000000 --- a/docs/windows-system-policy.md +++ /dev/null @@ -1,157 +0,0 @@ -# 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:` | Übereinstimmende lokale Policy | -| `helper.binary.sha256:` | Ü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//`. - -## 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. diff --git a/docs/windows-system-s0-s2-results.md b/docs/windows-system-s0-s2-results.md deleted file mode 100644 index 03c8b1d..0000000 --- a/docs/windows-system-s0-s2-results.md +++ /dev/null @@ -1,340 +0,0 @@ -**Aktuelle Übernahme 17. November 2026:** [Kompakter Einstieg](handover.md) -und [heute geprüfte Zugänge](operations-access.md). Quellenstand 0733 ist gepusht; -der Diagnose-/Kontextpatch ist compilegeprüft, nicht auf der VM installiert. -Server bestätigt221 failed3 und neuen 7d75 unknown2. Windows-SSH derzeit ohne -Reverselistener; keine neue native Gastnachlese und keine neue Risikofreigabe. -Nachfolgende Absätze sind datierte Originalergebnisse. - -**17. November, 09:35 UTC – Ursache des Windows-Totalausfalls behoben (Server):** -Nicht das SYSTEM-Skript, sondern ein Serverfehler hielt den Agenten seit 22:19 UTC -offline. Der Agent schreibt bei jeder SYSTEM-Delegation einen inhaltsleeren -JobResult-Platzhalter (Revision 1, `SYSTEM_DELEGATION_REQUIRES_HELPER_SNAPSHOT`). -Der Abgleich importierte den Helperstand (Revision 2) zuerst; danach lehnte der -Server den älteren Platzhalter als „result identity conflict“ ab. Der Agent -sendet ihn bei jeder Verbindung zuerst. Belege: TCP-Verbindungen lebten etwa -160 ms und wurden vom Server geschlossen; `ingress_window` stand seit 22:19:53 -still; ein lesend kopiertes Agentenjournal enthielt genau die Nachricht -`93fc8f7c…` als einziges aktives Ereignis. Folge: keine Heartbeats, kein -Inventar, keine Zeitbelege (`TIME_RUNTIME_NO_EVIDENCE`), kein Abgleich. -Fix in `crates/server/src/job_gateway.rs`: Nur dieser exakte Platzhalter, nur für -SYSTEM-Jobs mit reserviertem Start, gebundenem Grant und höherer Serverrevision -wird ohne Ledgeränderung quittiert und auditiert -(`superseded_delegation_placeholder_acknowledged`). Andere widersprüchliche ältere -Ergebnisse werden weiterhin abgelehnt. Image `4335556b…` auf dem Server aus dem -ausgerollten Paket 221 mit genau dieser einen Datei gebaut (Clippy `-D warnings`, -Zieltest bestanden, Release-Build) und mit unveränderter Composekette ausgerollt. -Tatsächlich um 09:31:09 UTC quittiert; Heartbeats, Zeitbroker und Abgleich laufen -wieder. Der Job bleibt unknown/Revision 2. Der Abgleich bleibt erwartungsgemäß -`ready=false` (`EFFECT_UNRESOLVED` nur für 7d756c34). Dabei synchronisierte der -Agent 09:31:10–09:33:34 UTC 343-mal; zum Schutz der Journale ist der -Windows-Agentdienst seit 09:34:36 UTC normal gestoppt, der Helper läuft. -Ein Neustart beider Dienste um 09:02 UTC hatte zuvor nichts geändert. -Userentscheidung 17.11.: Der alte Versuch bleibt unknown und wird nie wiederholt, -soll aber neue, einzeln WebUI-genehmigte SYSTEM-Versuche nicht mehr blockieren. -Dafür sind Server- und Agent-/Helperänderungen nötig (noch nicht umgesetzt). - -**17. November, 08:45 UTC – lesende Forensik zum Unknown und Tunnelkorrektur:** -NTFS-USN-Journal: Die Skriptdatei `script-4dd91fa7…-89226940….ps1` wurde um -22:19:51 UTC angelegt, beschrieben, geschlossen und in derselben Sekunde von der -Helperbereinigung gelöscht. PowerShell/Operational zeigt zwischen 22:19:44.3 und -22:20:06.1 UTC **keinen** PowerShell-Start; die angrenzenden SYSTEM-Starts sind -die regulären `boot_id`-Paare. Kontrolle: Der erfolgreiche LocalService-Skriptjob -`5f1ffef4…` erzeugte genau einen zusätzlichen Start. Prozesserstellungsaudit und -Sysmon fehlen. Ergebnis: keine beobachtbare Skriptausführung; ein in Millisekunden -wieder beendeter `powershell.exe` vor Hostinitialisierung ist nicht ausgeschlossen. -Genaue Fehlerstufe unbekannt (Ursache zwischen Dateischreiben und Hoststart). -**Kein Nichtstartbeweis, Unknown unverändert, keine Wiederholung.** -[Forensikbeleg](evidence/windows-system-unknown-357-forensics.json). -Der Entwicklungstunnel wurde auf Userauftrag über die lokale KVM-Konsole -wiederhergestellt und der Task `RmmDevReverseTunnel` um einen 5-Minuten- -Wiederholungsauslöser ergänzt (Aktion, Prinzipal, Schlüssel unverändert; -Original-XML `e7e8c304…` gesichert unter -`C:\ProgramData\RmmDevAccess\tunnel-repetition-20261117`, neuer Hash `5fd0e13e…`). -Seit 08:42:04 UTC läuft der Tunnel als SYSTEM-Task. - -**17. November, 08:25 UTC – rein lesender Befund, keine Zieländerung:** -Der Windows-Entwicklungstunnel ist seit **06:31:38 UTC** getrennt (Serverjournal, -Sitzung `rmm-win-tunnel` geschlossen), seither keine neuen Verbindungsversuche. -Wahrscheinliche Ursache: `ssh.exe` beendet sich per `ServerAliveCountMax` mit -Fehlercode; die Taskoption `RestartCount 999` greift unter Windows nur bei -Startfehlern, nicht bei Prozessende mit Exitcode ≠ 0. Der Tunnel ist damit nur -bis zum ersten Verbindungsabbruch dauerhaft. Gast läuft, DHCP-Erneuerungen und -HTTPS-Verbindungen des Agenten zum Server sind belegt. Server: Agent -`63ea15b2…` authentisiert sich fortlaufend (zuletzt 08:23:29 UTC, -`connection_generation` 1510), aber `restore_blocked=true`, `sync_required=true`, -`sync_ready=false`; letzter Checkpoint 11433/Generation 357 und letzte -Inventarbeobachtung 22:19:43 UTC. Keine Inventar- oder Heartbeatdaten seit dem -Unknown. Native Ursachenforensik zum Unknown steht aus, bis der Tunnel wieder -läuft; Ausnahme 357 weiterhin nicht freigegeben. - -**Vorwärtspatch, noch keine neue VM-Abnahme:** Fehlenden tatsächlichen -Agent-/Helper-Ausführungskontext in den reproduzierbaren Quellenstand übernommen; -Fehlerphasen, feste erlaubte Fehlercodes und gegebenenfalls erfassten Win32-Code -beibehalten, ohne beliebige Fehlermeldungen/Pfade auszugeben. Ein -CreateProcessW-Fehler verliert seinen nativen Code nicht mehr. Unabhängige -Quellprüfung und genau eine tatsächliche strenge Windows-All-target-Clippyprüfung -bestanden. Ein früherer Cargo-Aufruf scheiterte davor an einem veralteten -Operator-Mountpfad und führte Clippy nicht aus; separat im privaten Originalbeleg -erhalten. Keine neuen Tests, Release-Links, VM-Installation oder Jobs. -[Quellenprüfung](evidence/windows-system-script-error-context-source.json). -Dies behebt die fehlende Fehlerdiagnose und Kontextlücke **für zukünftigen Code**; -es erklärt den alten Sammelfehler nicht nachträglich und löst den gespeicherten -Unknown nicht auf. S2 bleibt unabgenommen. Die neue Ausnahme ist nur -[Vorschlag](windows-system-unknown-357-decision.md), noch nicht freigegeben. - -**22:45:55 UTC – maßgeblicher aktueller Stand:** S0 und der native -historienerhaltende Abschluss221 sind abgeschlossen. S2 ist **nicht bestanden**. -MCP-Antrag und tatsächliche WebUI-Genehmigung des neuen Jobs7d756c34… sind -belegt. Beide Originalledger enthalten jedoch Unknown199B -SYSTEM_SCRIPT_EFFECT_UNRESOLVED mit unverändert leerem consumed.result. -Originalstarts, Requestbezug und gespiegelt identischer Outcomehash wurden -nativ ausschließlich lesend nachgewiesen. Agent und Helper sind auf demselben -Kontrollkopf558407ec…/Generation357, ohne Fault oder pending_request. -Dies ist kein bloß ausstehender Erfolgsupload und kein neuer Kontrollspalt. -Ein ausgeführter SYSTEM-Prozess oder Nichtstart lässt sich daraus nicht belegen. -[Originalbefund](evidence/windows-system-script-original-unknown.json). - -Der konkrete Runtimefehler ging durch result.unwrap_or_else(|_| …) verloren; -eine nachträgliche Erklärung als Uhr- oder Win32-Fehler wäre Spekulation. -Zusätzlich fehlt im eingefrorenen ausführenden Quellstand der für den -Erfolgszeugen verlangte Ausführungskontext; der entsprechende bisherige -Arbeitskopiecode war beim engen S0-Abschluss nicht übernommen worden. -Ein enger Vorwärtspatch für Kontext und begrenzte Fehlerdiagnose wird geprüft. -Er ändert oder heilt diesen gespeicherten Unknown nicht. Keine neue Ausführung, -keine alte Grantwiederholung, kein Reset und keine neue Recoveryfreigabe angewandt. -Die zentrale befristete Testpolicy ist seit22:23:25UTC abgelaufen. - -**22:22 UTC:** Tatsächliche dev/test-WebUI-Genehmigung des neuen Plans -erfolgreich; BrowserExit0 und unabhängiges Audit mit -dev_test_browser_simulation/Testprincipal/exaktem Planhash bestätigt. -Der neue Job meldet derzeit unknown2/SYNC_EFFECT_UNRESOLVED aus -authoritative_sync, ohne Ausgabe. Das ist kein SYSTEM-Erfolgsnachweis; -keine Wiederholung oder neue Ausführung gestartet. -[UI und tatsächlicher Zwischenstand](evidence/windows-system-script-ui-and-unresolved.json). -Nun ausschließlich originale Helper-/Agentaufzeichnungen lesen und Ursache -beheben; ein später tatsächlich belegter Originalausgang ist vom frühen -Synchronisationsplatzhalter zu unterscheiden. - -**22:18 UTC:** Neuer SYSTEM-Skriptplan tatsächlich über MCP geplant und -eingereicht. Antrag8c3373c6…, Plan7c5c2fb1…, neuer Job 7d756c34…; -pending_approval und vor UI exakt0 Jobs/Outbox/Startgrants für diesen Auftrag. -Originalauftrag221 wird nicht wiederholt. -[MCP-Nachweis](evidence/windows-system-script-new-pending.json). -Die tatsächliche dev/test-WebUI-Bedienung folgt als eigener Schritt. - -**22:17 UTC:** Vorbereitete zentrale Skriptpolicy nach engem Mountvergleichfix -einmalig abgeschlossen und unabhängig als exakter Ersatz nachgelesen. -Originalepoch, Backup und ursprüngliche Ablaufzeit22:23:25.321002UTC erhalten; -keine Laufzeitverlängerung, Container-, Umgebungs-, Membership- oder DBänderung. -Frische normale Bereitschaft beider Rollen und keine offenen Jobs vor dem -Austausch erneut geprüft. Noch kein neuer Auftrag oder Freigabeartefakt. -[Zentrale Abnahme](evidence/windows-system-script-central-scope.json). -Jetzt folgt ausschließlich der neue MCP-Antrag mit tatsächlicher WebUI-Freigabe. - -**22:15 UTC:** Zentrale Policyerneuerung vor Austausch geblockt. -Unabhängige Nachlese: originale abgelaufene Policy weiterhin aktiv; Originalbackup, -Intent und Kandidat erhalten, keine neue Job-/Freigabewirkung. Ursache nativ -bestätigt: Docker liefert dieselben Mountobjekte in verschiedener Listenreihenfolge; -sechs Abfragen je Rolle zeigen unveränderte vollständige Config-/Host- und -kanonische Mounthashes. Keine tatsächliche Containeränderung. -[Fehlversuch und Ursache](evidence/windows-system-scope-renewal-preparation.json). -Nächster enger Schritt: Mengenvergleich korrigieren und nur den exakt -vorbereiteten Fall mit ursprünglicher Ablaufzeit kontrolliert abschließen. - -**22:06 UTC:** Lokale SYSTEM-Skriptqualifikation für das korrigierte Paar -nativ angewandt (Exit0), alle vier tatsächlichen Dateien unabhängig -nachgelesen; Agent11196 und Helper7772 anschließend regulär gestartet. -Nur FullMaintenance-Skripte/30s, keine MSI-/SCM-/Rebootrechte. -Originale Datenbanken, Schlüssel, Profil und Auto/Auto-SCM erhalten. -Ein zu früher Installeraufruf wurde von der Originalprozessprüfung vor -jeder Änderung blockiert; Caseabwesenheit und unveränderte laufende Rollen -wurden separat bestätigt und der Fehlversuch erhalten. Danach regulärer, -PID-/Exit-geprüfter Stopp und genau eine tatsächliche Konfigurationsanwendung. -[Lokale Abnahme](evidence/windows-system-script-scope-successor.json). -Noch kein neuer SYSTEM-Job; frische Rollenbereitschaft nach Neustart, -vorhandene begrenzte zentrale Policy erneuern, MCP → WebUI → Erfolg folgen. - -**21:51 UTC:** Regulärer frischer Abgleich des korrigierten Paares nativ -erfolgreich: Generation314, local_applied=true, exakte Helper-ACK bestätigt, -keine ausstehende Anwendung. Beide eigenen Zeitprüfungen und authentisierter -SID18-Helperpeer aktuell positiv beobachtet. Agent8420/Helper7624, -unveränderter Boot. Keine weitere administrative308-Recovery und kein -Wiederanwenden der alten Antwort. Helper bleibt absichtlich passiv ohne -SYSTEM-Capability. Einzelne Zeitlücken wurden ebenfalls beobachtet und bleiben -sperrend; die Momentaufnahmen sind keine spätere Startfreigabe. -[Normaler Abgleich](evidence/windows-closed-control-normal-sync.json). -Offen für S2: neue begrenzte lokale/zentral gebundene Skriptpolicy und -tatsächlicher neuer MCP → WebUI → SYSTEM-Erfolg. - -**21:47 UTC:** Profil9 für das tatsächlich laufende korrigierte Paar publiziert -und separat nachgelesen. Unverändertes vereinbartes KVM-Zeitprofil und -unveränderte Signaturschlüssel/Fristen; noch kein aktueller aktiver Zeit- oder -Jobnachweis. [Native Publikation](evidence/windows-closed-control-profile9.json). -Als Nächstes: originale aktive Konfiguration zurückstellen und regulärer Abgleich. - -**21:45 UTC:** Korrigiertes Paar aus Git 052456f nativ passiv installiert -und unabhängig nachgelesen: Agent 437a2aa0…, Helper 744dd4e6…, beide -Auto/Running. Vier ursprüngliche Datenbanken einschließlich vorhandener -Sidecars sowie ursprüngliche Sperren/Identität unter den gehaltenen Sperren -erhalten. Helper bleibt ohne Wirkung, aktive Qualifikationsnamen fehlen. -Der erste Vorbereitungsversuch scheiterte ausschließlich beim zweiten -Hashzugriff auf die selbst exklusiv gesperrten leeren Lockdateien; ursprüngliche -Images und leerer Fallordner wurden unabhängig bestätigt. Enger Bootstrapfix -prüft diese beiden Lockidentitäten und Länge0 unter den bestehenden Handles; -alle Datenbankbytes bleiben separat vollständig geprüft. -[Native Paarablesung](evidence/windows-closed-control-pair-native.json), -[Vorbereitungsfehler](evidence/windows-closed-control-lock-preparation.json). -Profil9, frischer normaler Abgleich und neuer SYSTEM-Auftrag sind noch offen. - -# S0–S2: tatsächliche Abschlussstrecke für Windows SYSTEM - -**Aktueller Befund um20:40UTC:** S0 und Fall 221 sind bestanden. S2 ist noch -offen: Nach zunächst erfolgreichem normalen Abgleich entstand ein weiterer -reiner Kontrollspalt durch TIME_STALE_RESPONSE vor dem Helpercommit. -Keine neue SYSTEM-Qualifikation oder Jobfreigabe wurde durchgeführt. -[Ursache und eng begrenzter normaler Onlinefix](windows-closed-control-online-continuation.md). -Die folgenden positiven Einzelstände bleiben an ihre Aufnahmezeiten gebunden; -Server-ready allein beweist keine gegenwärtige lokale Helperbestätigung. - -16. November 2026. Der Betreiber hat S0–S2 des -[Abschlussplans](mvp-completion-plan.md) ausdrücklich beauftragt. Keine -Linuxkapazitäts-, Updater-, MSI-, Zertifikats- oder Rebootarbeiten gehören zu -diesem Schritt. Der bestehende Fall 221 bleibt vollständig historienerhaltend. - -## S0: enger reproduzierbarer Quellenstand - -Der neue Quellencheckpoint ergänzt die bereits versionierte Domain-/Server- -und Windows-Sharingbasis ausschließlich um sechs notwendige Coredateien, -Operator-/Metadatenbeispiele und die zwei vorbereiteten S2-Controller. -[Exakte Quellen und SHA-256](evidence/windows-system-s0-source.json). -Zwei Agents prüften die Abhängigkeiten: Der Operator benötigt keine der -lokalen Windows-Updater-/Lifecycleänderungen. Produktquellen für das neue -Agent-/Helperpaar stammen aus diesem Gitstand, nicht aus einem veralteten -vollständigen privaten Snapshot. Der übrige lokale Arbeitsstand bleibt erhalten. - -Die Prüfung eines frischen Checkoutstands fand außerdem bereits versionierte -unvollständige Updater-API-Anschlüsse. Nur die benötigte Kompatibilität wird -ergänzt: bestehende Agentkontexte setzen das neue optionale Updaterimage auf -None; der Agent-/Helperuhrkonstruktor verweigert ausdrücklich die Updaterrolle. -Die vorzeitig registrierte, noch unversionierte Updaterbinary wird aus dieser -engen Cargoauswahl zurückgestellt. Keine Updaterimplementierung oder Fähigkeit -wird übernommen. Die übrigen Änderungen derselben Arbeitsdateien bleiben -unverändert lokal erhalten; Git enthält nur die geprüften Teiländerungen. - -Der erste tatsächliche Clippy-Aufruf des frischen Checkoutstands fand noch -einen nicht vollständigen Rollenmatch im Zeitbeobachtungsschreiber -`helper_runtime::record_verified_time` (E0004). Auch dort wird ausschließlich -die Updaterrolle ausdrücklich verweigert. Der erste Build bleibt als -fehlgeschlagen dokumentiert; kein Releaseartefakt daraus wurde installiert. - -Der bereits vorhandene Operator-SDK `66c156ce…` wurde aus seinem früheren -eigenständigen Snapshot gebaut. Dessen SHA-/Buildbeleg wird nicht nachträglich -diesem Gitcheckpoint zugeschrieben. Seine sechs Coredateien stimmen bytegenau -mit den hier versionierten überein. Der neue Produktpaarbuild und dessen -Manifest werden separat ausgewiesen. Noch keine neue SYSTEM-Abnahme. - -## Bestehenden Entwicklungstransport wieder verbunden - -Der neue SSH-Leseversuch scheiterte am fehlenden Reverse-Forward mit -`Connection refused`, nicht an einer neuen Hostkey- oder Benutzerfreigabe. -Die vorhandene Windows-KVM-VM lief. Ihre bereits bereitgestellte lokale -Administrator-Konsole zeigte den bestehenden Task `RmmDevReverseTunnel` als -Ready mit letztem Exit 255. Der Integrator forderte genau einmal den normalen -Start dieses vorhandenen Tasks an; keine Task-/SSH-Konfiguration geändert. - -Die neue strikt gepinnte SSH-Verbindung um **20:00:28 UTC / 21:00:28 MEZ** -bestätigte Task Running und beide RMM-Dienste weiterhin Stopped. Kein -Userhandgriff, kein Reboot, kein RMM-Job und keine Journalkorrektur. -Danach wurde ausschließlich der SDK mit vollständigem Hashreadback in den -geschützten Bootstrap-Hashpfad übertragen; 23202304 Byte, SHA-256 -`66c156ce0e20c2bc089fffb06e87aa8d5eaba042f175a3e9ddfa4b6fdd752c3a`. -Dies ist ein Stagingnachweis, keine native Anwendung oder Bereitstellung eines -neuen RMM-Agenten. Ausfallsicherheit des Entwicklungstasks ist damit nicht -allgemein abgenommen; kein neues Transportframework wurde begonnen. - -Der neue native SDK-Lesezeuge um **20:04:08 UTC** endete mit Exit 0 und exakt -dem ursprünglichen kanonischen Witnesshash `b92a51bb…`. Weiterhin vier Agentjobs, -drei Agentverbräuche/-starts/-outcomes und ein Helperverbrauch/-start/-outcome -sowie ein Intent. Kein Abschluss wurde dabei angewandt und keine Rolle gestartet. - -## S0-Build und S1-Anwendung tatsächlich bestanden - -Der korrigierte Gitstand `039c412` bestand Windows-GNU-Alltarget-Clippy mit -`-D warnings` und einen gezielten Release-Linklauf für Paar und Metadatenwerkzeuge. -Agent `bfbca0cd…`, Helper `5616ca95…`; dies ist weiterhin ein GNU-Entwicklungsbuild, -kein MSVC-Release. [Tatsächlicher Buildbeleg](evidence/windows-system-s0-pair-build-20261116.json). - -Die neue administrative Quittung `0b2bcbcb-9f1c-4ed5-a4a7-fe73339f3861` -wurde über die tatsächliche WebUI mit sichtbar simuliertem Testprincipal -bestätigt, heruntergeladen und am festen privaten Eingangsplatz publiziert. -Der Browser wartet vor dem Download ausdrücklich auf die erfolgreiche Antwort -der tatsächlichen UI-Bestätigung; ein alter vorhandener Downloadlink genügt nicht. - -Der aktuelle Placeholder-/Cache-/Unlock-/Signaturvertrag bestand anschließend -tatsächlich auf Windows mit SDK `66c156ce…`, ohne Produktdatenbanken zu öffnen. -Danach genau eine native Anwendung: **Exit 0**. Der unabhängige zweite native -Prozess bestätigte um **20:11:50 UTC** ebenfalls **Exit 0**: abgeleitet failed, -Revision 3, Original-Unknown erhalten, alter Grant nicht erneut ausgeführt, -physisches Originalevent 1 und aktive Queue 0. Beide RMM-Dienste blieben gestoppt. -Ready/HelperReady/Unlock sind ausdrücklich false; keine Jobgenehmigung. -[Öffentliche tatsächliche S1-Ergebnisse](evidence/windows-system-nonstart-221-closed.json). - -Die reine zentrale Nachlese um20:13UTC ergab unverändert35 Jobs/30 Grants/35Outbox -und nun3 administrative Quittungen mit korrektem Simulationsaudit. Der zentrale -Originaljob bleibt zunächst unknown/Revision2: Sein regulärer signierter -Abschluss folgt erst mit der korrigierten Runtime in S2. Keine direkte -Serverdatenbankkorrektur wurde verwendet. - -## S2 noch offen - -**Passiver Paarwechsel tatsächlich bestanden:** Native PowerShell-5.1-AST- -Prüfung des versiegelten Controllers ohne Fehler; PrepareStopped erfolgreich. -Die einmalige Installation um **20:21:11 UTC** und eine getrennte Nachlese -bestätigten Agent `bfbca0cd…` und Helper `5616ca95…`, beide Running/Automatic, -unter unveränderten LocalService-/SYSTEM-Konten. Passive Settings `9b6b7489…`, -Pin `cb0b618d…`, passive Agentconfig `d3ed4840…`. Ursprüngliche Identität, -PKI-/Journaldateikennungen und Lebensdauersperren blieben erhalten; alte -Qualifikationsdateien wurden mit Bytes/Datei-ID/ACL archiviert. Kein Reset. -Agentjobs und Helperwirkungen sind dabei deaktiviert. Der normale Dienststart -darf eigene Zustandsdaten schreiben. [Tatsächlicher Paarbeleg](evidence/windows-system-s2-passive-pair.json). - -**Zeitprofil 8 tatsächlich publiziert:** PrepareProfile um20:23:57UTC, -PublishProfile um20:24:09UTC und unabhängige Prozess-/Dateinachlese um20:27UTC -bestanden. Neuer Profilhash `17b50660…`; gleiches genehmigtes begrenztes -Windows/KVM-Vertrauensmodell. Beide Rollen laufen mit den neuen Images und -unveränderten Dienstkonten/Startarten. Dies ist **noch kein frischer signierter -Laufzeitnachweis**. [Genauer Profilbeleg](evidence/windows-system-s2-profile8.json). - -Für die aktuelle Jobqualifikation wird die bereits genehmigte originale aktive -Agentconfig erhaltend wiederhergestellt, während der Helper weiter passiv und -ohne Qualifikation bleibt. Präzisierung einer vorher zu engen Quellenlesung: -Auch der passive Heartbeatpfad kann signierte Zeitabfragen starten. Er publiziert -einmalige Rohproben; im aktiven Jobmodus stammen aktuelle Bereitschaftsbelege -aus Readiness/Peer und normalem Sync. Die initiale Startbedingung allein war -kein Beleg, dass passive Abfragen unmöglich wären. Neue Prozessgenerationen -werden stets neu gebunden, alte Publikations-PIDs nicht übernommen. - -Noch auszuführen: aktive Skriptvoraussetzungen qualifizieren, -regulären frischen SignedSync -und terminalen Originaljob nachweisen, bestehenden SYSTEM-Scope eng erneuern -und einen neuen MCP-/WebUI-SYSTEM-PowerShell-Auftrag ausführen. Diese Handlungen -sind noch geplant; aus S1 folgt kein erfolgreicher SYSTEM-Skriptprozess. - -**Normaler Kontrollbetrieb wiederhergestellt:** Beide neuen Rollen wurden mit -gehaltenen ursprünglichen Prozesshandles normal gestoppt, Originalconfig -`5cd4cb98…` erhaltend wiederhergestellt und mit unverändert passivem Helper -gestartet. Um20:29:40UTC bestätigte der Server Generation304, -ready/helper_ready=true, restore_blocked=false und den Originaljob221 -**failed**. Keine direkte SQL-Korrektur, keine neue Jobfreigabe. -Aktuelle geschützte Runtimeberichte um20:34UTC binden Agent3456/Helper10224, -neue Prozessgeburten, beide qualifizierten eigenen Uhren und authentischen -Pipeaustausch. Der native Helperprobe meldet bei deaktivierten Wirkungen -erwartungsgemäß helper_ready=false und keine SYSTEM-Fähigkeiten; das wird -nicht zu true umgedeutet. [Kontrollnachweis](evidence/windows-system-s2-control-ready.json). - -Präzisierung der Zeitbelege: Die separaten Roh-Sampledateien werden nur im -passiven Samplingmodus publiziert. Die aktuelle native Nachlese fand dort -noch Generation303/PID5416; diese Dateien sind ausdrücklich **kein** frischer -Nachweis für die aktiven Prozesse. Für diese gelten aktuelle geschützte -Readiness-/Peerberichte und regulärer SignedSync. Es wurde kein zusätzlicher -Clockpfad implementiert und kein alter Prozessbeleg umetikettiert. diff --git a/docs/windows-system-script-first-attempt.md b/docs/windows-system-script-first-attempt.md deleted file mode 100644 index f658824..0000000 --- a/docs/windows-system-script-first-attempt.md +++ /dev/null @@ -1,82 +0,0 @@ -# Erster tatsächlicher Windows-SYSTEM-Skriptversuch - -16. November 2026. **Nicht bestanden.** MCP-Antrag und tatsächliche sichtbar -simulierte WebUI-Genehmigung wurden ausgeführt; der Originalversuch steht -weiterhin auf `unknown`. Kein Retry und keine Erfolgskorrektur wurden vorgenommen. - -Der feste Plan `0ebc5db7-bcdc-430b-a243-7c79e1c1a5f4` gehört zum Antrag -`ce1b969b-66b2-4548-a28c-7e81943507c4`, Job -`94047873-5088-433b-bc1b-490d3eafe0da`, Versuch -`f071e6d6-8635-42f7-92fa-533c681edd8b`, Originalgrant -`97e705b8-fb2b-4158-84d9-d90595d1ce6e`. Das Skript prüft die tatsächliche -Windows-Identität auf SID18 und soll ausschließlich -`Windows-System-MVP:S-1-5-18` ausgeben. RemoteSigned gilt nur für den -genehmigten PowerShell5.1-Prozess. Keine Dienst-, Paket- oder Neustartaktion. - -## Tatsächliche Genehmigungs- und Ausführungskette - -Vor dem echten UI-Klick bestanden null Jobs, Outboxeinträge und Startgrants -für diesen festen Versuch. Anschließend bestanden genau ein Job, eine -Auslieferung und ein Grant. Der Audit bindet denselben Planhash an -`dev_test_browser_simulation`, `testsimulation=true` und -`simulated-testprincipal-a`. Es gab keinen direkten Freigabe-API-/DB-Aufruf. - -Der unabhängig gebaute und auf Windows tatsächlich ausgeführte reine -Lesezeuge `cd21eef6…` bestätigt auf beiden Originalledgern genau einen -Verbrauch, einen Startzeugen und ein Outcome. Beide Originalsignaturen und -derselbe Requesthash stimmen. Der Helperstartzeuge wurde um16:03:57MEZ -geschrieben. Beide Outcomes enthalten `SYSTEM_SCRIPT_EFFECT_UNRESOLVED`, -null Exitcode und leere Ausgaben. `consumed.result` ist jeweils nochNULL; -das Agentintent steht auf `may_have_dispatched` und bindet den gleichen -gespiegelten Outcomehash. Ein Startzeuge des Helpers ist kein Nachweis eines -tatsächlich gestarteten PowerShell-Kindprozesses. - -## Konkreter Fehler und enger Fix - -Der installierte Helper0502 hält sein Zustandsverzeichnis seit seinem Start -mit `GENERIC_READ | GENERIC_WRITE` und `FILE_SHARE_READ | FILE_SHARE_WRITE`. -`system_script::execute` öffnet genau dieses Verzeichnis erneut, fordert aber -vor dem Erstellen der Skriptdatei ausschließlich `FILE_SHARE_READ`. Dieser -zweite Open ist mit dem bestehenden Writerhandle unvereinbar. - -Eine tatsächliche rein lesende Windowsprobe am unveränderten laufenden -HelperPID1304 um16:15:04MEZ bestätigte die Windows-Semantik: - -- gewünschter Zugriff `GENERIC_READ`, ShareRead: Fehler32/SharingViolation; -- derselbe gewünschte Zugriff, ShareRead|ShareWrite: erfolgreich geöffnet. - -Die Probe legte keine Datei an und führte kein Skript aus. Die Quellreihenfolge -platziert die fehlerhafte Öffnung vor Skriptdatei und Kindprozessstart. Die -historischen Journale selbst speichern jedoch nur den generischen Fehler; -sie werden deshalb nicht durch eine nachträgliche Erfolgs- oder Nichtstart- -behauptung überschrieben. - -Der Fix verwendet nur für diese Verzeichnisöffnung die vorhandene -`PinnedFile::open_read_shared`-Funktion. Gewünschter Zugriff bleibt nur lesend; -Delete-Sharing, Dateiidentität, ACL-Prüfung und Genehmigungsgrenzen bleiben -unverändert. Build und Installation des korrigierten Paares sind getrennte -Nachweise. Die tatsächliche erfolgreiche SYSTEM-Skriptabnahme steht weiterhin aus. - -Der GNU-Alltargets-Clippy-Lauf mit `-D warnings` und beide Releasebuilds der -engen Ableitung sind tatsächlich bestanden. Von251 eingefrorenen Quelldateien -wurde ausschließlich diese eine Zeile geändert. Neuer Agent98dcafec…, -Helper325d2faf…; gebaut im vorhandenen isolierten Builder, nicht auf der VM -installiert und kein MSVC-Release. Es wurden keine zusätzlichen Tests geschrieben. -[Buildnachweise und tatsächlicher Readonlyzeuge](evidence/windows-system-script-sharing-fix-build-20261116.json). - -## Erhaltener Sperrstand - -Der letzte native Readonlyzeuge zeigt zusätzlich den Kontrollspalt in -Verbindung221: Agentcheckpoint10784/Entscheidung0442c732…, Helpercheckpoint413/ -Entscheidung193b951b…, Agentcheckpoint des Helpers10783. Beide Faultfelder -sindNULL. Originalrequests und Antworten sind erhalten. Die alte ausdrücklich -auf Verbindung205 und null unbekannte Wirkungen begrenzte Reparaturfreigabe -deckt diesen neuen Fall nicht ab. - -Die zentrale Skriptpolicy lief am16.November um16:15:01MEZ ab. Die spätere -lesende Serverprüfung bestätigte den Ablauf und weiterhin genau einen Job -und einen Grant mit Zustand `unknown`. Keine Frist wurde verlängert, keine -Identität ersetzt, kein Journal gelöscht und kein Neustart ausgeführt. - -[Öffentliche Originalnachweise](evidence/windows-system-script-attempt-20261116.json). -[Konkreter gesonderter Abschlussvorschlag](windows-system-script-nonstart-221-proposal.md). diff --git a/docs/windows-system-script-nonstart-221-proposal.md b/docs/windows-system-script-nonstart-221-proposal.md deleted file mode 100644 index d853933..0000000 --- a/docs/windows-system-script-nonstart-221-proposal.md +++ /dev/null @@ -1,43 +0,0 @@ -# Vorschlag: genau den gescheiterten SYSTEM-Testversuch erhalten und abschließen - -**Vom Betreiber am16.November2026 ausdrücklich freigegeben; noch nicht ausgeführt.** Ausschließlich die -bestehende Windows-Testidentität, Job94047873…, Versuchf071e6d6… und -Grant97e705b8… aus dem [tatsächlichen Fehlerbeleg](windows-system-script-first-attempt.md). -Keine allgemeine Wiederherstellungs-, Retry- oder Produktionsausnahme. - -Der belegte Sharingfehler liegt im installierten Code vor Skriptdatei und -CreateProcess. Der Originalhelperprozess und sein dauerhaft gehaltener -Writerhandle sind vor einem Abschluss unabhängig erneut zu binden. Die -vorhandenen Journale enthalten bereits ein unveränderliches Unknown-Outcome; -der administrative Abschluss darf dieses nicht durch erfundene historische -Ergebnisse ersetzen. - -Der konkret freigegebene Ablauf ist: - -1. Originalgrant, Signatur, Geräte-/Boot-/Prozess-/Dateiidentitäten, genau die - beiden Starts und Unknown-Outcomes, das Intent und die ursprünglichen - Abgleichantworten unabhängig prüfen und unveränderlich archivieren. - Den Codepfad und die tatsächliche ShareMode-Probe als eigene zusätzliche - Nichtstartbeweiskette binden. Fehlende oder abweichende Belege verweigern. -2. Einen getrennten administrativen Abschlussbeleg für genau diesen Versuch - und den Kontrollspalt221 in der tatsächlichen WebUI anzeigen und mit dem - sichtbar simulierten Testprincipal bestätigen. Kein Job- oder Startrecht - entsteht durch diesen Beleg. -3. Einen nachvollziehbaren historienerhaltenden Abschluss hinzufügen: der - ursprüngliche generische Unknown-Beleg bleibt unverändert erhalten; der - zusätzliche geprüfte Abschluss weist ausschließlich den fehlgeschlagenen - Nichtstart aus, niemals Erfolg. Auch die alten Kontrollantworten bleiben - erhalten. Keine alte Lease oder historische Uhr wird als aktuell benutzt. -4. Die eng korrigierten Binaries identitäts- und historienerhaltend installieren - und beide Rollen erneut durch den regulären frischen signierten Abgleich - führen. Ohne vollständig bestätigten Abschluss bleibt die Ausführung gesperrt. -5. Erst danach einen neuen festen MCP-Plan mit eigenem Versuch und eigener - tatsächlicher WebUI-Genehmigung für dasselbe harmlose Identitätsskript - anlegen. Keinen alten Grant erneut verwenden oder ausliefern. - -Kapitel0 der Spezifikation1.28 begrenzt die bisherige zusätzliche Ausnahme -ausdrücklich auf Verbindung205 und verlangt dort: „Kein weiterer Verbrauch, -SYSTEM-Intent, offener oder unbekannter Effekt darf vorliegen.“ Dieser neue -Fall erfüllt diese Bedingung nicht. Die dafür nötige neue ausdrückliche Betreiberentscheidung liegt jetzt vor -und ist in Kapitel0, Version1.29, dokumentiert. Der einzeilige Sharingfix und die lesende Fehlerdiagnose benötigen -diese zusätzliche Ausnahme nicht. diff --git a/docs/windows-system-state-witness.md b/docs/windows-system-state-witness.md deleted file mode 100644 index a7b06c6..0000000 --- a/docs/windows-system-state-witness.md +++ /dev/null @@ -1,93 +0,0 @@ -# Fester Nur-Lese-Zeuge für Windows-Helperwartung - -Stand2026-11-14: `examples/system_state.rs` ist implementiert. Windows-GNU- -Example-Clippy mit `-D warnings`, Release-Link und AMD64-PE-Prüfung bestanden -im Defaultprofil. Anschließend im gemeinsamen Featurebuild `80655271…` mit -Agent/Helper und23+7 nativ bestandenen Units gebunden. **Keine Dienstwartung -oder binäre Erhaltungsabnahme durch den Witness allein.** - -## Tatsächlicher nativer Nur-Lese-Lauf - -Fall `f4879e01-7eb6-40ab-ac4c-7a9a50ea358b`, EXE-SHA256 -`d0b2d033e99ec4819f5de562fc2ad06b844a63b230271df578d5e9ce4c565e5c`: -Bootstrap-Administratorprozess auf der tatsächlichen Windows-VM, Exit0, -kein Timeout,3006Zeichen JSON, keine Fehlerausgabe. Separater Readback der -dauerhaften nativen Receipt stimmte exakt überein. Keine erneute Programmausführung. - -Die Integritätsprüfung und Bindung des tatsächlichen nativen SQLite-VFS- -Dateihandles an die gehaltene Helperdatei bestanden. Vorhanden sind genau die -drei Basistabellen: `consumed`0, `execution_evidence`0 und `windows_helper_files`1; -deren typisierte Zeilenhashes sind privat erhalten. Alle vier Helper-Synctabellen -fehlen ausdrücklich; kein Ready-/Syncbeleg wird daraus abgeleitet. Die vorbereitete -Intentablage ist vorhanden und besitzt weiterhin exakt die beiden0B-Leaves. - -Keine Schlüssel-/privaten Zeileninhalte ausgegeben, keine Clock-, Dienst-, -Policy-, Datenbank- oder Jobänderung. Zentrale Zähler und geschlossene Flags -vorher/nachher identisch: Windows0/0/0/0, Linux30/30/26/0. Geschützte -Rohbelege und `acceptance.json` liegen unter -`devstate/windows-client/system-state-native/f4879e01-7eb6-40ab-ac4c-7a9a50ea358b/`. -Dies ist kein LocalService-/SYSTEM-Pipe-, Intent-PERSIST- oder RMM-Jobnachweis. - -## Fester Beobachtungsumfang - -`SystemStateProbe.exe` hat keine Argumente und benötigt einen tatsächlich -aktivierten Administratorgruppen-Token ohne Threadimpersonation. Der Bootstrap- -Runner bindet den tatsächlichen Aufrufkontext. Es ist kein LocalService-/SYSTEM- -Pipebeweis, keine RMM-Capability und kein Genehmigungsweg. - -Der feste Beobachtungsumfang ist `C:\ProgramData\RustDiscoverySystem`: - -- `state\ledger.sqlite`: ausschließlich lesende SQLite-Transaktion, - Integrität, bekannte Schema-/Indexdefinitionen sowie Zeilenzahl und - deterministischer typisierter Hash je erlaubter Tabelle. Pflicht sind - `consumed`, `execution_evidence` und `windows_helper_files`. Die vier - `helper_sync_*`-Tabellen dürfen gemeinsam fehlen; `absent_tables` meldet das - ausdrücklich. Teilweise oder unbekannte Schemas werden verweigert. -- `state\executor.lock`, `helper.json`, `agent-pin.json`: ausschließlich - Dateimetadaten, Owner-/DACL-Prüfung und ACLhash. Keine Pin-/Request-/Schlüssel- - oder privaten Zeileninhalte in der Ausgabe. -- Optional `agent-intents`: entweder vollständig abwesend oder exakt der - vorprovisionierte Ordner mit zwei regulären, leeren festen Leaves. Nur - Metadaten; keine SQLiteöffnung oder Initialisierung dieser Dateien. Ein - bereits initialisierter Intentstore gehört nicht zu diesem Wartungsprofil. - -Gehaltene Handles, Wiederöffnung des festen Pfads und die tatsächliche native -SQLite-VFS-Dateikennung müssen übereinstimmen. Volume-ID und FILETIME erscheinen -als Dezimalstrings, damit PowerShell alle64Bit erhält. Der Witness akzeptiert -die vom bestehenden Helper erstellten geerbten Datei-ACEs nur unter -dem gehaltenen geschützten State-Verzeichnis, bei weiterhin exakt geprüften -effektiven Writerrollen und SYSTEM-/Admin-Owner. Andere Schutzdeskriptoren werden -nicht passend geändert; Root-, State- und Intentverzeichnisse bleiben geschützt. -Die Datenbankverbindung -bleibt read-only; es gibt weder Migration noch Schreib-PRAGMA, WAL-Override, -`immutable` oder `nolock`. Bestehende Journal-/WAL-/SHM-Sidecars und ein -abweichender Rollbackheader werden vor der SQLiteöffnung verweigert. Kein -Journal wird repariert, gelöscht oder zurückgesetzt. - -Die separate tatsächliche Nur-Lese-Erhebung `acl-readonly-d4795190…` bestätigte -den geschützten State-Ordner mit Administratorowner und die beiden vom Helper -erzeugten SYSTEM-eigenen, ungeschützten Dateien mit genau drei geerbten Full- -Control-ACEs für SYSTEM, Administratoren und Helper-Service-SID. Keine Reparse- -Points, keine Datei-/ACLänderung oder privaten Dateiinhalte gelesen. Die private -Metadatenreceipt hat SHA256 `12e2ca43…`; dies ist **keine native Ausführung** -des neuen vollständigen Witnessprogramms. - -Der Reader begrenzt Dateigröße auf1GiB, Schemaobjekte auf32, Zeilen pro Tabelle -auf10000, einzelne Werte auf1MiB, gehashte Text-/Blobwerte insgesamt auf32MiB -und die JSON-Ausgabe auf32768Byte. Synchrone Dateisystem-/Securityabfragen -besitzen dadurch keine harte Zeitgrenze; der separate Bootstrapcontroller muss -seinen eigenen Witnessprozess begrenzen. Fehler geben ausschließlich -`SYSTEM_STATE_WITNESS_REFUSED` aus. Kein Bytehash einer laufenden Datenbank; -einen solchen darf der Wartungsrunner erst nach bestätigtem Ende beider alten -Dienstprozesse separat erheben. - -Die native Handleabfrage verwendet die dokumentierte reine -[SQLite-WIN32_GET_HANDLE-Operation](https://www.sqlite.org/c3ref/c_fcntl_begin_atomic_write.html). -Der Handle bleibt Eigentum von SQLite. Der Schutzdescriptor wird nur mit -[GetSecurityInfo](https://learn.microsoft.com/en-us/windows/win32/api/aclapi/nf-aclapi-getsecurityinfo) -gelesen; keine Privilegien oder DACLs werden verändert. - -Der bestehende `RuntimeStateProbe.exe` für das Agenttelemetriejournal bleibt -unverändert und wird vom Wartungsrunner gesondert verwendet. Das Notebook -bleibt Entwicklungsrechner; kein Agent, Server, VM-Neustart oder Job wurde -für diesen Quellen-/Crossbuildnachweis gestartet. diff --git a/docs/windows-system-unknown-357-decision.md b/docs/windows-system-unknown-357-decision.md deleted file mode 100644 index 2166a55..0000000 --- a/docs/windows-system-unknown-357-decision.md +++ /dev/null @@ -1,60 +0,0 @@ -# Entscheidungsbedarf: neuer SYSTEM-Testversuch mit unbekanntem Ausgang - -Status: **Vorschlag, nicht genehmigt und nicht implementiert.** -Aktueller Auftrag S0–S2; der alte Fall221 ist abgeschlossen, S2 ist nicht bestanden. - -## Tatsächlicher Befund - -Neuer MCP-Plan7c5c2fb1-63d4-413c-ad89-6d033f2bf057, tatsächliche dev/test-WebUI- -Genehmigung und neuer Job7d756c34-3506-4545-8ecd-0e94b9fe7569 sind belegt. -Versuch4dd91fa7-f04d-4a9d-8143-b7f69d9e0680, Grant89226940-dcf5-4647-8707-9fea48940027. -Beide Originalledger enthalten denselben199B-Unknown -SYSTEM_SCRIPT_EFFECT_UNRESOLVED/Hash1f284b66578d61c4364cc0060a67ce9b467e1d661ed8885804391b51a6f18b1a. -consumed.result bleibt NULL; der Intent hat may_have_dispatched und spiegelt -genau diesen Unknown. Kontrollköpfe sind auf357 ausgerichtet, ohne Fault. -[Unabhängige native Nachlese](evidence/windows-system-script-original-unknown.json). - -Die Runtime hat den ursprünglichen Fehler verworfen. Weder ein erfolgreicher -Prozess noch ein Nichtstart ist dadurch nachgewiesen. Ein passender späterer -Erfolg liegt nicht im Helper. Der ausgeführte Bildstand437a/744d bleibt installiert; -keine neue Ausnahme, Reinstallation, Journaländerung oder Wiederholung erfolgte. -Die befristete zentrale Testpolicy ist abgelaufen. - -## Bestehende Grenze - -[AGENTS.md](../AGENTS.md): „Unklare Wirkung bleibt unknown, nicht blind wiederholen.“ -[Spezifikation0, Version1.29](../Rust_RMM_Implementierungsspezifikation.md) -gestattet ausdrücklich **genau** den damaligen Testfall221. Dessen Nichtstartbeleg -und Freigabe gelten nicht für diesen neuen Grant. Gleicher Sammelcode und gleicher -Outcomehash beweisen weder gleiche Fehlerursache noch einen Nichtstart. - -## Vorgeschlagene ausdrücklich begrenzte Betreiberentscheidung - -Für ausschließlich diese Entwicklungs-VM und diesen einen neuen Unknown-Fall -könnte eine **separate administrative Risikofreigabe für einen neuen Test** -zugelassen werden. Das ist eine Änderung des bisherigen Vertrags, kein bereits -vorhandener normaler Wiederherstellungspfad. - -- Originaljob, Unknown, Starts, Requests, Signaturen, Identität und Journale - bleiben erhalten. Kein Erfolg, Nichtstart oder belegter Abbruch wird erfunden. -- Der alte Grant und der alte Versuch bleiben dauerhaft verbraucht; sie werden - niemals erneut ausgeführt. Der alte Ausgang bleibt sichtbar unbekannt. -- Eine eigene signierte, tatsächlich in der dev/test-WebUI bestätigte und - auditierte Entscheidung müsste genau Gerät, Originalfall und **einen neuen - festen Testplan** binden. Sie ersetzt weder Zeit-/Peer-/Signaturprüfungen noch - die zusätzliche tatsächliche WebUI-Genehmigung des neuen MCP-Skriptplans. -- Die Ausnahme würde nur die blockierende Wirkung dieses einen alten - Unknown für genau den ausdrücklich gebundenen neuen SID-Prüfauftrag aufheben, - keine allgemeine Unknown-Heilung oder dauerhafte Root-/SYSTEM-Freigabe. -- Vor einem neuen Versuch müssen die fehlende Ausführungskontext-Dokumentation - und das Verwerfen der Fehlerursache korrigiert und gezielt geprüft sein. - Keine Installation oder neue Jobausführung allein aufgrund dieses Dokuments. - -Ohne ausdrückliche Betreiberentscheidung bleibt dieser Fall gesperrt. -Unabhängig davon sind der enge Vorwärtspatch und seine Compileprüfung zulässig. -Ein Detailplan der tatsächlichen Beleganwendung ist vor einer eventuellen -Zieländerung zusätzlich zu prüfen; keine direkte API-/DB-Freigabe. - -Dieser Vorschlag erklärt **nicht**, weshalb der ursprüngliche Prozesspfad -fehlschlug. Die vorhandenen Belege reichen dafür nicht; eine nachträgliche -Uhr-/Win32-Ursachenbehauptung wäre unbelegt. diff --git a/docs/windows-time-profile-config.md b/docs/windows-time-profile-config.md deleted file mode 100644 index f00494c..0000000 --- a/docs/windows-time-profile-config.md +++ /dev/null @@ -1,571 +0,0 @@ -# Erste öffentliche Windows-Zeitkonfiguration V2 - -Stand 2026-11-15: Der reale Paarfall `4887940a-4c9c-4807-aaf2-6fbc94faad46` -ist nach abgeschlossener unabhängiger Nachlese gebunden (Result `2898a72b…`, -Originalintent `40e9cd55…`, separater Read `63e453fb…`). Die vorherige -Verweigerung mit fehlenden Rollenbelegen bleibt als historischer lokaler Test -nachgewiesen. Ein Zeitvertrauen oder durchgehende Heartbeats sind durch den -Paarabschluss ausdrücklich nicht bewiesen. - -Der Operator prüft die unveränderten öffentlichen Vorbereitungsbelege -`c3077acf-12da-410e-9f55-e75a1cd0a75f`, deren getrennten Ed25519-Zeitschlüssel, -Gerätebindung und tatsächlich gelesene KVM-Plattform. Die ursprüngliche -Vorbereitung bleibt mit `roles_qualified=false` unverändert. Die akzeptierte -Betriebsannahme ist ausdrücklich -`active_guest_no_pause_save_restore_snapshot_migration_host_suspend`; das ist -keine physikalische Kalibrierung und keine automatische Überwachung dieser -Betriebsannahme. - -Der neue Agent ist an SHA256 -`0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c` -und Buildreceipt `f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446` -gebunden. Seine 202 Quellinputs sind durch `11717fab…` fixiert; das tatsächlich -erweiterte Zeitmodul hat SHA256 `342494c4…`. Gegen die ursprüngliche Quelle -`d8594c1e…` kamen die passive Sampling-Auswahl und deren neunte Prüfung hinzu. -Der Helper bleibt `59675a3c…`, aus dem ursprünglichen Linkbeleg `04ed34e6…` -und Quellbeleg `96b05fe1…`. Diese unterschiedlichen Provenienzen werden nicht -gleichgesetzt. Der tatsächliche neue Paar-Payload verwendet für -`qualification_sha256` und `manifest_sha256` jeweils den neuen Beleg `f04024f7…`; -der alte Helper-Quellbeleg ist kein Ersatz dafür. - -Bevor ein Fall erstellt werden kann, müssen ein abgeschlossener passiver -Paarwechsel und unabhängig fixierte Originalbelege vorliegen. Für beide Rollen -werden SCM-Status, PID, Kernel-Prozessgeburt, tatsächliches Konto, aktivierte -Service-SID, gehaltener Prozesshandle, Imagepfad, Imagehash und native FileID -verknüpft. Die alten numerischen 601-Proben bleiben ausdrücklich rohe -Voraussetzungsbelege; sie qualifizieren kein Produktimage. Der Producer erzeugt -öffentliche Rollen- und Plattformbelege und daraus das vorhandene strikte -V2-Format mit genau beiden Rollen. Er behauptet weder signierte Laufzeitprüfung -noch physikalische Genauigkeit. Fehlende oder widersprüchliche Belege sperren. - -## Geplanter Ablauf nach neuem realem Paar-Readback - -Die folgenden Phasen sind **vorbereitet, nicht auf dem Ziel ausgeführt**: - -1. Root bestätigt Original-Paarfall und Originalbeleg-Hashes; diese werden als - konkrete Quellenkonstanten gebunden und nochmals geprüft. -2. `prepare` liest ausschließlich öffentliche lokale Belege und erzeugt einen - privaten, einmaligen Fall. `stage --case ` überträgt ausschließlich den - fixierten Controller über den bestehenden bestätigten SSH-Transport. -3. `install --case ` darf genau eine bisher fehlende feste öffentliche Datei - veröffentlichen. Bereits vorhandene Datei, aktiver Marker oder Teilfall - verweigern einen neuen Installationsversuch. Ein verlorener Antwortweg führt - ausschließlich zu `read --case `, nicht zu Wiederholung oder Rollback. -4. Root liest den ursprünglichen Fall separat und prüft danach die echten - passiven Agent-/Helper-Zeitbelege. Eine erfolgreiche Veröffentlichung allein - setzt `clock_runtime_qualified` ausdrücklich nicht auf true. - -## Begrenzte Wirkung und Erhaltungsnachweis - -Der Controller verwendet ausschließlich die vorhandenen lesenden SCM-, -Kernel-, FileID-, PKI-Metadaten- und Journalzeugen. Er importiert keine alten -Stop-/Start-/Swap-/Repair-Phasen. Die aktuelle Prozessgeneration, beide Images, -vier Code-/Policydateien, Konfiguration, Geräteidentität, Zertifikat, -Schlüsselmetadaten, Telemetrieidentität, Sequenzmonotonie und leere -Job-/Helper-Intents werden vor, während und nach der Veröffentlichung geprüft. -Der private Schlüssel wird weder gelesen noch gehasht. - -Eine neue private Bootstrap-Falldirectory wird nativ exklusiv mit geschützter -SYSTEM-/Administrators-DACL angelegt. Alle Originalmarker werden create-only -geschrieben und geflusht. Nur der öffentliche Helper-Stamm erhält bei Bedarf -fehlende `0x001200a9`-Leserechte für beide **Service-SIDs**, ausschließlich für -diesen Ordner, ohne Vererbung auf State/PKI/Ledger. Fremde oder weiter gehende -Service-Rechte werden verweigert. Die Kandidatdatei erhält vor Veröffentlichung -SYSTEM/Administrators-Vollzugriff und dieselben begrenzten Leser. Die feste -Zieldatei wird nach durablem Publish-Intent mit einem gleichvolumigen, -überschreibungsfreien Move veröffentlicht; anschließend müssen FileID, Hash -und DACL unverändert sein. Keine allgemeine Stromausfall-Atomizität wird daraus -abgeleitet. Teilzustände bleiben im Originalfall lesbar, ohne automatische -Reparatur oder Rechte-Rücksetzung. - -Unmittelbar vor der ersten Erstellung wird `install_not_before` aus der -nativen VM-UTC gelesen und im ursprünglichen Intent sowie Ergebnis erhalten. -Das ist eine Herkunftsuntergrenze für die nachfolgende separate Nachlese und -den passiven Collector, keine eigenständige Uhrvertrauensbehauptung. - -## Laden und tatsächliche Grenzen - -Das vorhandene `signed_clock::native::SignedClock::open` lädt bei jedem Öffnen -geschützte Settings, beweist den eigenen Dienstprozess und öffnet den festen -Stamm sowie die maximal 16384 Byte große Datei über `PinnedFile`. Besitzer -müssen SYSTEM/Administrators bleiben; zusätzliche Leser dürfen nur die -festgelegte Lesemaske besitzen. Beide Images müssen zu den Settings passen. -Die Prüfung bindet Dateiinhalt und FileID; spätere Rechecks öffnen denselben -Namen erneut und verwerfen Austausch oder Änderungen. Fehlerhaft beobachtete -Konfigurationen oder fehlgeschlagene Reads stellen alte Autorität nicht wieder -her; geänderte Bytes derselben Generation gelten als Fork. - -Im neuen Agenten versucht die passive Heartbeat-Schleife das Setup bei bisher -fehlendem Profil erneut. Ein erster Pin benötigt daher nach Quellenvertrag -keinen Dienstneustart. Das ist **noch kein VM-Nachweis**. Der Agent schreibt erst -nach tatsächlich erfolgreichem `complete` pro Verbindung öffentliche historische -`agent-time-sample.json` und `helper-time-sample.json` in sein bestehendes -geschütztes State-Verzeichnis. Der Helper-State bleibt unverändert. Root muss -diese Originalbelege noch für die tatsächlich installierten Rollen und -Konfigurationsbytes prüfen. Ein Statusfile ersetzt kein aktuelles Job-Startgate. - -## Tatsächlich lokal ausgeführt - -- Python-Syntaxprüfung und geschlossene Sourceguards: PASS. -- Sechs lokale Vertragsfälle: PASS. Sie prüfen die reinen Referenzbytes, - fehlende Paarbelege, falsche Rollen/Images/Geburt/SID/FileID/Policy/Identität, - create-only, begrenztes Lesen, Symlink- und Duplicate-JSON-Verweigerung. - Positive In-Memory-Fixtures sind ausdrücklich keine native Qualifikation. -- Beide erzeugten PowerShell-ASTs mit vorhandenem lokalem Parser: PASS. -- Lokale ETS-Integer-/Bool-/String-Reproduktion sowie Objekt-/Arrayreihenfolge: - PASS. Der unveränderte Vergleich aus `e6debe5` war unter Windows PowerShell 5 - unzureichend: ETS-verpacktes `System.Int32=1` konnte im Objektzweig zu `{}` - werden. Der exakt übernommene Comparator aus der getrennt geprüften - Clockquelle `90c2708c…` rekonstruiert CLR-Skalare vor dem Objektzweig als - unadornierte Werte. Der Clockoperator hat diesen Vergleich außerdem tatsächlich - gegen den vollständigen alten Livezustand und ETS-Positiv-/Negativfälle - geprüft (`82c4ebe7…`). Das ist kein Profilinstallationsnachweis. -- Die festgehaltenen öffentlichen Eingänge, rohen Rollenbelege und realen - Quell-/Buildbelege werden vom Operator lokal erfolgreich gelesen. Die durch - Root tatsächlich ausgeführten neun Linux- und neun Windows-Zeitmodulprüfungen - sind über deren Originalbeleg-Hashes und exakte Testnamen angebunden. -- `prepare` ohne reale Paarbelege: erwartete Verweigerung ohne angelegten Fall. - -Im ursprünglichen lokalen Quellprüfstand noch nicht ausgeführt: Übertragung, -ACL-Änderung, Konfigurationsinstallation, -Produktdienst-Laden/Reopen auf der VM, signierte passive Laufzeitabnahme, -WebUI-Genehmigung oder RMM-Job. Der damalige Transportausfall nach Notebook-Suspend war später im -bestätigten Wartungsfenster behoben. Der vorbereitete Fall `570c7a86…` bleibt -unverändert ohne neue Rollenbelege; der tatsächliche neue Paarbeleg ist4887. - -## Tatsächlicher gebundener Vorbereitungsschritt und Transfer - -Lokale Vorbereitung `ad9fd154-b2be-4f5d-9e17-65abb721ceaf` bestanden; -Config-SHA256 `2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`, -Manifest `0c9a3ffeed490757f7bd8c63d7e2ec28156212945094621f511e20679ce0b3b0`. -Der getrennte Bindungsreview des Operators `a8d55b60…` hat bestanden. -Erste tatsächliche Transferphase begann nach `2026-11-15T15:27:41Z`. -Der fixierte Controller wurde einmalig übertragen und separat hashgeprüft; -Originalantwort `stage-reply.json` im genannten privaten lokalen Fall, -SHA256 `29f7654f766ebb53045832bb8c5ed6c83d2cbd96e0a5e1ce6df494cef0c026e6`. -Noch kein Konfigurationsinstallations- oder Laufzeitnachweis aus diesem Schritt. - -## Tatsächliche Installation: Teilzustand, nicht abgeschlossen - -Der einmalige Installationsaufruf begann nach `2026-11-15T15:28:18Z`. -Die VM hielt vor der ersten Erstellung die Originaluntergrenze -`2026-11-15T15:28:24.1309868Z` im Intent fest. Der Bootstrap endete mit -`IOException` an Controllerzeile294, dem einzigen -`[IO.File]::Move($staged,$target)`. Der ursprüngliche sichere Fehlerbeleg -`windows-client/system-pipe-upgrade/remote-error-b01d395c-9141-4bc6-ad70-1b67fb936881.json` -enthält Exit1, Fehlerklasse und Zeile, keinen privaten Fehlertext. Die genaue -I/O-Ursache ist damit noch nicht geklärt; es wird kein Sharing-/ACL- oder -Antivirusproblem als bewiesen ausgegeben. Es gab keinen zweiten Installversuch. - -Ein eigener ausschließlich lesender Originalaufruf begann nach -`2026-11-15T15:28:37Z` und bestand. Originalantwort im privaten Fall -`ad9fd154-b2be-4f5d-9e17-65abb721ceaf`: -`read-51eea530-4155-42d7-9053-1008e84059b6-reply.json`, SHA256 -`93143fc05e7c814e9b164cd322abd411eee0dedcb485fbb5547a1db8f1975cd2`. -Die feste Zieldatei ist **nicht vorhanden**. Der ursprüngliche Intent, aktive -NoRetry-Marker, Directory-ACL-Intent und dessen Abschluss sowie der -Publish-Intent sind vorhanden; ein `result.json` fehlt. Die nur für diesen -Ordner erlaubten Service-Leserechte wurden somit gesetzt, die Konfiguration -wurde nicht veröffentlicht. Originale FileIDs/Hashes/PKI-Metadaten, laufende -Agent-/Helper-Prozessgenerationen, Jobfreiheit und Journalzeugen bestanden die -lesende Erhaltungsprüfung. - -Der Teilzustand bleibt unverändert; kein Retry, Rollback, Dienstwechsel oder -RMM-Job wurde ausgeführt. Der passive Zeit-Collector wurde ausdrücklich -**nicht** gestartet. `clock_runtime_qualified=false` bleibt bestehen. Nach dem -bestätigten Wartungsfenster bis15:30UTC erfolgen keine weiteren VM-Aufrufe. -Die gesonderte serverseitige `agent.update`-Inventar-Constraintkorrektur und -anschließend frische Heartbeats/ACKs sowie echte signierte Zeitbelege bleiben -getrennt zu prüfen. Eine spätere Fortsetzung benötigt zuerst eine lesende -Ursachenklärung und einen konkret geprüften Vertrag für den ursprünglichen -Teilfall; ein neuer Fall darf diesen Marker nicht umgehen. - -## Sharing-Verletzung bei der Konsolenfinalisierung - -Die VM meldete beim gesonderten Konsolenabschluss für `File.Move` den HRESULT -`0x80070020` (Win32 32, Sharing-Verletzung). Der Helper hielt seit seinem -Start einen Lesehandle auf `C:\ProgramData\RustDiscoverySystem`. Der Code -erlaubte ausschließlich `FILE_SHARE_READ`. Beim Verschieben des Kandidaten -aus dem Bootstrap-Verzeichnis öffnet Windows den **Zielordner** für -`FILE_ADD_FILE`. Dieser Zugriff kollidiert mit dem gehaltenen Handle. Die -native Fehlermeldung nennt keine Prozess-ID. Die Zuordnung folgt aus den -Öffnungsmodi des Helpers und der dokumentierten Windows-Rename-Operation. -[Windows-Rename](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/87f86c9b-6c2a-4803-84b7-131a74a434fa) -· [Windows-Sharingprüfung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/8c0e3f4f-0729-49f4-a14d-7f7add593819) - -Im korrigierten Quellstand öffnen der Helper, der Agent beim Laden des -Peer-Pins und die Zeitprüfung genau diesen öffentlichen Stamm über -`PinnedFile::open_read_shared`. Der Lesehandle lässt auch einen berechtigten -Schreibzugriff auf den Ordner zu. Weiterhin sperrt er das Löschen und -Umbenennen des Ordners. Über Kinddateien entscheiden deren eigene DACL und -gehaltene Datei-Pins. Einstellungen, Peer-Pin und Zeitprofildatei werden -weiterhin mit geteiltem Lesezugriff geöffnet. Die vorhandenen Prüfungen von -Owner, DACL, Reparse-Attributen und Dateiidentität laufen bei jedem Pin. - -Workspace-Formatprüfung, Cargo-Check aller Windows-Ziele mit `system-helper` -und Clippy mit `-D warnings` bestanden im Windows-Clock-Builder offline. -Beide x86-64-PE-Debugprogramme wurden dort gelinkt. Agent-SHA-256 -`b5fe5ea55c857415c979f06851e54a2d1fbe4cbfe2fe7ad1660e209aae3fa583`, -Helper-SHA-256 `c6b41b0867df23f2c04c2550a39678672ef66d35a4b41215769265924deaf8a1`. -Der erste Buildversuch endete in einem anderen Builder wegen fehlendem -`widl`. Die Windows-VM hat diese Änderungen bisher weder ausgeführt noch -durch erneute Profilveröffentlichung und zwei passive Rollenbelege bestätigt. - -### Optimiertes Release-Paar für die nächste Windows-Abnahme - -Am 15. November 2026 wurden Agent und Helper aus Commit -`e952698f5e2bab808e816858a727ef40347f6142` auf dem Entwicklungsrechner -gebaut. Der Quellstand kam aus einem schreibgeschützt eingebundenen Git-Archiv. -Der unabhängige Vergleich nach dem Build bestätigte alle 708 Quelldateien -gegen Git-Tree `708c88b4d6a92d9f9cbebc70146250062532f45f`. -Rust 1.99.1 und Cargo 1.99.1 liefen im vorhandenen Clock-Builder ohne Netzwerk. -Der ausgeführte Befehl war - -```sh -cargo build --release --target x86_64-pc-windows-gnu --features system-helper --locked --offline -p rmm-agent-windows --bin rmm-agent-windows --bin rmm-helper-windows -``` - -| Datei | Bytes | SHA-256 | -| --- | ---: | --- | -| `rmm-agent-windows.exe` | 23 543 434 | `2dd64e743431ad4c8244e43bef30c4c1c2123ad26a094853811a418626bb87e7` | -| `rmm-helper-windows.exe` | 17 191 183 | `9c313c07a20c82797cbd8c8ca7c289c1d227b0bd6a4a686f38c4db3bbdded199` | - -Beide Dateien haben einen ausführbaren PE32+-Header mit AMD64-Maschinenkennung -`0x8664`. Der private Originalbeleg `profile-share-release-e952698/receipt.json` -hat SHA-256 `1ec1ec472043e8673e5b92f9029fd809434451d9452e3b24bbd85b21f017017d`. -Das erste Prüfskript traf auf dem Notebook auf eine ältere Python-Hashlib ohne -`file_digest`. Die Nachprüfung lief mit SHA-256 über dieselben fertigen Bytes. -Die Installation dieses Paars und die native Profilveröffentlichung mit den -zu diesen Binaries passenden Zeitprofilbindungen stehen aus. - -## Unabhängiger lokaler Review des Move-Fehlers und fester Diagnosepfad - -Der nachfolgende Review liest ausschließlich Quellen und vorhandene öffentliche -Originalbelege auf dem Entwicklungsrechner. Kein Gast-/Serverzugriff, keine -Installation, kein Retry und keine Freigabe wurden dabei ausgeführt. - -Belegt ist der Ablauf bis zum Publish-Intent mit Kandidathash -`2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`, -1177Bytes, Volume9815088561147542064 und FileID6d990300000003000000000000000000. -Der spätere originale Read93143fc0… belegt das fehlende Ziel und fehlendes Resultat. -Er fragt jedoch die Kandidatdatei selbst nicht ab. Ihr aktueller Bestand ist -somit **nicht** nachgewiesen. Original-rootSDDL im Intent, ACL-done-SDDL und spätere -rootSDDL sind bytegleich: die ACL-Phase wurde ausgeführt, ohne effektive Rechte -zu ändern. Bestehende NoRetry-Marker bleiben bestehen. - -Die genaue Ursache der IOException ist mit diesen Belegen nicht bestimmbar. -Der alte Fehlerbeleg enthält weder HRESULT noch nativen Fehlercode. Die statisch -geprüften WriteBytes-, FileIdentity- und FileVolume-Handles werden in `finally` -geschlossen; ein eigener Handleleak ist daraus nicht belegt. Das rechtfertigt -weder eine Sharing-Lockerung noch Dienststopp, ACL-Änderung, Antivirusausnahme, -Copy/Delete-Fallback oder erneuten Move. Microsoft beschreibt für -[File.Move](https://learn.microsoft.com/en-us/dotnet/api/system.io.file.move) -mehrere IOException-Ursachen; die Regeln für vorhandene Handles stehen getrennt -in [CreateFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilew). -Sharing, Defender oder ein konkreter Win32-Code bleiben hier ausdrücklich -Hypothesen. Der ursprüngliche HRESULT darf aus späteren Lesefehlern nicht -rückwirkend abgeleitet werden. - -Der bestehende Pythonoperator hat deshalb einen **separaten, ausschließlich -lesenden** Originalfallpfad `diagnose-partial` erhalten. Er bindet ausschließlich -Fallad9fd154-b2be-4f5d-9e17-65abb721ceaf, dessen Manifest0c9a3ffe…, -Originalgeneratora8d55b60…, Originalcontrollerd8b4fd4f… und Konfigurationshash2b4a…. -Die vorhandenen Marker und Originaldateien werden nicht geändert. `load_case` -wird absichtlich nicht verwendet: dessen Generatorbindung darf nicht auf die -neue Quelle umgedeutet werden. Ebenso wird keine neue Skript-SHA als ursprüngliche -`request.script_sha256` ausgegeben. Der neue Reader hat eine eigene Source-SHA, -die der kleine In-Memory-Launcher vor der Ausführung prüft; genau ausgeführte -Readerbytes, Intent, rohe Antwort und separater Receipt werden ausschließlich -in einem neuen lokalen700/600-Diagnosefall gespeichert. - -Geplanter Aufruf, **hier nicht ausgeführt**, erst nach erneut ausdrücklich -bestätigtem Zugang und dessen erfolgreichem Readback: - -```sh -python3 /home/kevin/Schreibtisch/Coding/rust-discovery-signed-clock/deploy/windows/time_profile_config.py diagnose-partial -``` - -Kein `--case`: der Reader akzeptiert keine andere Fall-ID oder frei wählbare -Pfade. Die lokalen Originalbelege liegen weiterhin im Agent-Updater-Worktree. -Die geschützte aktuelle Zugangskonfiguration muss noch mindestens60s zulassen; -sonst erfolgt kein SSHaufruf. Native PowerShell-AST-/VM-Ausführung dieses neuen -Readers sind noch offen. Er enthält keine Publish-/ACL-/Serviceoperation und -fragt weder Uhrqualität noch Dienst-Snapshot ab. - -Der Reader liefert nur aktuelle Kandidat-/Zielidentität, Größe, Hash, DACLhash, -Attribute und Zeiten sowie feste Originalmarker/active-Bindung und Root-SDDL. -Aktuelle Lesefehler werden mit Exceptiontyp/HRESULT und nur bei passender -HRESULT-Facility mit Win32-Code aufgezeichnet, ohne freien Fehlertext. Diese -Nummern gehören ausschließlich zum **neuen Leseversuch**. Er setzt immer -`old_move_hresult_unknown=true`, `retry_authorized=false`, -`installation_verified=false` und `clock_runtime_qualified=false`. - -Das Ergebnis ist Grundlage einer späteren Entscheidung, keine Retryerlaubnis: - -- Kandidat unverändert und Ziel fehlt: Veröffentlichung weiterhin nicht erfolgt; - im nächsten aktiven Wartungsfenster anhand des Originalzustands mit einem - überprüften Finalisierungsbefehl fertigstellen. Das MVP-/Profilvorhaben ist - bereits beauftragt; dafür keine pauschale zusätzliche Chatgenehmigung verlangen. -- Ziel vorhanden: weder Move noch Install erneut aufrufen; zuerst Ziel-/Kandidat- - FileID-/Hash-/ACLbindung und tatsächliche Laufzeitwirkung getrennt beurteilen. -- Fehlender/veränderter Kandidat, widersprüchliche Marker, andere Dateiidentität - oder Lesefehler: Teilzustand erhalten, keine automatische Rekonstruktion, - Löschung oder Rechte-/Dienständerung. - -Lokal tatsächlich bestanden: Pythoncompile, bestehende Sourceguards und acht -Vertragsfälle, davon zwei neue für den geschlossenen Reader und seine exakte -Source-/Intent-/Receiptbindung ohne Legacy-Hashadoption. Der Transport ist dabei -vollständig gemockt; dies ist kein nativer Befund. Die Kontrollbelege des alten -fehlgeschlagenen Installationsfalls bleiben bytegleich erhalten. Ein konkreter -Publikationsfix wurde mangels belegter nativer Fehlerursache nicht erfunden. - -## Nachlese durch die Bedienperson auf der Windows-VM - -In der administrativen VM-Konsole konnte die Bedienperson den Kandidaten -`time-attestation.candidate.json` lesen. SHA-256 stimmte mit dem im -Publish-Intent hinterlegten Wert `2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b` -überein. Für den festen Zielpfad unter `RustDiscoverySystem` meldete -PowerShell `ObjectNotFound`. Dieser Konsolenbefund ergänzt den früheren -Readback um den Inhalt des verbliebenen Kandidaten. FileID, DACL und -Dienstgeneration wurden bei dieser Konsolenabfrage nicht erfasst. - -Für die Fortsetzung an derselben VM-Konsole liegt -[`Complete-OriginalTimeProfile.ps1`](../deploy/windows/Complete-OriginalTimeProfile.ps1) -bereit. Der Befehl übernimmt die Prüffunktionen aus den SHA-256-geprüften -Bytes des bereits installierten Controllers. Vor der Veröffentlichung prüft er -die ursprüngliche Datei-ID und das Volume, den Inhalt, die DACL, die -ursprünglichen Marker und beide laufenden Dienstgenerationen. Er hält die -beiden Prozesshandles während der Veröffentlichung offen. Ein exklusiv -erstellter zusätzlicher Marker verhindert eine doppelte Ausführung. - -Nach der Verschiebung an den festen Zielpfad vergleicht das Skript die -Dateiidentität und die Dienstzustände erneut. Bei einem neuen Move-Fehler erfasst -es Fehlerklasse und HRESULT für diesen Aufruf. Ein erneuter Start trifft auf -den Abschlussmarker oder den vorhandenen Zielpfad und beendet sich. Das -Ergebnis einer erfolgreichen Veröffentlichung hält die separate -Laufzeitprüfung der beiden Dienstrollen ausdrücklich offen. - -Lokal geprüft wurden die PowerShell-Syntax, die Bindung an die gespeicherten -Originalbelege und der Vergleich mit der tatsächlichen Kandidatenidentität. -Eine veränderte FileID wurde im lokalen Vergleich abgewiesen. Die Ausführung -des Abschlussbefehls auf der VM und die anschließende Zeitprüfung stehen aus. - -## Ergebnis vom Konsolenschritt automatisch abholen - -Für den vorbereiteten Profilabschluss steht `Open-TimeProfileReceiptWindow.ps1` -zur Verfügung. Die Bedienperson startet es auf der Windows-VM. Das Skript prüft -die beiden Downloads gegen feste SHA-256-Werte, öffnet den vorhandenen -Reverse-SSH-Transport und führt den festen Abschluss lokal aus. Die -Weiterleitung auf dem Server ist an `127.0.0.1:22240` gebunden. Auf der VM -endet sie an einem temporären Loopback-Port. Der Prozess sendet dort den -Abschlussstatus und die öffentlichen Belege der beiden Zeitdienstrollen. -Er liest keine Befehle vom Socket. Die Gast-Kontofrist und die Aufgabenplanung -werden nicht geändert. Strg+C oder zwölf Minuten beenden das Vordergrundfenster. - -Die serverseitige Frist für den vorhandenen Transportschlüssel und der aktive -Abschalttimer wurden für den 15. November 2026, 18:00 Uhr MEZ, geprüft. -Beim Bereitstellen wurden der PowerShell-Parser, die Downloadhashes, die -bestehenden Quellprüfungen und die sechs lokalen Prüffälle für die Zeitbelege -ausgeführt. Ein Ergebnis von der VM liegt bei Bereitstellung noch nicht vor. - -Der Ergebnisempfänger auf dem permanenten Server wurde anschließend gestartet. -Seine Anfangsprüfung des laufenden Gateways und der gespeicherten -Windows-Gerätebindung war erfolgreich. Der Server fragt den Loopback-Port -nur bei vorhandenem SSH-Listener ab und legt eingehende Belege im privaten -Fall `time-profile-receipt-f7f56e9f` ab. Für Zeitbelege verwendet er die -bestehende Rollen-, Boot-, Generations- und Altersprüfung mit je einer -Datenbanklesung vor und nach dem Empfang. Die Bereitstellung des Empfängers -belegt noch keine Profilveröffentlichung auf dem Gast. - -## Rückmeldung der Windows-VM am 15. November um 17:05:36 Uhr MEZ - -Der Empfänger hat im Fall `time-profile-receipt-f7f56e9f` die Antwort -`finalization_failed` gespeichert. Der Abschlussbefehl bestand die Prüfungen -auf Kandidat, Berechtigungen und Dienstgenerationen bis zur Veröffentlichung. -Der Aufruf von `File.Move` meldete HRESULT **0x80070020** -(`ERROR_SHARING_VIOLATION`). Zeile 94 gibt diesen Fehler an den Aufrufer -weiter. Empfangsbeleg SHA-256 -`7cc51d44abfbe7949b0896053a463f3bd140b1844229e9ba206683db34d6f2ba`, -Ergebnis `172edeaf54ca08f4e5b1ad3662884da6ec217636ca30bbd8274e73140f6ef35b`. - -Der Code des installierten Helpers öffnet das öffentliche Stammverzeichnis -mit Lesezugriff und ausschließlich `FILE_SHARE_READ` und hält diesen Handle -im laufenden Dienst. Ein Rename aus einem anderen Verzeichnis benötigt am -Zielverzeichnis `FILE_ADD_FILE`. Das erklärt einen konkreten Konflikt. -Die VM-Rückmeldung enthält keine Liste der tatsächlich offenen Handles. -Für den älteren Installationsaufruf ohne HRESULT bleibt der Fehlercode -unbekannt. Das laufende Konsolenskript hat keine weitere Veröffentlichung -versucht. Für diesen Lauf liegt keine erfolgreiche Zeitprüfung vor. -[Windows-Dateisystemregeln für Rename](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/87f86c9b-6c2a-4803-84b7-131a74a434fa) - -Nach der fehlgeschlagenen Erstveröffentlichung ergab eine unabhängige Abfrage -von `inventory.get_device` über den permanenten Server einen neuen Kontakt -um 17:12:44 Uhr MEZ, Präsenz `online` und Quelle `windows.base`. -Geräte-ID, Agent-ID, Assignment, Enrollmentgeneration und authentifiziertes -Zertifikat stimmten mit der Telemetrieabnahme vor dem Profilversuch überein. -Der Agent meldete weiterhin die drei passiven Fähigkeiten `heartbeat/1`, -`windows.base/1` und `agent.update/1`. -### Erstprovisionierung nach dem belegten Sharingkonflikt - -`Complete-OriginalTimeProfile.ps1 -InitialCreate` ist eine eigene Reparatur -für das bislang fehlende Ziel. Sie setzt den vorhandenen Abschlussintent und -den gespeicherten Fehler `File.Move / System.IO.IOException / 0x80070020` -voraus. Die ursprünglichen Quell-, ACL-, Dienst-, Geräte- und -Kandidatenbindungen gelten weiter. Der ursprüngliche Kandidat bleibt als -Referenz erhalten. Der alte Move-Erfolg und dessen `result.json` werden durch -diesen Pfad nicht nachträglich erzeugt. - -Der feste neue Name wird genau einmal mit `CreateNew` angelegt. Windows -erhält dabei bereits eine geschützte DACL mit explizitem Leseverbot für die -beiden Service-SIDs. Der kontrollierende Prozess besitzt den einzigen -Datenhandle. Er schreibt und flusht die 1177 qualifizierten Bytes und liest sie -über denselben Handle vollständig zurück. Er prüft Hash, Volume, neue FileID, -einzigen Hardlink, Länge und DACL. Dann prüft er die ursprüngliche -Kandidatenidentität und die laufenden Dienste noch einmal und schreibt einen -Prüfbeleg. Erst jetzt setzt er die bereits gebundene endgültige DACL auf dem -gehaltenen Handle und prüft Identität, Hash und DACL erneut. Nach Schließen -folgt eine separate Prüfung beider Pfade und Dienste. Damit wird eine neue -Ziel-FileID dokumentiert. Die DACL des öffentlichen Ordners bleibt unverändert. -[Windows-Dateierstellung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/498a5eeb-afc9-445f-99ed-a7e4b73c648b) -[.NET-Framework-Konstruktor mit Erstellungs-DACL](https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream.-ctor?view=netframework-4.8) - -Eine vor der DACL-Freigabe unterbrochene Erstellung kann eine vorhandene -Teildatei mit gesperrtem Dienstzugriff hinterlassen. Nach erfolgter -DACL-Freigabe ist die Datei lesbar, auch wenn der Prozess vor dem -abschließenden Ergebnis ausfällt. Ein neuer Versuch wird in beiden Fällen -verweigert. Die getrennten `console-initial-create-*`-Dateien dokumentieren -Intent, verifizierte neue Zielidentität und tatsächlichen Abschluss oder -Fehlerphase. Das Ergebnis weist `clock_runtime_qualified=false` aus. Für -dessen positive Bewertung sind weiterhin die unabhängigen Zeitbelege der -installierten Dienste erforderlich. - -Lokal bestanden Parserprüfung, Kompilierung des kleinen nativen -Handle-Readers, Prüfung seines Strukturlayouts und drei simulierte -Entscheidungsfälle mit echtem beziehungsweise verändertem Fehlerbeleg. -Der frühere lokale Prüfharness wählte beim ersten Strukturlayoutaufruf die -falsche .NET-Überladung; nach Angabe des Typs bestand die Prüfung. Der -Original-Kandidaten-/FileID-Vergleich und die acht bisherigen Profilfixtures -bestanden ebenfalls. Dieser Stand wurde auf der Windows-VM noch nicht -ausgeführt. - -Das passende Konsolenfenster ruft ausschließlich die Variante `-InitialCreate` -auf. Der neue Empfänger `time-profile-receipt-f0488aba` war vor Übergabe des -Befehls aktiv und hat die erwartete Geräte- und Gatewaybindung geprüft. Er -unterscheidet die neue Rückmeldung von der alten Move-Fehlermeldung und -speichert die Erstveröffentlichung und den signierten Rollenvergleich getrennt. -Für diesen Skriptstand liegen bei Bereitstellung ausschließlich lokale Prüfungen -vor. Die Bestätigung der VM steht aus. - -Am 15. November endete die Freigabe um 18:00 Uhr MEZ. Der Empfänger für -die Erstveröffentlichung schloss mit `window_expired`. Es lag keine -entsprechende Gastquittung vor. Für die Fortsetzung wurde derselbe -Weiterleitungsschlüssel bis 23:45 Uhr MEZ freigegeben. Frist und aktiver -Abschalttimer wurden auf dem Server geprüft. Der neue Empfänger -`time-profile-receipt-a6bb4e2f` hat den Gateway- und Gerätebezug geprüft -und ist bereit. Der Konsolenstarter nimmt die Serverfrist als Parameter -`-Until` entgegen und begrenzt jeden lokalen Start weiterhin auf zwölf Minuten. - -### Rückmeldung aus dem Abendfenster - -Um 20:24:02 Uhr MEZ empfing der Server im Fall `time-profile-receipt-a6bb4e2f` -die Gastquittung `finalization_failed`. Der Aufruf mit `CreateNew` hatte das -Ziel geöffnet. Bei der ersten Prüfung am offenen Handle wich die vom Kernel -gelesene SDDL-Zeichenfolge vom vorbereiteten Sicherheitsdeskriptor ab. Der -Controller brach in `verify_creation` in Zeile 176 mit `0x80131501` ab. -Der Abbruch lag vor dem ersten Schreiben von Profilbytes und vor der Freigabe -der Datei für die Dienste. Der HRESULT stammt von der ausgelösten -PowerShell-Ausnahme. Er identifiziert keine abweichende Berechtigung. - -Die Quittung enthält weder die beiden Deskriptoren noch eine spätere Nachlese -der Zieldatei. Der konkrete Unterschied und der aktuelle Dateizustand bleiben -zu prüfen. Der Empfänger beendete sich nach diesem Fehler wie vorgesehen. -Es gibt aus diesem Lauf keinen erfolgreichen signierten Rollenvergleich. -SHA-256 der Gastantwort samt Serverkontext: -`a1725dbc532f022857e828080bec107ec32efd58836e22dd250909b9d7c2d28b`. - -Ein separater MCP-Abruf bestätigte anschließend einen neuen Windows-Heartbeat -um 20:25:35 Uhr MEZ. Präsenz war `online`, die Quelle `windows.base`. -Gerät, Agent, Assignment, Enrollmentgeneration und authentifiziertes Zertifikat -stimmten mit dem früheren Abnahmebeleg überein. Beleg-SHA-256 -`7ea828b42b3c7948956aad56845502ffa52192ce6ca14728203f8574d70a28ec`. - -Der Konsolenstarter prüft im aktualisierten Quellstand vor einem Aufruf des -Abschlussbefehls auf einen vorhandenen Fehler oder einen offenen Intent. -In beiden Fällen liest er den vorhandenen Stand. Die Rückmeldung kennzeichnet -mit `finalizer_invoked`, ob dieser Start den Abschlussbefehl aufgerufen hat. -Enthält der Fehlerbeleg die bei der Erstellung verglichenen Deskriptoren, -überträgt der Starter sie mit der Länge und den vorhandenen Datei-IDs an den -Ergebnisempfänger. Ältere Fehlerbelege bleiben ohne diese Angaben lesbar. - -Der PowerShell-Parser und fünf lokale Fälle bestanden: erster Aufruf, -vorliegender Fehler, offener Intent, bereits vorliegender Erfolg und -widersprüchliche Erfolgs-/Fehlermarker. Nur der erste Fall rief im Test den -simulierten Abschluss auf. Diese Prüfung lief auf dem Entwicklungsrechner. - -### Fehlerbeleg beim ersten Vergleich des Sicherheitsdeskriptors - -Unterscheiden sich Soll- und Ist-SDDL an der neu angelegten Datei, erfasst der -Controller beide Werte für Besitzer, Gruppe und DACL am exklusiv gehaltenen -Dateihandle. Der private Fehlerbeleg enthält dazu das optionale Feld -`creation_descriptor` mit `expected_sddl`, `actual_sddl` und `bytes`. -Bei erfolgreicher nativer Identitätsabfrage kommen `file_id` und -`volume_serial` hinzu. Scheitert das Lesen der Zusatzmetadaten, hält -`metadata_hresult` dessen Fehlercode fest. Die ursprüngliche Abweichung -bricht den Aufruf vor dem Schreiben der Profilbytes und der Rechtefreigabe ab. -Der ältere Gastbeleg enthält diese neuen Felder noch nicht. - -Lokal bestanden die Parserprüfung, vier PowerShell-Fälle für Vergleich und -Fehlerbeleg sowie die acht vorhandenen Profiltests. Die vier Fälle umfassten -ungleiche Deskriptoren mit lesbarer beziehungsweise fehlender FileID, einen -gleichen Deskriptor und einen unabhängigen Folgefehler. Die FileID-Abfrage war -simuliert. Eine native Abnahme dieser Belegerweiterung steht aus. - -### Konsolennachweis der leeren Zieldatei - -Die Bedienperson las den festen Zielpfad auf dem Windows-Gast. Die -Dateigröße betrug 0 Byte. Beim Vergleich der ungebrochenen SDDL-Texte -unterschieden sich ausschließlich die DACL-Steuerflags: erwartet `PAI`, -gelesen `P`. Beide Deskriptoren enthalten denselben Eigentümer und dieselbe -Gruppe (BUILTIN-Administratoren), die geschützte DACL und dieselben sechs -expliziten ACEs in identischer Reihenfolge. Die beiden Dienst-SIDs haben -je eine explizite Verweigerung von ReadData. Der Befund erklärt den -Textvergleichsabbruch. Er belegt keine Freigabe der Datei. - -SHA-256 der UTF-8-Texte ohne die Zeilenumbrüche der Konsolendarstellung: -erwartet `d4726c7973c9b0cd8a66c1b129d1b5eb58d2bbfc1b103018e0a31a71fb1d9020`, -gelesen `a0e1d856ed3bdbe884b23599f7c53d8a281d6409a42bbfa48649127b2aa22793`. -Die erste Fehlerquittung enthielt keine FileID der leeren Zieldatei. - -Der Modus `-ResumeEmpty` prüft die bestehenden Fallbelege und öffnet das -leere Ziel exklusiv. Vor dem Schreiben protokolliert er dessen jetzt -festgestellte FileID. Dieselbe Kennung muss nach dem Schreiben und nach -der Freigabe der Leserechte wieder vorliegen. Beim DACL-Vergleich sind nur -die beiden für diesen Fall beschriebenen Formen zulässig. Der Starter -vergleicht die FileID zusätzlich mit der Quittung. Der Rückkanal überträgt -das Ergebnis und die passiven Zeitmessungen. - -Lokal bestanden acht Profiltests, die PowerShell-Parserprüfung, die -C#-Kompilierung, fünf AMD64-Strukturlayoutprüfungen und 20 Vergleiche -von Sicherheitsdeskriptoren. Acht lokale Fälle prüften die Auswahl des -Startmodus und das Verhalten bei vorhandenen Markern. Die Anwendung auf -dem Windowsgast und signierte Zeitmessungen beider Dienste stehen aus. - -### Windows-VM, 15. November 2026, 20:40 Uhr MEZ - -Der Controller schloss die Profilinstallation im Fall -`ad9fd154-b2be-4f5d-9e17-65abb721ceaf` ab. Ab -`2026-11-15T19:40:47.0850024Z` schrieb er die vorbereiteten 1177 Bytes. -Beim Rücklesen stimmten der erwartete SHA-256 -`2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b` -und die bei leerer Datei protokollierte FileID -`95990300000007000000000000000000` überein. Der Kandidat blieb erhalten. -Agent und Helper liefen während der Veröffentlichung weiter. - -Der Empfänger auf dem Projektserver bestätigte die Quittung in Sitzung -`d8b4b255-8e3f-4aa7-8377-684ce9adbea1`. -SHA-256 des Gast-Ergebnisbelegs -`62a04be9c7d08d3687b51eacd6adbe290b91e16ba934d6b5bb531e8764a56cf5`, -SHA-256 der serverseitigen Publikationsquittung -`1a0ce65c852523072d6822024541591482e0bae3788834993c2548e9cbf7647e`. -Um 20:40:59 Uhr MEZ fehlte beim anschließenden Lesen noch mindestens -einer der beiden passiven Zeitbelege. diff --git a/docs/windows-time-route-fixture.md b/docs/windows-time-route-fixture.md deleted file mode 100644 index 554da9e..0000000 --- a/docs/windows-time-route-fixture.md +++ /dev/null @@ -1,55 +0,0 @@ -# Windows: fester passiver mTLS-Zeitrouteprobe - -Stand2026-11-15: Quelle und lokaler Windows-Cross-Link fertig, **noch keine native Ausführung**. Dieser enge Fixture dient als HTTP-/Broker-Endpunktnachweis vor dem erhaltenden passiven Paarupgrade. Er ist kein installierter Dienstrollen-, Trusted-Clock-, SignedSync-/Ready- oder Jobnachweis. - -`crates/agent-windows/examples/time_route_probe.rs` verwendet ausschließlich die bestehende Geräteidentität der Windows-VM. Gerätecert/-key bleiben in den festen vorhandenen Statepfaden und werden nur intern für den gemeinsamen `https_channel::mtls_client` gelesen. Private Keybytes werden weder ausgegeben noch gehasht oder in Evidence kopiert; der zusätzliche rohe Zwischenbuffer wird nach Clientbau gelöscht. Es gibt kein PFX, Enrollment, neues Gerät, frei wählbares Netzwerkziel, Shellkommando oder Zertifikats-/Namensprüfungs-Bypass. Domain/SAN/SNI, Projekt-CA, TCP-Ziel88.99.80.202:443 und `/agent/v1/time-attestation` bleiben fest. Der Pool wird für die drei Aufrufe wiederverwendet. - -Der Fixture läuft nur als tatsächlich berechtigter Bootstrapadministrator ohne Threadimpersonation. Er behauptet ausdrücklich keine LocalService-/SYSTEM-Ausführung. Eigener fester Fallpfad: `C:\ProgramData\RustDiscoveryBootstrap\time-route\`, darin vor Start genau `TimeRouteProbe.exe`, `context.json`, `time-public-key.json`. Die beiden Kontrollpfade müssen Root-/Administrators-/SYSTEM-geschützt sein. Der tatsächliche EXE-Pfad muss zum eigenen Fall passen; `intent.json` wird create-only **vor** dem ersten Netzwerkaufruf geschrieben. Nach verlorenem Ergebnis werden ausschließlich Originaldateien gelesen, nicht derselbe Lauf wiederholt. - -Die bestehende passive Agentkonfiguration und der bisherige öffentliche Peerpin sind fest an ihre Originalhashes aus14fb gebunden. Die Geräte-/Tenant-/Enrollment-/Assignment-/Jobpublickeybindung stammt aus diesem geschützten Peerpin; Agent-/Asset-ID sind fest. Deshalb ist dieser Fixture absichtlich für den Stand **vor** dem Paarupgrade vorgesehen. Ein später geänderter Peerpin wird nicht still adaptiert. Der echte separate öffentliche Zeitpin ist SHA256 `c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2`, unabhängig vom konkreten Jobkey geprüft. Private Signierdateien wurden nicht gelesen. - -## Feste Protokollfälle und begrenzte Aussage - -Je Aufruf wird eine neue eigene256-Bit-CSPRNG-Nonce verwendet, mit eigener zufälliger Prozessinkarnation und dem fest gebundenen Kontext. Positive Antwort: HTTP200, exakte kanonische Codec-/Signaturbytes, strikte Ed25519-Prüfung mit dem echten öffentlichen Zeitkey, kompletter Originalrequesthash einschließlich Nonce/Context, Serverinstanz/-boot, Key-ID/-generation und begrenzte signierte Qualitätsfelder. Verwendet wird der vorhandene `DalekVerifier`; kein neuer Algorithmus und keine vorgetäuschte `Sample`-/Calibration-/Clockkonstruktion. - -Die beiden weiteren festen Fälle verändern ausschließlich den Tenant zur bekannten anderen Test-Tenant-ID (erwartet403) beziehungsweise die zuvor von Root gelesene aktuelle Connectiongeneration auf deren Vorgänger (erwartet409). Kein Helperrequest, Job-, Grant-, UI-, MCP-, Sync-/Enrollment- oder TimeSetterpfad. Jede Antwort ist begrenzt; drei feste Requests, jeweils höchstens3s. Diese Transporttimeoutgrenze ist **keine** behauptete1s-/100ms-Clockqualifikation. Clock-/Dienstrollen-/SyncReady-Nachweis bleibt ausdrücklich false. - -Nur öffentliche Requests/Signaturantworten, Status-/Hashmetadaten und feste Scopefelder gelangen in den eigenen create-only Fall. Statische „keine Jobs/Grants“-Scopefelder ersetzen keinen unabhängigen tatsächlichen Serverzählersnapshot. Root muss vor/nach dieselben geschlossenen Windows-/Linux-/Policy-/Grantzähler und erhaltene PKI-/DB-/Lockidentitäten separat vergleichen. Erst dieser gekoppelte Beleg darf den Endpunkt als tatsächlich passiv abgenommen ausweisen. - -## Noch fehlende echte Kontextdatei - -Es wurde **keine** `context.json` mit Dummywerten erzeugt. Root liefert nach Gatewaydeployment den tatsächlichen frischen DB-/Bootbeleg; Deployment kann die Verbindungsgeneration ändern. Die enge Datei hat ausschließlich folgende Pflichtfelder: - -| Feld | Bedeutung | -| --- | --- | -| `schema_version` | exakt1 | -| `case_id` | exakte eigene kanonische Fall-UUID | -| `connection_generation` | tatsächlich aktuell aus der Server-DB, größer1 | -| `windows_boot_id` | tatsächliche aktuelle DB-`connection_boot_id` | -| `server_boot_id` | tatsächliche aktuelle permanente Serverboot-ID | -| `server_context_evidence_sha256` | unveränderlicher Root-Originalbeleg dieser frischen Abfrage | -| `binding_sha256` | SHA256 der vorhandenen typisiert serialisierten öffentlichen Gerätebindung | - -Der spätere feste Root-Operator muss Originalbeleg und frisch gerenderte Datei sowie tatsächliches Gateway-/Brokerdeployment vor Ausführung prüfen. Eine beliebige Callerboolean genügt nicht. Der Probe selbst prüft Serverantwort und Kontextbindung; diese vorgelagerte Provenienz ist zusätzlich Root-verantwortet. Der einzelne geplante CLI-Aufruf lautet strukturell `TimeRouteProbe.exe probe `; hier **nicht ausgeführt**. - -## Tatsächlich lokal qualifiziert - -Unveränderlicher Fall `time-route-fixture-qualification-3fdf513e-197b-41ab-b161-9dfc2adc94da`, exakt203 öffentliche Compilerinputs: der erhaltene c467-Produktcheckpoint202 plus genau dieses neue Example. Aktueller fremder Updater-WIP wurde bewusst nicht in diesen Fixture übernommen; es gibt keine Behauptung,203 entspräche dem gesamten gegenwärtigen Workspace. Inputmanifest `1c4ed151efacc60bc3487356fcbdca0b665a02da9b7ceef7454d5eaa4f310d47`; Fixturequelle `808ef3a3fe21ca100fae38250c40c0738c3e4076c686c642776f0aa2bc891d9c`; Receipt `fce8c42cce33a35be1ee0468c97010ac3797a713668503783e449d30ea538678`. - -Rustfmt nur dieses Example (`skip_children`), Windows-Examplecheck, Clippy mit `-D warnings` und Release-Link PASS. Offline-Docker, Quellen nur lesbar, eigene private Targets, keine Credentials-Mounts. Keine zusätzlichen Tests oder VM-Abfragen ausgeführt; vorherige tatsächliche Linux-Codec-/Servernachweise werden separat durch Root gebunden, nicht durch diesen Cross-Build ersetzt. - -`TimeRouteProbe.exe`:19172660Bytes, AMD64-PE, SHA256 `4ef3fc85f5d140f2ad0ff14745dc5d5453a058203d785235d7dabafdf522b088`, Modus0500/ein Hardlink. Enger Readonly-Capabilitymanifest-SHA256 `22ca87604e942b91e68981f694934bc8c933c5fb5ab5858f27a2d3884d64df42`. Der neue Produktpaarbeleg26dc/5967 und dessen Modulquelle d859 bleiben unverändert; dieses Example installiert oder startet keinen Agenten. - -Offen: unabhängiger Fixture-Review, echtes Gateway-/Brokerdeployment und dessen frische Kontextprovenienz, einmalige native Ausführung mit200/403/409, separater lesender Originalfallnachweis und tatsächliche Erhaltungs-/Nulljobwitnesses. Erst danach ist dieser Endpunktgate für die nächste getrennte passive Paarwartung verfügbar. Windows-MVP-Wirkungsabnahmen bleiben offen. - -## Native passive Protokollabnahme - -Tatsächlich anschließend auf der Windows-VM bestanden: genau ein fester -HTTP200/403/409-Lauf mit echter Signatur-/vollständiger Kontextprüfung und Exit0, -sowie separater Originalfallread mit bytegleicher Antwort. Fall68b841a5-784f-4a34-a8a4-060b267713f0; -Runreplyc556747f75987f8d6ced477086cfd77edfb00f2ac74a99b6e721f3c278ecc28a, -Runpreservation04bb81f781656f9e695225885b5088d498d1ebe5708a95db563dd6321525617a, -Readpreservatione9ef65dc101505919bcba00e1a214d752f44154d6b3f5789c27234551e01e9b9. -Details und die ehrlichen Grenzen des ersetzten alten Abschlusslesers stehen in -`windows-time-route-operator.md`. Keine Dienstrolle/Clockfrische/SyncReady oder -Jobwirkung durch diese Fixture bewiesen. diff --git a/docs/windows-time-route-operator.md b/docs/windows-time-route-operator.md deleted file mode 100644 index 63a1054..0000000 --- a/docs/windows-time-route-operator.md +++ /dev/null @@ -1,121 +0,0 @@ -# Fester passiver Windows-Zeitroutennachweis - -Quellenstand 2026-11-15: `deploy/windows/time_route_context.py` liest ausschließlich -öffentliche aktuelle Installationsmetadaten nach dem getrennten Gatewaydeployment. -`deploy/windows/time_route_acceptance.py` bereitet die bereits gebaute feste -`TimeRouteProbe.exe` vor und besitzt ausschließlich die getrennten Phasen -`stage`, `run` und `read`. Keine Phase verändert RMM-Dienste, Geräteidentitäten, -Zeitdienst, Richtlinien oder Jobgenehmigungen. - -Der Collector bleibt mit `DEPLOYMENT_RESULT_SHA=None` geschlossen. Der Operator -bleibt mit `CONTEXT_GATE=None` geschlossen. Der Operator darf erst den tatsächlich -abgelesenen Collectorfall und dessen BelegSHA binden. Keine Beispielkontexte, -Dummykeys oder Kalibrierungszahlen ersetzen diese Daten. Vor Stage und Run wird -exakt derselbe aktuelle öffentliche Kontext erneut gelesen. Ein Generations-, -Boot- oder Gatewaywechsel verlangt eine gesonderte Bewertung; kein automatischer -Retry und keine Umdeutung eines alten Belegs. - -Die feste SQL-Transaktion ist `READ ONLY` und liest die aktive Windowsinstallation -mit Enrollment, Assignment, Verbindungsgeneration, Windows-Boot und Capabilities. -Zusätzlich werden tatsächlicher Serverboot und Gatewayimage/-identität vor/nach -verglichen. Weder SQL-Zugangsdaten noch Geräteschlüssel werden gelesen oder -exportiert. Auf Windows verwendet ausschließlich die geprüfte EXE den bestehenden -Geräte-mTLS-Schlüssel intern, wie in `windows-time-route-fixture.md` beschrieben. - -Die beiden Windows-Verzeichnisse für Nutzlast und Steuerbelege sind getrennt, -damit die EXE zu Beginn genau ihre drei festen Eingabedateien vorfindet. Alle -Steuerbelege entstehen neu; ein verlorener Run ist ausschließlich lesbar. Der -Controller hält sein gestartetes Prozessobjekt mit Kernelhandle, wartet auf das -tatsächliche Ende und begrenzt ausschließlich diesen eigenen Prozess bei Timeout. -Die tatsächliche positive Signatur-/Kontextantwort sowie HTTP 403 und 409 müssen -im unveränderten Bericht stehen. Die ursprünglichen sechs nativen Windowsfelder, -Journalidentität und geschlossenen Servergates werden vor/nach separat geprüft. -Diese Abnahme beweist Transport und kryptografische Kontextbindung, keine -Dienstrolle, Timerqualität, aktuelle Clockfreigabe oder Jobwirkung. - -Lokal tatsächlich ausgeführt: Pythoncompile, beide Quellguards, geschlossene -Deployment-/Kontextgates, exakte groß-/kleinschreibungssensitive Aktionsgrenze und -Prüfung gegen die PowerShell-Aliaskollision `H`. Alle bestanden. Originalfall -`a324c4e5-d1a9-495e-aba8-cb755a174e98` unter -`devstate/windows-time-route-source/`; ReceiptSHA -`de5fdf7f01b0d0a40c4c8def16eaf87efc8bce2696d35e2097c9e394d52510ad`. -Native PowerShell-AST, unabhängiger Quellenreview, tatsächliche Kontextablesung, -Stage, Run und anschließender eigener Read sind hier noch nicht ausgeführt. -Der Operator führt diese Schritte nicht automatisch aus. - -## Tatsächliche native lesende Vorbereitung - -Nach ausdrücklicher Rootdelegation wurde auf der vorhandenen Windows-VM die -PowerShell-5.1-Quelle ausschließlich im Speicher mit `Parser.ParseInput` geparst. -Tatsächlich: PowerShell5.1.26100.9818, null AST-Fehler, Controller nicht ausgeführt. -Keine Stage-/Route-/Dienstaktion. Davor und danach lief ausschließlich der bereits -angenommene originale14fb-`finish`-Leser mit seinen bestehenden passiven Journal- und -SYSTEM-State-Probes: alle sechs stabilen nativen Felder und Journalidentität -unverändert, Sequenz monoton. Diese Probes rufen keine Clock-/Snapshotoperation -auf; sie ersetzen keinen Zeitrollen- oder aktuellen Frischebeweis. - -Eigener unveränderlicher Fall -`devstate/windows-time-route-native-readonly/a6d61a92-b7f3-4a8d-9df0-569941ab7ccd`, -ReceiptSHA `44504007fa7d0379e608375181b926ff2a20ae248cfeb2fb51d127b858b3536d`. -ScriptSHA bleibt `4c88fdf36f22b0273baaa08bf522bfefbf8482b45317ef852c0e0a331a1fbef2`. -Deployment-/Kontextgates bleiben geschlossen, Stage und Route weiterhin offen. - -## Tatsächliche passive Route und separater Read bestanden - -Root hat den tatsächlichen erfolgreichen Unterfall -`continue-backend-v1/result.json` mit SHA -`3017634f101ee8aff62988f195ccb3a7a8b9e03eaa48b8fb339af9ceb3ad2b4b` -und separater Nachlese gebunden. Der alte fehlgeschlagene Deploymentfall bleibt -unverändert fehlgeschlagen. Collectorfall68b841a5-784f-4a34-a8a4-060b267713f0, -Receipt658fa5ffa63c6e412237f5feb718b745bb560230f17c54e437ad8bd98e9ad65b, -Kontext3c0e4ff3b16b86fb4e98d2ff163686305ea533570c40ae3bef1270ab89648ed3: -tatsächliche aktuelle Geräte-/Tenant-/Generation-/Bootbindung und Gatewayimage. -Die ungenutzte doppelte Deploymentpfadkonstante wurde entfernt. - -Stage meldete tatsächlich Erfolg, bevor der nachgelagerte alte14fb-finish- -Leser nach180s ohne Antwort abbrach. Das ist kein erfolgreicher Originalwitness. -Eine direkte lesende Diagnose antwortete sofort, keine laufenden Probeprozesse. -Der erste Agentname dieser Diagnose war falsch; `present=false` für -`RustDiscoveryAgent` ist kein Ausfall des tatsächlichen `RmmDiscoveryWindows`. -Keine Stage wurde wiederholt und bis dahin kein HTTP-Probelauf gestartet. - -Auf ausdrückliche Rootanweisung ersetzte die Fortsetzung den hängenden früheren -Upgradeabschlussleser durch dessen vorhandene reine FileID-/SCM-/Kernelprimitive, -ohne Journal-/Clock-/Snapshotaufruf. Die ersten umfangreichen Readerbytes -überschritten als EncodedCommand die Windows-Kommandozeilengrenze; der Reader -wurde danach als feste hashgebundene Nutzlast über stdin übermittelt. Auch dieser -Fehler lag vor jedem Probestart. Originalbelege wurden nicht überschrieben. -Die Fortsetzung liegt als enge `direct()`-Funktion im bestehenden Operator; -keine weitere Operator-Datei entstand. Tatsächlich ausgeführte Quelle ist im -Originalfall als `executed-direct-operator.py` unverändert gesichert. - -Der einzige tatsächliche TimeRouteProbe-Lauf ergab: - -- HTTP200, echte Ed25519-Signatur, kompletter eigener Nonce-/Request-/Kontextbezug. -- HTTP403 für den fest abweichenden Tenant. -- HTTP409 für die vorherige Verbindungsgeneration. -- Tatsächliches Kernelprozessende mit Exit0, kein Timeout, stderr leer. - -Runreply `c556747f75987f8d6ced477086cfd77edfb00f2ac74a99b6e721f3c278ecc28a`, -Erhaltungsbeleg `04bb81f781656f9e695225885b5088d498d1ebe5708a95db563dd6321525617a`. -Separater Read `read-direct-6f2e1bc2-e26c-4dfb-a642-06a6a154ef5c` bestätigt -bytegleichen gespeicherten Runreply und neuen Erhaltungsbeleg -`e9ef65dc101505919bcba00e1a214d752f44154d6b3f5789c27234551e01e9b9`. -Tatsächlicher ReportSHA9f1635c19c801f95c9828e9e31071a487b430f105a61977ee2d60f076f3d3623, -ExitfileSHA6d131d2796936913f53286573e56f7fb3e515d04ebbd55ae9d6794440e6053b5. - -Direkt vor/nach Run und Read unverändert: laufende ursprüngliche Dienste mit -Kernel-PID/Geburt/Image/Konto, ursprüngliche config/PKI/Publicpin-Bytes, -DateiIDs/ACLs und Privatekeymetadaten ohne Keyread, native Telemetriedateiidentität -sowie aktuelle Helper-DB-/Lockdateiidentitäten. Deren alte FileID/Geburt stimmen -ebenfalls; die historischen ACL-Digests aus dem anderen Probe sind abweichend -und werden ausdrücklich nicht als erfolgreicher Altvergleich ausgegeben. -Aktuelle direkte ACL-Metadaten sind vor/nach identisch. Geschlossene Windows- -Job-/Outbox-/Permitzähler bleiben0; Linux31/31/27 und Rootpolicy unverändert. -Der alte umfassende Journalabschlussleser bleibt als Timeout offen; es wurde -keine erneute Journalintegritätsprüfung behauptet. - -Dies ist ausschließlich eine tatsächliche passive mTLS-/Signatur-/Kontextabnahme. -Dienstrollen-Zeitauthorität, Clockfrische, SyncReady und Jobwirkungen bleiben -weiterhin unbewiesen und geschlossen. Kein Agentpaarwechsel oder VM-Neustart -war Bestandteil dieses Schrittes. diff --git a/docs/windows-time-service-start.md b/docs/windows-time-service-start.md deleted file mode 100644 index f04dfd7..0000000 --- a/docs/windows-time-service-start.md +++ /dev/null @@ -1,75 +0,0 @@ -# Einmaliger Start des vorhandenen Windows-Zeitdiensts - -Stand 2026-11-14: [Bootstrapquelle](../deploy/windows/time_service_start.py) -implementiert, unabhängig quellgeprüft, Python-Syntax und PowerShell-AST lokal -bestanden. **Einmaliger nativer Start und separater Readback bestanden.** -Der Nutzer hat den Start des vorhandenen -W32Time ausdrücklich erlaubt. Die Ausführung übernimmt der Root-Orchestrator -nach Quellenprüfung auf der Windows-VM; das Notebook bleibt Entwicklungsrechner. - -Der einzige Dienstbefehl ist `Start-Service -Name W32Time`. Startart, -Dienstkonto, Imagepfad, Dienst-SDDL, SID-Typ, NTP-Konfiguration und Richtlinien -werden nicht geschrieben. Für einen gestoppten Dienst müssen außerdem null -Dienstabhängigkeiten vorliegen; sonst erfolgt kein Start. Pending-/unbekannte -Zustände blockieren. Ein bereits laufender Dienst wird nur als -`already_running` dokumentiert. Es gibt keinen Resyncbefehl, kein Policyupdate, -keinen RMM-Job und keinen Reboot. Ein natürlicher Zeitsync durch den gestarteten -Dienst ist erlaubt, aber **kein Nachweis einer qualifizierten Uhr**. - -`prepare` verlangt die fünf unabhängig bekannten SHA256-Werte für Agent, -Helper, Agentkonfiguration, Helperkonfiguration und Agentpin. Es legt einen -privaten lokalen Fall an, bindet den bereits gespeicherten zentralen -Beforekontext `time-service-start-context/888b18b8-da7e-4b9f-9e36-32a23f2ff973`, -überträgt ausschließlich die feste, hashgeprüfte Bootstrapquelle und liest -den tatsächlichen Ausgangszustand. Der Start verwendet diese Originalpins und -diesen Fall unverändert. RMM-PIDs, Prozessentstehung, Dienstdefinitionen, -Binaryhashes sowie Konfigurations-/PKI-Metadaten müssen erhalten bleiben. -Der private Geräteschlüssel wird nur über Dateimetadaten und ACL-Hash geprüft; -seine Bytes werden nicht gelesen oder exportiert. - -Die Registryprüfung hasht nur ausdrücklich aufgeführte stabile Dienst-, NTP- -und Policy-Konfigurationswerte. Sie gibt keine Rohwerte/NTP-Hostnamen aus. -Volatile LastSync-/Laufzeitwerte werden nicht als unveränderlich vorausgesetzt; -der Hash behauptet keine vollständige Abdeckung sämtlicher Registrywerte. -W32Time-Status und dessen PID dürfen sich durch den erlaubten Start ändern. - -Vor dem einzigen Startaufruf werden ein privater Originalbeleg und zwei -dauerhafte, ausschließlich neu anlegbare Startreservierungen gespeichert: -im Fallverzeichnis und als globaler W32Time-Einmalbeleg. Auch lokal entsteht -vor dem SSH-Aufruf ein ausschließlich neu anlegbarer Startversuchsbeleg. -Eine verlorene Antwort, ein Fehler oder ein unvollständiger Beleg erlaubt nur -`readback --id ORIGINALFALL`; weder Startwiederholung noch automatischer -Rollback sind implementiert. Readback meldet den tatsächlichen aktuellen -Zustand und bewahrt unbestätigte Ergebnisse als solche. Frühere private -SSH-Fehler werden vor/nach Aufrufen versioniert erhalten. - -Die folgenden Befehle sind **Aufrufvorlagen**; die Hashplatzhalter -müssen aus dem unabhängig bekannten aktuellen Deployment stammen: - -```text -python3 deploy/windows/time_service_start.py prepare --agent-sha256 HASH --helper-sha256 HASH --config-sha256 HASH --policy-sha256 HASH --pin-sha256 HASH -python3 deploy/windows/time_service_start.py start --id ORIGINALFALL -python3 deploy/windows/time_service_start.py readback --id ORIGINALFALL -``` - -Vollständige Metadaten bleiben in geschützten lokalen/VM-Fallbelegen. Die CLI -gibt nur Fallkennung, Status, Running-/Erhaltungs-/Readback-Merkmale und den -ausdrücklich nicht geprüften Uhrvertrauensstatus aus. Lokaler Quellnachweis: -`devstate/windows-client/time-service-start-source/225c3208-4a3f-4528-8c17-b3846b70812f/qualification.json`; -PowerShell nur geparst, kein Windows-API-/VM-Aufruf und keine Produkttestsuite. - -## Tatsächliche Ausführung - -Fall `c3552c3f-24d1-4713-bd0b-544aee4ffd18` auf dem Windowsgast: -Vorbereitung bestätigte Stopped und die bekannten Originalhashes. Anschließend -genau ein `Start-Service W32Time`, Status Running, Erhaltungsprüfung bestanden. -Getrennter späterer Readback bestätigte denselben Originalresultbeleg und -Running ohne Startwiederholung. Agent5140 und Helper6240 unverändert; -Dienstdefinition/SDDL und ausgewählte NTP-/Policy-Konfigurationswerte erhalten. -Kein privater Schlüsselinhalt gelesen und keine Konfiguration geschrieben. - -Zentraler Kontrollstand vorher/nachher identisch: Windows0Jobs/0Outbox/0Grants/ -0ungeklärt, Linux30/30/26/0; Rootpolicyhash und geschlossene Transporthooks -unverändert. Geschützter Abschlussbeleg `acceptance.json` im Originalfall, -SHA256 `365d897d94f6fb16b3112fcb5126bdc09224b34e0a6ef46940ca8e7a651807fb`. -Quellhash `ef5d4ce8…`. **Kein Uhrqualifikations-, RMM-Job- oder Rebootbeleg.** diff --git a/docs/windows-trusted-os-clock-source.md b/docs/windows-trusted-os-clock-source.md deleted file mode 100644 index ad3fd7f..0000000 --- a/docs/windows-trusted-os-clock-source.md +++ /dev/null @@ -1,150 +0,0 @@ -# Windows: ausdrücklich genehmigtes aktives OS-Zeitprofil - -Stand2026-11-15, normative Userentscheidung in Spezifikation1.23/Projektentscheidungen (`b761384`). `trusted_os_active_guest` ist nun implementiert und lokal geprüft. Keine Zeitkonfiguration, keine Schlüssel-/Pinprovisionierung, kein VM-Aufruf und keine Gatefreischaltung wurden daraus vorgenommen. Die frühere [KVM-Bewertung und Entscheidungsfrage](windows-kvm-clock-contract-proposal.md) ist der historische Vorschlag; die ausdrückliche Zustimmung gilt nur unter den dort genannten Betriebsannahmen. - -Der neue Modus vertraut den dokumentierten Windows-Zeit-APIs und einer korrekt laufenden Hardware-/KVM-/QEMU-Zeitbasis als nomineller Intervalluhr. Er behauptet keine unabhängig gemessene physikalische Genauigkeit. Vor Pause, Save/Restore, Snapshot-Rückkehr, Migration oder Host-Suspend müssen beide Agent-/Helperprozesse beendet werden; danach sind frische Prozesse, Challenges und unabhängiger Sync erforderlich. Solche Ereignisse mit weiterlaufenden Prozessen werden nicht unterstützt oder durch eine nicht vorhandene VMGenID-Erkennung scheinbar abgedeckt. Der Code verändert keine VM-/Hosteinstellung. - -## Geschützter, disjunkter Loadervertrag - -Die bestehende geschützte Datei bleibt `C:\ProgramData\RustDiscoverySystem\time-attestation.json`. Es existiert hier **keine erzeugte Instanz**. Zwei vollständige `deny_unknown_fields`-Records verhindern eine automatische Übernahme: - -| Eigenschaft | Schema1 | Schema2 | -| --- | --- | --- | -| Modus | bisherige numerische Kalibrierung | ausdrücklich `trusted_os_active_guest` | -| Profilfeld | `calibrations` mit genau2 Rollen | `trusted_os_active_guest` mit genau2 `qualifications` | -| Basisfehler | positiv und höchstens10ms | kein `base_error_ns`-Feld und kein Nullbasis-Trick | -| Plattform-/Betriebsbindung | bisheriger Qualifikationsvertrag | feste KVM/QEMU/Hyper-V-Clock-Kennung, Provenance-SHA und fester aktiver Betriebsvertrag | -| Fremde/gemischte Felder | verweigert, auch `trusted_os_active_guest:null` | verweigert, auch `calibrations:null` | - -Unbekannte Versionen, Profile, Annahmen, Plattformen, fehlende oder doppelte Rollen, falsche Imagehashes und fehlende Qualifikationsreferenzen bleiben geschlossen. Commonfields sind unverändert Schlüsselgeneration, Serverinstanz, vorhandene Gerätebindung und separate öffentliche Zeitkeys. Der Zeitkey bleibt vom konkreten Jobkey unabhängig. Die tatsächlich installierte eigene Dienst-/Token-/Imageidentität wird weiter unabhängig geprüft; ein Konfigurationswert ersetzt diese Prüfung nicht. - -## Softwarebudget und Fences - -Der vollständige native Getterbracket bleibt Interrupt-before, Unbiased-before, Wallclock, Unbiased-after, Interrupt-after. Schema2 verwendet konservativ das Maximum der **beiden vollständigen** Interrupt-/Unbiasedbracketbreiten. Die Umrechnung von100ns-Einheiten nach Nanosekunden erfolgt exakt mit überlaufgeprüfter Ganzzahlmultiplikation; dafür fällt kein Umrechnungsrest an. Es wird keine zusätzliche positive physikalische Fehlerkonstante erfunden. Ein im nominellen OS-Zählerraum gleichwertiger Capture darf deshalb ein Nullbracket liefern; das ist keine physikalische Nullfehlerbehauptung. Schema1 behält unverändert seinen bisherigen Interruptbracket plus tatsächlich qualifizierten positiven Basiswert. - -Die bestehenden Budgets bleiben erhalten: maximal50ms für die konservative Summe der drei Captures; volle selbst gemessene RTT und konservative1s-/100ms-Frischegrenzen. Codec, Wirebytes, Signaturdomäne, getrennte Nonces/Rollen/Inkarnationen, eigener Boot-/Connectionkontext und gesamtes UTC-Intervall ändern sich nicht. Jede spätere Nutzung erfasst die eigenen Getter erneut; keine Belegverlängerung. Serverquellqualität und jeder normale Sync-/Grant-/Verbrauchs-/Ledger-/WebUI-Gate bleiben zusätzliche Voraussetzungen. - -Ein zusätzlich geschlossener Constructorfehlerpfad verhindert Wiederbelebung nach beobachteten fehlerhaften Konfigurationen: Der Rawhash wird **vor** JSON-/Profilprüfung gegen den gehaltenen Prozesshead beobachtet. Unterschiedliche Bytes invalidieren den globalen Epoch ohne Übernahme eines neuen Hashes oder Floors. Ein RAII-Fence schließt bekannte Autorität auch bei geschütztem Lese-/Pinfehler oder abgebrochenem Konstruktor. Erfolgreiche Konstruktoren derselben gültigen Konfiguration drehen den Epoch nicht. Wiederherstellung alter Bytes heilt keine alte Evidenz oder offene Nonce; erst eine neue Challenge ist zulässig. Die bisherige monotone Konfigurationsannahme bleibt erhalten; diese Änderung erfindet kein dauerhaftes neues Floorjournal. - -## Öffentliche Producer-Form für den späteren echten Beleg - -Der konkrete serialisierbare Rust-Vertrag ist `Configuration::TrustedOs(TrustedOsConfiguration { ... })`; er kann ausschließlich aus tatsächlich gelieferten öffentlichen Nachweisen befüllt werden. Die folgende Form benennt Pflichtdaten, enthält keine Dummykeys und erzeugt keine Konfiguration: - -| Feld | Erforderliche echte Quelle | -| --- | --- | -| `schema_version` | exakt2 | -| `key_generation`, `server_instance`, `public_keys_hex` | tatsächlich qualifizierter permanenter Broker-/Signierrollenbeleg; nur öffentliche Zeitkeys | -| `binding` | unveränderte bestehende geschützte Geräte-/Tenant-/Enrollment-/Assignment-/Jobpublickeybindung | -| `trusted_os_active_guest.operating_assumption` | exakt `active_guest_no_pause_save_restore_snapshot_migration_host_suspend` | -| `trusted_os_active_guest.platform` | exakt `kvm_qemu_hypervclock` | -| `trusted_os_active_guest.platform_provenance_sha256` | tatsächlicher selektiver Plattform-/Betriebsannahmenbeleg, separat geschützt durch Root provisioniert | -| `trusted_os_active_guest.qualifications` | genau eine Referenz je `agent` und `system_helper`, jeweils exakter neuer Produktimagehash plus tatsächlicher rollen-/imagegebundener Qualifikationsbeleg-SHA | - -Keine Tabelle, Referenz oder Source-Datei ist selbst eine Kalibrierung oder Jobfreigabe. Der spätere Root-Producer muss Originalbelege, exakte Images und deren unabhängige native Abnahmen prüfen, bevor er diese Form serialisiert und den geschützten Konfigurationswechsel als eigenen überprüften Fall durchführt. Fehlende echte Daten bleiben fehlend; kein automatisches `calibrated=true`, kein beliebiger Betrag und kein privater Keyimport. Die Vorqualifikationsreferenz darf nur die tatsächlich belegten Source-/Image-/Dienstrollen-/Rohcapture-/Plattformbefunde aussagen: Sie behauptet noch keine funktionierende signierte Runtime. Deren unabhängige native Prüfung folgt nach Bereitstellung der echten öffentlichen Zeitkonfiguration; ein clockpflichtiger Helper-Snapshot oder bereits bereiter Clockgate ist keine Voraussetzung des ersten passiven Bootstrapwitness. Die aktuell früher gelinkten Produktpaare sind wegen dieses neuen Modulcodes veraltet; ein neues Paar und neue native Nachweise folgen getrennt. - -## Tatsächliche lokale Qualifikation - -Unveränderlicher202-Input-Fall `trusted-os-qualification-c4679433-b632-4d6e-8668-f0f2fb54a542`, Manifest `e2f0abd2909129554431257b06ae17774c95fb5abd428cbefeba2c4f573ca269`, Modulquelle `d8594c1eba2c2cc5d5fde4a462b2110aa2e7e64081452b742c4ed81a2cfb477d`, Receipt `96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d`. Offline-Docker, Quellen nur lesbar, eigene private Targets, keine Credentials-Mounts. - -- Rustfmt und Linux-Lib/Tests-Clippy mit `-D warnings`: PASS. -- Linux-Release-Link und die acht relevanten `signed_clock`-Guards: PASS. Vollständige Liste18; zehn andere Tests ausdrücklich herausgefiltert. Drei neue Guards prüfen disjunkte Opt-ins und beide Rollenbindungen, beide vollständigen Brackets samt Integer-/Budgetgrenzen sowie den tatsächlichen malformed-Raw-Loaderpfad mit Restore und geschlossenem alten Epoch/Pendingowner. -- Windows-GNU-Alltargetscheck und Clippy mit `system-helper`: PASS. Release-Lib-Test-EXE erfolgreich gelinkt, **nicht ausgeführt**. Kein neues Produktpaar in diesem Beleg. - -Der erste Windowscheck scheiterte vor Crateprüfung an fehlenden Execbits alter kopierter Cache-Buildskripte. Originalfehlerlog/Exit101 sind erhalten. Nach Änderung ausschließlich der eigenen kopierten ELF-Buildskriptmodi bestanden dieselben eingefrorenen Quellen separat; keine Unterdrückung eines Sourcefehlers. - -Linux-ELF `trusted-os-clock-tests`:4245312Bytes, SHA256 `0ae3487cff59c349ebde629fce3258c9f298e5cc24562bf2020409865f224912`. Windows-Lib-Test-EXE:12772565Bytes, SHA256 `ecb57571b8df1b4a178f7d7e2dc1ad21fee11cdb5ea558a2eb35a52f544e64e5`. Beide Übergabedateien Modus0500/ein Hardlink. Lokale Guards/Cross-Link ersetzen nicht die tatsächliche Cloud-Linux-Ausführung und anschließenden Windows-Rollen-/Runtimebelege. Gates bleiben bis dahin geschlossen. Strukturierter EventLog-Kindadapter und übrige Windows-Wirkungsabnahmen bleiben gesondert offen; Windows ist nicht vollständig abgenommen. - -## Getrennte vorbereitete Folgeschritte - -Der neue feste Linux-first-Operator ist `deploy/windows_trusted_clock_linux_acceptance.py`, SHA256 `cbabb7c88bf070bcc3ac6933650a7abf114e00b5bcabe3aefdfc4db213a997a9`. Lokal vorbereiteter Fall `293ecff5-6c6f-47a2-9ce2-60de0ffe99ed`, Manifest `52cda33ccba636adc35fb534e34095be7b3d9d3abc0ff7c9896c29dd433fc373`. Er prüft die vollständige18er-Liste vor den acht festen `signed_clock`-Guards; zehn fremde Cratetests bleiben transparent gefiltert. Die tatsächlichen bestehenden Linuxruntime-Witnesses und der auf die eigene Prozessgruppe begrenzte Runner sind bytegleich zum vorherigen Raw-Clock-Operator. Python-AST, lokale Prepare-/Revalidation und dieser Bytevergleich PASS. Keine Zielausführung durch diesen Agenten; Root führt den einmaligen nativen Lauf und den separaten Originalfall-Read durch. - -Danach separat tatsächlich gebaut: neues Windows-GNU-Produktpaar aus exakt demselben202-Input-Snapshot und derselben Modulquelle `d8594c1e…`, Fall `trusted-os-candidate-link-542cbf43-afb2-4994-b141-06e003e5e2e8`. Offline/Netzwerk aus, Quellen nur lesbar, keine Credentials-Mounts, ausschließlich Agent und SYSTEM-Helper. Release-Link Exit0 (17.91s), Quellen vorher/nachher unverändert. Receipt `04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d`, Buildlog `e9437ac94a63d20a68c1af35f1670042fe44407796a03541cdcd7bdb9e16bfaa`. - -| Neuer Profilkandidat | Bytes | SHA256 | -| --- | ---: | --- | -| Agent | 22283627 | `26dc9d2f6928c5a41050ac9324e041c065e7a9ae52324416f3bb6222c002ae6b` | -| SYSTEM-Helper | 13143052 | `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e` | - -Beide sind AMD64-PEs, Modus0500/ein Hardlink. Frühere Paare bleiben historisch erhalten. Kein Paarupgrade, neuer Mainindex, öffentliches Zeitpinfile, Kalibrierungswert oder Clockgatewechsel wurde ausgeführt. Der aktuelle passive Paarcontroller bleibt weiterhin fest geschlossen und bindet noch seine vorige Kandidatengeneration; diese neue Generation erfordert später einen eigenen überprüften Controllerbeleg und frische CAS-/Serverwitnesses. Die öffentliche Producer-Form oben enthält bewusst nur tatsächlich zu belegende Felder und keine Platzhalterkonfiguration. - -## Tatsächlich Linux-first auf der Cloud-VM bestanden - -Originalfall `293ecff5-6c6f-47a2-9ce2-60de0ffe99ed`: vollständige18er-Liste -vor Ausführung geprüft, genau acht signed_clock-Guards bestanden,0failed/ignored, -zehn andere ausdrücklich gefiltert. Execute-Receipt -`98aae935740eb4c9d50366715be9a130791b141681b091af431129d6f833f563`. -Separater Originalread bestätigt gleiche Source-/Artefaktbindungen und erhaltene -aktuelle Runtime-/Control-/Stateidentitäten, Receipt -`06711537d71f436b7776e7c2d47eb6e2963820b7a6c55302bc7786568c23c28b`. -Unabhängiger Quellenreview des Schema-/Bracket-/Constructorfencedeltas ebenfalls -ohne konkreten Befund abgeschlossen. Keine Windows-Rollen-/Zeitkonfiguration, -kein RMM-Job oder Effektgate wurde dadurch aktiviert. - -## Tatsächliche öffentliche Vorbereitungsdaten, keine Konfiguration - -Lokaler Fall `windows-time-profile-public-preparation/c3077acf-12da-410e-9f55-e75a1cd0a75f` -bindet den tatsächlich selektiv gelesenen KVM-/Hypervclock-Plattformbeleg94ae865e…, -den echten öffentlichen Zeitpin c31d31d2…, die unveränderte öffentliche14fb- -Gerätebindung und das tatsächliche202-Input-Produktpaar26dc/5967. Receipt -`97e4db147f31f3cff134d2bc596d7d73ea5330b8b5a87971f215bb03a9751391`, -Provenienz `1c0db66cd0692024f68bddd71949692d274380a86e4b880fea0756479ceb5d0c`. -Timekey und konkreter Jobkey sind verschieden. Keine private Signierdatei gelesen. - -Der ausdrücklich gelieferte öffentliche Plattformoriginalbeleg hat Modus0664; -der vorhandene0600-Pinloader wies ihn zuerst erwartungsgemäß ab. Originalbytes -und Modus wurden nicht geändert. Die bekannte SHA94ae bindet ausschließlich eine -neue eigene0600-Kopie innerhalb dieses lokalen700-Falls; sie wird nicht als schon -provisionierter geschützter Zielpin ausgegeben. Keine zusätzliche Operatorquelle -oder Toolinstallation entstanden. - -Dieser Fall ist ausdrücklich **keine** `time-attestation.json`. Für die beiden -Schema2-`qualification_sha256` fehlen noch tatsächliche Dienst-/Prozess-/Imagebelege -der neuen Produktimages. Der frühere Rawcapture-Probe601… ist ein anderes Image -und ersetzt diese Bindung nicht. Nach der getrennten passiven Paarwartung dürfen -die tatsächlichen neuen LocalService-/SYSTEM-Kernel-/Servicebelege mit vorhandenen -Source-, Rawcapture- und Plattformbelegen verbunden werden. Erst danach wird die -echte V2-Konfiguration erstellt; Runtimefrische und Genehmigungen folgen getrennt. - -## Zeitprüfung bei ausgeschalteten Jobs am 15. November 2026 - -Die Konsole der laufenden VM bestätigte, dass weder der Jobschalter noch die -Jobbindung konfiguriert waren. Die Zeitprofildatei war noch nicht installiert. -Die bisherige Runtime übersprang bei ausgeschalteten Jobs auch den gesamten -signierten Zeitvergleich. Damit konnte die geplante Rollenprüfung über diesen -passiven Dienststand nicht beginnen. - -Im neuen Quellstand prüft der Agent am Heartbeat, ob das geschützte Zeitprofil -vorliegt. Erst dann beginnen Agent und Helper den vorhandenen Vergleich mit -eigenen Challenges. Für den passiven Betrieb beträgt die Pause zwischen -Vergleichen pro Rolle 30 Sekunden. Die Datei allein belegt keine Zeitqualität. -Beide Rollen prüfen Pin, Gerätebindung, Signatur und Fristen. Der Jobschalter, -die JobClock und die Genehmigung bleiben getrennt. Ein Fehler beim Start des -passiven Vergleichs lässt Heartbeats und Inventar weiterlaufen. - -Neun gezielte Prüfungen bestanden erst lokal und dann auf der Cloud-Linux-VM -als UID 65534 (Exit 0, 15 weitere Tests gefiltert, Ergebnis-SHA-256 -`3424b0f916f0c9e68ed24d8ee0adeeb5feb5e8e834f63cfcbaadc5e45b06f840`). -Die neue Prüfung umfasst Profilauswahl und Abfrageintervall. Der Windows-Crossbuild -der Librarytests und Clippy mit allen Windows-Targets und `system-helper` -bestanden. Die installierten Dienstbinärdateien haben eigene Versionsnachweise. - -Dieselben neun Tests liefen danach aus dem gebauten Windows-Testbinary auf der -Windows-11-VM. Die Namensliste der bestandenen Tests stimmte mit der auf der -Cloud-Linux-VM überein. Ergebnis: AMD64, Exit 0, neun bestanden, null -fehlgeschlagen oder übersprungen, 42 weitere gefiltert. Quittung -`39c76e698f5dd351096d1deed40cddbcc1a6677f93457b48ad4a4c3cedb36e88`. -Der native Testprozess prüfte die Logik mit Testdaten. Der signierte -Zeitvergleich in den beiden installierten Dienstprozessen ist eine eigene -offene Abnahme. - -Für den Nachweis aus den laufenden Diensten hält der Agent je passiver Verbindung -den ersten vollständig geprüften Zeitvergleich pro Rolle fest. Im Agent-State -entstehen `agent-time-sample.json` und `helper-time-sample.json`. Die -SYSTEM-Beobachtung setzt die authentifizierte positive Antwort des Helpers auf -`TimeComplete` voraus. Beide Belege enthalten Rolle, Agent-PID, Windows-Boot, -Verbindungsgeneration, Verifier-Inkarnation, Beobachtungszeit und die SHA-256-Werte -der Anfrage und der empfangenen Antwort. Der Agent veröffentlicht sie beim -Heartbeat aus dem Zustand der jeweiligen Verbindung. Diese historischen Daten -werden bei der Jobfreigabe und der Prüfung der aktuellen Zeit nie eingelesen. -Der erweiterte Code bestand den Windows-Alltargets-Clippycheck. Die tatsächlichen -Belegdateien der installierten Rollen stehen noch aus. diff --git a/docs/windows-update-dev-window.md b/docs/windows-update-dev-window.md index f3f1715..f15b098 100644 --- a/docs/windows-update-dev-window.md +++ b/docs/windows-update-dev-window.md @@ -1,48 +1,10 @@ -# Entwicklungsfenster für Windows Update +# Befristetes Windows-Updatefenster im Entwicklungsprofil -Auf dem per HTTPS aufgenommenen Windows-Testgerät läuft der Agent als LocalService. Das temporäre Wartungsfenster verwendet den SYSTEM-Helper desselben veröffentlichten Agentpaares. Die beiden zulässigen Skripttexte sind in der [Domain](../crates/domain/src/jobs.rs) festgelegt. Alle Anträge laufen über die reguläre Gerätewarteschlange und die sichtbare WebUI-Genehmigung. +Der reguläre Windows-Agent verwendet für administrative Skripte den dauerhaft eingerichteten [SYSTEM-Helper](../deploy/windows/README.md). Für den eigenen Windows-Testgast ohne bestehenden Helper gibt es zusätzlich einen Geräteoperator für die Identitätsprobe und die fest hinterlegte Updatevorlage. Er erwartet eine per HTTPS eingeschriebene Installation mit Enrollmentgeneration und Zuweisungsversion 1 sowie den registrierten Entwicklungszugang. Ein vorhandener Helper schließt das Öffnen eines neuen Fensters aus. [Operator](../tools/windows_update_scope.py) -1. Aus dem Checkout den angemeldeten Entwicklungsclient, seine laufenden Prozesse und den zentralen Zustand lesen. +1. Vom Entwicklungsrechner `python3 tools/windows_update_scope.py inspect` und `python3 tools/windows_update_scope.py plan` ausführen. Ziel, installierte Version und registriertes Agent-/Helperpaar abgleichen. +2. Für den konkret beauftragten Test `python3 tools/windows_update_scope.py window --minutes 15` starten und die ausgegebene Fall-ID festhalten. Der Controller prüft Gerätebindung und signierte Zeit, pausiert während des Fensters das Release-Polling und meldet `central_scope_open`, sobald die Regel bereitsteht. +3. Die zentrale Fensterregel gilt für den sichtbar simulierten Nutzer `simulated-testprincipal-a` in der privaten Entwicklungs-WebUI. Dort die festgelegte Bibliotheksrevision für genau dieses Gerät als SYSTEM einreichen und den festen Plan prüfen. Die Identitätsprobe `Write-Output ([System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value)` mit genau einem abschließenden LF liefert `S-1-5-18`. Dafür höchstens 30 Sekunden Laufzeit wählen. Die Vorlage „Windows-Updates installieren“ darf bis zu 3.600 Sekunden laufen. Die Fensterdauer zuvor passend zur voraussichtlichen Aktion wählen. +4. Nach dem terminalen Ergebnis den Controller mit Strg+C schließen oder die Ablaufzeit abwarten. Nach Unterbrechung mit `python3 tools/windows_update_scope.py close --case FALL-UUID` fortsetzen. Der Controller zieht die zentrale Regel zurück und baut den temporären lokalen Helper nach dem Abgleich zurück. Zum Schluss den laufenden Agenten, den Update-Dienst und einen frischen Geräteabgleich prüfen. - ```sh - python3 tools/windows_update_scope.py inspect - python3 tools/windows_update_scope.py plan - ``` - -2. Ein Fenster öffnen und den Befehl während der Wartung im Vordergrund laufen lassen. - - ```sh - python3 tools/windows_update_scope.py window --minutes 15 - ``` - - Der Befehl gibt die Fall-ID aus. Der Dev-Operator setzt die aktuelle HTTPS-Erstaufnahme mit Enrollmentgeneration 1 und Zuweisungsversion 1 voraus. Vor der ersten Geräteänderung speichert der Server die Fall-ID, den signierten Ausgangscheckpoint, beide Binärhashes und die ursprüngliche Richtlinie. Beim Öffnen prüft der Operator die signierte Paarversion, den laufenden Agenten und seine Gerätebindung. Nach einem passenden Geräte-Heartbeat und einer aktuellen signierten Helper-Uhr meldet der Operator `central_scope_open`. Ab dann steht die Richtlinie bereit. Die einzige zugelassene Bedienperson im Entwicklungsprofil ist `simulated-testprincipal-a`. Das Release-Polling pausiert während des Fensters. Die Ablaufzeit des Fensters steht in UTC in der Ausgabe. Ein anderes noch aktives SYSTEM-Fenster bleibt dem bisherigen Betreiber zugeordnet. - -3. In der privaten WebUI das Windows-Gerät und die gewünschte gespeicherte Skriptversion wählen. Zur Prüfung der Identität eine Bibliotheksrevision für Windows PowerShell und Identität `system` verwenden. Der Skripttext ist die folgende Zeile mit genau einem abschließenden LF. - - ```powershell - Write-Output ([System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value) - ``` - - Bei der Identitätsprobe höchstens 30 Sekunden wählen. Den unveränderlichen Plan prüfen, den Antrag absenden und in der sichtbaren dev/test-WebUI genehmigen. Erwartete Ausgabe ist `S-1-5-18` bei Exitcode 0. Die separate Katalogvorlage „Windows-Updates installieren“ darf bei einem entsprechenden Wartungsauftrag bis 3.600 Sekunden laufen. Sie meldet Updateergebnisse und den Neustartbedarf. - -4. Nach dem Ergebnis mit Strg+C schließen oder die Ablaufzeit abwarten. Die Zentrale entzieht den Scope, der Controller wartet auf terminale Versuche, entfernt den temporären Helper und stellt die geschützte Agentkonfiguration wieder her. Endgültige Arbeitsprojektionen dieses Fensters werden unter ihrem ursprünglichen Job-/Grant-Schlüssel lokal archiviert. Zentrale Ergebnisse, Startnachweise, Signaturen und alte Checkpoints bleiben lesbar. Ein neuer Geräteabgleich darf denselben Job oder Grant nicht wieder annehmen. Er prüft LocalService, Release-Polling und den nachfolgenden Heartbeat ohne SYSTEM-Capability. Bei unterbrochener SSH-Verbindung oder einem abrupt beendeten Controller den Rückbau mit der angezeigten Fall-ID fortsetzen. - - ```sh - python3 tools/windows_update_scope.py close --case FALL-UUID - ``` - - Die zentrale Richtlinie läuft auch bei Verbindungsverlust ab. Der lokale Helper hält den nächsten Agent-Paarwechsel bis zum abgeschlossenen Rückbau an. Ein noch laufender beziehungsweise ungeklärter Auftrag wird im regulären Auftragsablauf geklärt. Der Befehl zum Schließen kann anschließend erneut ausgeführt werden. - -Die native Identitätsabfrage und der vollständige Rückbau sind im [Entwicklungsnachweis vom 17. November](evidence/windows-update-window-20261117.json) dokumentiert. - -Derselbe `close --case` schließt eine abgebrochene Einrichtung, sobald die Fall-ID ausgegeben wurde. War der Helper schon synchronisiert, vergleicht der Controller den ursprünglichen und den aktuellen signierten Checkpoint mit den lokalen Journalen. Zum Abschluss müssen Agent und Release-Polling laufen und ein neuer synchroner Heartbeat ohne SYSTEM-Fähigkeiten vorliegen. - -Die [native Abbruchabnahme](evidence/windows-update-early-abort-20261117.json) beendet den Controller nach dem ersten passenden authentisierten Helper-Heartbeat und vor dem Öffnen der Richtlinie. Auf einem freien Windows-Entwicklungsgerät lässt sich der Ablauf wiederholen. - -```sh -python3 tests/windows_update_early_abort.py --execute -``` - -Auch nach einem abgebrochenen Test gibt der Befehl die Fall-ID aus, mit der sich der Rückbau fortsetzen lässt. - -Die echte Installation von KB890830 v5.147 und der zugehörige administrative Wartungsneustart sind [nativ belegt](evidence/windows-update-installation-20261117.json). Dabei wurde der zuvor gestoppte Windows-Zeitdienst aktiviert und eine gemessene Zeitabweichung korrigiert. Native CP850-Ausgabebytes bleiben unverändert erhalten. Die WebUI bietet für native PowerShell-Ausgabe eine CP850-Textansicht mit expliziter Dekodierungswahl. Der Umlaut im gespeicherten Updateergebnis und der bytegleiche Download wurden im Browser geprüft. [Darstellungsnachweis](evidence/powershell-output-encoding-20261117.json) +Bei ungeklärtem Versuch den vorhandenen Auftrag und seinen Nachweis prüfen. Ein noch laufender oder ungeklärter Versuch kann den Rückbau anhalten. Die Fall-ID erlaubt es, denselben Rückbau fortzusetzen. [Wiederanlauf nach Abbruch](evidence/windows-update-early-abort-20261117.json) · [Native Installation](evidence/windows-update-installation-20261117.json) diff --git a/proto/BACKEND_CONTRACT.md b/proto/BACKEND_CONTRACT.md index cb1f14c..8e95b2a 100644 --- a/proto/BACKEND_CONTRACT.md +++ b/proto/BACKEND_CONTRACT.md @@ -1,699 +1,25 @@ -# Backend integration contract — codec/protocol 1, development only +# Geräteprotokoll und Skriptaufträge -## Root QueryLogs allowlist profile 1 +Linux- und Windows-Agenten bauen die Verbindung zum Gateway ausgehend auf. Eine eingeschriebene Installation authentisiert sich mit ihrem Clientzertifikat. Der Server ermittelt daraus Kunde und Agent. Die Nachrichtenfelder stehen in der Protobuf-Datei und den zugehörigen Rust-Typen. [Gateway-Routen](../crates/server/src/main.rs) · [Nachrichtenformat](agent.proto) · [Rust-Typen](../crates/protocol/src/lib.rs) -Root `query_logs` now uses the same RootScope authorization path as root scripts, -services and reboots at planning, submission recheck, human approval and final -permit. It still requires explicit dev-root enablement, the selected tenant, -asset, agent, enrollment/assignment, principal and helper-policy capability bindings; -this change does not enable root or create/approve jobs. +## Nachrichten auf dem Gerätekanal -Prefer the following optional action-specific object in each private root-policy -scope (the surrounding policy remains schema_version 1): +| HTTPS-Endpunkt | Anfrage | Antwort | +| --- | --- | --- | +| `POST /agent/v1/messages` | Ein `ClientHello` eröffnet die Verbindung. Weitere `MessageBatch`-Anfragen übertragen unter anderem Inventar, Abgleich, Auftragsstatus und Ergebnisse. | Ein `MessageBatch` enthält die Antworten des Servers. | +| `POST /agent/v1/poll` | Ein `PollRequest` enthält einen Heartbeat und die gewünschte Wartezeit von 0 bis 25 Sekunden. | Das Gateway bestätigt den Heartbeat und liefert vorhandene Arbeit mit derselben Antwort. Im Leerlauf genügt die Bestätigung. | -```json -"root_logs": { - "schema_version": 1, - "allowed_units": ["rmm-acceptance.service"], - "sensitive_units": ["custom-audit.service"] -} -``` +Beide Endpunkte verwenden `application/x-protobuf` und Protokollversion 1. Eine Nachricht trägt unter anderem die Gerätekennung, die Generationen von Einschreibung und Verbindung, die Boot-ID, Sequenznummer und Nachrichten-ID. Für gespeicherte Meldungen wie ein Skriptergebnis bestätigt der Server die ursprüngliche Nachrichten-ID. [HTTP-Verarbeitung](../crates/server/src/agent_http.rs) · [Speicherung und Bestätigung](../crates/server/src/agent_service.rs) -`allowed_units` is exact, case-sensitive, max 128 distinct `.service` names. -An explicit empty list denies logs for that scope. There is **no fallback to -allowed_services**: permission to mutate a service is not permission to read its -logs, nor the reverse. Unknown log-profile versions, paths, wildcards, duplicates, -option-like names and malformed lists fail closed. No SSH or shell fallback exists. +## Vom Antrag bis zum Ergebnis -Backend actor environment variables, parsed only as bounded JSON string arrays: +1. WebUI oder MCP bindet ein einmaliges Skript oder eine feste Bibliotheksrevision an Ziele und Ausführungsidentität. Der Plan hält Skriptbytes, Prüfsummen, Zeitfenster, Laufzeit, Ausgabegrenze und Versuche fest. Für den weiteren Ablauf gelten drei Kennungen. `plan_id` öffnet die Planprüfung, `operation_id` bezeichnet den eingereichten Auftrag, `job_id` die Ausführung auf einem Gerät. [Plan und Auftragsabfragen](../crates/server/src/jobs.rs) · [Skriptbibliothek](../crates/server/src/script_library.rs) +2. Einreichen erzeugt `pending_approval`. Die berechtigte Person entscheidet in der WebUI. Erst bei Genehmigung legt der Server die geplanten Jobs und die Zustellung an. Die Tokenrechte für Kunde, Planung, Einreichung und Skriptkontext werden serverseitig geprüft. [Genehmigungen](../crates/server/src/approvals.rs) · [MCP-Zugriff](../docs/public-access.md) +3. Der Agent empfängt `JobOffer`, speichert den Versuch und antwortet mit `JobAccepted`. Vor dem Start fordert er die signierte `ExecutionPermit` an. Sie bindet unter anderem Kunde, Installation, Versuch, Planhash, Nutzdatenhash, Ausführungsidentität und Frist. Das Dienstkonto führt reguläre Skripte aus. Ein für die Installation eingerichteter Helper führt Linux-Skripte als `root` beziehungsweise Windows-Skripte als `SYSTEM` aus. [Startrecht](../crates/server/src/job_gateway.rs) · [Prüfung und Ausführungsjournal](../crates/agent-core/src/jobs.rs) +4. `JobResult` übermittelt Status, Exitcode, Standardausgabe, Fehlerausgabe und ein Kennzeichen für abgeschnittene Ausgabe. Bei erneutem Kontakt gleichen Agent und Server ihre Journale ab. Eine wiederholte Zustellung desselben Versuchs bewahrt dessen ursprüngliches Ergebnis. Bei unklarer Wirkung wird der Versuch abgeglichen. [Ergebnistypen](../crates/protocol/src/jobs.rs) · [Journalabgleich](../crates/agent-core/src/reconcile.rs) -* `RMM_ROOT_LOG_UNITS='["rmm-acceptance.service"]'`: explicit global log-unit - source for selected scopes without a root_logs object. If a scope has root_logs, - the environment acts only as an additional intersection/ceiling, never a way to - widen its list. Unset plus no scoped list means empty/deny. Empty string or `[]` - is explicit deny-all. A boolean, filename or shell fragment is not accepted. -* `RMM_ROOT_SENSITIVE_LOG_UNITS='["custom-audit.service"]'`: additional sensitive - classifications. It never allows a unit or removes an existing classification. +Auch ein Neustart ist ein Skriptauftrag. Sein erfolgreicher Exitcode bestätigt die Annahme durch das Betriebssystem. Bootwechsel, authentisierter Kontakt derselben Installation und ein erfolgreicher Folgeauftrag belegen den Wiederanlauf. [Abnahme auf beiden Plattformen](../docs/mvp-completion-plan.md) -Set these in the actual **backend container/process** if using environment-based -configuration; a variable only in the VM harness/agent environment does not alter -backend policy. Keep RMM_PROFILE=development, RMM_DEV_ROOT_ENABLED and the private -RMM_DEV_ROOT_POLICY_FILE explicit; no test automatically sets them. The agent's -RMM_LOG_UNITS_FILE and the helper's local unit policy remain independent limits. -The current helper uses its own allowed_services list for journal-unit checks; -that does not replace the backend's separate read allowlist or grant service -mutation rights through this new backend log policy. +## Erstaufnahme und Selbstupdate -Every root-log authorization requires current `root:execute` **and** `logs:read` -membership permissions. Sensitive sources additionally require current -`logs:read_sensitive`, independently for requester and approver wherever the -shared root authorization service is invoked. No viewer role, capability, -allowlist, dev flag or root permission silently grants sensitive-log access. -Sensitive classifications are unioned across all scopes for the same target, so -choosing another principal/scope cannot declassify a source. ssh.service, -sshd.service, sshd@*.service instances, auditd.service and systemd-logind.service -are always sensitive, even if a configured sensitive list is empty. No membership -receives sensitive-log access by default. - -A new grant for `query_logs` records the source classification on its job. The -immutable payload identifies the exact source and target. Stored log queries -and individual job reads enforce the reader’s current tenant permissions and -credential scopes. All log output requires `logs:read`. Sensitive sources and -historical jobs without a recorded classification also require -`logs:read_sensitive`. An operations reader can still see the job state and -numeric exit code. The result then carries `output_restricted: true` and omits -the protected output, evidence and free-text fields. Only explicitly selected -token scopes can convey the additional permission. - -Root log jobs bind one exact unit and UTC interval, with nonnegative timestamps, -positive interval **at most exactly 24h** (no rounded-hour widening), 1–1000 lines, -20–3600s runtime and 1–65536 output bytes. Standard capabilities remain required: -query_logs, root:query_logs, rmm.sync.v1, helper.root.v1 and the exact -helper.policy.sha256:. Full job/plan bytes and root identity are unchanged; -helper verification, resource locks, current start permission and the human UI -approval boundary still apply. - -Policy tests use synthetic job shapes/permission requirements only, not fabricated -DB memberships or approvals. A real selected-policy root journal read and sensitive -member acceptance remain native/browser integration cases, not claimed by unit tests. - -## Public certificate evidence (migration 0012) - -Device detail and list items now additionally expose: - -* `certificate_sha256`: lowercase SHA-256 of the current registered/most recently - issued leaf DER certificate. Rotation updates this pin immediately; issuance - alone is **not proof** that the new certificate was used in a TLS connection. -* `last_authenticated_certificate_sha256`: nullable SHA-256 of the actual verified - TLS peer certificate at the most recent successful registered-device binding - lookup; `last_authenticated_at` is its database UTC RFC3339 observation time. - Both are null until such evidence is observed after this migration. They are - not backfilled from issuance or historical heartbeats. - -The binding lookup atomically records evidence only for an unrevoked current pin -or a still-valid previous-certificate overlap. It is called by WSS authentication -and device mTLS HTTP paths, including key bootstrap, renewal and artifact access. -Thus a lost renewal response/old-certificate overlap may leave the current pin -**new** while the most recently authenticated peer remains **old**. A subsequent -successful new-certificate Hello records the new peer without changing agent ID -or enrollment generation. This is most recent authentication evidence, not an -assertion that every concurrent channel uses the same certificate. - -Fingerprints are derived by the TLS server, never from a client header/payload. -Authentication time is separate from presence: these lookups do **not** update -last_contact_at. Only an accepted fresh heartbeat updates presence; old telemetry, -key/artifact GET and certificate renewal do not. Invalid/unregistered/revoked or -expired-overlap certificates do not update authentication evidence. Current -membership/tenant checks apply to both public DTOs; foreign assets remain 404. -No private key, CSR, certificate PEM or raw credential is added to device DTOs. - -This is the implemented **backend increment**, not Linux-MVP acceptance. No -execution, human/browser approval, VM job, result replay, or helper acceptance -is claimed by this document. `tests/backend_contract.py` deliberately stops at -pending approval and denial of preapproval start requests. - -## Browser and HTTP - -The compiled `web/dist/index.html` and `/assets/*` are served on the same TLS -origin (`RMM_WEB_DIR`, Compose `/web`). Unknown API routes do not fall back to -HTML. Development profile is required; production refuses to start. - -Run `python3 deploy/dev.py jobs-auth` **once** for an existing initialized dev -environment. It generates separate private browser and operator credentials in -gitignored `devstate/`, never prints values, and does not authorize anything. -It refuses credential rotation/overwrite. Existing viewer credentials remain -read-only. `devstate/browser-login.json` is mode 0600; use this path for the -browser harness rather than copying secrets into source or command arguments. - -* `POST /auth/dev/login {username,password}` requires exact Origin - `https://rmm-dev.internal:18443` (configurable `RMM_UI_ORIGIN`). A fixed - `simulated-testprincipal-a`, tenant A only, gets a one-hour in-memory session. - Cookie: `__Host-rmm_session`, HttpOnly, Secure, SameSite=Strict, Path=/. -* `GET /auth/session` returns `{principal:string,tenant_id,csrf_token,roles, - testsimulation:true,approval_origin:"dev_test_browser_simulation"}`. -* Cookie-authenticated mutations require Origin **and** `X-CSRF-Token`. - `POST /auth/logout {}` revokes the session. Server restart requires re-login; - it does not erase durable plans, approvals, jobs or reservations. -* An Authorization header always selects bearer authentication, even alongside - a valid cookie. Bearer/MCP principals never get an interactive context. - -Business prefix: `/api/v1/tenants/{tenant}`. Supported paths: - -* GET `/devices`, `/devices/{asset}`, `/health`, `/operations`, - `/operations/{operation}`, `/jobs/{job}`, `/operation-plans/{plan}`. -* POST `/operation-plans`, `/operation-plans/{plan}/submit - {idempotency_key}`, `/jobs/{job}/cancel {reason}`. -* POST `/operation-plans/{plan}/authorizations {plan_hash,decision?}`: - decision defaults to `approve`; explicit `reject` supported. This handler - requires the interactive cookie context, exact hash, persistent pending request, - current scopes/capabilities/assignment, deadline and limiting policy. It is not - exposed as an MCP service. Approval creates authorization, operation, fixed - jobs and outbox atomically. Repeated approval returns the same operation. -* POST `/log-queries` uses the `LogQuery` DTO in server/monitoring.rs. Stored - results are bounded and explicitly partial. Live mode creates a fixed plan and - pending request; it never invokes a collector directly. - -Plan creation accepts the UI's spec-23.4 shape, including `tenant_id`, action -string, targets, parameters, schedule/offline_policy, rollout and reason. Exactly -one Linux UTF-8 script variant is supported; ambiguous variants fail closed. -The internal typed `PlanInput` is also accepted and is used by shared services. -`agent_service` remains the default. Selected root script/service/reboot plans -require the explicit, expiring dev policy and independently enforcing helper -profile described below; root is not enabled by default. Legacy package actions -never gain root authority. Package actions bind architecture, recipe_version and installation_context; -updates require `reboot_policy:"never"`; reboot binds dependency_group. - -Plan detail/creation returns `{plan_id,plan_hash,expires_at,plan_payload, -plan_payload_bytes,resolved_targets:[{asset_id,agent_id}],excluded_targets:[], -jobs:[{job_id,attempt_id,asset_id,agent_id,job_payload_hash,script_sha256,payload}], -approval_state}`. `plan_payload_bytes` is the actual stored byte array, not a -JSON view re-hashed by the UI. Detail exposes a submitted pending request after -reload. Job/attempt IDs in plans are reservations, **not executable job rows**. - -Submit returns the stable operation including `approval_state`, `state` alias, -planned_job_count, job_count, execution_state, counts and job summaries. Pending -approval has zero jobs and null execution_state. Reusing an idempotency key for -another plan conflicts; repeated submit of one plan returns its one operation. -Operation/list summaries omit potentially large result outputs: fetch `/jobs/{id}` -for the bounded result. Its stdout/stderr are raw JSON byte arrays. - -Device, operation and package-recipe lists support `?limit=1..500&cursor=...` -(default 100). Signed cursors bind tenant, actual principal, resource/sort, -page size and a fixed as_of, and expire after ten minutes. New rows after as_of -are excluded; IDs use ascending UUID order. Additional dynamic filters are not -implemented and unknown query fields are rejected on these paged routes. -Inventory/health freshness and job status remain live observations, not a -transactional historical snapshot. Health/log evidence remains explicitly bounded. - -## Shared Rust payloads and wire - -Authoritative Rust contracts: - -* `rmm_domain::jobs::{Action,JobPayload,PlanPayload,PlannedJob, - ExecutionPermitPayload,JobState,RecipeReference,encode,hash}`. -* `rmm_protocol::{Envelope,Payload,JobOffer,JobAccepted, - ExecutionPermitRequest,ExecutionPermit,JobStateChanged,JobResult,CancelRequest}`. -* Schema mirror: `proto/agent.proto`; additive oneof tags 20–26, reserved 15–19. - Existing passive tags and protocol version 1.0 remain unchanged. HTTP adds - top-level MessageBatch and PollRequest. Reconciliation adds Envelope tags 27/28. - -Codec 1: compact UTF-8 serde JSON of declared structs in declaration field order, -explicit null optional fields, ordered arrays, UTC RFC3339 times, integer limits, -no unordered parameter maps or floating-point values. The server stores exact -plan/job bytes once. SHA-256 hashes those bytes. Script hashes cover exact UTF-8 -bytes, including BOM/newlines; there is no postapproval normalization. - -`JobPayload`: schema_version, tenant_id, asset_id, agent_id, -enrollment_generation, assignment_version, job_id, attempt_id, typed Action, -execution_identity, not_before, start_before, max_runtime_seconds, -max_output_bytes. Action is a flattened tagged object (`action:"run_script"`, -interpreter, script_utf8, arguments, expected_stdout), **inside** JobPayload.action. -Inspect the Rust enum for the other six complete typed action shapes. - -Administrative signature profile: **Ed25519 only**, OpenSSL, 64-byte signature -over the exact ExecutionPermitPayload bytes. Signed payload starts with fields -`domain:"rmm.execution-permit"`, `schema_version:1`. It binds grant_id, -authorization_id, tenant_id, asset_id, agent_id, enrollment_generation, -assignment_version, job_id, attempt_id, plan_hash, job_payload_hash, action, -execution_identity, not_before, start_before (at most 60 seconds), -max_runtime_seconds and key_id. Key ID is SHA-256 of raw 32-byte public key. -The protected persistent key is `devstate/jobs/ed25519.pem`, separate from TLS CA -and software-update keys. GET `/api/v1/job-signing-key` is authenticated and returns -key_id, algorithm, schema_version, public_key_hex. Provision/pin that public key -over the verified bootstrap channel. A key sent with a job is not a trust anchor. - -### Agent WSS sequence - -1. Connect with enrolled mTLS identity; ClientHello sequence >0 and connection - generation 0. Advertise only action names that actually work on this device: - run_script, refresh_inventory, query_logs, set_service_state, ensure_package, - apply_updates, reboot. The server persists capabilities for planning checks. -2. ServerHello selects the connection generation. Every subsequent fresh request - uses it. Heartbeat/inventory handling stays compatible. Honest short bursts of - journal/state traffic are allowed; limit is 20 inbound messages/second. -3. JobOffer is sent only from the postapproval durable outbox, after ServerHello - or the independent one-second WSS delivery timer/normal ACK traffic. It includes exact payload_bytes, hashes, - authorization and fixed IDs. It grants **no** execution permission. Commit the - offer to SQLite before sending JobAccepted with the same IDs/hash and a bounded - nonempty journal_proof. Repeat unacknowledged durable envelopes unchanged. -4. Server sends Ack only after durable acceptance/receipt commit. A fresh - ExecutionPermitRequest immediately before effect includes job_id, attempt_id, - job_payload_hash, assignment_version. Its response is ExecutionPermit, **not** - Ack. Denial uses denial_code and empty payload/signature. Do not offline-buffer - permit requests or treat any denial as authority to execute. -5. On grant receipt, agent **and helper** verify Ed25519 against the pinned key, - all signed bindings against the exact job bytes/current device identity, - trusted time/deadline and execution identity, then durably consume both grant - and `(agent,generation,job,attempt)` before effect. Hold local resource locks. - The backend commits reservation and signed bytes before transmission. It never - issues another grant for this attempt, even if the first response was lost. -6. JobStateChanged carries revision >0, state, IDs and grant_id. Running, - verifying, awaiting_reboot and unknown are nonterminal state events. JobResult - carries revision, terminal/unknown/awaiting_reboot state, grant_id, raw bounded - stdout/stderr, output_truncated, reboot_required, optional exit_code, - evidence_json and error_code. Both are durable until concrete message-ID Ack. - A valid late terminal result may reconstruct missing intermediate states. - Lower-revision state evidence never resets a terminal/unknown ledger. -7. Success evidence needs `postconditions_passed:true`. Scripts additionally - require exit_code 0 and exact expected_stdout when bound. Reboot success needs - evidence `new_boot_id` equal to the authenticated envelope boot_id, different - from the boot recorded at grant reservation. Failed results need error_code. - Cancellation needs `not_started:true` or `abort_confirmed:true`. A definite - prestart failed/cancelled/expired result may omit grant_id **only** when no - grant was ever reserved and evidence contains `not_started:true`. -8. Grant issuance is not a start acknowledgement. After an unconfirmed reserved - start window or running deadline the ledger becomes unknown, never expired/ - cancelled by inference. A late definitive bound result can reconcile unknown, - with an audit event. No retry grant is created. Unknown keeps resource/rollout - reservations; a new action requires a newly approved plan, not redelivery. - -Envelope message-ID identity includes observed_at/sequence/boot/payload; changing -connection_generation on retransmission is the only hash-normalized field. Late -durable job evidence may be ingested from a fenced channel, but it never refreshes -presence or obtains new offers/grants. Telemetry aging quotas do not discard old -job results. End-to-end restore synchronization remains an open gate. - -## MCP - -Real **rmcp 3.9.0**, Streamable HTTP `/mcp`, tested protocol **2025-11-25** legacy -initialize/notifications-initialized/session lifecycle. 2026-07-28 is not claimed. -Use verified TLS and Authorization bearer on **every** HTTP request, plus Accept -`application/json, text/event-stream`; carry returned Mcp-Session-Id. SDK validates -Host and browser Origin; MCP cookies alone never authenticate. - -Ten tools: tenants.list, inventory.list_devices/get_device, -monitoring.get_health, logs.query, operations.plan/submit, jobs.get/cancel, -sessions.request. No approval tool. Sessions explicitly return unsupported. -Operations.plan arguments are `{tenant_id,input:}`; -operations.submit `{tenant_id,plan_id,idempotency_key}`; jobs.get requires exactly -one of operation_id/job_id. Tool schemas derive from the same Rust input types; -adapters call shared job/inventory/monitoring services, not alternate policies. - -## Known acceptance and implementation gaps - -* Agent executor, journal consumption, independently verifying privileged helper, - real browser approval, positive grant/result/replay tests, and all VM jobs are - **not** implemented/proved by this backend dispatch. Do not advertise action - capabilities merely because a provider type exists. Separate agent/helper - workers own execution integration; this document does not claim their acceptance. -* Production OIDC/JWKS/OAuth browser flow is **not implemented**. Production still - refuses to start; this is not a production-ready auth implementation. Development - now has persistent tenant-scoped memberships with distinct permissions and - revocation checks, not a blanket viewer/operator approval mapping. -* Backend reconciliation now supports clean/replayed/reconnected journals, durable - result replay and targeted outcome decisions. The **agent/helper consumer of the - new protocol is a separate integration**, not implemented by this dispatch. - Missing authoritative jobs/history and regressed journals fail closed for manual - recovery. Coordinated rollback of every independent ledger still requires an - explicit operator restore procedure, not automatic readiness. -* No standalone worker role, production artifact store, agent capability/forwarding - integration for native APT acceptance, or separate append-only audit archive. Root scope - configuration is deliberately not generated/enabled by this backend work. -* `tests/local_integration.py` now retains the passive TLS/auth/RLS checks and checks - durable authorization relationships instead of asserting job tables are absent. - Its native fixture is selected by its own identity, never an arbitrary online VM. -* No database/PKI reset or VM/credential access is part of this dispatch. - -## Backend follow-up: HTTPS, housekeeping, controls and catalog - -### HTTPS agent transport (mTLS, application/x-protobuf) - -* `POST /agent/v1/messages`: MessageBatch `{protocol_major=1 [tag 1], - repeated Envelope messages [tag 2]}`. Maximum encoded body 1 MiB, 16 envelopes. - Hello is a batch of exactly one ClientHello envelope, generation zero. Response - is MessageBatch containing ServerHello, then possibly one already-approved - offer. Fresh heartbeat/permit controls are singleton batches; multi-message - batches contain durable inventory/job evidence only. Durable envelopes can be - retried with their original message IDs. Failed partial batches may have already - persisted earlier messages; replay is deduplicated and never re-executes work. -* `POST /agent/v1/poll`: PollRequest `{Envelope envelope [tag 1], uint32 - wait_seconds [tag 2]}`. Envelope is one fresh heartbeat with current generation. - Wait is 0–25 seconds. Response is MessageBatch with the concrete heartbeat ACK - and optionally one offer/cancel. No work is normal, not a job error. Do not - interpret the heartbeat ACK as acceptance of a job or execution permit. -* WSS and HTTPS call one durable ingest service. Switching transport requires a - new Hello and increments generation. Old polls/streams cannot get new work or - grants. Late bound durable job evidence does not refresh presence. Fresh replay, - untrusted time, protocol/capability mismatch, and oversized input fail closed. - Successful inbound traffic is rate-bounded per registered device in PostgreSQL. -* WSS checks persistent revocation at one-second intervals, verifies the actual - TLS peer certificate expiry during traffic, and forces reauthentication after - at most one hour. Certificate identity/expiry come from TLS, never HTTP headers. - -### Certificate rotation and recovery - -`POST /agent/v1/certificates/renew` is mTLS JSON `{csr_pem}` with a valid current -P-256 CSR. Response `{agent_id,certificate_pem,overlap_seconds:300}`. The transaction -stores new fingerprint/certificate/CSR hash and fences the connection generation. -Agent/asset/enrollment generation are unchanged. The previous certificate binding -has a five-minute overlap. Persist the exact pending CSR/key before requesting; -repeating the **same CSR bytes** during overlap returns the same certificate after -a lost response. Previous credentials cannot rotate again using a different CSR. -Do not delete the old identity before atomically installing/verifying the response. -Expired/revoked identities do not get a verification bypass or public recovery grant. - -### Background policy and interactive controls - -A background task starts in gateway/all roles, visits the explicitly authorized -development tenant registry in separate transaction-local RLS contexts, and runs -every second with per-tenant advisory coordination. It expires pending requests -and definitively unstarted jobs offline; reserved unconfirmed starts/running -deadlines become unknown, never inferred cancelled/expired. Outbox redelivery uses -the same durable lease and fixed attempt; WSS delivery no longer waits for inbound -heartbeats. No scheduler path creates approvals, attempts or start permissions. - -At start, current persistent requester/approver permissions, recipe references, -identity/assignment, stops, deadlines, resource locks, plan rollout limits, failure -thresholds and tenant cumulative limits are rechecked. Development tenant policy -defaults are at most 100 reservations/hour and 10 concurrent reserved attempts; -unknown retains its resource/rollout slot. Reboot dependency groups are serial; -the development policy additionally permits only one active reboot per tenant, -so changing a caller-supplied group label cannot bypass reboot serialization. -Positive authorized quota/replay/effect acceptance remains a browser/agent test gate. - -Cookie+CSRF+Origin+explicit permission are required for these JSON endpoints: - -* `POST /api/v1/tenants/{tenant}/devices/{asset}/revocation {reason}` -* `POST /api/v1/tenants/{tenant}/operation-plans/{plan}/revocation {reason}` -* `POST /api/v1/tenants/{tenant}/execution-stop {stopped:boolean,reason}` - -Bearer credentials cannot invoke them, even with an additional browser cookie. -Device revocation clears old-certificate overlap, fences active channels and -requests cancellation. Plan revocation preserves execution evidence and blocks new -starts; an already issued short-lived grant/running effect is not retroactively -undone. Stop release never approves pending work. Audit records the real test -principal/session, reason and explicit simulation origin. The matching UI controls -and positive browser-driven administrative tests belong to the browser worker. - -### Immutable development catalog and artifacts - -`GET/POST /api/v1/tenants/{tenant}/package-recipes` uses AptRecipe: -`{schema_version:1,provider:"apt",package,version,architecture:"amd64", -recipe_version,installation_context:"system",reboot_policy:"never"}`. Import is -interactive catalog:write only. No shell command, download URL, installer option -or implicit reboot can be supplied. Database versions are immutable and content -hashed. Exact package/version/architecture identifies one immutable recipe; -ensure_package additionally binds recipe_version. apply_updates requires each -selection as `name=exact-version`, never a package-manager-wide upgrade. - -PlanPayload adds `recipe_references:[{package,version,architecture,recipe_version, -sha256}]`, hashed inside the exact stored plan bytes and rechecked at approval/start. -This is additive: empty references are omitted and old stored plan bytes round-trip -unchanged (golden-tested). JobPayload and ExecutionPermit signatures/fields are -unchanged. Legacy ensure_package/apply_updates root execution remains disabled; -catalog presence does not enable privilege. The isolated APT-v2 contract below -does not silently upgrade those old payloads. - -`POST /.../artifacts {bytes:[0..255],media_type}` is interactive catalog:write only; -maximum 256 KiB. `GET /.../artifacts/{id}` requires current tenant operations:read, -returns attachment bytes and verifies the stored SHA-256/size on each read. A local -ArtifactStore trait implementation stores private, immutable content-addressed -files under the administrative key directory's `artifacts/{tenant}/` tree, writes -and syncs before publishing, and refuses production profile. This is not a general -MCP upload tool, remote installer URL path, or production S3 adapter. Agent artifact -downloads are now target/approval/reference authorized as described below; -recipe-fed privileged package execution remains separate integration. - -## Sync/root/inventory/artifact integration profile (next agent/helper consumer) - -### Trust bootstrap and passive inventory - -`GET /api/v1/job-signing-key` now also accepts the **actual enrolled, unrevoked, -unexpired device mTLS identity**, using the same binding as WSS. There is no -redirect and the response remains exactly `{key_id,algorithm:"Ed25519", -schema_version:1,public_key_hex}` (raw 32-byte key, SHA-256 key ID). Explicit -Authorization always selects bearer authentication and never falls back to -mTLS/cookies after failure. The agent's existing no-redirect mTLS bootstrap works -without putting any viewer/MCP credential on the device. Helper trust provisioning -remains independent; an agent-supplied key is never helper authority. - -The old strict `rmm_domain::Inventory` is unchanged. The gateway additionally -validates `inventory_document::validate` over the existing linux.base JSON: -optional `observations` array (<=32), `collection_started_at` and -`collection_completed_at` (both required with observations). Each <=32 KiB -observation has exactly `scope,source_id,observed_at,quality,completeness,truncated, -error_code,data`; times are real RFC3339, scopes are unique linux names, quality -and completeness are enumerated, and a device cannot assert received_at. -Collection is bounded to one hour/72-hour telemetry age and the full JSON to -512 KiB. Existing base fields still validate strictly. Accepted additive data is -stored, not stripped or relabelled valid/complete. `RMM_EXTENDED_INVENTORY=1` -is now backend-compatible and was exercised with the real local native collector; -that is **not** VM acceptance. Root/control job payload limit is 65,536 bytes, -matching the current independently verifying helper parser. - -### Exact public wire types (protocol major 1, minor 0) - -`rmm_protocol::Payload::{SyncRequest,SyncResponse}` use new oneof tags **27,28**. -Earlier tags/reservations are unchanged. Both transports use the same service. -Advertise **`rmm.sync.v1`** in ClientHello. It closes the server start/offer gate -on every Hello until a fresh valid reconciliation. Legacy clients remain passive/ -first-session compatible, but their existing local reconnect block is not bypassed. -Root always additionally needs helper readiness. SyncRequest is a singleton HTTPS -MessageBatch or one WSS Envelope, with fresh current generation/boot/sequence/time. - -`SyncRequest` fields/tags: - -1. request_id (UUID, durably reserve before sending) -2. journal_id (stable agent SQLite journal UUID) -3. checkpoint (monotone committed local checkpoint, u64 <= i64::MAX) -4. previous_decision_id (last durably applied server decision, empty initially) -5. assignment_version -6. repeated SyncAttempt (<=256) -7. repeated durable_message_ids (<=256 concrete unacknowledged IDs) -8. journal_complete (true only for a complete unsettled-attempt summary) -9. helper_journal_id (stable **independent helper** journal UUID, empty if absent) -10. helper_checkpoint (its own monotone checkpoint) -11. helper_previous_decision_id (its last durably applied signed checkpoint) -12. previous_request_id (recover a lost agent response when decision ID is unknown) - -`SyncAttempt` fields/tags: - -1. job_id; 2. attempt_id; 3. job_payload_hash; 4. grant_id (empty only if absent); -5. consumption: `unconsumed|consumed|uncertain`; -6. logical state: queued, accepted, requesting, running, verifying, -awaiting_reboot, unknown, succeeded, failed, cancelled, expired; -7. logical job-state revision; 8. original_boot_id; -9. optional JobResult (may be omitted when supplied in field 13); -10. result_message_id; 11. outcome_sha256; -12. optional canonical outcome_bytes (<=512 KiB); -13. optional **original durable Envelope** containing that JobResult. - -For durable result replay, field 13 is required: preserve the original message ID, -sequence, observation time, boot and payload. Rewrapping the same result ID with -sync-envelope metadata is an identity conflict. Connection generation is the only -receipt-hash-normalized envelope field. Optional field 9 must agree exactly with -field 13 if both are supplied. Accepted-but-not-started is a logical summary, not -an executor's raw SQLite status name; map a locally journalled offer to accepted. - -`SyncResponse` has `decision_bytes [1], signature [2]`. It is returned **instead -of** a generic Ack, only after the checkpoint/readiness/outcome transaction commits. -The exact signed bytes are durably cached by request ID/content/current generation; -same ID with different content or an old-generation replay is rejected. On lost -response/reconnect, use a fresh request ID and previous_request_id pointing to the -persisted old request, rather than inventing a checkpoint or replacing a grant. - -### Signed reconciliation / independent helper SyncAck - -Authoritative Rust types are in `rmm_domain::reconciliation`: -`ReconcileDecisionPayload`, `AttemptDecision`, `ReconciledOutcome`, -`canonical_outcome_bytes`. Fixed Ed25519 over exact decision bytes, using the -independently pinned administrative key. Domain is **rmm.reconciliation-decision**, -schema_version 1, never rmm.execution-permit. Validity is at most 60 seconds. -Verify signature **before** parsing/trusting fields; then current tenant, asset, -agent, enrollment/assignment/connection generations, boot, journal IDs/checkpoints, -request ID/hash, key ID and deadline. Request hash is SHA-256 of canonical prost -`SyncRequest::encode_to_vec()`, not arbitrary reformatted JSON or Envelope bytes. - -The payload additionally binds ready, helper_ready, reason, concrete acknowledged -message IDs and per-attempt decisions. Every AttemptDecision binds fixed job and -attempt, job-payload hash, grant ID, authorization/plan references, action, -execution_identity, revision, exact outcome state/hash, previous local outcome hash, -original boot and an explicit **unlock** decision. `valid_profile` checks only the -generic profile/time bounds, not signature or caller-specific bindings. - -Outcome codec 1 has the same field values/order as helper Outcome: -state, stdout, stderr, exit_code, output_truncated, reboot_required, evidence, -error_code. Use **canonical_outcome_bytes**, which recursively sorts evidence -object keys independently of serde feature flags, preserves raw output bytes and -explicit nulls, and returns the bytes to hash. If outcome_bytes is provided it must -already be canonical. Hashing arbitrary local JSON spacing/key order is invalid. - -The helper must independently compare its own journal/checkpoint, consumed grant, -fixed job hash/identity, revision and **previous_outcome_sha256** before applying a -signed per-attempt unlock. For an unchanged terminal outcome it compares its own -canonical outcome against outcome_sha256; no repeated outcome body is necessary. -For verified reboot reconciliation the server supplies new canonical outcome_bytes -and their hash. Keep consumed grant/attempt tombstones: unlocking a resource is -**not** deleting consumption or permitting a second execution. Apply decisions -idempotently and durably before reporting readiness. A decision is never a grant, -even when ready=true. Continue to obtain a separate fresh ExecutionPermit. - -Known definitive attempts can receive targeted unlock decisions while another -attempt keeps global readiness false; do not turn such an unlock into global -execution authority. Unknown free scripts with no bound postcondition remain -manual needs-attention. Requesting/running/ambiguous grant consumption persists -unknown with resource reservations, never retries automatically. A reboot can be -reconciled only with the reserved original boot, authenticated different boot and -persisted new-boot inventory; the exact definitive result is audited and signed. -Missing authoritative jobs/hash/assignment mismatches create a sticky -sync_recovery_required fault, not a new job. Omitting that attempt later cannot -clear it. Sequence rollback and missing checkpoint history likewise fail closed. -Manual controlled identity/ledger recovery is required for those faults. - -Clean complete journals and accepted-unstarted jobs retain fixed IDs/revisions and -regain readiness; Sync creates no operation, approval, outbox, attempt or permit. -Only message IDs actually present in durable receipts/observations are ACKed. -The backend tests prove real empty-journal/helper-checkpoint roundtrip, clean -reconnect, response-loss recovery, signature/tamper checks and persistent restore -denials. Accepted-unstarted classification is unit-tested. Positive consumed-job, -independent helper apply/unlock and real reboot-result E2E cases still require the -browser/agent/helper workers; no direct API/DB approval fixture was manufactured. - -### Explicit selected root profile (default OFF) - -Require `RMM_PROFILE=development`, `RMM_DEV_ROOT_ENABLED=true` and -`RMM_DEV_ROOT_POLICY_FILE=/private/policy.json`. The file must be regular, -nonsymlink, <=64 KiB, mode 0600, owned by the administrative-key owner with a -non-writable-by-others parent. Schema (configuration example, **not an enablement -or native proof performed by this dispatch**): - -```json -{ - "schema_version": 1, - "profile": "development", - "expires_at": "REPLACE-WITH-EXPLICIT-RFC3339-DEADLINE", - "scopes": [{ - "tenant_id": "SELECTED-TENANT-UUID", - "asset_id": "SELECTED-ASSET-UUID", - "agent_id": "SELECTED-AGENT-UUID", - "enrollment_generation": 1, - "assignment_version": 1, - "principals": ["simulated-testprincipal-a"], - "helper_policy_sha256": "EXACT-INDEPENDENTLY-PROVISIONED-HELPER-POLICY-HASH", - "acceptance_evidence_id": "REAL-REVIEWED-NATIVE-HELPER-RECORD", - "allowed_services": ["rmm-acceptance.service"], - "allow_root_scripts": false, - "allow_reboot": false - }] -} -``` - -The evidence ID is trusted administrator deployment metadata, **not remote -attestation or proof manufactured from a capability string/unit test**. Populate -it only after independently reviewed helper provisioning/acceptance. The backend -did not create such a file or enable root. Migration 0008 assigns root:execute only -to the explicit dev test human, not viewers or all operators. Requester **and** -approver need root:execute and selected scope; free scripts also scripts:execute. - -Agent advertises root capabilities only after authenticating the actual root -socket/peer and its independently provisioned helper policy: -`rmm.sync.v1`, `helper.root.v1`, `helper.policy.sha256:<64-lowercase-hex>`, -the base action, and `root:`. A plain base capability is insufficient. -Current profile permits explicitly allowed root scripts (<=300s), exact allowed -running/stopped services (>=180s), and explicitly enabled reboot (>=60s), output -<=64 KiB. Successful helper sync is required again at start. Current permissions, -policy expiry/hash, assignment, approval, stops, deadlines and quotas are rechecked. -Never relabel agent_service into root; the helper still verifies all signature, -identity, payload, time, local-policy and one-time-consumption bindings itself. -Legacy ensure_package/apply_updates **without** an exact apt_manifest are not -root-enabled or submit/approval eligible. The optional schema-2 fixture profile -below is a separate explicit opt-in; it is not enabled by this dispatch. - -### Agent artifacts and isolated APT-v2 contract - -Plan creation optionally accepts top-level `artifact_ids:[UUID...]` (<=16 unique). -The server reads and verifies actual immutable local objects, then hashes -`PlanPayload.artifact_references` into the plan: each entry binds job_id, -attempt_id and `{artifact_id,sha256,size_bytes}`. Empty references are omitted for -old codec compatibility. Approval/start recheck those exact references and bytes. - -`GET /agent/v1/artifacts/{artifact_id}?job_id=...&attempt_id=...&offset=0&length=...` -requires device mTLS (bearer selection is rejected), current target assignment, -an actual approved active job and a matching immutable plan reference. Reserved -preapproval IDs confer no access. Cross-tenant/foreign/missing references return -the same 404. Length is 1..512 KiB, default 512 KiB; the current local import adapter -still limits each object to 256 KiB. Response is attachment bytes, 206/Content-Range -for a partial chunk, and x-artifact-sha256 for the complete object hash. No free -filesystem path or model-provided download URL exists. Positive authorized -download through an actual UI-approved fixture remains a browser integration gate. - -### Authoritative helper-compatible APT schema 2 (latest parallel handoff) - -Use the exact contract in **tools/apt-transaction/HELPER-CONTRACT.md**. Public domain -types now match it: `AptExecutionManifest`, `ResolvedAptTransaction`, -`PackageArchive` in `rmm_domain::apt_transaction`. All reject unknown/duplicate -fields. This is **schema 2 inside the existing schema-1 JobPayload Action**, not -a new unsigned IPC field or a changed ExecutionPermit profile. - -Manifest fields, in declared serialization order: -`type:"rmm.apt.helper-action",schema_version:2,action,execution_profile:"dev-test", -transaction_sha256,resolved_apt_transaction,transaction_bytes,provider_sha256, -hook_sha256,apt_config_sha256,runtime_sha256,test_result_id`. -The exact transaction bytes must hash correctly and strictly decode to the complete -typed nested object. The helper writes those original bytes, not a JSON view. -Transaction fields: schema_version=1, recipe_id, recipe_version="1", -platform="ubuntu-24.04-amd64", resolver_config_version="rmm-apt-local-v1", -no_reboot=true, status_fingerprint, baseline_sha256, packages. PackageArchive fields: -name, architecture, old_version, new_version, origin, sha256, size, archive_path. - -The current native profile is **only** the two code-pinned, single-package -rmm-mvp-test fixture transactions, architecture all, exact size 20672 and known -SHA-256 pins shared with the helper contract: - -* rmm-apt-fixture-install-1.0: absent -> 1.0, - `74036ae81223deab3aae994fd2a2a695af408741777e1ce17dcb4e32f1235867` -* rmm-apt-fixture-update-1.1: 1.0 -> 1.1, - `ef67c9fe0ba1443fcfe465768e1204763063c369a2a1da04af6027d8a9c00491` - -Both use rmm-test origin and fixed content-addressed root-store archive paths. -No arbitrary catalog, dependency expansion, removal, URL, shell conversion or -automatic update/reboot is accepted by this fixture enablement. - -Domain Action changes preserve old bytes when options are None: - -* EnsurePackage adds `recipe_id:Option` and - `apt_manifest:Option`, default None/omitted. Execution - requires Some, outer recipe_id/version and package/version/architecture matching - the exact nested apt-execute transaction. -* ApplyUpdates adds the same optional apt_manifest. The executable fixture update - uses provider apt, packages `["rmm-mvp-test"]`, reboot_policy never, and the exact - nested update recipe/versions. The manifest, not an unpinned package-manager - selection, binds the complete actual transaction. -* Dedicated `AptNativeAcceptance {recipe_id,recipe_version,apt_manifest}` serializes - action **apt_native_acceptance**, with manifest action **apt-native-acceptance**. - Permit.action is exactly apt_native_acceptance. It is not run_script. - -`Action::validate()` requires the full manifest for executable package actions. -`validate_plan_shape()` only preserves immutable **legacy catalog previews**: -their authorization_status is unsupported_manifest_required; submit/approval/start -reject APT_MANIFEST_REQUIRED. Old missing-manifest jobs never gain execution rights. -The HTTP normalizer accepts the complete typed apt_manifest and explicit recipe_id; -its equality checks do not discard fields or accept parameter aliases. Transaction -hash references are also part of the immutable plan. All target, identity, -assignment, action, runtime, approval and grant bindings remain unchanged. - -Native acceptance additionally requires current `apt:native_acceptance` permission -(migration 0010 grants it only to the dev test human), root:execute, the selected -device/root policy and successful agent/helper reconciliation. Root scope may add -an **optional**, default-absent `apt` object: -`{allow_native_acceptance:false,allow_execute:false,provider_sha256,hook_sha256, -apt_config_sha256,runtime_sha256}`. Set pins only to reviewed installed bytes and -runtime/config measurements. Capabilities must include apt.manifest.v2 and -apt.native-acceptance.v1 for the dedicated test, or apt.native-accepted.v1 for -ordinary fixture apt-execute, plus the base action/root:, helper profile -and exact helper policy digest. Runtime is >=180s. Missing policy/pins/capabilities -or local acceptance rejects; a capability is not native proof. - -The existing independently enforcing helper bridge consumes the unchanged exact -signed JobPayload bytes, verifies both manifest representations/code/runtime pins, -root-private prefetch/sealing, current baseline, native locks and sandbox, and -maintains its own consumption ledger. Backend work does not weaken its systemd -sandbox, create a native acceptance record, advertise capabilities, install or run -APT. Agent forwarding/capability advertisement, UI action creation and actual -UI-approved native VM acceptance remain separate worker integrations. - -Earlier generic artifact-reference utilities are retained as PinnedAptTransaction, -AptArchiveReference and ResolvedAptJobPayloadV2, with AptExpectation and -AptExpectedPackage aliases for data callers. **Do not use the prototype V2 job -envelope for the real helper bridge**; the authoritative path above is the existing -v1 JobPayload with a fully preserved schema-2 Action.apt_manifest. +Frische Geräte laden `/install/linux.sh` oder `/install/windows.ps1` über HTTPS. Für die Erstaufnahme verwenden sie den Aufnahmeweg des Kunden. Eingeschriebene Geräte fragen die veröffentlichte Agentversion über `/agent/v1/releases/current` ab. Der Updater prüft das signierte Manifest und die gebundenen Artefakte. Bei einer bereits installierten administrativen Helper-Version zählt für die Manifestgültigkeit der Zeitpunkt ihrer Registrierung im Katalog. Bei Neuinstallationen und Updates zählt die aktuelle Zeit. [Implementierung der Release-Routen](../crates/server/src/agent_updates.rs) · [Produktbeschreibung](../Rust_RMM_Implementierungsspezifikation.md) diff --git a/tests/agent_jobs/README.md b/tests/agent_jobs/README.md index 612032f..a745b49 100644 --- a/tests/agent_jobs/README.md +++ b/tests/agent_jobs/README.md @@ -1,51 +1,12 @@ -# Targeted local agent/helper checks +# Skriptaufträge und Linux-Installationsstaging testen -Actually executed on the development Linux host, not the target VM: - -```sh -/home/Kevin/.cargo/bin/cargo test -p rmm-agent -p rmm-agent-linux -p rmm-privileged-helper -``` - -First-increment result: **24 unit tests passed** (4 agent, 12 Linux provider, -6 helper verifier/ledger/clock, 2 helper peer-ACL/policy). Tests live next to their private -implementation APIs. They cover SQLite reopen, exact duplicate/conflicting -offers, request reservation ambiguity, state/event rollback, cancellation/ -expiry evidence, duplicate grants and attempts, unknown resource retention, -every permit/identity binding, forged signatures, payload tampering, clock -window endpoints, unsafe paths/corruption, peer UID mismatch, root execution -denial in the network agent, actual harmless script bytes/output/limits and -provider process-group cleanup. Unsafe service/package/reboot effects use -existing typed mocks; native APT mutation is specifically tested as denied. - -Also actually passed for these packages: `cargo clippy --all-targets -- -D warnings`, -`cargo fmt -- --check`, and debug `cargo build -p rmm-agent -p rmm-privileged-helper` -(using the explicit `/home/Kevin/.cargo/bin/cargo` path). Initial Clippy errors in -two provider test slice clones, helper accept-loop style and agent nested-if -style were corrected, not suppressed. - -This is not a real browser-approved WSS job, VM service, package or reboot -acceptance. The complete bootstrap and known hard blockers are in -`deploy/linux/README.md`. Do not run native host mutation to replace VM evidence. - -## Second increment — actually executed locally - -The targeted Rust command above now passes **34 tests** (10 agent, 15 Linux, -7 helper-library, 2 helper-binary). Added tests cover native observation wire -mapping/size/unsupported metadata, fresh live inventory time, typed log request -allowlist/window/limits including inward fractional-time rounding, future-schedule fairness, write-once signing-key pins, -actual loopback **mTLS** key bootstrap with DNS/SNI-preserving connect override, -wrong-server-name rejection without creating trust, and durable original boot/ -awaiting-reboot evidence with retained resource locking. - -Also actually passed: +Vom Projektstamm aus lassen sich die Tests für Auftragsbindung und Ausführungsjournal sowie die beiden Tests des Linux-Stagingwerkzeugs aufrufen. ```sh +cargo test --locked -p rmm-agent-core --test contracts python3 tests/agent_jobs/test_install.py -python3 -m py_compile deploy/linux/install.py tests/agent_jobs/test_install.py ``` -Two create-only staging/guard tests passed; the installer was not run against -the host root or VM. An initial Python annotation incompatibility on the local -interpreter was corrected using postponed annotations; tests then passed. -Targeted Clippy with `-D warnings`, debug builds and Rust formatting checks also -passed. No native service/package/reboot effects, VM access or server restart. +Die Rust-Tests prüfen die Signatur und die Bindung des Startrechts an Gerät, Versuch und Skript. Sie öffnen das Journal nach dem Verbrauch eines Startrechts erneut und prüfen, dass derselbe Versuch keine zweite Ausführung auslöst. [Vertragstests](../../crates/agent-core/tests/contracts.rs) + +Der Python-Test baut einen temporären Verzeichnisbaum für `deploy/linux/install.py` auf. Er prüft die vorbereiteten Dateien, das Verhalten bei erneuter Anlage sowie die Ablehnung unsicherer Pfade und privater Schlüssel. Die Abnahme des öffentlichen HTTPS-Installers und der tatsächlichen Geräteaufträge steht im MVP-Nachweis. [Stagingtest](test_install.py) · [Abnahme](../../docs/mvp-completion-plan.md) diff --git a/tests/agent_sync/README.md b/tests/agent_sync/README.md index 7b59040..ceb2586 100644 --- a/tests/agent_sync/README.md +++ b/tests/agent_sync/README.md @@ -1,264 +1,11 @@ -# Reconciliation client handoff — isolated module, not yet production wire-up +# Wiederanmeldung und Journalabgleich testen -**Historical module-only handoff.** Production wire-up has since been implemented -in the agent dispatcher, helper control RPC and shared transport actor. Current -contract and verification boundaries: `deploy/linux/runtime-README.md`. The -earlier patch-position instructions below are retained as implementation history, -not an assertion that the modules are still unregistered. +Linux und Windows nutzen den gemeinsamen Agentenkern für den Abgleich nach einem Verbindungswechsel. Die Integrationstests legen eigene SQLite-Journale in temporären Verzeichnissen an. Sie prüfen unter anderem die Bindung signierter Entscheidungen an die aktuelle Verbindung, den Erhalt eines verbrauchten Startrechts und die Rückmeldung bereits gespeicherter Skriptergebnisse. Der Test für den Windows-SYSTEM-Helper deckt die Wiederanmeldung nach bereits quittierter Ergebnismeldung ab. [Agentenabgleich](../../crates/agent-core/tests/reconcile.rs) · [Helper-Abgleich](../../crates/agent-core/tests/helper_reconcile.rs) -Only new files were added for this dispatch: -`crates/agent/src/reconcile.rs`, `crates/agent/tests/reconcile.rs`, this document. -No existing agent/helper/backend/domain/protocol file or Cargo manifest was -changed. No VM, SSH, API approval, root effect or server restart was performed. -The test module uses the actual public protocol/domain contracts, OpenSSL -Ed25519 and real SQLite files, not substitute wire structs or an in-memory mock -journal. Build-directory locks were allowed to resolve normally. - -## Public module API - -* `ClientSync::new(Binding)` — process-local mutation gate starts closed. Existing - `safety('connected')` is never reset/deleted. The binding contains the already - provisioned administrative key, not a key received with a response. -* `Channel { connection_generation, boot_id }` — construct only after validating - the current authenticated ServerHello. Use the native Linux boot UUID, never - the agent instance/process UUID. Enrollment/assignment/tenant/asset/agent remain - bound by `Binding` and by every decoded local offer. -* `SyncClock::now()` and production `NativeClock::default()` — native synchronized - clock plus wall/monotonic jump checks. A false clock closes mutation authority; - it does not prevent independent passive telemetry. -* `initialize(&Connection)` — creates only additive `reconcile_*` tables in the - already locked, privately opened agent journal. Existing tables are required: - `counter`, `job_attempts`, `job_events`. The second connection is the existing - private `consumption.sqlite` with `consumed`/`execution_evidence`. -* `prepare(&mut journal, &consumption, Channel, Option<&HelperSnapshot>, &clock)` - returns `PreparedSync { envelope, request }`. It closes the old gate, checks - integrity/checkpoint/generation, archives original results, records ambiguous - requesting/running/verifying as unknown, reads real offers/consumption/boot/ - outcomes/events and durably reserves the fresh request and sequence BEFORE - sending. Resend that exact envelope on the same live channel. After lost - response/reconnect, prepare a NEW request, using the durable prior request ID; - it does not invent a checkpoint or execution grant. -* `apply(&mut journal, &SyncResponse, &clock)` returns `Applied { decision_id, - acknowledged_message_ids, helper_instruction, reason }`. Verify exact signed - bytes before parsing, the separate reconciliation domain/profile, exact prost - request hash, every current identity/channel/boot/journal/checkpoint/key/time - binding, complete attempt coverage and exact receipt IDs. All agent changes, - result archives, ACK deletions and decision chain commit in one transaction. - Identical already-applied current responses are idempotent; stale/different - responses cannot open a gate. Terminal local state is never downgraded. Negative - server unknown decisions may carry an older server revision, but local revision - is retained with max(local, server), never reset and never made startable. -* `apply_consumption(&mut consumption, &clock)` applies only the agent process's - own targeted signed unlocks in an independent SQLite transaction. Recompare - grant/attempt/device and previous canonical local outcome, preserve consumed - tombstones, persist exact decision evidence, then allow the process gate to open. - Failure/crash between journal and consumption commits leaves mutations closed. -* `HelperInstruction` is the ORIGINAL `SyncResponse` plus its signed decision ID, - helper journal and checkpoint. Forward it unchanged to the authenticated helper. - It is never a new grant, permit, shell command or unsigned unlock boolean. -* `confirm_helper(&HelperSnapshot)` requires the independently authenticated root - helper to report that exact decision/checkpoint as durably applied and no - unsettled effects. `can_start(&Channel, root: bool, &clock)` stays false for - root until then, and expires with the signed decision deadline. Select `root` - from the verified immutable job identity, not from caller convenience. -* `close()` on every disconnect, new Hello, transport fencing or revocation. -* `archive_events(&Connection)` INSIDE the existing event-ACK transaction, before - deleting an ACKed event. This preserves original result envelope ID/sequence/ - boot/time/raw outputs for future sync. No historical result is rewrapped with - a new sync envelope identity. -* `verify_response(...)` is the pure independently testable signature/binding - verifier; it does not apply or execute anything. - -`HelperSnapshot { journal_id, checkpoint, previous_decision_id, attempts }` is a -complete snapshot obtained from the root-owned helper journal via authenticated -socket/peer credentials. It must NEVER be deserialized from a server response or -an unauthenticated local socket. Canonical helper outcome bytes can be imported -as a **new** durable agent JobResult with fresh event identity/revision (no new -job/attempt/effect). This resolves a lost helper response while retaining both -the older unknown result and the actual helper result. A consumed root attempt -omitted by the helper, changed helper journal/checkpoint, missing authoritative -server job/history, sequence rollback or generation regression remains blocked. -Sticky recovery faults cannot be cleared merely by omitting the offending entry. - -## Minimal integration patch positions (after APT ownership release) - -1. `main.rs` module declarations: add `mod reconcile;`. Agent fields: retain one - `ClientSync` and `NativeClock`, initialized from the pinned job Binding. A - passive agent without a binding must not advertise sync/root readiness. -2. `Agent::session`: advertise `rmm.sync.v1`; after validated ServerHello, before - any permit request, obtain the authenticated helper snapshot if configured, - call `prepare`, send its envelope. Both WSS and HTTPS singleton MessageBatch - carry the SAME envelope. No transport-specific readiness shortcut. -3. Inbound payload match: route current valid `Payload::SyncResponse` to `apply`; - then `apply_consumption`; forward any helper instruction unchanged, fetch the - helper's post-apply authenticated snapshot and call `confirm_helper`. -4. Replace the first-session `safe_session` condition in the scheduler AND the - immediately-before-effect dispatcher with `can_start`. Retain fresh independent - ExecutionPermit verification/consumption, immutable plan binding, normal - cancellation checks and provider resource locks. Sync never supplies start - authority or creates an executable job. Resync before the <=60s gate lease - expires, and call `close()` immediately when a channel fails/is fenced. -5. In `jobs::ack`, call `initialize` once during open and `archive_events` in the - same transaction as the concrete ACK's deletion. Without this hook, this module - still archives pending results during prepare, but cannot recover an original - event already erased by old code. Legacy final results can still reconcile - canonical hashes against authoritative stored server results. -6. Helper RPC needs typed authenticated snapshot/apply operations. Its new process - gate must start closed. Independently verify the original decision signature, - all helper identity/checkpoint/attempt/hash/action/boot/previous-outcome bindings - against ROOT-owned state, apply targeted unlocks transactionally, keep consumed - tombstones, then acknowledge its signed decision/checkpoint. An ordinary APT - probe/capability ready flag is NOT sufficient. This dispatch deliberately did - not modify the concurrently owned helper/transport files or claim this root - RPC consumer already wired. Never call agent `apply_consumption` on a helper's - root database as a substitute for independent helper verification. - -The adapter refuses >256 attempts/receipts, >512 KiB canonical outcomes or a ->1 MiB request, rather than dropping unknown attempts/results. There is no unsafe -automatic compaction, journal deletion, new-grant retry or recovery-fault reset. -Coordinated rollback of every independent ledger still requires operator recovery. - -## Targeted verification - -Actually executed successfully during implementation: - -Final result: **18 reconciliation integration tests passed**; targeted Clippy -with `-D warnings` and formatting check passed. No warnings were suppressed. +Aufruf im Projektstamm ```sh -/home/Kevin/.cargo/bin/cargo test -p rmm-agent --test reconcile --locked -/home/Kevin/.cargo/bin/cargo clippy -p rmm-agent --test reconcile --locked -- -D warnings -/home/Kevin/.cargo/bin/rustfmt --edition 2024 --check crates/agent/src/reconcile.rs crates/agent/tests/reconcile.rs +cargo test --locked -p rmm-agent-core --test reconcile --test helper_reconcile ``` -Coverage includes real SQLite reopen, clean reconnect and accepted-unstarted jobs, -exact signatures/all identity bindings/fake key, replay and response-loss recovery, -original result retention and exact ACKs, canonical outcome rejection, unknown -resource retention, sticky missing server/helper records and checkpoint regression, -independent local outcome mismatch, actual helper-result import and original/new -boot evidence. Helper/server responses in these local tests are fixtures; no real -approval, helper root operation or backend/VM end-to-end acceptance is claimed. - -## Independent helper consumer (separate ownership increment) - -New files: `crates/privileged-helper/src/reconcile.rs` and -`crates/privileged-helper/tests/reconcile.rs`. Existing helper lib/main/APT and -agent files were deliberately NOT changed. This is a complete SQLite/verifier -core, **not yet registered in the production RPC dispatcher**. - -### Helper API and locking - -* `ExecutorGuard::acquire(state_directory, owner_uid)` opens the SAME existing - `executor.lock`. Production uses owner UID 0. `snapshot`, `apply` and `can_start` - verify the supplied connection is that directory's actual `consumption.sqlite`, - not a memory/private copy. Replace, rather than nest, existing per-request - `lock_state` acquisition. Hold this guard through grant consumption and effect. -* `HelperSync::new(independently_provisioned_Binding, &clock)` always starts closed. - The pin cannot be supplied in IPC or automatically replaced. The root-owned - journal persists a binding hash; changed key/identity requires controlled - recovery, not an in-band rebind. -* `snapshot(&mut db, &guard, generation, &clock, &boot)` closes the previous lease, - reads **every** actual consumed row plus saved Request, verifies the historical - exact Ed25519 grant at its original validity window, checks current bound - device/action/job/attempt/plan/authorization, and derives canonical outcomes, - original native boot and durable per-row revisions. It atomically reserves a - fresh monotone independent helper checkpoint. No agent-provided attempt list is - used to construct this root snapshot. -* `apply(&mut db, &guard, &SignedResponse, original_request_protobuf, &clock, &boot)` - independently verifies the exact reconciliation signature/domain/profile/key, - device and all current request/channel/journal/checkpoint/boot/time bindings. - It hashes the ORIGINAL canonical `SyncRequest::encode_to_vec()` bytes, not a - JSON rendering. All captured root attempts must appear in both request and - signed decisions; root grant/action/plan/previous canonical outcome must match. - The entire actual ledger fingerprint is rechecked while holding the same - executor guard and SQLite immediate transaction. Mutation after capture, - omissions, missing original evidence, unknown state, checkpoint/history rollback - and independently detected agent-journal replacement fail closed; recovery - faults are sticky and have no automatic reset API. -* Only explicit, independently matched signed per-attempt `unlock` decisions - update `consumed.result` and the saved outcome. The consumed grant/attempt stays - permanently present. Definitive known outcomes may be unlocked while another - unknown retains the global resource lock and readiness remains false. An unknown - script cannot become successful from a server-ready/callback boolean or a new - body; only the separately validated reboot reconciliation can supply a new - definitive body. Reboot additionally compares the helper's OWN current boot - source with the original persisted native boot and signed new-boot/inventory - evidence. Process instance UUIDs are not a boot source. -* Apply returns `Applied { snapshot, unlocked_grants, ready }`. Forward its - `snapshot` as the authenticated checkpoint ACK. It has the applied decision ID - and SAME checkpoint expected by `ClientSync::confirm_helper`. Do not call - `snapshot()` again to make the ACK: that creates a new challenge/checkpoint. -* `can_start(&db, &guard, generation, &clock, &boot)` rechecks process-local lease, - deadline, actual boot, persisted decision/checkpoint, complete ledger fingerprint - and absence of unresolved consumed resources immediately before a fresh grant. - `close()` removes the process lease. Native implementations are `NativeClock` - (synchronization/monotonic jump checks) and `NativeBoot` (Linux boot_id). - -Gate admission is checked immediately before grant consumption while retaining -the executor guard through save_start, the existing final fresh-grant/clock check -and actual execution. After consumption the changed fingerprint intentionally -blocks **new** starts; it does not retroactively revoke the already admitted -locked operation. Do not retry admission after consuming the same grant or -release/reacquire the guard between admission and execution. ExecutorGuard is -movable but not shareable by reference across threads, preventing accidental -concurrent use of one flock guard by separate request handlers. - -No protocol dependency or manifest change was added: the helper currently has no -direct prost/rmm-protocol dependency. Its private bounded parser reads the actual -existing SyncRequest tags 1–12 and SyncAttempt tags 1–13. Unknown/duplicate fields, -bad wire types, nonminimal/overflowing varints, truncation and size/count violations -are denied. Nested JobResult/Envelope never serve as independent root proof. -Production glue passes bytes from the real agent protocol type; shared-wire -schema changes must update this fail-closed decoder explicitly, not silently. - -### Mapping and production patch positions - -1. Register `mod reconcile;` in the helper **binary** `main.rs` (the standalone - module imports the package's existing library types). Construct one HelperSync - from the root-owned config/key and NativeClock; do not restore an open gate - from SQLite. Keep existing action policy, APT manifest/runtime validation, - artifact checks, privilege boundary and peer ACL intact. -2. Add typed snapshot/apply RPC variants after socket ACL/SO_PEERCRED validation. - Apply accepts original `decision_bytes`, `signature` and original canonical - SyncRequest bytes. It accepts NO external key or unlock/ready callback flag. - General and APT listeners must share the same root DB and executor guard. -3. Root `Snapshot` maps to agent `HelperSnapshot`: - journal_id/checkpoint/previous_decision_id unchanged; each LocalAttempt maps - UUIDs to strings and copies job_payload_hash, grant_id, consumption, state, - revision, original_boot_id, outcome_sha256 and canonical outcome_bytes. - Set optional result/result_envelope to None and result_message_id empty. The - agent core already imports actual helper outcomes as new durable agent results - when needed. Additional root-only plan/request hash fields remain available - for audit and independent checks. -4. Map agent `HelperInstruction.response` byte arrays directly to SignedResponse; - pass the prepared SyncRequest's original prost bytes alongside it. Send the - apply-returned authenticated snapshot to `ClientSync::confirm_helper`. -5. Add `HelperSync::can_start` checks under ExecutorGuard before **every** general - or APT grant consumption/effect path. Probe/capability flags do not replace - that check. Shared checkpoint state alone never opens another process's gate. - A fresh capture fences older process leases. Prefer one shared broker/gate for - both profiles; if they are separate processes, reconcile the selected process - before use rather than assuming both inherited readiness. - -### Replay safety bound without a new protocol nonce - -Each new process requires a fresh in-memory capture and a newly committed helper -checkpoint. Cached DB readiness/captures are not loaded as process authority. -Additionally the signed issued_at must be >= process birth AND the private fresh -capture time, and validity is at most 60 seconds. Thus an old cached response -cannot initialize a restarted helper, even while its old TTL has not expired; -ordinary same-process retries of the exact already-applied response are idempotent -and do not extend the lease. A local clock ahead of the signer may cause a safe -clock/reconciliation block: there is deliberately no skew grace that would admit -a pre-process response. This is a strict liveness limitation of the current -nonce-less contract, not an invented attestation or perpetual authorization. -Coordinated restore of all independent histories remains operator recovery. - -The helper integration tests use actual SQLite files, real Ed25519 and the shared -executor lock, with fixture signatures and an injectable boot source for the -simulated positive reboot change. No native reboot/service/APT effect or root -deployment was performed. Targeted command: - -```sh -/home/Kevin/.cargo/bin/cargo test -p rmm-privileged-helper --test reconcile --locked -``` +Für die Geräteabnahme werden vor und nach einem Neustart Bootbezug und Installationskennung verglichen. Ein auf dem neuen Boot ausgeführter Folgeauftrag liefert den Nachweis für den wiederhergestellten Skriptbetrieb. [MVP-Abnahme](../../docs/mvp-completion-plan.md) diff --git a/tests/agent_transport/README.md b/tests/agent_transport/README.md index 93d7e84..1a208f1 100644 --- a/tests/agent_transport/README.md +++ b/tests/agent_transport/README.md @@ -1,48 +1,11 @@ -# Native agent transport regressions +# HTTPS-Gerätekanal testen -These are local Linux tests, **not VM/MVP acceptance**. They use ephemeral PKI, -strict server-name/CA verification and mandatory client certificates on loopback. -No production endpoint, VM, enrollment, job approval or database is touched. +Die lokalen Linux-Integrationstests betreiben einen TLS-Server auf Loopback und erzeugen eigene Zertifikate. Der Agent meldet sich mit Clientzertifikat an, sendet Nachrichten und fragt nach Arbeit. Der Test unterbricht eine Antwort und prüft anhand der Nachrichten-ID, dass beim erneuten Senden nur ein Datensatz entsteht. Weitere Fälle prüfen falschen Servernamen, unbekannte CA und fehlendes Clientzertifikat. [Transporttest](../../crates/agent/tests/https_channel.rs) · [Gemeinsamer Testserver](common.rs) -The OpenSSL fixture must set a session-id context for client authentication. -On this host (OpenSSL 1.1.1w), the isolated replay regression originally failed -on reconnect with `ssl_get_prev_session`, code `336433429`, reason -`session id context uninitialized`; the client received TLS `InternalError`. -Disabling the session cache and tickets did not provide that context. The fix -sets a fixture-specific session context and restores normal caching/tickets; -it changes neither production TLS nor certificate verification. Handshake -diagnostics print only SSL codes and static library/function/reason metadata. +Der Zertifikatstest deckt den Verlust einer Erneuerungsantwort und die Zuordnung des erneuerten Zertifikats zum vorhandenen Schlüssel ab. Er prüft die Übernahme nach einem unterbrochenen Wechsel und die Ablehnung ungültiger Identitäten. [Zertifikatserneuerung](../../crates/agent/tests/certificate_rotation.rs) -Locked versions: openssl 0.10.82 / openssl-sys 0.9.118; reqwest 0.12.28 uses -rustls 0.23.46 with ring 0.17.14 (workspace disables reqwest default TLS). - -The replay test asserts missing response returns an error without a fabricated -ACK, repeats the exact encoded batch/message ID, and retains one deduplicated -application record. No execution retry is introduced. Rotation retains its -three identity/crash/recovery tests. Its harness also runs the four HTTPS -contract tests because it compiles and uses that same transport implementation; -rotation-only fixtures live in the rotation test, without dead-code allowances. - -Reproduce locally (commands, not a VM acceptance recipe): +Aufruf im Projektstamm ```sh -OPENSSL_CONF=/dev/null cargo test -p rmm-agent --test https_channel --locked real_mtls_hello_poll_durable_replay_and_fencing -- --exact --nocapture -cargo test -p rmm-agent --test https_channel --test certificate_rotation --locked -cargo clippy -p rmm-agent --test https_channel --test certificate_rotation --locked -- -D warnings +cargo test --locked -p rmm-agent --test https_channel --test certificate_rotation ``` - -`OPENSSL_CONF=/dev/null` isolates only the test process from host OpenSSL config; -it does not disable TLS, trust, name verification or mandatory mTLS. - -## Observed local verification (2026-11-12) - -- Isolated pre-fix replay: failed with the server reason/code above and client - `received fatal alert: InternalError` on the second explicit send. -- After the context fix: isolated pair of targets passed (7 + 4 tests). -- Five additional consecutive native runs with the normal environment passed - (7 + 4 each; 55 test executions, seven distinct cases because the HTTPS - contract is deliberately included in the rotation harness). -- Targeted `cargo clippy ... -- -D warnings` passed; file-scoped rustfmt check - passed. No dead-code/lint suppression was added. -- VM execution, production backend integration and production wiring were not - performed by this dispatch; Linux-MVP acceptance remains outside this result. diff --git a/tests/oidc/README.md b/tests/oidc/README.md deleted file mode 100644 index e13e1de..0000000 --- a/tests/oidc/README.md +++ /dev/null @@ -1,42 +0,0 @@ -# Integrated server OIDC test (explicit local development fixture) - -Prerequisites: native `cargo build -p rmm-server --locked`, normal migrations through -0011 applied to the existing development database, existing protected development -configuration/CA/job key, Python cryptography, existing web Playwright/Chromium and -the isolated certutil tool used by the browser harness. No external IdP is required. - -Run `python3 tests/oidc/server_integration.py`. It starts its own ephemeral loopback -TLS provider and native API on an unused loopback port, and reaches the existing -development PostgreSQL container through its bridge address. It does not publish -PostgreSQL or restart the existing server/database. Private configuration is parsed -internally as data; no shell sourcing, credential stdout/argv or browser artifacts. - -The only administrative fixtures are its own random restricted auth-state login -role, synthetic external identity routing row and explicit `human` membership row -in development tenant A. It grants no membership from OIDC groups/email. Those -fixtures and its own encrypted state rows are removed afterwards. It does **not** -write authorization/job/permit rows or positively invoke a plan approval endpoint. -The only approval-endpoint test uses a bearer and must be denied before plan lookup. - -Actual latest standalone run: **35 assertions passed**, including a real Chromium -provider button/cross-site callback with normal CA validation and a temporary NSS -store. Browser interaction is visibly synthetic and uses explicit dev simulation. -The configured production-profile start/login check uses simulation false solely -to test configuration behavior against the mock; this is **not** external-provider, -human production-approval or Linux-VM acceptance. - -Covered: code/PKCE/nonce/state, binding non-burning and callback replay, stable -mapping, final session/CSRF/logout, JWT resource audience/ID-token separation, -issuer/expiry/kid/rotation/scopes, actual MCP lifecycle/inventory call and insufficient -scope denial, persistent membership revocation, disabled external identity, foreign -tenant not-found, bearer+cookie approval denial, production dev-route disabling. - -Harness corrections during implementation: avoid duplicate Python environment -keywords; do not route the dev-login JSON extractor in production; read MCP SSE to -its concrete JSON-RPC response instead of waiting for a long-lived stream to close. -No auth/approval check was disabled to make the harness pass. - -Current backend configuration/routes/migration/provisioning contract is -`crates/server/OIDC.md`. Earlier `proto/BACKEND_CONTRACT.md` statements about absent -production auth describe the pre-OIDC backend increment, not this additive adapter. -The other Sync/root/APT contracts and native-execution gates are unchanged. diff --git a/tools/apt-transaction/HELPER-CONTRACT.md b/tools/apt-transaction/HELPER-CONTRACT.md deleted file mode 100644 index b49ba50..0000000 --- a/tools/apt-transaction/HELPER-CONTRACT.md +++ /dev/null @@ -1,384 +0,0 @@ -# Typed RootHelper bridge contract (implementation, not native acceptance) - -## Host reboot evidence and historical configured effect (Spec 1.13) - -An ambient `reboot_required=true` is honest pending evidence, not an implicit -reboot request or a failed package postcondition. Future fixture effects must -prove equal HOST flags before/after, unchanged boot and no private-worker flag. - -The parent captures `active/host-reboot-before.json` **before unshare/private -`/run`**. Schema 1 fields are `transaction_sha256`, `job_payload_sha256`, -`effect_armed_ledger_id`, `grant_id`, `boot_id`, `host_reboot_required` (bool), -and `observed_at_ms`, plus `schema_version`. Creation is exclusive and fsynced; -its observation must belong to the original grant window. New native prechecks -use schema 2, retaining the old exact checks and adding -`host_reboot_before_sha256` and `host_reboot_required_before`. The child binds the -saved host observation; its private `/run` never measures the host flag. - -After real APT success the parent verifies the current host flag equals the -saved value, boot is unchanged and `sandbox-result.reboot_required` is false. -False/false and true/true are valid; either change or a private-worker flag -vetoes acceptance. Outcome evidence includes `host_reboot_required_before`, -`host_reboot_required_after`, `host_reboot_before_sha256`, -`reboot_required_introduced:false`; `reboot_required` truthfully retains ambient -true. Ordinary acceptance record **schema 3** explicitly binds those fields and -`native_prechecks_schema_version:2`. The reader rejects old record schemas or -inconsistent values. Separate future recovery records use schema 2 and retain -their distinct `rmm.apt.native-recovery` type. Noop observations remain effect-free -and report their actual current reboot flag. Fresh planning adds the required -public bool `host_reboot_required`; known ambient true is shown in the fixed -WebUI plan reason. - -Historical grant `33775478-15b0-46ec-b059-44f500dbb0b6` had **no host-before -sample**. It must never acquire retroactive success or an acceptance record. -Fixed mode `verify-configured-recovery` receives the same eight original binding -fields as `verify-partial`. Only its signed schema-4 configure-only job, old -provider `5ff260…`, old schema-1 prechecks, original partial grant `31ef5e5e…` / -proof `dc3bf387…`, preserved recovery once marker, exact Configure hook, APT exit -0 and private-worker false are eligible. It checks complete stable installed -1.0 state, clean audit, actual payload, unchanged boot, idle locks and current -host marker contents twice, rechecking all thirteen immutable witnesses. - -Output is `known_failed` / -`APT_RECOVERY_CONFIGURED_ACCEPTANCE_REBOOT_FLAG_VERIFIED`. Its 24-field proof -contains the original eight bindings, type/schema, original evidence digest, -partial proof hash, original baseline and current snapshot hashes/fingerprint, -payload hash, full snapshot, check time, `effect_complete:true`, -`partial_effect:false`, `postconditions_passed:false`, `reboot_required:true`, -`host_reboot_required:true` and `host_reboot_marker_sha256`. No ctime-based -inference becomes a before measurement. It writes nothing and runs no package -mutation. Rust independently verifies the saved signature/old unknown code, -appends a separate immutable proof, and leaves consumption locked until normal -signed RootSync. Native classification and future 1.1 acceptance remain pending -until actually executed; **81 local Python tests passed**, including both actual -APT argument regressions under the readonly unprivileged offline container. - -## Configure-only partial recovery (schema 4, local implementation) - -This is a **new, separately WebUI-approved** dev-test native action. Schema 4 -requires `native_recovery = {schema_version:1, previous_grant_id, -previous_attempt_id, partial_proof_sha256}` and forbids `native_retry`. -Resolved transaction schema 2 adds `operation:"configure_only"`; only the -existing `rmm-apt-fixture-install-1.0` recipe/version 1, pinned fixture archive, -and old/new version `1.0` are eligible. Schema 1 retains its exact encoding. - -The helper first requires the original saved signed request, immutable SQLite -partial proof, definitive `APT_PARTIAL_UNCONFIGURED_VERIFIED` outcome, and closed -consumed row. `recovery-planning` receives exactly `{native_recovery, proof}`; -Python rechecks the original still-active witnesses and complete current partial -snapshot. It seals only the content-addressed baseline and returns the normal -planning projection plus `native_recovery`. Ordinary planning continues to reject -unconfigured packages. This passive projection creates no job or authorization. - -For execution the helper archives the definitive old active directory, stages -the exact proof as `active/partial-proof.json`, and binds its hash in the new -signed manifest. Python independently checks history, original target, full -partial baseline and installed fixture bytes. APT receives only -`install -- rmm-mvp-test=1.0`; the actual v3 hook must contain exactly one -equal-version `**CONFIGURE**` action. Unpack, removal, foreign packages and pending -configuration remain forbidden. The same native sandbox, grant deadlines, -locked-store handoff and complete postcondition/audit checks apply. - -Create-once markers are `recovery-attempt-.json`, -`pending-recovery-.json`, and `recovery-.json`. -Original/retry markers, signed histories and the original unknown proof remain -intact. Recovery produces `native_recovery:true`, `recovery_record_sha256` and -`partial_proof_sha256`; it creates no fresh-install acceptance record or -`native_record_sha256`. A later separately approved native 1.1 upgrade must -provide the ordinary acceptance evidence for the changed provider/runtime. - -Local actual APT 2.6.2, with a vetoing collector and independently guarded fake -dpkg, emitted only the exact configure action/target; real and copied package -status stayed unchanged. This is **local regression evidence**, not Cloud-VM -recovery acceptance. Native deployment, UI approval and execution remain the -parent's next acceptance step. - -## Explicit one-attempt recovery (schema 3, 2026-11-13) - -Schema 2 keeps its exact old encoding (the optional field is omitted). Schema 3 -requires `native_retry` and is valid only for dev-test `apt-native-acceptance`: - -``` -native_retry: { - schema_version: 1, - previous_grant_id: UUID, - previous_attempt_id: UUID, - bootstrap_marker_sha256: SHA256(original exact marker bytes) -} -``` - -This reference belongs to a **new separately UI-approved signed job**, never -an unsigned IPC override. Under the existing device lock, before consuming the -new grant and again before staging, the helper verifies the original saved -Ed25519 request historically, identical target/generation/assignment/transaction, -distinct job/attempt/authorization/plan, same-ledger terminal `failed` result -`HOOK_NOT_HANDED_OFF`, matching recorded outcome, original context/launch/ -sandbox-100 evidence and absent hook/acceptance/retry markers. Historical -signature verification never grants a current start. Unknown or partial history -fails closed. Original active state may only move through the existing terminal -history rule; original tombstone never changes. - -Provider independently checks original marker hash and immutable history, -identical full baseline and current normal baseline gates. It exclusively writes -`bootstrap-retry-.json` binding the new attempt, signed reference and -hashes of historical evidence. Worker, hook and completion recheck it. This is -one recovery attempt per fixed fixture recipe, not general automatic retries. -Test/native outcomes are recorded in `docs/implementation-status.md`. - -**Dedicated-runner update:** the current deployment and readiness protocol is -defined in [`../../deploy/linux/apt-helper-README.md`](../../deploy/linux/apt-helper-README.md). -The actual additive domain schema-2 types and AptNativeAcceptance variant have -since landed and are exercised by a local exact-signature/helper roundtrip test. -Agent routing and nonce/root-peer/identity/profile/stack-bound readiness are -implemented. Older descriptions below of absent domain fields or missing runner -describe the earlier increment, not a remaining implementation gate. Real VM -profile/probe/installation acceptance remains unmeasured, not passed. - -## Current integration status / exact outstanding domain change - -The helper now contains a real provider bridge in -`crates/privileged-helper/src/apt.rs`, called by its existing peer-credential -authenticated IPC handler, **not** by a script wrapper. The domain job source -was leased to the backend worker during this dispatch; it was not edited. -Legacy package jobs cannot supply the required manifest and remain gated. -No package capability was added to the agent. No native package/service/reboot -operation, VM action, helper installation or acceptance record occurred here. - -Required additive domain/backend contract, before capability advertisement: - -1. Define typed `AptExecutionManifest` **schema 2**, `ResolvedAptTransaction` - schema 1 and `PackageArchive` in domain (same exact fields/serde shape as the - helper types below; do not make domain depend on the helper crate). All deny - unknown/duplicate fields. No `serde_json::Value` opaque action authorization. -2. Existing `Action::EnsurePackage` and `Action::ApplyUpdates` gain a field - `apt_manifest: Option`, default None for legacy reads. - Execution/validation requires Some for APT. Serialization MUST preserve the - complete object; ignoring unknown fields is explicitly detected and denied by - `APT_DOMAIN_MANIFEST_NOT_CONFIGURED`. No unsigned IPC manifest field exists. -3. Add a dedicated Action variant with this exact JSON shape: - - ```json - { - "action": "apt_native_acceptance", - "recipe_id": "rmm-apt-fixture-install-1.0", - "recipe_version": "1", - "apt_manifest": {"": ""} - } - ``` - - `Action::name()` and permit.action are `apt_native_acceptance`. Root-only, - explicit dev-test, specific target, fixed UI-authorized job/attempt. The - upgrade recipe is `rmm-apt-fixture-update-1.1` and needs another job. This is - NOT an alias of run_script/diagnostic arbitrary execution. Backend plan/UI - allowlisting must show full transaction, exact hashes, origin, no-reboot, - execution identity and test-acceptance nature before approval. -4. For fixture ensure_package the outer recipe_id/version must match the nested - transaction exactly as strings. For apply_updates, outer provider=`apt`, - packages=`["rmm-mvp-test"]`, reboot_policy=`never`, nested upgrade recipe - only. Other original action parameters are retained and compared against the - domain's typed serialization, never accepted through parameter aliases. -5. Backend validation/planning/signing must validate both manifest transaction - representations, generate JobPayload once and sign its exact payload hash in - the existing Ed25519 permit. Keep all existing target/tenant/generation, - authorization/plan/job/attempt/identity/time bindings. Planning needs the - inspected root runtime/config hashes and immutable baseline/fingerprint. -6. Agent forwarding/capability negotiation must be separately integrated after - the domain contract and native prerequisites are complete. This dispatch did - not change agent/protocol/server files. No optimistic capability claim. - -Current clear gates include `APT_PROVIDER_NOT_CONFIGURED`, -`APT_MANIFEST_NOT_CONFIGURED`, `APT_DOMAIN_MANIFEST_NOT_CONFIGURED`; an older -domain may reject the action even earlier as INVALID_JOB/unknown field. That -earlier rejection is not a fallback or authorization shortcut. - -## Public Rust API - -Current additive passive/no-change contract is documented in -`deploy/linux/runtime-README.md` ("Passive APT planning and declarative -no-change"). `readiness::PlanningResult` is returned only by authenticated -`apt_planning_v1`; it creates no capability. `planning-status` can create only -content-addressed root metadata seals. A normal exact already-desired fixture -returns driver `verified_no_change` / `POSTCONDITION_ALREADY_MET`, never a fake -`POSTCONDITIONS_VERIFIED` transaction/hook. Parent consumption and all signature, -manifest/runtime/native-record/artifact/current-state gates remain required. - -``` -apt::ProviderConfig // serde deny_unknown_fields -apt::AptExecutionManifest // schema 2 -apt::ResolvedAptTransaction // schema 1 -apt::PackageArchive -apt::is_apt_action(&JobPayload) -> bool -apt::policy_header(&JobPayload, &ProviderConfig) -> anyhow::Result<()> -apt::prepare(&Binding, &Request, &ProviderConfig, DateTime) - -> anyhow::Result -PreparedApt::execute(self, &rusqlite::Connection) -> anyhow::Result -apt::install_known_payloads() -> anyhow::Result<()> -``` - -PreparedApt has no public fields/unchecked constructor. `prepare` independently -calls Binding::verify (exact Ed25519 request/grant and all existing bindings), -checks policy, exact signed manifest/domain preservation/code/runtime bindings, -installed trusted bytes and pre-grant prefetched artifacts. Parent consumes and -save_start-persists the request before execute. Execute independently requires -the corresponding consumed row (same agent/generation/job/attempt, result NULL) -and the exact originally saved request/signature/permit/plan/authorization. -Its stable effect_armed_ledger_id is `apt--`. - -## Exact manifest schema 2 inside Action.apt_manifest - -``` -type: "rmm.apt.helper-action" -schema_version: 2 -action: "apt-native-acceptance" | "apt-execute" -execution_profile: "dev-test" -transaction_sha256: SHA256(transaction_bytes) -resolved_apt_transaction: complete typed ResolvedAptTransaction object -transaction_bytes: Vec / JSON array of integer bytes -provider_sha256: SHA256(exact installed Python provider bytes) -hook_sha256: SHA256(exact installed fixed hook bytes) -apt_config_sha256: SHA256(print-config output bytes) -runtime_sha256: SHA256(canonical inspect-runtime output object) -test_result_id: ASCII identifier [A-Za-z0-9_.-], 1..128 bytes -``` - -The full object AND exact transaction bytes are required. Deserialize the bytes -with the strict typed schema and require equality to the nested object. The -provider writes those **same bytes**, not reformatted JSON, to expectation.json. -It copies **the full original Request.job_bytes unchanged** to signed-action.json; -job_payload_sha256 in context is SHA256 of those complete domain job bytes. -The Python loader now requires that full JobPayload envelope and checks the -nested action, job/attempt/root identity, inner bytes/hash/object and code pins. -A detached old standalone schema-1 helper-action manifest is no longer accepted. - -ResolvedAptTransaction fields (all mandatory): schema_version=1, recipe_id, -recipe_version="1", platform="ubuntu-24.04-amd64", -resolver_config_version="rmm-apt-local-v1", no_reboot=true, status_fingerprint, -baseline_sha256, packages. PackageArchive fields: name, architecture, -old_version (null/string), new_version, origin, sha256, size, archive_path. - -Only the code-pinned single-package fixture install/upgrade is configured. -Production and arbitrary catalogs remain denied; a test acceptance does not -authorize another recipe/closure/profile. Exact fixture hashes are in README. - -## Root configuration / trusted installation / prefetch - -Existing root-owned 0600 helper config gains optional `apt_provider` (absent = -disabled). No new secret/environment variable or caller-supplied path: - -```json -{ - "schema_version": 1, - "execution_profile": "dev-test", - "allow_fixture_bootstrap": true, - "allowed_recipes": ["rmm-apt-fixture-install-1.0", "rmm-apt-fixture-update-1.1"], - "runtime_sha256": "", - "apt_config_sha256": "" -} -``` - -These are local policy limits, not approvals. Keep the existing binding, -signing-key pin, agent UID/socket GID and parent ledger provisioning unchanged. -No artifact URL/network fetch exists in the root provider. - -Planned administrator tool installation, **not executed**: - -``` -/usr/local/libexec/rmm-privileged-helper --install-apt-provider -``` - -Root-only, fixed paths, create-only: embeds Python/hook bytes at Rust compile -time, writes root-owned `/usr/lib/rmm-apt-transaction/{apt_transaction.py,hook}` -(0644/0755), `/var/lib/rmm-apt-transaction` and archives/baselines/history (0700), -and `install-metadata.json` (0600, provider/hook hashes). Refuses existing files/ -directories instead of replacing/chmodding them. Partial installation requires -explicit operator reconciliation; no automatic deletion/repair. On each use, -installed bytes and metadata must match the helper's compiled known payloads. -The interpreter is fixed `/usr/bin/python3 -I`, root-owned resolved interpreter; -all provider/store path components are root-owned, nonsymlink and not writable -by group/others. This installation creates no acceptance or grant. - -Planned explicit pre-grant fixture preparation, **not executed**: - -``` -/usr/bin/python3 -I /usr/lib/rmm-apt-transaction/apt_transaction.py provision-fixture-store -``` - -Only the two pinned deterministic fixture archives can be created, never an -arbitrary archive/URL. Archives and `prefetch-.json` receipts are fsynced, -root-owned 0600, exclusive creation. Receipt fields: schema_version=1, sha256, -size, sealed_at_ms. Helper requires receipt time <= permit.not_before, matching -actual SHA256/size/single-link archive. Missing/writable/symlinked/unprefetched -artifacts fail before consumption. All downloads/imports must finish before the -final short grant, never during execution. Artifact mTLS fetch elsewhere must -ultimately yield the same root-verified sealed-store contract, not an agent path. - -The same preparation stores complete canonical dpkg baseline at -`baselines/.json` and emits baseline hash/status fingerprint -for the approved immutable plan. It creates neither jobs nor authorization. -For subsequent changed baselines, the root-only `prepare-baseline` mode samples -current dpkg state and creates a new content-addressed canonical baseline before -the new plan/final grant. An identical existing baseline is only read/verified, -never rewritten; changed state creates another hash file, never resets archives, -receipts or acceptance/attempt markers. It creates no job authority. Do not -modify a sealed file or fake a fingerprint. Archive preparation is create-only. - -Root `inspect-runtime` / `print-config` provide the planning measurements; hash -inspect-runtime's canonical JSON object **without its trailing newline**. Review -the measured binary/OS/dpkg configuration rather than blindly trusting a hash. - -## Handoff, outcomes, recovery and unit prerequisites - -Parent handler retains its existing device lock, consumes once, save_start -persists exact signed request, and rechecks clock/grant before effects. Bridge -creates active/0700 and expectation/signed-action/baseline/config/context files -0600 using exclusive nofollow writes and file/directory fsync. Context schema 2 -contains the same grant/job/attempt/authorization/plan IDs and original UTC -deadline translated to CLOCK_MONOTONIC, not a fresh 60-second grant. - -An old active directory can only move to history/ when the same -parent ledger contains a definitive succeeded/failed result. Unknown/null, -unrecognized/partial handoffs or existing history destination block execution. -No tombstone/native bootstrap-attempt record is removed. Parent grant/attempt -consumption survives any active-directory move. - -Python receives only fixed mode/path argv and two hash/ledger fields via stdin, -with cleared environment; no shell, secret argv or script conversion. Structured -stdout is bounded to 64 KiB (excess drained without unbounded allocation), raw -stderr discarded. Never timeout-kill APT. Client timeout is unknown while the -helper keeps running and eventually journals the real result. - -Exit 0 alone is never success. Strict JSON effect_state/code/evidence validation -requires bound ledger, exact package versions, full snapshot hash, installed -fixture payload hash, and bootstrap test flags/native-record/test-result binding. -Malformed/nonzero/missing/wrong evidence -> unknown. known_failed with an armed -marker -> unknown, not failed. Existing finish() leaves consumed.result NULL for -unknown/awaiting_reboot and persists execution_evidence, retaining the device lock. - -**Existing helper systemd unit is not an APT-capability deployment.** Its -ProtectSystem=strict/other hardening can prevent the required store/package -writes and namespace setup. A separately reviewed native runner/unit profile -must permit the narrowly agreed fixture writes and setup capabilities while -preserving the provider's final sandbox. No unit sandbox was weakened here. -Do not announce capability based solely on a successful helper build. - -Local verification commands/results are reported in the dispatch return. -Native helper installation, IPC package execution, lock probe, fixture install/ -update and VM approval/acceptance remain unrun. Tests using private temporary -ledgers/mock children are not native acceptance evidence. - -Actually executed for this bridge increment: - -``` -/home/Kevin/.cargo/bin/cargo fmt -p rmm-privileged-helper -- --check -/home/Kevin/.cargo/bin/cargo clippy -p rmm-privileged-helper --lib --bin rmm-privileged-helper --tests -- -D warnings -/home/Kevin/.cargo/bin/cargo test -p rmm-privileged-helper --lib --bin rmm-privileged-helper -PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/apt_transaction -p 'test_*.py' -v -``` - -Final results: formatting and warning-denying Clippy passed; **16 library + 2 -binary Rust tests passed**, **41 Python tests passed**, AST syntax checks passed -for **6 Python files**. No full workspace suite was run. An initial Rust test -fixture used legacy ApplyUpdates, which the current domain rejected as -`INVALID_JOB`; cryptographic/parent-ledger tests were corrected to use an -existing valid signed action without executing it or allowing it as an APT -action. This is not evidence that the missing domain package contract landed. diff --git a/tools/apt-transaction/README.md b/tools/apt-transaction/README.md index 6c2168a..e8091b6 100644 --- a/tools/apt-transaction/README.md +++ b/tools/apt-transaction/README.md @@ -1,432 +1,5 @@ -# Root-helper APT transaction provider / explicit first native acceptance +# APT-Transaktionsprüfungen -**Latest 2026-11-13:** The separately WebUI-approved configure-only attempt -`33775478…` reached APT 0 and completely installed fixture 1.0, but old provider -`5ff260…` rejected acceptance on the actual host reboot flag. Its private worker -reported false; the historical job had no HOST-before sample. It remains -**unknown** (`FIXTURE_UNEXPECTED_REBOOT_REQUIRED`), with no acceptance record, -Root scope closed and APT endpoint stopped. No before measurement or successful -acceptance is inferred retrospectively. +Dieses Verzeichnis enthält den lokalen APT-Prüfprovider und den Generator seiner Testpakete. Seine eigenen Tests liegen unter `tests/apt_transaction` und prüfen beispielsweise, welche Paketaktionen zur freigegebenen Transaktion gehören. [Provider](apt_transaction.py) · [Paketgenerator](build_fixture.py) · [Tests](../../tests/apt_transaction/test_guard.py) -New source implements an original-bound readonly failed-effect classification -and a parent-namespace host-before/after contract for future jobs, matching -Spec 1.13. Ambient true/true is reported honestly; changed host flags, private -worker flags or changed boot reject acceptance. All **81 Python tests passed** -in the readonly unprivileged offline container, including actual APT argument -regressions with guarded fake effects and unchanged real/copied status. Native -classification/new-runtime 1.1 acceptance remain pending. See -[`HELPER-CONTRACT.md`](HELPER-CONTRACT.md) for the exact versioned contract. - -**Earlier 2026-11-13:** The Cloud fixture retry reached armed hook and APT exit 0, -leaving fixture 1.0 unpacked/unconfigured. An original-bound readonly proof and -normal signed RootSync now classified that original attempt as **failed** -(`APT_PARTIAL_UNCONFIGURED_VERIFIED`), preserving all histories/tombstones. -No native acceptance record or package repair exists. Root test policy remains -closed. Detailed real evidence: `../../docs/implementation-status.md`. - -The configure-only recovery path, requiring its own new fixed WebUI approval, is implemented in source -(schema 4 manifest, transaction schema 2), with a dedicated passive recovery -projection and separate immutable recovery records. Its qualified runtime is now installed and its actual Cloud copied-database -sandbox readiness probe passed, preserving original state. **No configure-only -package effect or native package acceptance has yet run.** All **75 Python tests passed** in the offline readonly -unprivileged container, including actual APT 2.6.2 configure-only protocol and -guarded fake-dpkg arguments with unchanged real/copied status. See -[`HELPER-CONTRACT.md`](HELPER-CONTRACT.md) for the precise recovery boundary. - -Source configuration now disables APT's `dpkg::selection::remove::approved` -rewrite, retaining the exact package's Configure operation while both pending -modes remain disabled and hook-pinned. Upstream explanation: -[APT 2.7.14 dpkgpm.cc](https://github.com/Debian/apt/blob/2.7.14/apt-pkg/deb/dpkgpm.cc#L1626-L1657). -Local actual APT 2.6.2 regression in an offline readonly unprivileged container -proved unpack + exact `--configure rmm-mvp-test:all`, no `--pending` or foreign -target; independent dpkg guard simulated effects, real/copied status unchanged. -67 Python tests passed with this opt-in regression. **This correction is now installed and sandbox-probed on the Cloud VM; -its native package effect remains unaccepted.** No automatic repair, -marker reset or implicit unknown-resolution is introduced. Older sections below -describe historical increments; current operational status is the linked log. - -Reproduce that **local** configure regression using the existing development -image with APT 2.6.2 (no host APT command): - -```sh -docker run --rm --read-only --network none --user 1000:1000 \ - --tmpfs /tmp:rw,exec,nosuid,nodev,mode=1777 \ - --tmpfs /tmp/opencode:rw,exec,nosuid,nodev,mode=1777 \ - -v "$PWD/tools/apt-transaction:/src/tools/apt-transaction:ro" \ - -v "$PWD/tests/apt_transaction:/src/tests/apt_transaction:ro" \ - -v "$PWD/deploy/linux:/src/deploy/linux:ro" -w /src \ - -e PYTHONDONTWRITEBYTECODE=1 -e RMM_APT_ARGUMENT_REGRESSION=1 \ - rust-discovery-dev-build:local \ - python3 -m unittest discover -s tests/apt_transaction -p 'test_*.py' -q -``` - -Current dedicated runner/probe/profile/agent integration and executed local -checks: [`../../deploy/linux/apt-helper-README.md`](../../deploy/linux/apt-helper-README.md). -The general helper unit remains unchanged; actual native VM measurements are -still required. Readiness alone advertises no accepted package capability. - -**Helper integration contract update:** -[`HELPER-CONTRACT.md`](HELPER-CONTRACT.md) defines the implemented Rust helper -bridge, root installation/store layout, schema-2 embedded manifest and exact -remaining additive domain fields. It supersedes the older standalone signed -helper-action example below: signed-action.json must now contain the **full -original JobPayload bytes**, with `action.apt_manifest`, including exact -`transaction_bytes`. No detached/unsigned manifest is accepted. No agent -capability or native acceptance follows from this bridge build. - -**Implemented, locally tested; NOT integrated or VM-tested.** No host package -installation, VM access, real native acceptance, production evidence, grant -issuance or WebUI approval has been performed here. The native process path is -real code (unshare/mount/capabilities/seccomp/APT/dpkg), not merely a parser; -its root/native execution is still unverified. Local root/installer execution -in tests is explicitly mocked. No real acceptance record was created. - -Python >=3.9, standard library; OS dependencies: APT/dpkg, util-linux -unshare/mount, libseccomp.so.2, Linux x86-64 namespaces/seccomp/capabilities. -Only Ubuntu 24.04 amd64 is eligible; this is not a support/acceptance claim. -No Rust API, Cargo workspace changes, network endpoint, signature verifier, -grant service or automatic retry is included. - -## The circular gate is replaced, not bypassed - -There are now two distinct helper-only CLI operations: - -``` -/usr/bin/python3 -I /usr/lib/rmm-apt-transaction/apt_transaction.py native-acceptance -/usr/bin/python3 -I /usr/lib/rmm-apt-transaction/apt_transaction.py execute -``` - -* `native-acceptance`: dedicated **dev-test** action, exactly one code-pinned - fixture install OR upgrade, its own fixed job/attempt and actual WebUI approval. - It permits only absence of a *previous* native record for that fixture recipe. - It uses the same signed binding, archives, native sandbox, hooks, locks, - deadlines and independent verification as normal execution. No force/insecure/ - skip-validation flag exists. -* `execute`: requires an existing matching record **and** a freshly verified, - separately UI-approved normal job/startgrant. An acceptance record never - substitutes for any signature or authorization. - -**Scope matrix:** records produced here authorize only their exact fixture -recipe, package closure, runtime identity and **dev-test** profile. Production -is rejected (`PRODUCTION_ACCEPTANCE_REQUIRED`), even for a test record. General -catalog packages are rejected (`FIXTURE_RECIPE`); the bootstrap does not certify -arbitrary packages or widen provider support. Supporting those needs a separate -reviewed native-acceptance policy/provider revision, not relabelling this record. -The legacy unsigned administrator-created `native-acceptance.json` schema 1 -is no longer used. Old helper contexts (schema 1) are rejected as well. - -Each of these is a separate, one-time bootstrap recipe (recipe_version `1`): - -| recipe_id | exact transition | architecture | origin | -|---|---|---|---| -| `rmm-apt-fixture-install-1.0` | absent -> 1.0 | all | rmm-test | -| `rmm-apt-fixture-update-1.1` | 1.0 -> 1.1 | all | rmm-test | - -Exactly one package, `rmm-mvp-test`, no dependencies/scripts/triggers. One job -never installs both versions. Upgrade requires another fixed UI-approved job. -Pinned deterministic Debian ar/USTAR archives, **20,672 bytes each**: - -``` -1.0 74036ae81223deab3aae994fd2a2a695af408741777e1ce17dcb4e32f1235867 -1.1 ef67c9fe0ba1443fcfe465768e1204763063c369a2a1da04af6027d8a9c00491 -``` - -`build_fixture.py EXISTING_PRIVATE_OUTPUT_DIR` creates those exact bytes with -fixed metadata. It refuses overwrites and never installs/imports/publishes. -Real local dpkg-deb control/payload inspection confirms the only installed file -is `/usr/share/rmm-mvp-test/version`, with the selected version plus newline. -The builder now uses deterministic stdlib ar/USTAR construction, not the previous -timestamp-dependent `dpkg-deb --build` output. Older built archives do **not** -qualify for bootstrap; import these pinned bytes manually into the approved -catalog, verify and seal them before requesting the final 60-second grant. - -## Mandatory signed-action and verified-helper contract - -This module does **not** verify signatures. The root helper is the trust boundary. -Before writing any handoff files or invoking either mode, it MUST independently: - -1. Verify the signed grant type/schema/algorithm/key, online validity and actual - human WebUI authorization (or explicitly labelled allowed dev-test UI - simulation), tenant/asset/agent identity and generation/assignment bindings. -2. Verify plan hash, job payload hash **of exact bytes**, fixed job/attempt, - action, execution profile, recipe/version, code/hook/config/runtime hashes, - exact complete resolved transaction and deadlines against that signed grant. -3. Enforce an explicit helper operation allowlist: `apt-native-acceptance` only - from the dedicated dev-test fixture-bootstrap action, never a generic - diagnostic/shell/API request. `apt-execute` must not invoke bootstrap mode. -4. Recheck trusted clocks/current rights and durably consume the grant and - attempt in its parent journal BEFORE spawning. Reject previous/uncertain - attempts. Unprivileged network/MCP callers cannot write these files or invoke - an unrestricted privileged subprocess API. Preserve peer-credential checks. - -### Signed job payload: exact schema 1 - -The following object itself is the **signed/grant-hash-bound job payload**, -stored unchanged as `active/signed-action.json`; it is NOT an extra unsigned -root manifest or a caller's `verified: true` assertion. Fields are mandatory: - -```json -{ - "type": "rmm.apt.helper-action", - "schema_version": 1, - "action": "apt-native-acceptance", - "execution_profile": "dev-test", - "transaction_sha256": "", - "resolved_apt_transaction": "", - "provider_sha256": "", - "hook_sha256": "", - "apt_config_sha256": "", - "runtime_sha256": "", - "test_result_id": "" -} -``` - -The string placeholder for `resolved_apt_transaction` above MUST be replaced -with the complete nested object in actual payloads. Normal mode uses action -`apt-execute`. Production is a recognized profile but cannot use these test -records. The helper must verify the signed action, not merely trust ownership -of a separately supplied hash. The provider rechecks exact signed-payload hash, -type/schema/action/profile, nested transaction equality and code/config/runtime -bindings; it relies on the helper for cryptography and grant consumption. - -### ResolvedAptTransaction schema 1 - -All fields mandatory; unknown fields/types and duplicate JSON keys are rejected: - -``` -schema_version: integer = 1 -recipe_id: one exact fixture recipe above -recipe_version: "1" -platform: "ubuntu-24.04-amd64" -resolver_config_version: "rmm-apt-local-v1" -no_reboot: true -status_fingerprint: 64 lowercase hex characters -baseline_sha256: 64 lowercase hex characters -packages: [PackageArchive] # exactly one for this accepted scope -``` - -`PackageArchive` exact fields: - -``` -name: "rmm-mvp-test" -architecture: "all" -old_version: null for install, "1.0" for update -new_version: "1.0" for install, "1.1" for update -origin: "rmm-test" -sha256: corresponding code-pinned hash above -size: 20672 -archive_path: "/var/lib/rmm-apt-transaction/archives/.deb" -``` - -The general parser still understands up to 128 package changes / 1 MiB, but that -does not authorize a broader execution scope. Frozen dataclasses/tuple closure; -strict Debian version ordering via read-only typed `dpkg --compare-versions`. -Status fingerprint hashes raw status/architecture/extended_states and trigger -database state. Dirty dpkg updates, pending triggers, repair, reinstall, -downgrade, removal, crossgrade and core/kernel/boot packages are unsupported. - -`active/baseline.json` is the complete canonical all-package snapshot from -`installed_snapshot()` (`dpkg-query`), not just the changed package: - -```json -{"package:architecture":{"version":"","status":"install ok installed"}} -``` - -Its canonical byte SHA256 binds `baseline_sha256`. A new install requires actual -absence, not leftover config-files. Existing consistent noninstalled entries may -be present for other packages. Fingerprint/baseline are rechecked in the native -hook, not accepted from simulation as authorization. - -### VerifiedHelperContext schema 2 - -Root helper writes `active/context.json` only after the checks/consumption above: - -```json -{ - "schema_version": 2, - "transaction_sha256": "", - "job_payload_sha256": "", - "action": "apt-native-acceptance", - "execution_profile": "dev-test", - "effect_armed_ledger_id": "", - "grant_id": "", - "job_id": "", - "attempt_id": "", - "authorization_id": "", - "plan_sha256": "", - "not_before_ms": 1794484800000, - "start_before_ms": 1794484860000, - "boot_id": "", - "monotonic_start_before_ns": 123456789000 -} -``` - -UTC integer milliseconds; start window <=60,000ms, exclusive upper deadline. -Helper translates that same verified deadline to same-boot CLOCK_MONOTONIC ns; -never grants another fresh window. Both clocks/boot are checked after expensive -verification, before native launch and at the final hook gate. An installation -validly started is not aborted merely because its start deadline later expires. - -## Deployment / exact invocation - -Planned, **not deployed here**. Root helper/operator installs reviewed files: - -* `apt_transaction.py` -> `/usr/lib/rmm-apt-transaction/apt_transaction.py`, 0644 -* fixed `hook` -> `/usr/lib/rmm-apt-transaction/hook`, 0755 -* `/var/lib/rmm-apt-transaction` and `active`, 0700, root-owned -* sealed archives in `archives/`, root-owned; no nonroot writer -* active expectation/context/baseline/signed-action/apt.conf files, 0600 -* empty root-owned active `empty`, `lists`, `cache` directories, 0700 - -All path components must be real root-owned nonsymlink/non-group/world-writable -paths. `apt.conf` must equal `apt_config()` bytes. Read-only `print-config` emits -them; root-only `inspect-runtime` emits canonical measured runtime identity for -the helper/planner's reviewed signed payload, not an acceptance claim. - -For **either** operation, stdin is exactly: - -```json -{"transaction_sha256":"","effect_armed_ledger_id":""} -``` - -Use sanitized environment and close inherited private fds. No secrets in argv. -An acceptance request must invoke `native-acceptance`; a normal signed action -must invoke `execute`. Mixing the two is rejected. Internal `hook` and -`sandbox-worker` modes are not exposed as privileged IPC operations. - -## Native pipeline and evidence publication - -Both modes run the same pipeline: - -1. Root/signed action/recipe/runtime/preconditions/actual archive validation; - constant hook/config/code binding before APT. Native provider flock only - serializes this provider, never replaces APT's locks. -2. Bootstrap additionally writes/fsyncs O_EXCL - `bootstrap-attempt-.json` in BASE, independently of active/ - and grant IDs. One-time per recipe; no automatic deletion/reset/retry, even - after a failed native precheck. An operator must reconcile failures and use - a separately reviewed lifecycle/revision, not remove tombstones to retry. -3. Separate native child via fixed `unshare --mount --pid --fork --mount-proc - --net`, private propagation, tmpfs `/run`/`tmp`/`var/tmp`/`dev`, protected - readonly/masked kernel/boot/control-plane/tool/archive paths. -4. Drop bounding/effective/permitted capability sets to exactly filesystem/UID - subset `{0,1,3,4,6,7,8,31}`; inherited/ambient empty. No SYS_BOOT/SYS_ADMIN/ - SYS_PTRACE/KILL/RAWIO/NET_ADMIN/MKNOD. Set NoNewPrivileges, load inherited - seccomp denying reboot/kexec, module loading, mount/namespace changes, - ptrace/process writes and other kernel-control operations. -5. **Actual native prechecks inside that child:** different PID/mount/net ns, - expected namespace PID1, exact caps/NNP/Seccomp, readonly mount flags, tmpfs - identity, masked sysrq, no conventional systemd/dbus/helper sockets; invalid - reboot magic and invalid kexec flags/fds must return EPERM. These calls never - contain valid reboot magic/commands or valid kexec input. No PID1 signals. -6. Hold real existing `/var/lib/dpkg/lock-frontend` with fcntl; a separate native - `apt-get -o DPkg::Lock::Timeout=0 check` must report that frontend-lock conflict - (100 + expected lock diagnostic). `check` is read-only, not an installation - probe. Never delete locks, kill owners or use simulation to prove locking. - A busy foreign lock vetoes the bootstrap. Release only this process's fd. -7. Fsync native-prechecks record, then sandbox-ready marker. Native APT uses - exact local archives, `--no-remove --no-install-recommends` and - constant isolated config. No global APT hooks/sources/preferences; reviewed - dpkg global config is runtime-hash-bound in the signed action. Native foreign - lock wait remains bounded to 10 seconds. - **2026-11-13 native diagnosis:** `--no-download` prevented APT's local file - acquisition and emitted `**ERROR**` instead of the absolute archive filename - in protocol v3. The provider permits local acquisition of the presealed - archive; the AF_UNIX-only private worker still rejects actual IPv4/IPv6 - socket creation. Both denials are now checked inside worker/hook/probe. - A permitted IP socket or unrelated resource error vetoes; this is not a - network-download allowance or acceptance/manifest/hash/path bypass. -8. Mandatory v3 pre-dpkg hook repeats signed/runtime/scope/sandbox checks, - validates the whole actual action set, actual hashes/control/payload, - status/baseline and final deadline; O_EXCL + file/directory fsync effect-armed - marker **before returning 0**. Second hook is vetoed. No fallback. - Immediately after successful file/directory fsync, UTC/monotonic deadline and - boot identity are checked again. Expiry vetoes the hook while retaining its - armed marker: conservative unknown/reconciliation, never marker reuse. -9. After native child exit 0 and valid bound markers/result, independently query - **all** installed versions/statuses, detect unexpected changes, require empty - `dpkg --audit` and exact installed fixture version-file bytes. Private /run - reboot flag is combined with host flag. Bootstrap requires no reboot flag. -10. Only then publish root-owned 0600 schema-2 - `acceptance-.json`, staging/fsync complete bytes before - exclusive publication and directory fsync. No failed/stale-start/partial/ - unknown execution is promoted. Parent must treat publication/IO uncertainty - as unknown and reconcile; a record is never an excuse to retry that job. - -Record binds exact approved recipe/packages, full measured runtime (tool, hook, -APT config, resolved binaries including APT/dpkg/dpkg-deb/dpkg-query/Python/ -unshare/mount/shell/libseccomp hashes and version strings, OS/kernel identity, -dpkg config fingerprint), transaction/job-payload/plan hashes, grant/job/attempt/ -authorization/test-result IDs, precheck/hook/postcondition hashes and completion -time. It explicitly contains `test_acceptance: true`, `noProductionEvidence: true`. -Install and upgrade have separate records; one does not certify the other. - -## Result / safety bounds - -One JSON result on stdout: `effect_state` = `known_failed`, `verified`, or -`unknown`; stable `code`; structured `evidence`. Every structured bootstrap -result, including veto/unknown, carries `evidence.test_acceptance=true` and -`evidence.noProductionEvidence=true`. Verified bootstrap additionally reports -record hash/test-result ID. Exit 0 means structured result, not job success. -Malformed CLI/hook input exits 100 with generic diagnostics. Parent must journal -missing output/death/partial markers after possible launch as unknown. - -No `awaitreboot` output in this version: no post-boot completion condition exists. -No reboot is invoked. Any reboot/follow-up/retry needs another fixed approved job. -No auto-configure-all, autoremove, dist-upgrade, repair, index refresh, installer -timeout killing, or automatic record/attempt clearing is provided. - -APT retains its frontend lock and normally hands off the inner dpkg lock. -**No claim that both locks are held during the hook.** Direct foreign dpkg and -malicious root are outside the frontend-lock guarantee; native inner locking -still applies. Root scripts are intrinsically trusted host-filesystem code; -this is not general malicious-root containment or arbitrary deferred-side-effect -verification. Bootstrap avoids that expansion by accepting only pinned -script/trigger/dependency-free fixtures. Existing dpkg triggers/global config, -kernel, root administrators, trusted binaries/helper remain in the TCB. - -## Primary sources and actual local verification - -APT 2.7.14 sources read before parser implementation: - -* -* -* - -Native read-only lock probe checked against `DoCheck` (`Cache.Open/CheckDeps`, -not dpkg/install) in: -. - -Hook protocol **VERSION 3**, nine fields: -`name old-version old-arch old-multiarch direction new-version new-arch -new-multiarch action`. New install old triple `- - none`; `<` install/upgrade, -`>` downgrade/removal; action absolute archive path or `**CONFIGURE**`/ -`**REMOVE**`. Config lines precede a blank separator and support percent escaping -and repeated unnamed lists. SHA/size/origin are NOT transmitted in v3: actual -sealed files are independently checked. Whole closure must match, including one -configure per unpack; extra/missing/repeated actions are vetoed. -`tests/apt_transaction/fixtures/install-v3.txt` is source-derived, **not a native -installation capture**. - -Actually executed unprivileged, with **no host package mutation**: - -``` -PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests/apt_transaction -p 'test_*.py' -v -``` - -**39 tests passed** at the documentation update. Original 22 guard/archive/ -parser/preconditions tests plus pinned fixture/control inspection, context/ -signed manifest/recipe/profile/runtime binding, native-record matrix, fsync/ -partial/negative evidence rejection, mocked full driver success/unknown/failure/ -stale/redelivery, mocked native mount/capability/namespace/socket introspection, -and local unprivileged seccomp invalid-input EPERM probes. -The post-fsync deadline regression advances mocked UTC/monotonic clocks (both -and each independently), observes nonzero hook outcome/no modeled dpkg start, -and verifies that the durable marker survives and prevents a second handoff. -Native root/installer/VM parts are explicitly mocked under private temporary -BASE paths; mock-generated records are deleted with those dirs and are NOT -native evidence. Safe invalid-input probes and seccomp loading really ran in -short-lived unprivileged children. No valid reboot/kexec operation or host PID1 -signal was attempted. Deterministic .deb bytes were really built/read/inspected, -never installed. Full root sandbox, real APT lock conflict, native fixture -install/update, helper signature integration and VM acceptance remain **unrun**. +Im MVP planen WebUI und MCP Linux-Wartung als Skriptauftrag. Ein zur Wartung berechtigter Benutzer reicht ein Shellskript für das Zielgerät ein. Die WebUI zeigt Skript und Rechte vor der persönlichen Entscheidung. Für den Ablauf im Produkt gilt der [Geräte- und Skriptvertrag](../../proto/BACKEND_CONTRACT.md). diff --git a/web/README.md b/web/README.md index 10b8c63..45710b2 100644 --- a/web/README.md +++ b/web/README.md @@ -1,227 +1,27 @@ -# Rust Discovery WebUI +# WebUI -React/TypeScript, no runtime demo data, no desktop/PTY/hypervisor integration. -Build assets: **`web/dist/`**; serve `index.html` and `/assets/*` from the TLS backend -on the same origin. Do not proxy authentication to a different origin. All API URLs -are relative; cookies use `credentials: same-origin`, mutations use `X-CSRF-Token`. -No token or password persistence, raw HTML rendering, automatic approval or retry. +Die React-/TypeScript-Anwendung wird als statisches Vite-Bundle vom Rust-Server ausgeliefert. Anmeldung, Kundenzuordnung, Rechteprüfung und Auftragsdaten kommen über denselben HTTPS-Ursprung. [Bedienung der WebUI](../docs/public-access.md) · [MVP-Abnahme](../docs/mvp-completion-plan.md) -## Geräteaufträge +| Bereich | Aufgabe | Einstieg im Code | +| --- | --- | --- | +| Geräte und Kunden | Bestand und Historie filtern, Geräteinventar lesen, Aufträge für ausgewählte Geräte beginnen, Kunden anlegen und umbenennen. | [Geräte](src/devices.tsx) · [Kunden](src/customer-management.tsx) | +| Skripte | Verfügbare Versionen nach Name und Plattform finden, Inhalt lesen und neue Versionen veröffentlichen. | [Bibliothek](src/script-library.tsx) | +| Aufträge | Ziele eines Kunden mit einer Bibliotheksversion oder einmaligem Skript verbinden, Rechte und Fristen wählen und den Antrag einreichen. In der Auftragsliste und im Gerätedetail sind die gespeicherten Ausgaben erreichbar. | [Auftragsdialog](src/order-composer.tsx) · [Ausgabe](src/console-output.tsx) | +| Genehmigungen | Offene Anträge aus WebUI und MCP prüfen. Der Verlauf zeigt Entscheidung, Person und Zeitpunkt. | [Genehmigungseingang](src/approval-inbox.tsx) · [Planprüfung](src/script-console.ts) | +| Verwaltung | Geräteaufnahme, Agent-Releases, MCP-Tokens und kundenbezogenen Ausführungsstopp bedienen. | [Ansichten und Navigation](src/main.tsx) · [Tokenverwaltung](src/mcp-token-management.tsx) | +| Verwaltung → Erweitert | Paketrezepte, Windows-MSI-Rezepte und öffentliche Artefakte im Kundenkatalog pflegen. Neue Geräteaufträge werden unter **Aufträge** als Skript eingereicht. | [Paketkatalog und Artefakte](src/management.tsx) · [MSI-Katalog](src/main.tsx) | -Unter **Aufträge → Neuer Auftrag** wählen Sie die Geräte und eine veröffentlichte -Skriptversion oder geben ein einmaliges Skript ein. **Neustartskript auswählen** -übernimmt die passende Bibliotheksversion für Windows (PowerShell als SYSTEM) oder -Linux (Shell als root). Gebundene Skriptbytes, Zielgeräte, Rechte und Zeitgrenzen -sind vor der Entscheidung unter **Genehmigungen** sichtbar. Frühere typisierte -Aufträge bleiben in der Historie lesbar. Im Gerätedetail stehen die zuletzt vom -Agenten gemeldeten Ausführungsrechte. `full_maintenance_v1` bezeichnet das -technische Profil eines genehmigten Administratorskripts. +Die Kopfzeile zeigt den gewählten Kunden. Ein Auftragsdetail bindet seinen Kunden über die Route. Beim Ändern von Planvorschau oder Skriptanzeige die Projektion aus den gespeicherten Planbytes verwenden. Bei der Genehmigung werden die angezeigten Skripte, Ziele und Grenzen an den Planhash gebunden. Ausgaben sind Daten. Die Anzeige trennt Exitcode, Standardausgabe, Fehlerausgabe und Kürzung. Originalbytes können im Ergebnisdetail heruntergeladen werden. -## Commands +## Lokal prüfen -From `web/`: `npm ci`, `npm run typecheck`, `npm test`, `npm run build`. -`npm run dev` binds loopback, but is not the authenticated TLS acceptance setup. -The public management service is documented in [public access](../docs/public-access.md). -The separate dev/test profile uses the SSH tunnel. Earlier local `rmm-dev.internal:18443` -examples below are historical. The notebook is development only, without an RMM -server or enrolled agent. No certificate-verification bypass is supported. +Die folgenden Befehle installieren die gesperrten Abhängigkeiten, prüfen den Code und bauen das Frontend. -## Historical script console and adapter contracts (specification 1.20) +```sh +npm --prefix web ci +npm --prefix web run typecheck +npm --prefix web test +npm --prefix web run build +``` -`run_script` remains a durable plan/request, not a PTY or interactive terminal. -The planner accepts complete fixed POSIX/Bash or Windows PowerShell5.1 scripts. -The optional action-wide `parameters.privileged_script_profile` is exactly -`full_maintenance_v1`; missing preserves the existing bounded mode, while present -null/unknown values fail. Full maintenance requires root on Linux or SYSTEM on -Windows, plus `scripts:execute` and the separate root/system scope. SYSTEM scripts -require the explicit profile. The UI selection grants no permission: central/local -opt-in, target capabilities, independent helper checks and actual WebUI approval -remain necessary. Full authority includes filesystem, network and services, and -can alter the agent/PKI or cause a reboot. It has no sandbox/no-reboot promise. -The profile budgets are Linux 1–300s, Windows 1–120s, at most 32768 script bytes -and 65536 output bytes. RemoteSigned, when explicitly bound, remains limited to -the approved Windows job process. - -Before submit/approval, `src/script-console.ts` projects every script from the -SHA256-verified stored plan bytes. It checks full payload structure, fixed -target/job/attempt IDs, script SHA256 and the job SHA256 reconstructed in Rust -declaration order. Every supplied payload/target alias must agree. It snapshots -the checked views, rejects later mutation and rechecks immediately before each -submit/approval action. The displayed script, arguments, identity, profiles, -budgets, deadlines and hashes come from that projection, never the draft editor. -Control characters, CR, BOM and bidi controls are made visible in the text view; -the full original JSON and stored bytes remain available. Existing pending-only -submission and interactivity/CSRF checks remain in force. - -`src/console-output.tsx` displays the actual stored job status and final stdout/ -stderr. Status polling is every four seconds; output arrives with the durable -result. There is no incremental output stream. Null result, empty output, -unknown exit code, unknown outcome, requested cancellation and truncation are -distinct. UTF-8 is a display attempt, not a claimed source encoding; invalid -UTF-8 is marked and original bytes can be downloaded as inert `.bin` files. -Terminal escapes and bidi controls are visible, never interpreted. Agent output -is React text and cannot create HTML, approval controls or follow-up jobs. - -MCP already dispatches plan/submit/read-results to the same server application -functions. Shared PlanRequest/Action schemas expose the profile; MCP has no -approval tool and its bearer context cannot become an interactive approval -session. No independent MCP execution or approval path was added. - -Local typechecking and renderer tests are source evidence only. Native Linux/ -Windows runs, deployment and actual UI/MCP acceptance remain separate gates. -Actually executed on 2026-11-14 for this source slice: `npm ci --ignore-scripts ---no-audit --no-fund`, `npm run typecheck`, `npm test` (49 passed across seven -files), `npm run build` (TypeScript and Vite passed). Five script-console tests -read `../tests/script_console/codec-golden.json` directly: the same three actual -Rust codec families cover legacy Linux agent, Linux root/full and Windows -SYSTEM/full with RemoteSigned. Checks cover full displayed script/target/attempt/ -profile/budgets/hashes, all aliases, mutation during/after verification and -independent scopes. Two output tests cover hostile HTML/terminal/bidi bytes, -unknown/cancellation/truncation, invalid encodings and absent/invalid results. -No browser, server, VM job, approval or deployment was executed in these checks. - -### JSON adapter contract at the time of the historical tests - -`src/api.ts` is the sole transport/contract boundary. Responses missing required -fields fail explicitly. Unknown backend fields are displayed without interpretation. -Pages: `{items,next_cursor,completeness,truncated,as_of}`. Tenant items: -`{tenant_id,name}` (`id` accepted as ID alias). Session: -`{principal:{id,display_name,simulated:boolean},tenants:[{tenant_id,name}],csrf_token}`. -`simulated` is explicit server evidence, never inferred from a username. -The backend session form `{principal:string,tenant_id,testsimulation:boolean, -csrf_token,roles,permissions}` is also accepted, retaining the exact principal and -tenant ID as labels until the tenant list supplies its authoritative name. Explicit -`testsimulation:false` is a nonsimulated OIDC session, not a dev identity. Missing -simulation metadata fails closed; neither principal names nor roles imply simulation. -Dev login `POST /auth/dev/login {username,password}`, GET `/auth/session`, POST -`/auth/logout {}`. Session and CSRF stay in memory only. Backend must disable dev -login outside dev/test and audit simulation origin/testprincipal/plan binding. - -Before offering login, the UI reads `GET /auth/config` using same-origin cookies, -no-store and verified browser TLS. Exact DTO: -`{oidc_configured:boolean,oidc_login_url:'/auth/oidc/login'|null,dev_login_enabled:boolean}`. -The only allowed OIDC link is the canonical relative `/auth/oidc/login`, and only -when configured. Issuer/external/absolute/return/query/fragment URLs are not used by -the frontend. OIDC callback codes/tokens stay with the backend; the normal reload -reads `/auth/session`. No local/session storage or auth query logging is used. -The password form requires explicit dev enablement and prominently identifies a -simulated dev/test principal. Production SSO-only configuration has no password -form or simulated-principal label. Configuration loading/error/absent modes never -fall back to dev login; errors and `not_configured` remain visible. - -Executed UI auth integration: typecheck/build, 23 unit tests including SSO-only, -config failure, redirect rejection and explicit nonsimulated session parsing; -real TLS management/login-config checks plus all three pending/TLS checks passed. -The current deployment announces OIDC not configured, dev login enabled. Its real -SSO redirect/callback is therefore not exercised by these UI tests; the positive -SSO presentation is unit-tested, not external-IdP or production acceptance. - -All business endpoints are under `/api/v1/tenants/{tenant}`: - -- GET `/devices[?cursor=]`, `/devices/{asset}`: `asset_id`, presence, health, - last_contact_at, source_id, observed_at, received_at, quality, completeness, - inventory/capabilities/other sections. Missing evidence stays `unknown`. -- POST `/operation-plans`: Spec 23.4 shape `{tenant_id,action,targets:{asset_ids}, - parameters,schedule:{not_before,start_before,offline_policy},rollout:{max_parallel, - halt_after_failures},reason}`. Times RFC3339 UTC; common parameters: - execution_identity, timeout_seconds, max_output_bytes. Script parameters: variants - with `{os_family:'linux',interpreter,encoding:'utf-8',script_utf8}`, arguments, - expected_stdout. Other action fields are explicit JSON, never shell commands. -- GET `/operation-plans/{id}`: `{plan_id,plan_hash,expires_at,resolved_targets:[], - excluded_targets:[],plan_payload_bytes|plan_payload,approval_state?}`. Preferred - `resolved_targets` entries are immutable previews `{asset_id,job_payload_hash, - payload,plan_target_id?}`. Alternatively `resolved_targets` lists asset IDs or - `{asset_id}` records and `payloads` supplies the previews. Legacy `jobs` is accepted - as the preview list only when neither preferred form is supplied. An incomplete - preferred form is not silently replaced by legacy data. In legacy previews only, - asset_id can also come from the exact payload. Every target requires a nonempty - exact payload and payload hash; preview coverage must equal the fixed target set, - duplicate asset IDs and contradictory payload asset IDs are rejected. - Script plans require the reserved `job_id`/`attempt_id` from the exact stored - payload, as well as matching script/job hashes. These are fixed definitions, - not proof of executable jobs or persisted attempts. Actual execution rows are - created only after approval. - Exact payload metadata and script/package hashes must be included. UI does not - recompute the plan hash from JSON. Missing fixed targets/previews/payload/hash or - excluded targets block submission and approval. All fields are shown, not just - target count. `approval_state` enables opening an existing pending request after - reload. -- POST `/operation-plans/{id}/submit {idempotency_key}` → `{operation_id, - approval_state:'pending_approval'}` (`state` also accepted for submit status). - No execution jobs before approval. The button then enables explicit review. -- POST `/operation-plans/{id}/authorizations {plan_hash}` → `{operation_id}`; - only click handler after explicit checkbox. Backend enforces interactive session, - pending state, exact immutable binding, permission, tenant, policy, expiry and - deduplicates repeated clicks. No MCP/bearer fallback. -- GET `/operations[?cursor=]`, `/operations/{id}` → approval_state, - execution_state, plan_id, planned_job_count/job_count, jobs (with job_id), counts. -- GET `/jobs/{id}` → state, attempt, cancel_requested, pending_reason, output, - results, verification, truncation/reboot flags; raw response shown completely. - POST `/jobs/{id}/cancel {reason}` only requests cancellation. - -Errors: `{code,message,retryable,correlation_id,details}`. Non-JSON errors also remain -visible; failed polling retains the old response alongside an error, never a green -success message. Tenant changes unmount all selection/plans/jobs and abort requests. -List pagination uses server cursors, without pretending a truncated page is complete. - -### Historical browser checks and separate acceptance gates - -`tests/browser/approval.spec.ts` uses actual UI interactions only. It never uses an -API client to authorize, never writes storageState, and disables traces/screenshots/ -video. Its restricted reporter suppresses raw step logs/errors/stdout/stderr because -Playwright failure call logs can contain password-fill arguments. Do not override -the reporter or enable Playwright DEBUG/PWDEBUG/trace logging for secret-bearing -tests. Failure artifacts remain in gitignored `web/node_modules/.cache/browser-results`; -inspect them only locally as potentially confidential and never publish them. -It is opt-in via `RMM_E2E_PROFILE=dev/test` and `RMM_E2E_MODE=execute`; without -both values no positive authorization/execution test runs. A separate -`pending.spec.ts` uses `RMM_E2E_MODE=pending-only`, never sends authorization -requests and verifies login/cookie, device selection, exact preview, pending with -zero executable jobs, session/plan reload, CSRF denial on logout and normal logout. -Set `RMM_E2E_ASSET_ID` to the explicitly selected Linux test asset and -`RMM_E2E_LOGIN_FILE` to an owned mode-0600 JSON file `{username,password}` in the -gitignored credentials directory. Never pass secret values in CLI arguments, log -them, bundle them or use production accounts. The test only submits Hello World; -it never reboots or updates the VM. - -The checked configuration isolates browser HOME to -`web/node_modules/.cache/browser-home`, with a private NSS trust database there; -only the public project dev CA is imported, never CA/server private keys. Browser -launch resolves the two fixed dev test DNS names to PC loopback via Chromium's -host-resolver rules; it does not change hosts files or global trust/configuration. -TLS name/chain verification stays enabled. Node's CA setting alone does not -establish browser trust. No ignore-HTTPS option, insecure flag, direct API -authorization or production simulation is allowed. - -Reproduce the pending-only checks with `python3 deploy/browser/run_pending.py` -from repository root after installing the browser/local NSS tool as documented in -`deploy/browser/README.md`. The runner imports the public CA, enrolls an explicitly -synthetic local mTLS test device, advertises only the capability required for plan -validation, runs real same-origin browser UI checks, and revokes that fixture in -cleanup. No executor, simulated result, VM access or approval is involved. Pending -requests remain durable and the synthetic device is visibly revoked afterwards. - -Actually executed on 2026-11-12: real TLS Chromium login, secure HttpOnly SameSite -cookie, tenant/device list, plan preview, pending submission with zero jobs/null -execution, reload/review, CSRF-denied logout, valid logout, rejection of the -wrong certificate DNS name and rejection of the server chain without the isolated -CA. All three real browser tests passed. A server-side count guard confirmed no new -jobs/outbox/grants. Sanitized local evidence: -`web/node_modules/.cache/browser-evidence/pending.json`. No positive browser -authorization, Hello-World result or VM feature acceptance is claimed here. -Verified-TLS fetches also confirmed the served same-origin index and both built -asset hashes match the current `web/dist` build. - -Build/unit checks are local development evidence only. Real backend/agent execution, -VM feature evidence, browser acceptance and production approval remain separate gates. - -### Gebundene Configure-only-Wiederherstellung (Schema4) - -Frontend prüft native_recovery mit ursprünglichem Grant/Versuch/Partial-Proof, -Transaktionsschema2 und ausschließlich configure_only/Fixture1.0→1.0. Normale -Schemas2/3 erlauben keine Operationserweiterung; Nichtnative-, Altversions-, -Hash- und Bindungsmanipulationen bleiben verweigert. Elf gezielte Safetytests, -Typecheck und Produktionsbuild bestanden. Tatsächliche separate Browser- -Vorbereitung/0-Jobgate/Genehmigung mit exakten Bytes ist belegt; der erste Plan -lief ohne Offer/Grant an der alten Journalgrenze ab. Paketabnahme bleibt separat: -`../docs/implementation-status.md`. Keine API-/DB-Freigabeabkürzung. +`npm --prefix web run dev` startet den Frontend-Entwicklungsserver auf Loopback. Die lokalen Browsertests prüfen die Bedienwege mit Testantworten. [Browsertests](../deploy/browser/README.md) Ein fertiges Bundle oder eine Git-Revision wird über den [Deploymentrunner](../docs/development.md) auf dem Server aktiviert.