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

175 lines
10 KiB
Markdown

# 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:
```text
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:
```text
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.