Jens/LumaOps-Public
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Publish LumaOps source

Browse Source
This commit is contained in:
LumaOps release export
2026-09-03 01:18:36 +02:00
commit 7f1c0e5f71
2363 changed files with 501543 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/REMOTE_AGENT_DESIGN.md
+19
View File
@@ -0,0 +1,19 @@
# Ontwerp voor LumaOps Agent
Het MVP bevat geen agent. Een handmatig remote OpenRGB SDK-endpoint past later in de connectorlaag, maar het kale SDK-protocol hoort nooit over internet: het biedt geen TLS, authenticatie of autorisatie.
De geplande agent draait op Windows of Linux naast een lokale OpenRGB-instance. Hij maakt zelf een uitgaande TLS-verbinding naar de hub, gebruikt een afzonderlijk revocable token, rapporteert genormaliseerde inventory/health en accepteert alleen schema-gevalideerde opdrachten. De hub bewaart geen OS- of OpenRGB-beheerderswachtwoorden.
Vereiste eigenschappen:
- device-bound identiteit en tokenrotatie;
- TLS met certificate validation en optionele pinning;
- command-idempotency, sequence numbers en deadlines;
- lokale allowlist, rate limiter en kill switch;
- offline veilige toestand en begrensde reconnect-backoff;
- audit aan agent- en hubzijde;
- geen inkomende luisterpoort op de remote host;
- versie/capability negotiation voor rolling upgrades.
Datamodel: agent, agent_connection, connector_instance en device_identity blijven afzonderlijk. Apparaten behouden hun interne UUID wanneer een agent reconnect of controllerindices wijzigen. Compromittering van één token mag geen andere agent of centrale beheerrechten ontsluiten.