Files
rust-discovery/docs/server-time-broker-bootstrap.md
T
2026-11-15 10:59:02 +01:00

16 KiB

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/<vollerSHA>/pin_bootstrap.py geladen: Root:Root0600, ein regulärer Link, geschützte Ancestry und exakter SHA256. Seine tatsächlichen Original-Preflight-/Build-/Quellen-/Boot-/Runtime- und Chrony-/Pinbindungen bleiben Pflicht. 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 das tatsächliche erfolgreiche probe-peer-acceptance-v1/result.json desselben Originalfalls nötig. Der Gate bindet den separat geprüften Probecontroller, vollständige Vorher-/Nachher-Zeugen samt ihren gespeicherten Bytes/Hashes, Sources, Artefakt, öffentlichen Pin, ursprüngliche Fehler-/Pinbelege und identische Boot-ID. Das tatsächliche Sample muss strikt Fehler≤500ms, Syncalter≤1h, Kernelstate0..4 und alle unveränderten Samplefelder erfüllen. Eine Fixture, Callerbool oder Dateipräsenz allein qualifiziert nichts. Die Qualitätsprobe muss erfolgen, bevor die neue Supplementary-Gruppe angelegt wird. Die neue DAC-Probe belegt das separat diagnostizierte Zugriffsprofil; die frühere GROUP-Probe mit Exit1 bleibt fehlgeschlagen und ihre Originalbytes/-Hashes bleiben gebunden. Eine historische erfolgreiche Probe wird nicht als aktuelle Zeitautorität wiederverwendet; der laufende Broker muss später vor jeder Signatur selbst frisch messen.

Auf dem Server ausschließlich isoliert starten:

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 _chrony989. 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/chrony9890700 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 Installationsgate ist ausschließlich an die neue 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 und der tatsächliche Manager-UnitPath; systemd-analyze unit-paths allein zeigt nur Compilerdefaults.

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.

Separater Peer-Qualifier: weiterhin 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. 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.