Agent-API
Der Codemeta-OS-RMM-Agent läuft auf Endpoint-Geräten (Workstations, Server) und kommuniziert über die Agent-API. Auth ist ein Agent-API-Key, der beim Enrollment generiert wird; Mandant und Asset ergeben sich aus diesem Key.
Alle Endpoints leben unter /api/v1/agent/....
Enrollment
Drei Methoden, ein Asset-API-Key für jeden Agent:
| Methode | Endpoint | Hinweis |
|---|---|---|
| Auto-Enroll | POST /api/v1/agent/enroll/auto | Mit Domain-/Hostname-Match |
| QR-Enroll | POST /api/v1/agent/enroll/qr | One-Time-Token aus QR-Code |
| Key-Enroll | POST /api/v1/agent/enroll/key | Pre-shared Bootstrap-Key |
Erfolgreich = {"agentId":"…","apiKey":"…","tenantId":"…","assetId":"…"}.
Den apiKey schicken Sie als Authorization: Bearer <key> an alle weiteren
Calls.
Operationen nach Enrollment
| Operation | Hinweis |
|---|---|
POST /api/v1/agent/events | Telemetrie-Batch hochladen |
GET /api/v1/agent/config | Aktuelle Konfiguration ziehen |
POST /api/v1/agent/tasks/<id>/result | Task-Ergebnis melden |
POST /api/v1/agent/heartbeat | Liveness-Signal |
Telemetrie-Modell
Pro Agent fließen Samples in regelmäßigem Intervall (CPU, RAM, Disk, Netzwerk-IO, Service-Status). Die Daten werden in einer Time-Series-Sicht aggregiert und stehen über die Analytics-Endpoints zur Verfügung.
Aktuell sind die Endpoints noch in Implementierung; Details zum endgültigen Datenmodell folgen mit dem Release des RMM-Moduls.
Verwandt
- Assets & Inventur — Agent gehört zu einem Asset
- Auth-Scopes