Files
rust-discovery/docs/server-time-broker.md
2026-11-15 00:45:05 +01:00

167 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Lokaler Linux-Zeitsignierbroker
Dieser neue Quellpfad trennt den privilegierten, fest begrenzten Zeitprovider
und Zeitsignierschlüssel vom unprivilegierten HTTP-Server. Er ist kein Job-
executor und erteilt keine WebUI-Freigabe, Capability oder TrustedClock-Lease.
Noch kein realer Brokerstart, Schlüsselsetup, Bootstrap oder Zieltest wurde
durch diesen Implementierungsauftrag ausgeführt. Lokale Prüfungen und native
Abnahmen werden getrennt nach tatsächlichem Lauf dokumentiert.
Das feste Executable akzeptiert keine Argumente. `run()` benötigt einen Root-
Prozess, eröffnet eine einzige fest gepinnte `NativeTimeSource` und verarbeitet
Verbindungen seriell am Unix-Streamsocket
`/run/rmm-time-source/broker.sock`, Listenbacklog4. Kein Internetlistener,
frei wählbarer Pfad/Befehl, IPC-Adminbefehl, dynamischer Interpreter, Jobgrant,
Zeitsetter oder automatisches Provisionieren. Cross-OS bleibt unsupported.
## Geschütztes Provisionierungsprofil
Voraussetzungen, **kein ausgeführter Bootstrap**: Geschützte root-eigene
Verzeichnisancestry ohne Symlinks und ohne Gruppen-/Fremdschreibrecht.
`/etc/rmm-time-source/signer.json` regulär root0600, ein Link, höchstens8KiB,
striktes JSON-Schema1 mit diesen Feldern:
- `server_instance`: nichtleere UUID des festen Servers.
- `key_id` und `key_generation`: eigenes Zeitkey-IDprofil und positive Generation.
- `signing_key_hex`: genau32Bytes privater Ed25519-Zeitschlüssel als64kleine Hexzeichen.
- `forbidden_public_keys`:1–32 eindeutige konkrete öffentliche Fremdrollenschlüssel.
- `expected_server_uid` und `server_gid`: beide ausschließlich10001.
Keine Schlüsselwerte in Chat, Logs, Receipts oder Git ablegen. Der Broker gibt
bei Prozessfehlern nur eine feste generische Fehlermeldung aus. Config und
Signer besitzen keine Debug-Ausgabe. Root muss den echten Jobsigner sowie
alle bekannten Update-/Health-/TLS-Ed25519-Rollen in die geschützte Verbotsliste
aufnehmen. Der Broker vergleicht dekodierte32Bytewerte mit seinem abgeleiteten
Timepublickey und verweigert jede Wiederverwendung. Eine nichtleere beliebige
Liste beweist allein nicht, dass der Operator alle tatsächlichen Fremdrollen
korrekt erfasst hat. Die Schlüsseldomäne des Codecs bleibt getrennt.
Gehaltene Datei-/Verzeichnis-FDs, Device/Inode/Konto/Modus/Linkzahl sowie
Länge/mtime/ctime werden kontrolliert. Rootrotation verändert keine laufende
Instanz stillschweigend: sie braucht den gesonderten geschützten Betriebsweg,
Stop und eine neue Brokerinstanz. Kein automatisches Übernehmen neuer Pins.
Die tatsächlichen Prozess-/Image-/PIDpins der Chrony-Instanz gehören separat
zum [nativen Provider](server-time-source.md). Neustart/Boot/Daemonwechsel
brauchen eine neue unabhängig geprüfte Rootprovisionierung; der Broker erfindet
keine Qualität aus einem Autostart oder dem bloßen Vorhandensein der Datei.
Der Runtimeparent muss für das Serverkonto traversierbar und root-write-only
sein. Der einmalig erzeugte Socket wird root:10001 mit Modus0660 gesetzt, seine gehaltene
Identität nachgeprüft und erst dann auf Listen geschaltet. `SO_PEERCRED` muss
kernelbestätigt PID>1 und UID/GID10001 liefern. Das entspricht dem tatsächlichen
Compose-Profil10001:10001; keine Fallbackidentität. Cleanup entfernt ausschließlich
den exakt selbst erzeugten Namen/Inode per `unlinkat` am gehaltenen Parent-FD.
Ein nach hartem Prozessabbruch verbliebener Socket blockiert den Neustart;
keine automatische Adoption, Entfernung oder Wiederholung auf unklarem Stand.
Die Rootdiensthärtung ist ein eigenes Operatorarbeitspaket. Für den lesenden
Zugriff auf das Image einer Chrony-Instanz mit anderer UID kann auf dem realen
Server `CAP_SYS_PTRACE` nötig sein. Daraus folgen keine neuen Codepfade für
`ptrace`, `process_vm_*` oder beliebige Prozessdaten. `CAP_SYS_TIME` ist für die
verwendeten ausschließlich lesenden `adjtimex(modes=0)`-Abfragen nicht nötig.
Keine Dienstunit oder Capabilityänderung wurde hier ausgeführt.
## Fester Draht- und Zeitvertrag
Genau eine Anfrage pro Verbindung:4Byte Big-Endian-Länge und1–8192Bytes
kanonisches JSON des bestehenden `Request`-Codecs. Unbekannte/duplizierte
Felder, nichtkanonische Bytes, falscher Endpunkt/Rollen-/Bindingschemawert,
zusätzliche bereits angelieferte Bytes oder unvollständige Frames verweigern
vor dem Provider-/Signaturpfad. Danach genau eine analog gerahmte
`SignedAttestation`-Antwort und Verbindungsende. Ein fehlgeschlagener Versuch
wird nicht intern wiederholt. Gesamtes Lese-/Signier-/Schreibbudget250ms,
gemessen mit eigener Monoton- und BOOTTIME; IO arbeitet nonblocking mit verbleibender
Gesamtfrist, nicht mit verlängerbaren Einzelreadtimeouts. Suspend während
des Reads eröffnet nach Resume kein neues Restbudget.
Vor **jeder** Signatur erfolgt `source.sample()`: tatsächliche gepinnte
Chrony-/Kernel-/Clockprüfung, keine gespeicherte Qualität. Der Payload enthält
nur den kanonischen AnfragesHA und geschützten Server-/Keykontext zusammen mit
dem tatsächlich privat konstruierten Sample. Nach der Probe liest der Broker
selbst REALTIME/MONOTONIC/BOOTTIME und Boot-ID; Rücksprung, Suspend-/Wallclock-
abweichung oder falscher Boot verweigern. Gemessene Erfassungsfenster sind keine
physikalische Timerkalibrierung.
Das UTCcapture bleibt das ursprüngliche Sample. Die Restzeit bis zur festen
250ms-Gesamtfrist, die bereits seit Samplecapture vergangene Zeit und beide
höchstens10ms-Erfassungsfenster werden vor Signierung konservativ in Fehler-
und Quellaltersobergrenze reserviert. Über500ms Fehler oder1h Quellalter
verweigert. Nach Ed25519-Signierung folgen eigene neue Clock-/Boot-/Frist-
prüfung und erneute geschützte Configprüfung vor Antwort. Kein nachträgliches
Verlängern der Frist und keine kostenlose neue Anfrage/Nonce/Jobberechtigung.
Der unabhängige Empfänger muss weiterhin vollständigen RTT, eigene Capture-
unsicherheit und strikte Deadlinegrenzen prüfen. Es gibt kein Holdover.
Der Broker authentisiert ausschließlich das lokale Serverkonto. Tenant,
Geräteidentität/mTLS, aktueller Connection-/Enrollment-/Assignmentkontext und
SQLautorisierung sind Pflichten der separaten Serverroute. Eine vom Server
weitergeleitete Helperrolle behauptet keine native Helperprozessattestierung
auf der Serverseite; deren unabhängiger Proof bleibt lokal beim Helper.
## Tatsächlich lokal geprüft
Im vorhandenen Offline-Buildimage
`sha256:9a76ad3744ebfdddae96ca10001ce8291c1b332fb54c8df5eea0e8e999ac6fc6`,
UID1000, Quellmount read-only, eigenes `devstate/broker-target`:
- `cargo test --locked --offline -p rmm-time-broker-linux --all-targets`:
3Guardtests bestanden,0fehlgeschlagen,0ignoriert,0gefiltert. Die Tests prüfen
synthetische Keyrollen, kanonische Frames und Frist-/Qualitätsüberläufe;
keine echten Schlüsseldateien, Root- oder Provideraufrufe.
- `cargo clippy --locked --offline -p rmm-time-broker-linux --all-targets -- -D warnings`:
bestanden nach Entfernung eines unnötigen `Ok(...?)`; keine Unterdrückung.
- Gezielte `rustfmt --edition2024 --check --config skip_children=true`-Prüfung
der drei eigenen Rustdateien: bestanden.
Release-Link und ausführbares Brokerbinary werden getrennt mit ihren
exakten Hashes im privaten lokalen Qualifikationsfall festgehalten. Ein Build
oder synthetischer Guardtest ist kein echter IPC-/Signier-/Providerlauf.
## Offene tatsächliche Gates
Unabhängiger Quellenreview und native Prüfungen sind separat auszuweisen. Tatsächliche Providerqualität, sichere Schlüssel-/
Pinprovisionierung, Diensthärtung, Rootbrokerstart auf Linux, mTLS-/SQLroute,
unabhängige Windows-Agent-/SYSTEM-Abnahme und Runtime-/Deadlineintegration
bleiben eigene Gates. Kein Notebook-RMM-Dienst, kein Zielreboot, keine neue
Freigabe- oder Ledgerstrecke folgt aus diesem Quellencheckpoint.
## Unabhängiger Review und Serverroute
Brokerquelle unabhängig geprüft. Privater QualifikationsreceiptSHA256
`0bc10b7e52ebfc06894eaf38fb070ac6dc14e973940e71c9e03faa9af6fdd409`
bindet13Inputs, tatsächliche lokale3/3Guardtests, Clippy/Fmt sowie
Release-Unitlink und ausführbares Brokerbinary. Keine echte Providerquery,
Schlüsselprovisionierung oder Brokerdienst durch diese Prüfungen.
Die neue Gatewayroute `/agent/v1/time-attestation` erhält8KiB Größenlimit,
prüft gültiges Geräte-mTLS und die aktuelle gesperrte Tenantinstallationszeile:
Agent/Asset, Enrollment-/Assignment-/Connectiongeneration, Windowsboot und
Windowscapability. Ein bereits fertiger SignedSync wird nicht verlangt, um den
initialen Clock-/Synczyklus zu vermeiden. Die geteilte Installationssperre bleibt
während der begrenzten lokalen Brokeranfrage erhalten; keine Job-/Grant-/
Outbox- oder Readyänderung. Nur Nonce-/Kontext-/Zeitmaterial wird zurückgegeben.
Der Container authentisiert den Hostbroker über Kernel-UID0 und den festen
root-eigenen Socket/Inode. Eine Host-PID ist in der eigenen Container-
PIDnamespace nicht sichtbar und kann als0 erscheinen; die erste zusätzliche
PID>1-Prüfung hätte legitime Anfragen blockiert und wurde nach unabhängiger
Analyse entfernt. [Kernel-Credentialabbildung](https://github.com/torvalds/linux/blob/master/net/core/sock.c).
Kein pid:host, privilegierter Container oder UIDremap-Fallback. Unmapped UID/
abweichender Dateibesitz bleibt deny. Der tatsächliche Namespace-/UIDbeleg ist
vor Deployment noch auszuführen; Endverifier prüfen weiterhin ihren separat
provisionierten Zeitschlüssel und die ganze Originalchallenge.
Route unabhängig sourcegeprüft; lokales Servercheck und Alltargets-Clippy mit
-Dwarnings nach Namespacekorrektur bestanden. Der erste UID1000-Compilerlauf
stoppte an einem nicht lesbaren bereits vorhandenen Registrycachefile(fnv);
getrennter privater Servertarget/UID0 im unveränderten read-only Offlinecontainer
bestand ohne Rechteaufweichung oder Änderung alter Artefakte. Keine neuen
Server-/DB-/mTLS-Integrationstests oder Produktionsbereitstellung behaupten.
Die500ms betreffen die Issuefunktion einschließlich Auth-/DBphase; die
Axum-Bytesextraktion liegt davor und ist nur größenbegrenzt. Vier gleichzeitige
Anfragen werden nach der ersten Authquery begrenzt, der lokale Brokerteil auf
300ms. Keine globale TCP-Bodyfrist oder Obergrenze aller Authqueries behaupten.
Detaillierte öffentliche Endpunktlast-/Bodyzeitlimits bleiben späterer Betrieb.