Keep installed admin helpers usable after release expiry
Rust development slice / linux (push) Failing after 13s
Rust development slice / linux (push) Failing after 13s
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Rust RMM: Architektur und Implementierungsspezifikation
|
||||
|
||||
Version 1.39 · 2026-11-18 · Sprache: Deutsch
|
||||
Version 1.40 · 2026-11-18 · Sprache: Deutsch
|
||||
|
||||
**Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam.
|
||||
|
||||
@@ -114,6 +114,10 @@ Minuten nach Empfang nutzbar (bisher 100 ms). Details Kapitel 0.3.
|
||||
|
||||
## 0 Auftrag und verbindliche Produktanforderungen
|
||||
|
||||
### 0.11 Gültigkeit von Releases bei bereits installierten Skripthelfern (Version 1.40)
|
||||
|
||||
Für Neuinstallationen und Updates muss das Release-Manifest zum Zeitpunkt der Prüfung gültig sein. Für Administrator-Skripte auf bereits installierten Clients prüft der Server die Manifest-Gültigkeit zum gespeicherten Zeitpunkt der Katalogregistrierung. Die Signatur wird mit dem aktuellen Schlüsselring geprüft. Gerätebindung, Helper-Hash, Berechtigungen und Auftragsgenehmigung sind weiterhin erforderlich.
|
||||
|
||||
### 0.10 Ausführbare Geräteaufträge (Version 1.39)
|
||||
|
||||
Jede neue Aktion aus WebUI oder MCP wird als `run_script` geplant. Das gilt auch für Neustarts. Die Bibliothek stellt je eine Revision für Linux (Root) und Windows (SYSTEM) bereit. Plan, Genehmigung und Ergebnis binden die ausgewählte Revision und das Zielgerät. Der Exitcode des Neustartskripts belegt die Annahme durch das Betriebssystem. Die Abnahme eines Neustarts erfordert zusätzlich einen geänderten Bootbezug, einen neuen authentisierten Kontakt und einen erfolgreichen Folgeauftrag der gleichen Kopplung.
|
||||
|
||||
@@ -14,6 +14,7 @@ use axum::{
|
||||
response::{IntoResponse, Response},
|
||||
routing::{get, post},
|
||||
};
|
||||
use chrono::{DateTime, Utc};
|
||||
use futures_util::StreamExt;
|
||||
use rmm_domain::{
|
||||
agent_update::{ArtifactDescriptor, Platform, ReleaseEnvelope, ReleaseManifest},
|
||||
@@ -186,6 +187,13 @@ fn keyring_path_with(
|
||||
pub fn verify_envelope(
|
||||
envelope: &ReleaseEnvelope,
|
||||
binding: Option<&rmm_domain::agent_update::UpdaterBinding>,
|
||||
) -> Result<ReleaseManifest, Error> {
|
||||
verify_envelope_at(envelope, binding, Utc::now())
|
||||
}
|
||||
fn verify_envelope_at(
|
||||
envelope: &ReleaseEnvelope,
|
||||
binding: Option<&rmm_domain::agent_update::UpdaterBinding>,
|
||||
time: DateTime<Utc>,
|
||||
) -> Result<ReleaseManifest, Error> {
|
||||
let platform = envelope.decode().map_err(|_| invalid())?.manifest.platform;
|
||||
let raw = keyring_bytes(platform)?;
|
||||
@@ -193,10 +201,7 @@ pub fn verify_envelope(
|
||||
envelope,
|
||||
binding,
|
||||
&raw,
|
||||
chrono::Utc::now()
|
||||
.timestamp()
|
||||
.try_into()
|
||||
.map_err(|_| invalid())?,
|
||||
time.timestamp().try_into().map_err(|_| invalid())?,
|
||||
)
|
||||
}
|
||||
fn keyring_bytes(platform: Platform) -> Result<Vec<u8>, Error> {
|
||||
@@ -420,15 +425,53 @@ pub async fn upload(
|
||||
json!({"artifact_id":input.artifact_id,"sha256":input.sha256,"size_bytes":input.size_bytes}),
|
||||
))
|
||||
}
|
||||
enum CatalogReleaseCheck {
|
||||
Current,
|
||||
InstalledHelper,
|
||||
}
|
||||
|
||||
impl CatalogReleaseCheck {
|
||||
fn verification_time(
|
||||
self,
|
||||
registered: DateTime<Utc>,
|
||||
now: DateTime<Utc>,
|
||||
) -> Result<DateTime<Utc>, Error> {
|
||||
match self {
|
||||
Self::Current => Ok(now),
|
||||
Self::InstalledHelper if registered <= now => Ok(registered),
|
||||
Self::InstalledHelper => Err(invalid()),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub async fn checked_release(
|
||||
tx: &mut Transaction<'_, Postgres>,
|
||||
id: Uuid,
|
||||
) -> Result<(ReleaseEnvelope, ReleaseManifest), Error> {
|
||||
let row = sqlx::query("SELECT envelope,envelope_sha256,manifest_sha256 FROM agent_update_releases WHERE release_id=$1")
|
||||
checked_catalog_release(tx, id, CatalogReleaseCheck::Current).await
|
||||
}
|
||||
|
||||
/// Used only to attest an enrolled, running helper against its registered release.
|
||||
/// The immutable catalog timestamp proves that the release was valid when registered.
|
||||
pub(crate) async fn checked_installed_helper_release(
|
||||
tx: &mut Transaction<'_, Postgres>,
|
||||
id: Uuid,
|
||||
) -> Result<ReleaseManifest, Error> {
|
||||
let (_, manifest) = checked_catalog_release(tx, id, CatalogReleaseCheck::InstalledHelper).await?;
|
||||
Ok(manifest)
|
||||
}
|
||||
|
||||
async fn checked_catalog_release(
|
||||
tx: &mut Transaction<'_, Postgres>,
|
||||
id: Uuid,
|
||||
check: CatalogReleaseCheck,
|
||||
) -> Result<(ReleaseEnvelope, ReleaseManifest), Error> {
|
||||
let row = sqlx::query("SELECT envelope,envelope_sha256,manifest_sha256,created_at FROM agent_update_releases WHERE release_id=$1")
|
||||
.bind(id).fetch_optional(&mut **tx).await?.ok_or_else(missing)?;
|
||||
let raw: Vec<u8> = row.get("envelope");
|
||||
let envelope: ReleaseEnvelope = serde_json::from_slice(&raw)?;
|
||||
let manifest = verify_envelope(&envelope, None)?;
|
||||
let time = check.verification_time(row.get("created_at"), Utc::now())?;
|
||||
let manifest = verify_envelope_at(&envelope, None, time)?;
|
||||
if encode(&envelope)? != raw
|
||||
|| hash(&raw) != row.get::<String, _>("envelope_sha256")
|
||||
|| hash(&envelope.decode().map_err(|_| invalid())?.payload_bytes)
|
||||
@@ -1180,6 +1223,44 @@ mod tests {
|
||||
let official_ring = encode(&official_keys).unwrap();
|
||||
assert!(verify_envelope_with_keyring(&official, None, &official_ring, 100).is_ok());
|
||||
assert!(verify_envelope_with_keyring(&development, None, &official_ring, 100).is_err());
|
||||
// At the expiry boundary, installed helpers still use the immutable
|
||||
// registration time. Bootstrap and update checks use the current time.
|
||||
let registered = DateTime::from_timestamp(100, 0).unwrap();
|
||||
let now = DateTime::from_timestamp(200, 0).unwrap();
|
||||
let check_catalog = |check: CatalogReleaseCheck,
|
||||
registered: DateTime<Utc>,
|
||||
envelope: &ReleaseEnvelope,
|
||||
keyring: &[u8]| {
|
||||
let at = check.verification_time(registered, now)?.timestamp() as u64;
|
||||
verify_envelope_with_keyring(envelope, None, keyring, at)
|
||||
};
|
||||
let installed = CatalogReleaseCheck::InstalledHelper;
|
||||
assert!(check_catalog(installed, registered, &official, &official_ring).is_ok());
|
||||
assert!(
|
||||
check_catalog(CatalogReleaseCheck::Current, registered, &official, &official_ring)
|
||||
.is_err()
|
||||
);
|
||||
assert!(check_catalog(CatalogReleaseCheck::InstalledHelper, now, &official, &official_ring).is_err());
|
||||
assert!(
|
||||
CatalogReleaseCheck::InstalledHelper
|
||||
.verification_time(now + chrono::Duration::seconds(1), now)
|
||||
.is_err()
|
||||
);
|
||||
assert!(
|
||||
check_catalog(CatalogReleaseCheck::InstalledHelper, registered, &development, &official_ring)
|
||||
.is_err()
|
||||
);
|
||||
let mut revoked_official = official_keys;
|
||||
revoked_official.keys[0].revoked = true;
|
||||
assert!(
|
||||
check_catalog(
|
||||
CatalogReleaseCheck::InstalledHelper,
|
||||
registered,
|
||||
&official,
|
||||
&encode(&revoked_official).unwrap()
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
let (linux, linux_keys) = make(Platform::LinuxX64);
|
||||
let (windows, windows_keys) = make(Platform::WindowsX64);
|
||||
let linux_raw = encode(&linux_keys).unwrap();
|
||||
|
||||
@@ -212,7 +212,7 @@ pub(crate) async fn permits(
|
||||
.fetch_optional(&mut **tx)
|
||||
.await?
|
||||
.flatten();
|
||||
let (_, manifest) = crate::agent_updates::checked_release(tx, release)
|
||||
let manifest = crate::agent_updates::checked_installed_helper_release(tx, release)
|
||||
.await
|
||||
.map_err(|err| {
|
||||
if err.0.is_server_error() {
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
|
||||
Auf Windows lieferte der erste Vorversuch Exitcode 0 und keine Ausgabe. Revision 2 meldete auf `0.1.14` den nativen Fehler 203. Der eingeschränkten Prozessumgebung fehlte `COMPUTERNAME`. Der aktualisierte Client ergänzte den nativen Rechnernamen. Dieselbe genehmigte Skriptrevision lieferte danach die Ankündigung des Neustarts, anschließend bestätigten Gast und Gateway den neuen Boot.
|
||||
|
||||
**Zur Entscheidung nach der Abnahme.** Derzeit berücksichtigt die zentrale Prüfung für bereits installierte Administrator-Helper auch das Ablaufdatum ihres Release-Manifests. Der Betreiber entscheidet separat über eine Anpassung für dauerhaft installierte Versionen.
|
||||
**Manifest-Gültigkeit für installierte Administrator-Helper.** Im Quellstand behoben. Der Server prüft die Gültigkeit zum gespeicherten Katalogzeitpunkt und verwendet den aktuellen Schlüsselring. Der Regressionstest prüft ein abgelaufenes Manifest in beiden Pfaden sowie den Widerruf des Signierschlüssels. Die HTTPS-Aufnahme und der Release-Katalog wurden zusätzlich mit isoliertem PostgreSQL geprüft.
|
||||
|
||||
## Ergänzte Lieferungen am 17. November 2026
|
||||
|
||||
|
||||
@@ -1,6 +1,10 @@
|
||||
# Verbindliche Projektentscheidungen
|
||||
|
||||
Stand: **2026-11-18**, Spezifikation **1.39** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
|
||||
Stand: **2026-11-18**, Spezifikation **1.40** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung.
|
||||
|
||||
## Release-Gültigkeit für installierte Skripthelfer (Version 1.40)
|
||||
|
||||
Der Betreiber hat entschieden, dass ein abgelaufenes Release-Manifest Administrator-Skripte auf bereits installierten Clients nicht sperrt. Bei der Prüfung des installierten Helfers zählt der unveränderliche Registrierungszeitpunkt im Katalog. Der aktuelle Schlüsselring entscheidet weiterhin über die Vertrauensstellung. Bei Neuinstallationen und Updates prüft das System die Gültigkeit zum aktuellen Zeitpunkt.
|
||||
|
||||
## Aktionen über Skripte (Version 1.39)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user