From 435c4453fecb5cce082f04b0b67a4335db4e7842 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Fri, 13 Nov 2026 17:01:14 +0100 Subject: [PATCH] test: verify native Linux TLS lifecycle and track remaining MVP gates --- deploy/browser/cloud_lifecycle_revoke.cjs | 51 +++++ deploy/cloud_lifecycle_acceptance.py | 234 ++++++++++++++++++++++ docs/implementation-status.md | 40 ++++ docs/mvp-gates.md | 98 +++++++++ docs/post-mvp.md | 25 +++ 5 files changed, 448 insertions(+) create mode 100644 deploy/browser/cloud_lifecycle_revoke.cjs create mode 100644 deploy/cloud_lifecycle_acceptance.py create mode 100644 docs/mvp-gates.md create mode 100644 docs/post-mvp.md diff --git a/deploy/browser/cloud_lifecycle_revoke.cjs b/deploy/browser/cloud_lifecycle_revoke.cjs new file mode 100644 index 0000000..4a75d79 --- /dev/null +++ b/deploy/browser/cloud_lifecycle_revoke.cjs @@ -0,0 +1,51 @@ +// Real interactive dev/test UI; never direct revocation/approval API calls. +const fs = require('node:fs'); +const path = require('node:path'); +const { chromium } = require('../../web/node_modules/playwright'); +const root = path.resolve(__dirname, '../..'); +const assert = value => { if (!value) { const e = new Error('Lifecycle UI mismatch'); Error.captureStackTrace(e, assert); throw e; } }; +function readPrivate(file) { + const s = fs.lstatSync(file); + assert(s.isFile() && !s.isSymbolicLink() && s.uid === process.getuid() && (s.mode & 0o777) === 0o600 && s.size < 1048576); + return JSON.parse(fs.readFileSync(file, 'utf8')); +} +(async () => { + const expected = readPrivate(path.resolve(process.argv[2])); + assert(expected.profile === 'dev/test' && expected.expected_principal === 'simulated-testprincipal-a'); + const login = readPrivate(path.join(root, 'credentials/server-browser-login.json')); + const browsers = path.join(root, 'web/node_modules/.cache/playwright-browsers'); + const version = fs.readdirSync(browsers).find(x => /^chromium-/.test(x)); + const executablePath = ['chrome-linux/chrome', 'chrome-linux64/chrome'].map(x => path.join(browsers, version, x)).find(x => fs.existsSync(x)); + const browser = await chromium.launch({ headless: true, executablePath, env: { ...process.env, HOME: path.join(root, 'web/node_modules/.cache/cloud-acceptance/home') } }); + try { + const page = await browser.newPage({ ignoreHTTPSErrors: false, timezoneId: 'UTC' }); page.setDefaultTimeout(15000); + let revocations = 0; let approvals = 0; + page.on('request', r => { const p = new URL(r.url()).pathname; if (p.endsWith('/authorizations')) approvals++; if (p.endsWith('/revocation') && r.method() === 'POST') revocations++; }); + await page.goto('https://localhost:18443/'); + await page.getByLabel('Benutzername').fill(login.username); await page.getByLabel('Passwort', { exact: true }).fill(login.password); + const response = page.waitForResponse(r => new URL(r.url()).pathname === '/auth/session' && r.status() === 200); + await page.getByRole('button', { name: 'Anmelden', exact: true }).click(); + const session = await (await response).json(); + assert(session.testsimulation === true && session.approval_origin === 'dev_test_browser_simulation' && session.principal === expected.expected_principal && session.permissions.includes('devices:revoke')); + await page.getByRole('status').filter({ hasText: 'SIMULIERT' }).waitFor(); + assert(await page.getByLabel('Mandant', { exact: true }).inputValue() === expected.tenant_id); + await page.getByRole('button', { name: expected.asset_id, exact: true }).click(); + const article = page.locator('article').filter({ has: page.getByRole('heading', { name: 'Inventardetail ' + expected.asset_id, exact: true }) }); + await article.locator('pre').waitFor(); const device = JSON.parse(await article.locator('pre').innerText()); + assert(device.agent_id === expected.agent_id && device.asset_id === expected.asset_id && device.presence === 'online'); + assert(device.capabilities.length === 2 && device.capabilities.includes('linux.base/1') && device.capabilities.includes('heartbeat/1')); + const control = article.locator('details').filter({ has: page.locator('summary').filter({ hasText: /^Geräteidentität widerrufen$/ }) }); + await control.locator('summary').click(); + await control.getByLabel('Grund für Geräteidentität widerrufen', { exact: true }).fill('Native passive Linux MVP lifecycle acceptance; revoke only this separate nonexecuting test identity'); + const nonce = await control.locator('code').innerText(); + await control.getByLabel('Bestätigungskennung eingeben', { exact: true }).fill(nonce); + await control.getByRole('checkbox', { name: 'Ich bestätige diese konkrete administrative Wirkung ausdrücklich.' }).check(); + await control.getByRole('button', { name: 'Geräteidentität widerrufen · ausdrücklich ausführen', exact: true }).click(); + await control.locator('pre').filter({ hasText: '"revoked": true' }).waitFor(); + assert(revocations === 1 && approvals === 0); + await page.getByRole('button', { name: 'Abmelden', exact: true }).click(); + } finally { await browser.close(); } +})().catch(error => { + const line = error.stack?.match(/cloud_lifecycle_revoke\.cjs:(\d+):\d+/)?.[1] || 'unknown'; + console.log('CLOUD_LIFECYCLE_UI_INCOMPLETE:' + error.constructor.name + ':source_line=' + line); process.exitCode = 1; +}); diff --git a/deploy/cloud_lifecycle_acceptance.py b/deploy/cloud_lifecycle_acceptance.py new file mode 100644 index 0000000..78502bd --- /dev/null +++ b/deploy/cloud_lifecycle_acceptance.py @@ -0,0 +1,234 @@ +#!/usr/bin/env python3 +"""Native TLS lifecycle on the existing Cloud VM, passive test identity only. + +Never replaces the permanent device, bypasses its unknown fence or executes a +job. Rotation uses the existing development trigger; revocation uses real UI. +""" +import base64 +import argparse +import hashlib +import json +import os +from pathlib import Path +import subprocess +import time +import uuid + +import cloud_apt_retry as apt +cloud = apt.cloud +require = cloud.require +STATE = cloud.ROOT/'devstate/cloud-lifecycle' + + +def prepare_vm(payload): + import signal + os.umask(0o077) + ident = str(uuid.UUID(payload['id'])) + binary = Path('/usr/local/libexec/rmm-agent-remote') + require(hashlib.sha256(binary.read_bytes()).hexdigest() == payload['binary_sha256'], 'reviewed native binary') + parent = Path('/var/lib/rmm-agent-remote/lifecycle') + if not parent.exists(): parent.mkdir(mode=0o700); os.chown(parent,993,984) + require(not parent.is_symlink() and parent.stat().st_uid == 993 and parent.stat().st_mode&0o777 == 0o700, 'private masked lifecycle parent') + root = parent/ident; root.mkdir(mode=0o700); os.chown(root,993,984) + def create(path, data): + fd=os.open(path,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,0o600) + with os.fdopen(fd,'wb') as f:f.write(data);f.flush();os.fsync(f.fileno());os.fchown(f.fileno(),993,984) + create(root/'enroll.token',payload['token'].encode()) + create(root/'ca.pem',base64.b64decode(payload['ca'],validate=True)) + wrong = root/'untrusted-ca.pem' + subprocess.run(['/usr/bin/openssl','req','-x509','-newkey','rsa:2048','-nodes','-days','1', + '-keyout',str(root/'untrusted-ca.key'),'-out',str(wrong),'-subj','/CN=RMM_LIFECYCLE_TEST_UNTRUSTED'],capture_output=True,check=True,timeout=10) + for p in (wrong,root/'untrusted-ca.key'):os.chown(p,993,984);p.chmod(0o600) + negatives={} + for name,server,ca in (('hostname','wrong-name.invalid',root/'ca.pem'),('untrusted-ca','discovery.ease-technologies.de',wrong)): + state=root/name;state.mkdir(mode=0o700);os.chown(state,993,984) + env=dict(PATH='/usr/sbin:/usr/bin:/sbin:/bin',HOME=str(root),RMM_AGENT_STATE=str(state), + RMM_CA_FILE=str(ca),RMM_SERVER_NAME=server,RMM_CONNECT_ADDR='88.99.80.202:443', + RMM_ENROLLMENT_TOKEN_FILE=str(root/'enroll.token'),RMM_EXTENDED_INVENTORY='0') + proc=subprocess.Popen(['/usr/sbin/runuser','-u','rmm-agent','--',str(binary)],env=env, + stdout=subprocess.DEVNULL,stderr=subprocess.PIPE,start_new_session=True) + try:_,error=proc.communicate(timeout=8) + except subprocess.TimeoutExpired: + os.killpg(proc.pid,signal.SIGTERM);proc.communicate(timeout=5) + raise RuntimeError('negative TLS process did not reject') from None + require(proc.returncode != 0 and not (state/'identity.json').exists(), 'native invalid trust/name must reject before enrollment') + negatives[name]=dict(rejected=True,exit_code=proc.returncode,stderr_sha256=hashlib.sha256(error).hexdigest(),identity_created=False) + state=root/'passive';state.mkdir(mode=0o700);os.chown(state,993,984) + unit='rmm-lifecycle-'+ident+'.service';path=Path('/etc/systemd/system')/unit + text=('[Unit]\nDescription=RMM passive native lifecycle acceptance\nAfter=network-online.target time-sync.target\n' + '[Service]\nType=simple\nUser=rmm-agent\nGroup=rmm-agent\nUMask=0077\nRestart=no\nRuntimeMaxSec=900\n' + 'Environment=RMM_AGENT_STATE='+str(state)+'\nEnvironment=RMM_CA_FILE='+str(root/'ca.pem')+'\n' + 'Environment=RMM_SERVER_NAME=discovery.ease-technologies.de\nEnvironment=RMM_CONNECT_ADDR=88.99.80.202:443\n' + 'Environment=RMM_ENROLLMENT_TOKEN_FILE='+str(root/'enroll.token')+'\nEnvironment=RMM_EXTENDED_INVENTORY=0\n' + 'UnsetEnvironment=RMM_JOB_BINDING_FILE RMM_JOB_SIGNING_KEY_BOOTSTRAP RMM_HELPER_SOCKET RMM_APT_HELPER_SOCKET\n' + 'ExecStart='+str(binary)+'\nNoNewPrivileges=true\nPrivateTmp=true\nProtectSystem=strict\nProtectHome=true\n' + 'ProtectKernelTunables=true\nProtectKernelModules=true\nProtectControlGroups=true\nRestrictSUIDSGID=true\n' + 'RestrictAddressFamilies=AF_UNIX AF_INET AF_INET6 AF_NETLINK\nCapabilityBoundingSet=\nAmbientCapabilities=\n' + 'ReadWritePaths='+str(state)+'\n') + fd=os.open(path,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,0o644) + with os.fdopen(fd,'w') as f:f.write(text);f.flush();os.fsync(f.fileno());os.fchmod(f.fileno(),0o644) + subprocess.run(['systemctl','daemon-reload'],capture_output=True,check=True,timeout=10) + return dict(id=ident,root=str(root),unit=unit,unit_sha256=hashlib.sha256(text.encode()).hexdigest(),negative_tls=negatives,passive_only=True) + + +def start_vm(payload): + ident=str(uuid.UUID(payload['id']));unit='rmm-lifecycle-'+ident+'.service';path=Path('/etc/systemd/system')/unit + require(hashlib.sha256(path.read_bytes()).hexdigest()==payload['unit_sha256'],'own lifecycle unit only') + subprocess.run(['systemctl','start',unit],capture_output=True,check=True,timeout=10) + return dict(started=True,passive_only=True) + + +def vm_state(payload): + ident=str(uuid.UUID(payload['id']));root=Path('/var/lib/rmm-agent-remote/lifecycle')/ident;state=root/'passive' + p=state/'identity.json' + if not p.exists():return dict(enrolled=False) + identity=json.loads(p.read_text());selector=json.loads((state/'certificates/current.json').read_text()) + cert=state/'certificates/versions'/str(uuid.UUID(selector['version']))/'device.pem' + der=subprocess.run(['openssl','x509','-in',str(cert),'-outform','DER'],capture_output=True,check=True,timeout=10).stdout + return dict(enrolled=True,identity={k:identity[k] for k in ('agent_id','asset_id')},selector=selector, + fingerprint=hashlib.sha256(der).hexdigest(),token_removed=not (root/'enroll.token').exists()) + + +def rotation_switch(payload): + ident=str(uuid.UUID(payload['id']));unit='rmm-lifecycle-'+ident+'.service';path=Path('/etc/systemd/system')/unit + require(hashlib.sha256(path.read_bytes()).hexdigest()==payload['unit_sha256'],'own lifecycle unit only') + directory=Path(str(path)+'.d');trigger=directory/'10-rotation-test.conf' + text='[Service]\nEnvironment=RMM_AGENT_PROFILE=development\nEnvironment=RMM_ROTATION_TEST_AFTER_SECONDS=1\n' + if payload['enabled']: + root=Path('/var/lib/rmm-agent-remote/lifecycle')/ident + require((root/'passive/identity.json').is_file(),'enrolled identity required before token cleanup') + token=root/'enroll.token' + require(not token.is_symlink() and token.stat().st_uid==993 and token.stat().st_mode&0o777==0o600,'own private enrollment token') + token.unlink() + directory.mkdir(mode=0o755) + fd=os.open(trigger,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,0o644) + with os.fdopen(fd,'w') as f:f.write(text);f.flush();os.fsync(f.fileno());os.fchmod(f.fileno(),0o644) + else: + require(not trigger.is_symlink() and trigger.stat().st_uid==0 and trigger.read_text()==text,'own exact trigger only') + trigger.unlink() + subprocess.run(['systemctl','daemon-reload'],capture_output=True,check=True,timeout=10) + subprocess.run(['systemctl','restart',unit],capture_output=True,check=True,timeout=10) + return dict(rotation_test_enabled=payload['enabled']) + + +def token_unused(payload): + root=Path('/opt/rust-discovery');sha=payload['sha256'];require(len(sha)==64 and all(c in '0123456789abcdef' for c in sha),'token hash only') + cmd=['docker','compose','--env-file',str(root/'devstate/.env'),'-f',str(root/'deploy/server.compose.yaml'), + 'exec','-T','postgres','psql','-X','-qAt','-v','ON_ERROR_STOP=1','-U','postgres','-d','rmm'] + value=subprocess.run(cmd,input=("SELECT consumed_at IS NULL FROM enrollment_tokens WHERE token_hash='"+sha+"';").encode(),capture_output=True,check=True).stdout.strip() + return dict(unused=value==b't') + + +def start(): + os.umask(0o077);STATE.mkdir(mode=0o700,exist_ok=True);m=cloud.contract + ident=str(uuid.uuid4());folder=STATE/ident;folder.mkdir(mode=0o700) + permanent=apt.prior.identity();old=m.protected_json(cloud.ROOT/'devstate/remote-vm.json') + unknown=m.protected_json(apt.STATE/'apt_install_retry/checkpoint.json')['plan']['jobs'][0] + before=cloud.bootstrap.rpc('linux-vm.conf',apt.stored_attempt_evidence,dict(job_id=unknown['job_id'],attempt_id=unknown['attempt_id'])) + material=cloud.bootstrap.rpc('server.conf',cloud.bootstrap.server,dict(action='enroll')) + result=cloud.bootstrap.rpc('linux-vm.conf',prepare_vm,dict(id=ident,binary_sha256=old['binary_sha256'],token=material['token'],ca=material['ca'])) + m.write_private(folder/'bootstrap.json',result) + unused=cloud.bootstrap.rpc('server.conf',token_unused,dict(sha256=hashlib.sha256(material['token'].encode()).hexdigest())) + require(unused['unused'],'negative TLS must not consume enrollment') + m.write_private(folder/'negative-token-unused.json',unused) + cloud.bootstrap.rpc('linux-vm.conf',start_vm,result) + backend=cloud.Backend();deadline=time.monotonic()+50 + while True: + native=cloud.bootstrap.rpc('linux-vm.conf',vm_state,dict(id=ident)) + if native['enrolled']: + args=dict(tenant_id=cloud.TENANT,asset_id=native['identity']['asset_id']) + device=backend.call('inventory.get_device',args) + if device['presence']=='online' and device['last_authenticated_certificate_sha256']==native['fingerprint']:break + require(time.monotonic()>'approval_origin'," + "'simulation',data->'testsimulation') FROM audit_events WHERE tenant_id='11111111-1111-4111-8111-111111111111' " + "AND event_type='device_revoked' AND data->'decision'->>'asset_id'='"+asset+"';") + raw=subprocess.run(cmd,input=query.encode(),capture_output=True,check=True).stdout.strip() + return json.loads(raw) + + +def revoke(ident): + ident=str(uuid.UUID(ident));folder=STATE/ident;m=cloud.contract + bootstrap=m.protected_json(folder/'bootstrap.json');rotation=m.protected_json(folder/'rotation.json') + require(rotation['verified'],'actual rotation required') + identity=rotation['after']['identity'];target=dict(tenant_id=cloud.TENANT,**identity) + backend=cloud.Backend();device=backend.call('inventory.get_device',{k:target[k] for k in ('tenant_id','asset_id')}) + require(device['presence']=='online' and set(device['capabilities'])=={'linux.base/1','heartbeat/1'},'only independent passive test identity') + before=cloud.bootstrap.rpc('linux-vm.conf',lifecycle_status,dict(id=ident,agent_id=identity['agent_id'])) + expected=folder/'revoke-ui.json';expected_value=dict(profile='dev/test',expected_principal='simulated-testprincipal-a',**target) + if expected.exists():require(m.protected_json(expected)==expected_value,'same existing administrative intent only') + else:m.write_private(expected,expected_value) + cloud.prepare_browser() + result=subprocess.run(['node',str(cloud.ROOT/'deploy/browser/cloud_lifecycle_revoke.cjs'),str(expected)],capture_output=True,timeout=90) + if result.returncode:print(result.stdout.decode('ascii',errors='replace').strip()) + require(result.returncode==0,'revocation UI incomplete; do not repeat blindly') + revoked=backend.call('inventory.get_device',{k:target[k] for k in ('tenant_id','asset_id')}) + require(revoked['presence']=='revoked','actual revocation required') + deadline=time.monotonic()+40 + while True: + after=cloud.bootstrap.rpc('linux-vm.conf',lifecycle_status,dict(id=ident,agent_id=identity['agent_id'])) + if after['retry_messages']>before['retry_messages']:break + require(time.monotonic()/`. 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 diff --git a/docs/mvp-gates.md b/docs/mvp-gates.md new file mode 100644 index 0000000..3eb3683 --- /dev/null +++ b/docs/mvp-gates.md @@ -0,0 +1,98 @@ +# Linux-MVP: Abnahmegates + +Stand 2026-11-13, ursprüngliche Auditbasis `d38d93d`, Spezifikation 1.9. Die +Bestandsaufnahme selbst hat keine Tests, Jobs oder Deployments ausgeführt; +anschließende tatsächliche Nachweise sind unten ausdrücklich ergänzt. Einzelbelege und spätere +Ergebnisse stehen im [Implementierungsstand](implementation-status.md). + +Ziel ist M0–M5 auf der tatsächlichen Ubuntu-24.04-x86-64-Cloud-VM gegen +`discovery.ease-technologies.de`. Das Notebook bleibt Entwicklungsrechner. +Windows ist separat passiv abgenommen und kein zusätzlicher Linux-MVP-Blocker. +RustDesk ist ausgeschlossen; M6–M8 werden nicht vorgezogen. + +Nach jedem Teilerfolg: Ergebnis samt Grenzen und Beleg speichern, Quellen und +Dokumentation pushen, diese Liste erneut prüfen und das nächste offene Gate +bearbeiten. Ein grüner Build oder ein einzelner erfolgreicher Job schließt das +MVP nicht ab. Neue Entdeckungen außerhalb dieser Gates kommen nach +[post-mvp.md](post-mvp.md). + +## Bereits belegte Strecken + +| Paket | Implementiert / lokal geprüft | Tatsächliche Cloud-Linux-Nachweise | Gesamtabnahme | +| --- | --- | --- | --- | +| M0 | Workspace, gepinnte Toolchain, Migrationen, RLS, explizite Dev-Identitäten; frischer isolierter PG-Bestand mit Migrationen 1–13 geprüft | ARM64-Serverbuilds, Loopback-Dockerports, interne DB, privater Verwaltungszugang; laufende Gerätehistorie erhalten | Abschließende Dokumentations-/Sourceprüfung mit aktuellem Stand erforderlich | +| M1 | Enrollment, TLS/mTLS, WSS/HTTPS, Zertifikatsstore/Rotation, Inventar und Quelle/Zeit | Unprivilegierter systemd-Agent; Inventar und frische Heartbeats; Hello über WSS und ausdrücklich gewählten HTTPS-Modus; echter WSS-Reconnect nach Gatewayneustart | Rotation, TLS-Negativfälle, Widerruf und tatsächlicher WSS-Ausfall/Fallback noch offen | +| M2 | Dauerhafte Pläne/Anträge, UI-Grenze, Signatur-/Attemptbindung, Journale, Locks, ACK/Sync | Wiederholt `pending_approval` mit 0 Jobs/Outbox/Grants; tatsächlicher simulierter WebUI-Klick; Hello-Ausgabe; Live-Inventur; Abbruch vor künftigem Start ohne Grant; Rootdienst setup/start/stop | Native Fehler-/Redelivery-/ACK-/Offlinefälle noch offen | +| M3 | Gemeinsame HTTP-/MCP-Fachlogik, Geräte-/Jobansichten, begrenzte Logs, Rechte-/Tenantprüfungen; Plattformmatrix vorhanden | MCP liest echte Geräte-/Jobdaten; Mandant B auf fremdes Gerät/Job verweigert; auditierter UI-Planbezug | Live-Logstrecke und abschließende UI/HTTP/MCP-Konsistenz samt betroffenen Negativpfaden offen | +| M4 | Gebundene Fixture-Rezepte, unabhängiger Helper, Sandbox, lokale Configure-Korrektur | Native Sandbox-/Lock-/Syscallprüfungen und armed Hook; letzter APT-Lauf Exit 0, Nachprüfung jedoch verweigert | **Offen: unknown/Teilwirkung**, keine Paket-Acceptance | +| M5 | MCP plan/submit, feste Zielmenge, Linux-Skripte, Reboot-/Rollout-/Ergebnisverträge | MCP→Antrag→UI→VM für Hello/Inventur; Idempotenz desselben Submit; feste Zielbindung | Reboot, Offlinefrist und vollständige begrenzte Sammel-/Fehlernachweise offen | + +Hier bedeuten „lokal“ und „implementiert“ keine erneute Ausführung oder native +Abnahme. Historische Teilnachweise gelten nur für ihren dokumentierten Stand. + +## Priorisierte offene Arbeit + +**Teilerfolg danach:** Linux-native Ablehnung falscher CA/falschen Namens, +Rotation mit gleichem Gerät und neuem tatsächlichem Peerzertifikat sowie +UI-Widerruf/Kanalfencing an separater passiver Testidentität auf derselben VM +bestanden. Dauerhafte APT-Unknown-Evidenz unverändert, keine Jobs, Testservice +gestoppt. M1 braucht weiterhin tatsächlichen WSS-Ausfall/Fallback; Gate 0 bleibt +die nächste blockierende Verwaltungsstrecke. MVP insgesamt weiterhin offen. + +Alle folgenden Schritte sind **geplant, nicht durch dieses Dokument ausgeführt**. +Jeder Ausführungsjob braucht weiterhin seinen eigenen festen WebUI-genehmigten +Plan. Zulässige dev/test-Browserbedienung bleibt sichtbar simuliert und auditiert. + +| Priorität / Gate | Minimaler Abschlussnachweis | Vorbedingung / Quelle | +| --- | --- | --- | +| 0. Unbekannte APT-Teilwirkung abgleichen | Ursprünglichen signierten Auftrag und vorhandene Nachweise prüfen; aktuelle vollständige Teilwirkung über einen zulässigen, gebundenen prüfenden Pfad feststellen; ausschließlich signierte gezielte Ergebnisübernahme in Agent, Server und **demselben** Helperledger. Alte Marker/History bleiben erhalten. Kein unsigned Unlock, blindes Retry oder pauschales `--configure --pending`. | Derzeit 9 Helperverbräuche, 1 unresolved; zentral 13 Jobs / 13 Outbox / 12 Grants / 1 unresolved. Rootpolicy geschlossen. `cloud_apt_retry.py finish` liest nur den alten Ausgang und ist **kein** Recoveryverfahren. | +| 1. Begrenzte APT-Wiederherstellung und M4 | Neue Configure-Korrektur unter identitäts-/journalbewahrender Installation nativ prüfen; nötige Wiederherstellungswirkung als neuen festen UI-Plan genehmigen. Fixture 1.0 unabhängig vollständig verifizieren, danach separat genehmigtes Upgrade 1.0→1.1 und passende runtimegebundene Acceptance. Normale `ensure_package`-/`apply_updates`-Pläne auf 1.1 separat als echte Noops mit unverändertem Paketbestand nachweisen. | Erst nach Gate 0 und sicherem Recoveryvertrag. Vorhandene Cloud-APT-Runner/Caseverzeichnisse sind create-only; nicht blind wiederholen. Neue Source-/Runtimepins nicht mit installierten Pins vermischen. | +| 2. Begrenzte Live-Logs und Lesesicht | Genau erlaubte Testunit, gebundenes Zeitfenster/Zeilen-/Bytelimit, Quelle und tatsächlicher Erhebungszeitpunkt; echte UI-Genehmigung vor Sammlung. Gespeicherte Ergebnisse über UI, HTTP und MCP gleich darstellen. Fremder Tenant/unerlaubte Quelle bleibt verweigert. | `query_logs`-Adapter vorhanden, aktueller Cloud-Nativnachweis fehlt. Historische VM-Runner enthalten überstimmte lokale Server-/Tunnelannahmen; vor Ausführung Cloud-only anpassen. Rootlogs haben eine eigene Read-Allowlist, keine Ableitung aus Dienständerungsrechten. | +| 3. Genau-eine-Wirkung und Wiederanlauf | Tatsächlich denselben genehmigten Offer/Versuch erneut zustellen und einmal gezielt Ergebnis-ACK verlieren: ursprüngliche IDs/Bytes erneut senden, genau ein Verbrauch/eine Wirkung, unveränderte Grantanzahl und dauerhafter Ergebnisempfang. Eigener kontrollierter Agentabbruch nach möglicher Wirkung muss `unknown` und gebundenen Abgleich ergeben. | AT-07/08/33, M2. `duplicate_offer` und `lost_result_ack` melden aktuell ausdrücklich `unsupported_native_fault_injection`. Der vorhandene Originalresult-Replaydriver ersetzt diese Fehlerauslösung nicht. Nur den hierfür nötigen eng begrenzten Entwicklungsadapter ergänzen. | +| 4. Offline, Ablauf und Entzug | Nach Annahme vor Start Verbindung verlieren: offline keine Starterlaubnis/Wirkung. Nach Wiederkontakt nur innerhalb gültiger Bindung/Frist starten. Separater Ablaufversuch bleibt nach Wiederkontakt `expired` ohne Grant/Wirkung. Rechte-/Genehmigungsentzug sperrt neuen Start. Bereits bestandenen Abbruch-vor-Start nicht als laufenden Installerabbruch ausgeben. | AT-06/09, M2/M5. Aktuelle Unknown-Sperre darf den eigentlich geprüften Offline-/Fristgrund nicht verdecken. Kein fremder Paketmanager wird beendet. | +| 5. M1-Identitätslebenszyklus | Native Rotation mit erhaltenen Agent-/Asset-/Enrollment-IDs und Journal; nicht nur neues Zertifikat ausgestellt, sondern neuer tatsächlicher TLS-Peerfingerprint benutzt. Ungültige CA/Name/abgelaufenes Zertifikat verweigert. Widerruf verhindert neue Starts und beendet/fenced den Kanal. | AT-03, M1. Öffentliche Fingerprint-/Authzeit-DTOs aus Migration 12 existieren bereits. Der alte Renewalrunner endet mangels Fälligkeit/Trigger bewusst `not_configured`; keine erfundene Zeit, Schlüsselkopie oder Neu-Enrollung als Rotationsbeleg. | +| 6. MCP-Referenzabläufe / fester Sammelplan | Kunde/Zielmenge aus gespeichertem Inventar eindeutig bestimmen; feste Skriptbytes/Versuche und alle Jobs vor Klick sichtbar; Änderung/zweiter Versuch braucht neuen Plan. MCP kann weder per Rolle noch Token genehmigen. Rollout-/Teilergebnisse ehrlich je tatsächlich vorhandener Zielmenge anzeigen. | M5, AT-29–34. Ein realer Linux-Testclient genügt für die verfügbare feste Zielmenge; daraus keine Mehrgeräteparallelität oder Mischplattformabnahme ableiten. Keine zusätzliche VM und kein Windows-Executor allein für eine größere Demo. | +| 7. Reboot zuletzt | Eigenständiger fester UI-genehmigter Rebootplan; vor Start alte Boot-ID dokumentieren; ausgehende authentisierte Wiederanmeldung mit neuer Boot-ID, neuem Inventar, signiertem Sync und gebundenem endgültigem Ergebnis. Ausbleibender Wiederkontakt ist kein Erfolg. | M5. Erst geschlossene frühere Wirkungen und geprüfte Recovery. Der bereits erlaubte einzelne Test-VM-Reboot ersetzt keine Plangenehmigung. Kein SSH-Reboot, Kernel-/Distributionsupdate oder Hypervisorzugang. | +| 8. Abschließende M0–M5-Prüfung | Aktueller Source-/Buildstand und betroffene Prüfungen, passende Plattform-/Capability-Matrix, Quellen/Zeit/Qualität, Tenantgrenzen und alle obigen nativen Belege vollständig. Keine ungeklärten Wirkungen oder behaupteten Tests; nach Abschluss neue Änderungen stoppen, Ergebnis dokumentieren und pushen. | Spec 25.4. Keine Produktionsfreigabe aus dev/test-Simulation ableiten. | + +M4 bleibt auf die dokumentierten, exakt gepinnten Testrezepte begrenzt. +`apt_native_update` ist eine echte Transaktion; ein nachfolgender +`apply_updates`-Noop ist **keine** zweite Updateausführung und kein Nachweis +beliebiger OS-/Kernelupdates oder eines allgemeinen Paketkatalogs. + +## Verbindliche Negativfälle passend zum gelieferten Umfang + +Zusätzlich zu den oben benannten nativen Abläufen müssen die vorhandenen +gezielten Prüfungen folgende Invarianten erhalten; nur reale Lücken ergänzen, +keine parallele Volltestsuite bauen: + +- AT-04/05: fremde Objekt-IDs, fehlender Tenantkontext, Poolwiederverwendung und + Artifact-/Workerpfade verweigern; Kenntnis einer UUID ist keine Berechtigung. +- AT-10/11: Clone-/Journalrollback bzw. alte Telemetrie erzeugen weder historische + Wiederholung noch frische Onlineanzeige. Kein tatsächlicher VM-Snapshot oder + Zurückrollen des erhaltenen dauerhaften Testjournals als Abkürzung erforderlich. +- AT-12–14: manipulierte Logs bleiben Daten; gleicher Idempotenzschlüssel mit + anderem Inhalt und veränderte genehmigte Ziele/Bytes bleiben verweigert. +- AT-24/27: Wiederanlauf und begrenzter Output/Telemetrieverkehr erhalten Journale, + andere Mandanten und Backpressure. Bestehender echter WSS-Reconnect ist belegt; + er ersetzt keinen Ergebnis-ACK-Verlust bei laufender Wirkung. +- AT-29–33: vor Genehmigung immer Null-Jobgate, keine Automation-/Policyfreigabe, + unveränderliche Pläne und keine zweite Wirkung bei Redelivery. + +AT-15/16/17–23/25/26 gehören gemäß Spec 25.3 zu Windows, PVE/RustDesk oder M7 +und blockieren das Linux-MVP nicht. AT-28 wird mit dem später gelieferten +Sollservice-/Monitoringumfang geprüft; aktuelle Gesundheit darf bis dahin +ehrlich `unknown` bleiben. + +## Solange APT unbekannt und gesperrt ist + +Unabhängig möglich sind Lesen gespeicherter UI-/HTTP-/MCP-Daten, Tenant- und +Null-Jobgateprüfungen, lokale Implementierung der notwendigen Faultadapter sowie +ein eng begrenzter passiver Identitäts-/TLS-Nachweis. Eine dafür getrennte +Testidentität auf derselben erlaubten Cloud-VM darf die dauerhafte Identität +und deren offene Wirkung nicht ersetzen oder die Sperre umgehen. + +Keine neue Paket-/Root-/Rebootwirkung starten, keinen alten Antrag erneut +genehmigen, keine Tombstones/DB-/PKI-/Identitätsdaten zurücksetzen. Insbesondere +eine durch Unknown blockierte Probe nicht als bestandenen Offline-/Fristtest +werten. Erst die dokumentierte sichere Auflösung öffnet den weiteren Ablauf. diff --git a/docs/post-mvp.md b/docs/post-mvp.md new file mode 100644 index 0000000..94ad8d0 --- /dev/null +++ b/docs/post-mvp.md @@ -0,0 +1,25 @@ +# Entdeckungen und Aufgaben nach dem Linux-MVP + +Stand 2026-11-13. Diese Liste erweitert den aktuellen Auftrag nicht. Erst die +[M0–M5-Gates](mvp-gates.md) abschließen; neue Entdeckungen hier einordnen, +anstatt nebenbei weitere Produkteigenschaften zu bauen. Sicherheits- oder +Korrektheitsfehler in einem aktuellen MVP-Pfad bleiben dort sofort relevant. + +| Entdeckung / späteres Thema | Tatsächlicher heutiger Stand | Spätere Aufgabe | +| --- | --- | --- | +| 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-/Inventar-/Tenantpfad und sieben native Tests bestanden. Kein Windows-Jobexecutor; Entwicklungsbuild unsigniert. | Native HTTPS-/Rotation-/Widerrufs-/Rebootpersistenz, eingeschränkter Helper, PowerShell und geprüfte MSI/EXE, MSVC-/Signier-/Installerabnahmen im ausdrücklich 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. | +| 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 | Verbrauchs-/Versuchstombstones werden erhalten; volle/inkonsistente Journale sperren neue Wirkungen. | Dokumentierte beidseitige Kompaktierung und Kapazitätsplanung; niemals stille Löschung von Unknown oder unbestätigten Ergebnissen. | +| 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 zusammenführen/archivieren und Querverweise vereinheitlichen. 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).