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

10 KiB

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/<SHA>/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:

python3 -I /reviewter/absoluter/pfad/server_time_source_pin_bootstrap.py host-pin --case <originale-ARM64-UUID>

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:

python3 -I /reviewter/absoluter/pfad/server_time_source_pin_bootstrap.py host-read --case <dieselbe-UUID>

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.