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

6.9 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.