Compare commits

...
Author SHA1 Message Date
kevin_janssen 01960477f8 Record verified production customer transfer cutover
Rust development slice / linux (push) Failing after 8s
2026-11-18 23:01:25 +01:00
kevin_janssen 480e3749a6 Complete customer transfers on first authenticated inventory
Rust development slice / linux (push) Failing after 8s
2026-11-18 22:57:05 +01:00
13 changed files with 234 additions and 76 deletions
+1 -1
View File
@@ -14,7 +14,7 @@ Für aktuelle virtuelle Geräte kann die WebUI einen registrierten Hypervisor au
Die RAM-Spalte zeigt den für Anwendungen verfügbaren und den gesamten physischen Arbeitsspeicher in GiB. Wie beim Speicherplatz zeigt ein Balken den belegten Anteil. Die CPU-Spalte ergänzt die zuletzt gemessene Systemauslastung als Prozentwert. Die Agenten gewinnen sie aus den CPU-Zeitdifferenzen zwischen zwei Heartbeats im Abstand von ungefähr 30 Sekunden. Linux liefert systemweite Werte. Windows liefert den Wert, wenn alle logischen CPUs zu einer einzigen Prozessorgruppe gehören. Vor dem ersten aussagekräftigen Intervall bleibt die Auslastung offen. Die WebUI und MCP lesen dieselbe letzte Messung. Für Agenten ohne Ressourcenmeldung stammen verfügbare RAM-Werte aus dem vorhandenen Inventar. [Inventarprojektion](crates/server/src/devices.rs)
Kunden lassen sich in der WebUI anlegen und umbenennen. Unter **Gerät verwalten → Kunden wechseln** wählt eine berechtigte Person den Zielkunden. Der Server prüft die Rechte zur Geräteverwaltung im bisherigen Kunden und zur Geräteaufnahme im Zielkunden. Der bereits installierte Agent empfängt den Wechsel über seine authentisierte Verbindung und erhält ein neues Zertifikat für eine neue Kopplung. Nach der ersten Inventarmeldung beim Zielkunden bestätigt die Person den Abschluss in der WebUI. Der Server sperrt die bisherige Geräteidentität. Inventar und Auftragsergebnisse der bisherigen Kopplung bleiben beim bisherigen Kunden. Noch nicht abgeschlossene Aufträge, ungeklärte Versuche und gültige offene Genehmigungen müssen vor dem Wechsel abgeschlossen werden. Gerätegebundene erhöhte Rechte erfordern eine eigene Bindung für die neue Kopplung.
Kunden lassen sich in der WebUI anlegen und umbenennen. Unter **Gerät verwalten → Kunden wechseln** wählt eine berechtigte Person den Zielkunden. Der Server prüft die Rechte zur Geräteverwaltung im bisherigen Kunden und zur Geräteaufnahme im Zielkunden. Der bereits installierte Agent empfängt den Wechsel über seine authentisierte Verbindung und erhält ein neues Zertifikat für eine neue Kopplung. Mit der ersten gültigen Inventarmeldung der authentisierten neuen Kopplung schließt der Server den Wechsel automatisch ab. Er sperrt die bisherige Geräteidentität und schaltet den Bestand in derselben Transaktion auf den Zielkunden um. Inventar und Auftragsergebnisse der bisherigen Kopplung bleiben beim bisherigen Kunden. Noch nicht abgeschlossene Aufträge, ungeklärte Versuche und gültige offene Genehmigungen müssen vor dem Wechsel abgeschlossen werden. Gerätegebundene erhöhte Rechte erfordern eine eigene Bindung für die neue Kopplung.
Eine ausgeschiedene Installation kann nach Widerruf und persönlicher Bestätigung endgültig gelöscht werden. Ein noch gültiger offener Genehmigungsantrag oder ein nicht abgeschlossener Job einschließlich `unknown` sperrt die Löschung. Daten weiterhin beteiligter Zielgeräte bleiben erhalten. [Regeln zur Löschung](migrations/0036_delete_device_pairing.sql)
+11 -1
View File
@@ -105,7 +105,7 @@ pub async fn ingest(
);
let mut tx = rmm_persistence::tenant_tx(&state.pool, tenant).await?;
control_lock(&mut tx, tenant, agent).await?;
let row=sqlx::query("SELECT revoked_at,connection_generation,transport,connection_boot_id,last_sequence,capabilities FROM agent_installations WHERE agent_id=$1 FOR UPDATE").bind(agent).fetch_one(&mut *tx).await?;
let row=sqlx::query("SELECT revoked_at,connection_generation,transport,connection_boot_id,last_sequence,capabilities,customer_transfer_pending FROM agent_installations WHERE agent_id=$1 FOR UPDATE").bind(agent).fetch_one(&mut *tx).await?;
let active = row.get::<Option<DateTime<Utc>>, _>("revoked_at").is_none()
&& row.get::<i64, _>("connection_generation") == i64::try_from(e.connection_generation)?
&& row.get::<String, _>("transport") == transport;
@@ -196,6 +196,16 @@ pub async fn ingest(
}
_ => anyhow::bail!("unsupported capability"),
}
if row.get::<bool, _>("customer_transfer_pending")
&& (matches!(&e.payload, Some(Payload::Heartbeat(_)))
|| matches!(&e.payload, Some(Payload::InventorySnapshot(s)) if s.scope != "agent.update"))
{
sqlx::query("SELECT finish_device_customer_transfer($1,$2)")
.bind(tenant)
.bind(agent)
.execute(&mut *tx)
.await?;
}
tx.commit().await?;
Ok(reply(
e,
+11 -27
View File
@@ -158,11 +158,13 @@ async fn status(
return Ok(private_json(json!({"transfer":null})));
};
destination(&mut tx, &p, t.target_tenant_id).await?;
let hostname = target_hostname(&mut tx, &t).await?;
let hostname = if t.completed_at.is_some() {
target_hostname(&mut tx, &t).await?
} else {
None
};
let state = if t.completed_at.is_some() {
"completed"
} else if hostname.is_some() {
"ready"
} else if t.target_agent_id.is_some() {
"enrolled"
} else {
@@ -186,7 +188,7 @@ async fn lock_source(
sqlx::query_scalar(
"SELECT i.revoked_at IS NULL AND i.last_authenticated_at IS NOT NULL AND a.archived_at IS NULL
FROM agent_installations i JOIN assets a USING (tenant_id,asset_id)
WHERE i.asset_id=$1 AND i.agent_id=$2 FOR UPDATE OF i",
WHERE i.asset_id=$1 AND i.agent_id=$2 AND NOT i.customer_transfer_pending FOR UPDATE OF i",
)
.bind(asset)
.bind(agent)
@@ -320,34 +322,16 @@ async fn complete(
Query(pair): Query<Pairing>,
) -> Result<Response, Error> {
let (p, mut tx) = source(&s, &headers, tenant, true).await?;
lock_source(&mut tx, tenant, asset, pair.agent_id).await?;
verify_pairing(&mut tx, asset, pair.agent_id).await?;
let t = transfer(&mut tx, pair.agent_id)
.await?
.filter(|t| t.transfer_id == id)
.ok_or(NOT_FOUND)?;
destination(&mut tx, &p, t.target_tenant_id).await?;
if t.completed_at.is_some() {
return Ok(private_json(json!({"state":"completed"})));
}
if target_hostname(&mut tx, &t).await?.is_none() {
// Older WebUI bundles may still request completion after the atomic cutover.
if t.completed_at.is_none() {
return Err(Error(StatusCode::CONFLICT, "TRANSFER_TARGET_NOT_READY"));
}
select_tenant(&mut tx, tenant).await?;
ensure_idle(&mut tx, pair.agent_id).await?;
sqlx::query(
"UPDATE agent_installations SET revoked_at=now(), connection_generation=connection_generation+1,
previous_certificate_sha256=NULL,previous_certificate_until=NULL
WHERE asset_id=$1 AND agent_id=$2 AND revoked_at IS NULL",
)
.bind(asset).bind(pair.agent_id).execute(&mut *tx).await?;
sqlx::query("UPDATE device_customer_transfers SET completed_at=now() WHERE transfer_id=$1")
.bind(id)
.execute(&mut *tx)
.await?;
audit(&mut tx, &p, "device_customer_transfer_completed", json!({
"transfer_id":id,"asset_id":asset,"agent_id":pair.agent_id,"target_tenant_id":t.target_tenant_id,
"target_asset_id":t.target_asset_id,"target_agent_id":t.target_agent_id
})).await?;
tx.commit().await?;
Ok(private_json(json!({"state":"completed"})))
}
@@ -443,8 +427,8 @@ async fn device_certificate(
.execute(&mut *tx)
.await?;
sqlx::query(
"INSERT INTO agent_installations(tenant_id,asset_id,agent_id,certificate_sha256,certificate_pem,connection_generation)
VALUES($1,$2,$3,$4,$5,$6)",
"INSERT INTO agent_installations(tenant_id,asset_id,agent_id,certificate_sha256,certificate_pem,connection_generation,customer_transfer_pending)
VALUES($1,$2,$3,$4,$5,$6,true)",
).bind(t.target_tenant_id).bind(new_asset).bind(new_agent)
.bind(hash(&certificate.to_der().map_err(anyhow::Error::from)?)).bind(&pem).bind(generation)
.execute(&mut *tx).await?;
+2
View File
@@ -25,6 +25,8 @@ WITH classified AS (
JOIN assets asset USING (tenant_id,asset_id)
JOIN tenants t USING(tenant_id)
WHERE a.tenant_id=$1 AND a.created_at<=$2 AND a.agent_id>$3
AND NOT a.customer_transfer_pending
AND (a.customer_transfer_activated_at IS NULL OR a.customer_transfer_activated_at<=$2)
AND ($4::uuid IS NULL OR a.asset_id=$4)
AND ($5::uuid IS NULL OR a.agent_id=$5)
)
+26 -2
View File
@@ -128,6 +128,7 @@ pub async fn list(
"device-fleet:{}",
rmm_domain::jobs::hash(binding.to_string().as_bytes())
);
let first_page = q.cursor.is_none();
let mut page = Cursor::parse(
s,
&p,
@@ -143,10 +144,15 @@ pub async fn list(
let mut last = None;
let mut truncated = false;
let mut authorized = false;
let mut principals = Vec::new();
for customer in tenants {
if page.last_tenant.is_some_and(|after| customer < after) {
continue;
}
if customer == p.tenant {
principals.push(p.clone());
continue;
}
let mut headers = h.clone();
headers.insert(
"x-rmm-tenant",
@@ -155,7 +161,25 @@ pub async fn list(
);
let current = crate::jobs::principal(s, &headers, false).await?;
crate::jobs::scope(&current, customer, false)?;
let mut tx = rmm_persistence::tenant_tx(&s.pool, customer).await?;
principals.push(current);
}
// Read all customers from the same snapshot so a transfer cannot appear
// under both customers if its cutover commits while listing the fleet.
let mut tx = s.pool.begin().await?;
sqlx::query("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
.execute(&mut *tx)
.await?;
if first_page {
page.as_of = sqlx::query_scalar("SELECT clock_timestamp()")
.fetch_one(&mut *tx)
.await?;
}
for current in principals {
let customer = current.tenant;
sqlx::query("SELECT set_config('app.tenant_id',$1,true)")
.bind(customer.to_string())
.execute(&mut *tx)
.await?;
match crate::permissions::require_principal(&mut tx, &current, "inventory:read").await {
Err(Error(StatusCode::FORBIDDEN, _)) if tenant.is_none() => continue,
other => other?,
@@ -179,7 +203,6 @@ pub async fn list(
.rows(&mut tx)
.await?;
let hosts = assigned_hosts(&mut tx, customer, page.as_of, &rows).await?;
tx.commit().await?;
for row in rows {
if items.len() == capacity {
truncated = true;
@@ -192,6 +215,7 @@ pub async fn list(
break;
}
}
tx.commit().await?;
if !authorized {
return Err(Error(StatusCode::FORBIDDEN, "FORBIDDEN"));
}
+2
View File
@@ -4,6 +4,8 @@ JOIN LATERAL (
SELECT a.agent_id, a.revoked_at
FROM agent_installations a
WHERE a.tenant_id=asset.tenant_id AND a.asset_id=asset.asset_id AND a.created_at<=$2
AND NOT a.customer_transfer_pending
AND (a.customer_transfer_activated_at IS NULL OR a.customer_transfer_activated_at<=$2)
AND a.last_authenticated_at IS NOT NULL AND a.last_contact_at IS NOT NULL
ORDER BY a.enrollment_generation DESC, a.created_at DESC, a.agent_id
LIMIT 1
+2 -2
View File
@@ -427,7 +427,7 @@ pub(crate) async fn plan_resolved(
let artifacts = crate::catalog::resolve_artifacts(&mut tx, tenant, &input.artifact_ids).await?;
let mut jobs = Vec::new();
for asset in ids {
let rows=sqlx::query("SELECT agent_id,enrollment_generation,assignment_version,capabilities FROM agent_installations WHERE asset_id=$1 AND revoked_at IS NULL AND NOT EXISTS (SELECT FROM device_customer_transfers t WHERE t.source_agent_id=agent_installations.agent_id AND t.completed_at IS NULL AND t.cancelled_at IS NULL) ORDER BY agent_id FOR SHARE").bind(asset).fetch_all(&mut *tx).await?;
let rows=sqlx::query("SELECT agent_id,enrollment_generation,assignment_version,capabilities FROM agent_installations WHERE asset_id=$1 AND revoked_at IS NULL AND NOT customer_transfer_pending AND NOT EXISTS (SELECT FROM device_customer_transfers t WHERE t.source_agent_id=agent_installations.agent_id AND t.completed_at IS NULL AND t.cancelled_at IS NULL) ORDER BY agent_id FOR SHARE").bind(asset).fetch_all(&mut *tx).await?;
if rows.len() != 1 {
return Err(fail(if rows.is_empty() {
"NOT_FOUND"
@@ -683,7 +683,7 @@ async fn recheck_for(
if job.payload.start_before <= Utc::now() {
return Err(fail("PLAN_EXPIRED"));
}
let r=sqlx::query("SELECT enrollment_generation,assignment_version,capabilities FROM agent_installations WHERE agent_id=$1 AND asset_id=$2 AND revoked_at IS NULL AND NOT EXISTS (SELECT FROM device_customer_transfers t WHERE t.source_agent_id=agent_installations.agent_id AND t.completed_at IS NULL AND t.cancelled_at IS NULL) FOR SHARE").bind(job.payload.agent_id).bind(job.payload.asset_id).fetch_optional(&mut **tx).await?.ok_or_else(||fail("AUTHORIZATION_REVOKED"))?;
let r=sqlx::query("SELECT enrollment_generation,assignment_version,capabilities FROM agent_installations WHERE agent_id=$1 AND asset_id=$2 AND revoked_at IS NULL AND NOT customer_transfer_pending AND NOT EXISTS (SELECT FROM device_customer_transfers t WHERE t.source_agent_id=agent_installations.agent_id AND t.completed_at IS NULL AND t.cancelled_at IS NULL) FOR SHARE").bind(job.payload.agent_id).bind(job.payload.asset_id).fetch_optional(&mut **tx).await?.ok_or_else(||fail("AUTHORIZATION_REVOKED"))?;
if r.get::<i64, _>("assignment_version") as u64 != job.payload.assignment_version
|| r.get::<i64, _>("enrollment_generation") as u64 != job.payload.enrollment_generation
{
+1 -1
View File
@@ -27,7 +27,7 @@ Alle acht Versuche lieferten Exitcode 0. Bei beiden Neustarts wurde die Wiederan
| Funktion | Beobachtung und Beleg |
| --- | --- |
| Öffentliche Verwaltung und Kundengrenzen | HTTPS-WebUI mit Passwort/TOTP, MCP mit widerrufbarem Token. Gerätebestand, Historie, eingeschränkter und kundenübergreifender Zugriff sowie Widerruf sind geprüft. [Öffentlicher Zugang](evidence/public-access-20261117.json) · [Kunden und Geräte](evidence/customer-fleet-20261117.json) |
| Kundenwechsel bestehender Geräte | Vormerken und abschließen unter „Gerät verwalten → Kunden wechseln“. Ein nativer Linux-Agent übernahm im isolierten TLS-/PostgreSQL-Test eine neue signierte Kopplung mit neuer Geräte- und Agent-ID. Ein Agentneustart mit der ursprünglichen Installationskonfiguration behielt die neue Kopplung bei. Die alte Kopplung blieb bis zur Bestätigung erhalten. Nach Abschluss sperrte das Gateway ihr Zertifikat, und die Historie war beim bisherigen Kunden weiterhin lesbar. Der Browser prüfte Zugangsbeschränkung, Status, Bestätigung und den Link zum Zielgerät in Mobilbreite. Beschränkte und globale Tokens wurden für Bestandslisten, direkte IDs und Widerruf geprüft. Ein nativer Windows-Test bestätigte die signierte Übernahme nach unterbrochener lokaler Zustandsumstellung und die Trennung der alten lokalen Daten. Die vollständige Windows-Feldabnahme eines Kundenwechsels steht aus. Revision `5253a9f` wurde am 18. November um 20:39 UTC mit Schema 42 bereitgestellt. Interne API, öffentliche API und Gateway bestanden ihre Healthchecks. Der öffentliche WebUI-Index entsprach dem Build. Die signierten Linux-Versionen `0.1.0-mvp.13` und `0.1.0-arm64.7` stammen aus derselben Revision. Windows `0.1.22` stammt aus `9e957e6` und enthält die zuvor veröffentlichte Korrektur der Helper-Zeitabfragen. Die drei Versionen sind Installer-Starter. Linux x64 und Windows sind zusätzlich im zweiten Entwicklungskatalog veröffentlicht. Um 20:46 UTC meldeten Linux x64, Linux ARM64 und Windows die neuen Versionen und die Fähigkeit zum Kundenwechsel bei denselben Geräte-IDs. Auf allen drei Geräten war die Zielkundenauswahl in der öffentlichen WebUI am Desktop und bei 390 px Breite bedienbar. In der produktiven Prüfung wurden null Wechsel vorgemerkt. [Ablauf](public-access.md#kunden-eines-bestehenden-geräts-wechseln) · [TLS-/Datenbanktest](../tests/customer_transfer.py) |
| Kundenwechsel bestehender Geräte | Vormerken und abschließen unter „Gerät verwalten → Kunden wechseln“. Ein nativer Linux-Agent übernahm im isolierten TLS-/PostgreSQL-Test eine neue signierte Kopplung mit neuer Geräte- und Agent-ID. Ein Agentneustart mit der ursprünglichen Installationskonfiguration behielt die neue Kopplung bei. Die alte Kopplung blieb bis zur Bestätigung erhalten. Nach Abschluss sperrte das Gateway ihr Zertifikat, und die Historie war beim bisherigen Kunden weiterhin lesbar. Der Browser prüfte Zugangsbeschränkung, Status, Bestätigung und den Link zum Zielgerät in Mobilbreite. Beschränkte und globale Tokens wurden für Bestandslisten, direkte IDs und Widerruf geprüft. Ein nativer Windows-Test bestätigte die signierte Übernahme nach unterbrochener lokaler Zustandsumstellung und die Trennung der alten lokalen Daten. Die vollständige Windows-Feldabnahme eines Kundenwechsels steht aus. Revision `5253a9f` wurde am 18. November um 20:39 UTC mit Schema 42 bereitgestellt. Interne API, öffentliche API und Gateway bestanden ihre Healthchecks. Der öffentliche WebUI-Index entsprach dem Build. Die signierten Linux-Versionen `0.1.0-mvp.13` und `0.1.0-arm64.7` stammen aus derselben Revision. Windows `0.1.22` stammt aus `9e957e6` und enthält die zuvor veröffentlichte Korrektur der Helper-Zeitabfragen. Die drei Versionen sind Installer-Starter. Linux x64 und Windows sind zusätzlich im zweiten Entwicklungskatalog veröffentlicht. Um 20:46 UTC meldeten Linux x64, Linux ARM64 und Windows die neuen Versionen und die Fähigkeit zum Kundenwechsel bei denselben Geräte-IDs. Auf allen drei Geräten war die Zielkundenauswahl in der öffentlichen WebUI am Desktop und bei 390 px Breite bedienbar. In der produktiven Prüfung wurden null Wechsel vorgemerkt. Der damalige Ablauf mit zweiter Bestätigung konnte zwei aktive Einträge erzeugen. Schema 44 schaltet mit der ersten gültigen Inventarmeldung atomar auf den Zielkunden um. Der Browser prüfte, dass nach dem Start keine zweite Aktion erforderlich ist. Ein isolierter Datenbanktest schloss einen bereits gemeldeten Wechsel ab und ließ einen Wechsel ohne Zielinventar offen. Der native Linux-Test bestätigte automatisch genau eine aktive Kopplung, den Widerruf des alten Zertifikats, die erhaltene Historie, den Neustart und die Rechteprüfung für beschränkte und globale Tokens. Revision `480e374` mit Schema 44 wurde am 18. November um 22:00 UTC bereitgestellt. API und Gateway meldeten gesunden Betrieb. Die produktive WebUI zeigte das betroffene Gerät genau einmal im Bestand des Zielkunden; die alte Kopplung blieb mit widerrufener Identität in der Historie des bisherigen Kunden. [Ablauf](public-access.md#kunden-eines-bestehenden-geräts-wechseln) · [TLS-/Datenbanktest](../tests/customer_transfer.py) |
| Erweitertes Inventar in den Gerätedetails | OS-Installationsdatum, letzter Neustart, Hersteller, BIOS-Seriennummer, verfügbares Garantieende, Netzwerkkarten mit IP-Adressen, durchsuchbare Software und angemeldete Benutzer. Beide Linux-Geräte melden den Zeitstempel des Root-Dateisystems als geschätztes Installationsdatum. Quelle `1f60183` wurde am 18. November um 19:23 UTC mit Serverhash `8a821863…` und Schema 41 aktiviert. Interne API, öffentliche API und Gateway wurden mit bestandenem Healthcheck gestartet. Der öffentliche WebUI-Index stimmte mit dem Build überein. 80 WebUI-Tests, 73 Linux- und Domänentests, 15 Bootstrap-Tests und zwei native Windows-Inventartests bestanden. Die vorhandene Windows-Kopplung meldet mit `0.1.19` neun Netzwerkkarten und drei systemweit registrierte Programme. Um 19:29 UTC meldete dieselbe Linux-x64-Kopplung nach dem regulären signierten Update auf `0.1.0-mvp.12` zwei Netzwerkkarten und alle 1.372 erfassten DEB-Pakete. Das Agent- und Helperpaar meldete sich bereit. Die Linux-Inventur holt durch ausstehende Meldungen verschobene Erfassungen nach. Die ARM64-Kopplung meldet mit `0.1.0-arm64.6` drei Netzwerkkarten und 893 DEB-Pakete. Beide Linux-Geräte melden ihre BIOS-Seriennummer. Der Windows-Gast meldet keine Seriennummer. Alle drei Geräte meldeten keine angemeldeten Benutzer und keine Garantiedaten. Für eine automatische Garantieabfrage fehlt eine Herstellerquelle. Die öffentliche WebUI zeigte die Details und fand jeweils einen tatsächlichen Softwareeintrag über die Suche auf dem Desktop und bei 390 px Breite. Die drei signierten Releases sind als Installer-Starter veröffentlicht. Linux x64 und Windows sind auch im Katalog von Development B veröffentlicht. [Geräteansicht](../web/src/device-inventory.tsx) · [Linux-Inventar](../crates/agent-linux/src/inventory.rs) · [Windows-Inventar](../crates/agent-windows/src/inventory.rs) |
| RAM und CPU-Auslastung in der Übersicht | RAM als verfügbar / gesamt in GiB mit demselben Belegungsbalken wie beim Speicherplatz. Die CPU-Spalte zeigt die letzte gemessene Auslastung in Prozent. Am 18. November wurde `6ed57c4` mit Schema 41 produktiv aktiviert. Beide TLS-Healthchecks und der öffentliche WebUI-Index stimmten mit dem Build überein. Die öffentliche Übersicht zeigte die RAM-Balken auf Desktop und bei 390 px Breite für alle drei Geräte. Die Detailansicht und die automatische Aktualisierung wurden in Chromium auf Linux x64 und ARM64 nachgelesen. OTRS meldete um 18:05 UTC nach dem signierten Wechsel auf `0.1.0-arm64.3` `6,2 / 7,6 GiB` und `1,1 %`. Um 18:06 UTC meldeten Linux x64 `0.1.0-mvp.9`, Windows `0.1.18` und ARM64 frische CPU-Werte und waren authentisiert erreichbar. [Geräteansicht](../web/src/devices.tsx) · [Geräteprojektion](../crates/server/src/devices.rs) |
| Gerätetyp in der Übersicht | Spalte „Type“ nach „Hostname“ mit `physical`, `virtual` und `hypervisor`. Erkannte Proxmox-VE-Hosts zeigen `Proxmox VE` als OS. Am 18. November wurde `c599baa` auf dem öffentlichen Server aktiviert. Der Serverrunner bestätigte API, Gateway und öffentlichen API-Dienst mit Binärhash `4f9c8c60…`. Der öffentliche WebUI-Index stimmte mit dem gebauten Bundle überein. Die unveränderten Geräteidentitäten meldeten nach regulärem signierten Update `virtual` auf Linux mit `0.1.0-mvp.7` um 16:45 UTC und Windows mit `0.1.17` um 16:47 UTC. Geräteliste, Details, Mobilansicht mit 390 px und Historie sind in der öffentlichen WebUI geprüft. Beide Pakete sind in Development A und B und als Starter für leere Kataloge veröffentlicht. Die Typen `physical` und `hypervisor` sind mit Testdaten geprüft. Die Feldabnahme auf einem physischen Gerät und einem Proxmox-VE-Host steht aus. [Inventarprojektion](../crates/server/src/devices.rs) · [Geräteansicht](../web/src/devices.tsx) |
+2 -2
View File
@@ -17,8 +17,8 @@ Bei einer VM mit dem gemeldeten Hersteller Hetzner erscheint ohne verfügbaren k
### Kunden eines bestehenden Geräts wechseln
1. In **Geräte** den Hostnamen öffnen und **Gerät verwalten → Kunden wechseln** wählen. Der Agent benötigt eine Version mit Unterstützung für den Kundenwechsel.
2. Den Zielkunden auswählen und **Kundenwechsel vormerken**. Hierfür braucht die angemeldete Person Geräteverwaltungsrechte beim bisherigen Kunden sowie Inventar- und Aufnahmerechte beim Zielkunden. Offene Aufträge und Genehmigungen vor dem Wechsel abschließen.
3. Sobald der Agent über seine bestehende Verbindung die neue Kopplung übernommen und Inventar gemeldet hat, zeigt die WebUI den Hostnamen beim Zielkunden. Den Wechsel bestätigen und **Kundenwechsel abschließen** wählen. Bei einem Offline-Gerät bleibt der Wechsel bis zum nächsten verfügbaren Kontakt vorgemerkt. Die Vormerkung kann vor der Zertifikatsausstellung abgebrochen werden.
2. Den Zielkunden auswählen und **Kundenwechsel starten**. Hierfür braucht die angemeldete Person Geräteverwaltungsrechte beim bisherigen Kunden sowie Inventar- und Aufnahmerechte beim Zielkunden. Offene Aufträge und Genehmigungen vor dem Wechsel abschließen.
3. Mit der ersten gültigen Inventarmeldung der neuen Kopplung wechselt der Eintrag automatisch in den Bestand des Zielkunden. Bei einem Offline-Gerät bleibt der Wechsel bis zum nächsten verfügbaren Kontakt vorgemerkt. Die Vormerkung kann vor der Zertifikatsausstellung abgebrochen werden.
Der gesamte Ablauf findet in der WebUI statt. Bisheriges Inventar und gespeicherte Aufträge stehen beim bisherigen Kunden in der Historie. Beim Zielkunden beginnen die Meldungen mit der neuen Kopplung. Gerätegebundene Administratorrechte sind an die jeweilige Kopplung gebunden und erfordern eine eigene Freigabe und Bindung.
@@ -0,0 +1,105 @@
ALTER TABLE agent_installations
ADD COLUMN customer_transfer_pending boolean NOT NULL DEFAULT false,
ADD COLUMN customer_transfer_activated_at timestamptz;
CREATE UNIQUE INDEX device_customer_transfers_target ON device_customer_transfers
(target_tenant_id,target_agent_id) WHERE target_agent_id IS NOT NULL;
-- The target has tenant-scoped access to its inventory. Only this function
-- can use that evidence to close the exact transfer in the source tenant.
CREATE FUNCTION finish_device_customer_transfer(target_tenant uuid, target_agent uuid)
RETURNS boolean
LANGUAGE plpgsql SECURITY DEFINER SET search_path = pg_catalog, public, pg_temp AS $$
DECLARE
move public.device_customer_transfers%ROWTYPE;
cutover timestamptz;
BEGIN
IF current_setting('app.tenant_id', true) IS DISTINCT FROM target_tenant::text THEN
RETURN false;
END IF;
SELECT t.* INTO move
FROM public.device_customer_transfers t
JOIN public.agent_installations a ON (a.tenant_id,a.asset_id,a.agent_id)
= (t.target_tenant_id,t.target_asset_id,t.target_agent_id)
WHERE t.target_tenant_id=target_tenant AND t.target_agent_id=target_agent
AND t.completed_at IS NULL AND t.cancelled_at IS NULL
AND a.customer_transfer_pending AND a.revoked_at IS NULL AND a.last_authenticated_at IS NOT NULL
AND EXISTS (
SELECT FROM public.observations o
WHERE (o.tenant_id,o.agent_id)=(a.tenant_id,a.agent_id)
AND o.received_at>=a.created_at AND o.quality='valid'
AND o.source_id IN ('linux.base','windows.base')
AND NULLIF(btrim(o.data->>'hostname'),'') IS NOT NULL
)
FOR UPDATE OF a,t;
IF NOT FOUND THEN
RETURN false;
END IF;
-- Serialize with source-side job planning and device controls. Pending
-- transfers already prevent new work from being submitted to the source.
PERFORM set_config('app.tenant_id',move.source_tenant_id::text,true);
PERFORM FROM public.agent_installations
WHERE (tenant_id,asset_id,agent_id)=(move.source_tenant_id,move.source_asset_id,move.source_agent_id)
FOR UPDATE;
IF EXISTS (
SELECT FROM public.jobs WHERE tenant_id=move.source_tenant_id AND agent_id=move.source_agent_id
AND state NOT IN ('succeeded','failed','cancelled','expired','closed_unknown')
) OR EXISTS (
SELECT FROM public.approval_requests r JOIN public.operation_plans p USING(tenant_id,plan_id)
WHERE r.tenant_id=move.source_tenant_id AND r.approval_state='pending_approval' AND p.expires_at>now()
AND convert_from(p.payload,'UTF8')::jsonb->'jobs'
@> jsonb_build_array(jsonb_build_object('payload',jsonb_build_object('agent_id',move.source_agent_id)))
) THEN
PERFORM set_config('app.tenant_id',target_tenant::text,true);
RETURN false;
END IF;
cutover := clock_timestamp();
UPDATE public.agent_installations
SET revoked_at=cutover, connection_generation=connection_generation+1,
previous_certificate_sha256=NULL, previous_certificate_until=NULL
WHERE (tenant_id,asset_id,agent_id)=(move.source_tenant_id,move.source_asset_id,move.source_agent_id)
AND revoked_at IS NULL;
UPDATE public.device_customer_transfers SET completed_at=cutover WHERE transfer_id=move.transfer_id;
INSERT INTO public.audit_events (tenant_id,event_id,principal,event_type,data)
VALUES (move.source_tenant_id,gen_random_uuid(),move.requested_by,'device_customer_transfer_completed',
jsonb_build_object('completion_origin','automatic_after_target_inventory','decision',
jsonb_build_object('transfer_id',move.transfer_id,'asset_id',move.source_asset_id,
'agent_id',move.source_agent_id,'target_tenant_id',move.target_tenant_id,
'target_asset_id',move.target_asset_id,'target_agent_id',move.target_agent_id)));
PERFORM set_config('app.tenant_id',target_tenant::text,true);
UPDATE public.agent_installations
SET customer_transfer_pending=false, customer_transfer_activated_at=cutover,
last_contact_at=COALESCE(last_contact_at,cutover)
WHERE (tenant_id,asset_id,agent_id)=(move.target_tenant_id,move.target_asset_id,move.target_agent_id);
RETURN true;
END;
$$;
REVOKE ALL ON FUNCTION finish_device_customer_transfer(uuid,uuid) FROM PUBLIC;
GRANT EXECUTE ON FUNCTION finish_device_customer_transfer(uuid,uuid) TO rmm_app;
-- Existing enrollments can already have proved their new identity under the
-- old workflow. Finish only transfers with that evidence and preserve history.
UPDATE agent_installations a SET customer_transfer_pending=true
FROM device_customer_transfers t
WHERE (a.tenant_id,a.asset_id,a.agent_id)=(t.target_tenant_id,t.target_asset_id,t.target_agent_id)
AND t.completed_at IS NULL AND t.cancelled_at IS NULL;
DO $$
DECLARE
destination record;
BEGIN
FOR destination IN SELECT target_tenant_id,target_agent_id FROM device_customer_transfers
WHERE target_agent_id IS NOT NULL AND completed_at IS NULL AND cancelled_at IS NULL
ORDER BY created_at,transfer_id
LOOP
PERFORM set_config('app.tenant_id',destination.target_tenant_id::text,true);
PERFORM finish_device_customer_transfer(destination.target_tenant_id,destination.target_agent_id);
END LOOP;
END;
$$;
+15 -17
View File
@@ -232,6 +232,7 @@ test('moves an existing pairing through the WebUI and waits for target inventory
target_asset_id: 'new-asset', target_agent_id: 'new-agent', target_hostname: 'NORD-PC' };
let state = '';
let canEnroll = false;
let posts = 0;
const listing = (items: unknown[]) => ({ items, next_cursor: null, truncated: false,
completeness: 'complete', as_of: new Date().toISOString() });
await page.route(origin + '/auth/config', r => r.fulfill({ json: {
@@ -257,14 +258,10 @@ test('moves an existing pairing through the WebUI and waits for target inventory
expect(req.headers()['x-csrf-token']).toBe('move-csrf');
expect(req.headers()['x-rmm-tenant']).toBe(source.tenant_id);
expect(url.searchParams.get('agent_id')).toBe(device.agent_id);
if (url.pathname === move) {
expect(req.postDataJSON()).toEqual({ target_tenant_id: target.tenant_id });
state = 'pending';
} else {
expect(url.pathname).toBe(move + '/move-fixture/complete');
expect(state).toBe('ready');
state = 'completed';
}
expect(url.pathname).toBe(move);
expect(req.postDataJSON()).toEqual({ target_tenant_id: target.tenant_id });
posts++;
state = 'pending';
return r.fulfill({ json: { state } });
}
return r.fulfill({ status: 404, json: { code: 'NOT_FOUND' } });
@@ -275,22 +272,23 @@ test('moves an existing pairing through the WebUI and waits for target inventory
await page.getByText('Kunden wechseln', { exact: true }).click();
await page.getByRole('combobox', { name: 'Zielkunde', exact: true }).selectOption(target.tenant_id);
await expect(page.getByText('Für diesen Zielkunden fehlt das Recht', { exact: false })).toBeVisible();
const prepare = page.getByRole('button', { name: 'Kundenwechsel vormerken' });
const prepare = page.getByRole('button', { name: 'Kundenwechsel starten' });
await expect(prepare).toBeDisabled();
await page.getByRole('combobox', { name: 'Zielkunde', exact: true }).selectOption('');
canEnroll = true;
await page.getByRole('combobox', { name: 'Zielkunde', exact: true }).selectOption(target.tenant_id);
await prepare.click();
await expect(page.getByText('Der Wechsel ist vorgemerkt.', { exact: false })).toBeVisible();
const finish = page.getByRole('button', { name: 'Kundenwechsel abschließen' });
await expect(finish).toHaveCount(0);
state = 'ready';
await expect(finish).toBeDisabled({ timeout: 10000 });
await page.getByRole('checkbox', { name: 'Ich bestätige den Kundenwechsel für dieses Gerät.' }).check();
await finish.click();
await expect(page.getByText('Kundenwechsel abgeschlossen.', { exact: false })).toBeVisible();
await expect(page.getByRole('link', { name: 'Neue Kopplung öffnen' })).toHaveAttribute('href',
const destination = page.getByRole('link', { name: 'Neue Kopplung öffnen' });
state = 'enrolled';
await expect(page.getByText('Der Wechsel wird mit der ersten Inventarmeldung', { exact: false }))
.toBeVisible({ timeout: 10000 });
await expect(destination).toHaveCount(0);
state = 'completed';
await expect(page.getByText('Kundenwechsel abgeschlossen.', { exact: false })).toBeVisible({ timeout: 10000 });
await expect(destination).toHaveAttribute('href',
'#geraete/' + target.tenant_id + '/new-asset/new-agent');
expect(posts).toBe(1);
});
test('shows real VM hosts and the Hetzner placeholder without adding a device', async ({ page }) => {
+50 -4
View File
@@ -20,6 +20,7 @@ import subprocess
import sys
import tempfile
import time
import urllib.parse
import uuid
from local_access_database import command
@@ -40,6 +41,27 @@ def until(probe, seconds=80):
raise AssertionError(f"Timed out waiting for {probe.__name__}")
def existing_transfer(sql, with_inventory):
"""Seed the state left by the old server before the extra confirmation."""
asset_a, asset_b, agent_a, agent_b, move = (uuid.uuid4() for _ in range(5))
sql(f"""INSERT INTO assets VALUES ('{A}','{asset_a}'),('{B}','{asset_b}');
INSERT INTO agent_installations
(tenant_id,asset_id,agent_id,certificate_sha256,last_contact_at,
last_authenticated_at,last_authenticated_certificate_sha256)
SELECT tenant::uuid,asset::uuid,agent::uuid,pin,now(),now(),pin
FROM (VALUES ('{A}','{asset_a}','{agent_a}','{secrets.token_hex(32)}'),
('{B}','{asset_b}','{agent_b}','{secrets.token_hex(32)}')) x(tenant,asset,agent,pin);
INSERT INTO device_customer_transfers (transfer_id,source_tenant_id,source_asset_id,source_agent_id,
target_tenant_id,target_asset_id,target_agent_id,requested_by,csr_sha256)
VALUES ('{move}','{A}','{asset_a}','{agent_a}','{B}','{asset_b}','{agent_b}','fixture',repeat('a',64));""")
if with_inventory:
sql(f"""INSERT INTO observations(tenant_id,agent_id,message_id,boot_id,sequence,
observed_at,source_id,quality,completeness,snapshot_id,data,payload_sha256)
VALUES ('{B}','{agent_b}',gen_random_uuid(),gen_random_uuid(),1,now(),'linux.base','valid',
'partial',gen_random_uuid(),'{{"hostname":"Legacy ready VM"}}',repeat('b',64));""")
return str(agent_a), str(asset_b), str(agent_b)
def run(server, agent, folder, db, api):
pg_password = secrets.token_hex(24)
command(["docker", "run", "-d", "--name", db, "-p", "127.0.0.1::5432",
@@ -58,6 +80,9 @@ def run(server, agent, folder, db, api):
ALTER DATABASE postgres OWNER TO rmm_migrator;
ALTER SCHEMA public OWNER TO rmm_migrator;""")
for migration in sorted((ROOT / "migrations").glob("*.sql")):
if migration.name.startswith("0044_"):
ready_source, ready_asset, ready_target = existing_transfer(sql, with_inventory=True)
waiting_source, waiting_asset, waiting_target = existing_transfer(sql, with_inventory=False)
sql(migration.read_text(), "rmm_migrator")
users, login_data = [], {}
@@ -149,6 +174,19 @@ def run(server, agent, folder, db, api):
return headers
owner, source_only, target_only = map(login, ("owner", "sourceonly", "targetonly"))
def fleet_ids(headers, hostname=None):
query = "" if hostname is None else "&q=" + urllib.parse.quote(hostname)
status, listing, _ = request("/api/v1/devices?view=current" + query, headers=headers)
assert status == 200, (status, listing)
return {row["agent_id"] for row in listing["items"]}
fleet = fleet_ids(owner)
assert {ready_target, waiting_source} <= fleet and {ready_source, waiting_target}.isdisjoint(fleet)
for asset, agent_id, expected in [(ready_asset, ready_target, 200), (waiting_asset, waiting_target, 404)]:
assert request(f"/api/v1/tenants/{B}/devices/{asset}?agent_id={agent_id}", headers=target_only)[0] == expected
print("PASS migration completes an existing reported transfer and hides an authenticated target without inventory")
token = secrets.token_hex(32)
token_path = folder / "enrollment"
token_path.write_text(token)
@@ -201,13 +239,15 @@ def run(server, agent, folder, db, api):
finally:
proc.send_signal(signal.SIGCONT)
def target_ready():
def target_completed():
status, dto, _ = request(transfer + query, headers=owner)
assert status == 200, (status, dto)
move = dto["transfer"]
return move if move["state"] == "ready" else None
ids = fleet_ids(owner, old["hostname"])
assert len(ids) == 1, ("fleet during transfer", ids)
return move if move["state"] == "completed" else None
moved = until(target_ready)
moved = until(target_completed)
assert moved["target_hostname"] == old["hostname"]
target_agent, target_asset = moved["target_agent_id"], moved["target_asset_id"]
assert target_agent != old_agent and target_asset != old_asset
@@ -215,11 +255,16 @@ def run(server, agent, folder, db, api):
assert local["agent_id"] == target_agent
assert not list(state.glob("customer-move-*-prior-journal.sqlite"))
assert proc.poll() is None
print("PASS the existing Linux process received a signed handoff and reported fresh target inventory")
assert target_agent in fleet_ids(owner) and old_agent not in fleet_ids(owner)
print("PASS fresh inventory from the running Linux process switches the sole active entry automatically")
route = suffix(moved["transfer_id"], "complete")
assert request(route, {}, owner)[0] == 200
assert request(route, {}, owner)[0] == 200
assert sql(f"""SELECT count(*) FROM audit_events
WHERE event_type='device_customer_transfer_completed'
AND data->'decision'->>'agent_id'='{old_agent}'
AND data->>'completion_origin'='automatic_after_target_inventory';""") == "1"
assert request("/agent/v1/customer-transfer", tls=old_context)[0] == 401
status, historic, _ = request(f"/api/v1/tenants/{A}/devices?view=history", headers=source_only)
assert status == 200 and any(x["agent_id"] == old_agent and x["lifecycle"] == "revoked" for x in historic["items"])
@@ -255,6 +300,7 @@ def run(server, agent, folder, db, api):
status, fleet, _ = request("/api/v1/devices?view=current", headers=bearer)
assert status == 200
assert (target_agent in {row["agent_id"] for row in fleet["items"]}) == (audience == "all")
assert all(row["agent_id"] != old_agent for row in fleet["items"])
destination = f"/api/v1/tenants/{B}/devices/{target_asset}?agent_id={target_agent}"
assert request(destination, headers={**bearer, "X-RMM-Tenant": B})[0] == (200 if audience == "all" else 404)
assert request(transfer + query, headers={**bearer, "X-RMM-Tenant": A})[0] == 403
+6 -19
View File
@@ -5,11 +5,10 @@ import { allowed } from './safety';
type Transfer = {
id: string;
state: 'pending' | 'enrolled' | 'ready' | 'completed';
state: 'pending' | 'enrolled' | 'completed';
tenant: string;
asset: string | null;
agent: string | null;
hostname: string | null;
};
function parseTransfer(value: unknown): Transfer | null {
@@ -17,14 +16,13 @@ function parseTransfer(value: unknown): Transfer | null {
const t = record(value);
const { transfer_id: id, target_tenant_id: tenant, state } = t;
if (typeof id !== 'string' || typeof tenant !== 'string' ||
(state !== 'pending' && state !== 'enrolled' && state !== 'ready' && state !== 'completed')) {
(state !== 'pending' && state !== 'enrolled' && state !== 'completed')) {
throw new Error('Der Server lieferte keinen gültigen Kundenwechsel.');
}
return {
id, tenant, state,
asset: typeof t.target_asset_id === 'string' ? t.target_asset_id : null,
agent: typeof t.target_agent_id === 'string' ? t.target_agent_id : null,
hostname: typeof t.target_hostname === 'string' ? t.target_hostname : null
agent: typeof t.target_agent_id === 'string' ? t.target_agent_id : null
};
}
@@ -35,7 +33,6 @@ function transferError(error: unknown) {
TRANSFER_ALREADY_PENDING: 'Für dieses Gerät ist bereits ein Kundenwechsel vorgemerkt.',
TRANSFER_ALREADY_STARTED: 'Der Agent übernimmt bereits die neue Kopplung.',
TRANSFER_AGENT_UPDATE_REQUIRED: 'Dieses Gerät benötigt eine Agentversion mit Kundenwechsel.',
TRANSFER_TARGET_NOT_READY: 'Warten Sie auf die erste Inventarmeldung beim Zielkunden.',
TRANSFER_SOURCE_INACTIVE: 'Diese Kopplung ist im bisherigen Kunden nicht mehr aktiv.',
FORBIDDEN: 'Für den Kundenwechsel fehlen Rechte beim bisherigen Kunden oder beim Zielkunden.',
NOT_FOUND: 'Das Gerät oder der Zielkunde ist für diese Sitzung nicht verfügbar.'
@@ -56,7 +53,6 @@ export function DeviceCustomerTransfer({ auth, customer, asset, agent, customers
}) {
const [expanded, setExpanded] = useState(false);
const [target, setTarget] = useState('');
const [confirmed, setConfirmed] = useState(false);
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const base = tenantPath(customer, '/devices/' + encodeURIComponent(asset) + '/customer-transfer');
@@ -80,7 +76,6 @@ export function DeviceCustomerTransfer({ auth, customer, asset, agent, customers
setError(null);
try {
await request(base + suffix + query, { csrf: auth.csrf_token, tenantId: customer, body });
setConfirmed(false);
status.reload();
} catch (e) {
setError(transferError(e));
@@ -99,17 +94,9 @@ export function DeviceCustomerTransfer({ auth, customer, asset, agent, customers
<button disabled={busy} className="quiet"
onClick={() => void submit('/' + encodeURIComponent(current.id) + '/cancel', {})}>Vormerkung abbrechen</button>
</>}
{current.state === 'enrolled' && <p role="status">Die neue Kopplung wartet auf ihre erste Inventarmeldung.</p>}
{current.state === 'ready' && <>
<p role="status"><strong>{current.hostname}</strong> hat sich beim Zielkunden gemeldet.</p>
<label className="check"><input type="checkbox" checked={confirmed} onChange={e => setConfirmed(e.target.checked)} />
Ich bestätige den Kundenwechsel für dieses Gerät.
</label>
<button className="primary" disabled={busy || !confirmed}
onClick={() => void submit('/' + encodeURIComponent(current.id) + '/complete', {})}>Kundenwechsel abschließen</button>
</>}
{current.state === 'enrolled' && <p role="status">Der Wechsel wird mit der ersten Inventarmeldung beim Zielkunden abgeschlossen.</p>}
{current.state === 'completed' && <p role="status">Kundenwechsel abgeschlossen. Die frühere Kopplung steht in der Historie.</p>}
{current.asset && current.agent && ['ready', 'completed'].includes(current.state) &&
{current.asset && current.agent && current.state === 'completed' &&
<a href={'#geraete/' + [current.tenant, current.asset, current.agent].map(encodeURIComponent).join('/')}>
Neue Kopplung öffnen
</a>}
@@ -126,7 +113,7 @@ export function DeviceCustomerTransfer({ auth, customer, asset, agent, customers
</select></label>
{target && (destination.error || destination.data && !canEnroll) &&
<p>Für diesen Zielkunden fehlt das Recht zur Geräteaufnahme oder zum Lesen des Inventars.</p>}
<button className="primary" disabled={busy || !canEnroll}>Kundenwechsel vormerken</button>
<button className="primary" disabled={busy || !canEnroll}>Kundenwechsel starten</button>
</form>
</> : <p>Für diese Sitzung ist kein weiterer Kunde verfügbar.</p>
: <p>Der Agent benötigt ein Update für den Kundenwechsel.</p>