167 lines
10 KiB
Markdown
167 lines
10 KiB
Markdown
# 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.
|