Files
rust-discovery/docs/server-time-source-bootstrap.md
T
2026-11-15 01:42:08 +01:00

17 KiB

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 <voller 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/<UUID> 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 host-read --case <UUID> 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 <UUID>. 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 <UUID> --sha256 <Archivhash> 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 <UUID> 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 <UUID> --sha256 <Probe-ELF-hash>. 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 <UUID> 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.

Chrony wird über den vorhandenen chrony.service-MainPID identifiziert. PIDFD, Prozessgeburtszeit, reale/effective UID/GID, tatsächlicher Executableinode, geschütztes /usr/sbin/chronyd samt SHA256 und Boot-ID werden beobachtet und erneut verglichen. 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/<chrony>/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.