Proxmox VE
Erstellen eines API-Tokens mit eingeschränkten Rechten und Überwachung eines Nodes, einer VM oder eines LXC.
NasDash ruft die Proxmox-HTTPS-API auf dem Port 8006 auf. Der Autorisierungs-Header wird aus der Token-ID und dem Token-Secret erstellt, die separat eingegeben werden.
Token erstellen
Ein eigener Benutzer mit Lesezugriff und ein eigenes Token, mit aktiver Privilegientrennung (Privilege Separation). Das Token hat dann nur die ihm gegebenen Berechtigungen, nie mehr als sein Benutzer. In Proxmox VE unter Datacenter → Permissions:
- Users → Add: ein Benutzer wie
nasdashim Realmpve(für die API ist kein Passwort nötig). - Add → User Permission: Pfad
/, dieser Benutzer, RollePVEAuditor, Propagate an. - API Tokens → Add: dieser Benutzer, Token ID
monitoring, Privilege Separation angehakt. Kopieren Sie das Geheimnis sofort: Es wird nur einmal angezeigt. - Add → API Token Permission: Pfad
/, das Tokennasdash@pve!monitoring, RollePVEAuditor, Propagate an.
PVEAuditor ist schreibgeschützt und umfasst Sys.Audit, VM.Audit und Datastore.Audit. Um den Bereich einzuschränken, vergeben Sie beide Berechtigungen auf /nodes/<node> und die zu überwachenden /vms/<vmid> statt auf /. Dasselbe in der Shell eines Knotens:
pveum user add nasdash@pve
pveum acl modify / --users nasdash@pve --roles PVEAuditor
pveum user token add nasdash@pve monitoring --privsep 1
pveum acl modify / --tokens 'nasdash@pve!monitoring' --roles PVEAuditorSchritt 4 wird am häufigsten vergessen: Ein Token mit Privilegientrennung ohne eigene Berechtigung liest nichts, selbst wenn sein Benutzer es dürfte (die API antwortet dann mit 403). Privilege Separation abzuwählen funktioniert auch, das Token trägt dann aber alle Rechte seines Benutzers; die Token-Berechtigung ist vorzuziehen. Tokens beschreibt das Administrationshandbuch von Proxmox VE.
NasDash-Felder
Geben Sie unter Einstellungen → Integrationen den Host ein, etwa pve.example.com, ohne Protokoll, Port oder API-Pfad. Tragen Sie 8006 getrennt unter Port, die vollständige Kennung wie nasdash@pve!monitoring unter Token ID und das Geheimnis unter Token Secret ein. NasDash ergänzt HTTPS und den API-Pfad. Fügen Sie dann eine Maschine hinzu und wählen Sie Verbindung, genauen Knotennamen und gegebenenfalls VM/LXC-ID und Typ qemu oder lxc.
Knotenspeicher wird bei erlaubtem Token gelesen. 401/403 bedeuten Zugangsdaten-/Rechtefehler; Timeouts/Ablehnungen werden wiederholt. Aktivieren Sie für lokale selbstsignierte Zertifikate ausdrücklich Selbstsignierte Zertifikate akzeptieren für diese Verbindung. Sonst gilt normale TLS-Prüfung. Deaktivieren Sie sie nicht global.
Erkennung funktioniert, aber die Maschine erscheint offline
Testen und Maschinen auflisten prüft die Erkennung, nicht den Zugriff auf die Messwerte jeder Maschine. Proxmox kann einen Knoten über /nodes als online melden und /nodes/<node>/status mit 403 ablehnen. Wählen Sie im Geräteeditor die Maschine und verwenden Sie Messwerte testen, um dieselben Messwerte wie das Widget abzurufen.
Prüfen Sie die effektiven Berechtigungen in Proxmox unter Datacenter → Berechtigungen:
- CPU, RAM und Laufzeit des Knotens:
Sys.Auditauf/nodes/<node>. - Messwerte einer VM oder eines LXC:
VM.Auditauf/vms/<vmid>. - Optionale Speicherstatistiken:
Datastore.Auditauf jedem benötigten/storage/<storage-id>. Ein verweigerter Speicherzugriff verhindert nicht das Laden von CPU, RAM oder Laufzeit.
Bei aktivierter Privilege Separation benötigen sowohl der Benutzer (oder seine Gruppe) als auch das API-Token die erforderlichen Leserechte auf den passenden Pfaden. Der effektive Zugriff des Tokens ist die Schnittmenge dieser Berechtigungen. Lassen Sie die Privilegientrennung aktiviert; Administrator- oder Schreibrechte sind unnötig. Ein neues Token erhält fehlende Rechte nicht automatisch.
401 weist auf ein Authentifizierungsproblem hin; 403 bedeutet, dass die API den Zugriff auf die angeforderte Ressource verweigert, auch ohne fehlgeschlagene Anmeldung im Protokoll. Testen Sie den gewählten Knoten oder Gast nach der Rechteänderung erneut. NasDash wiederholt die Überwachung automatisch. Ein 403 allein belegt keine Inkompatibilität mit einer Proxmox-Version.
Die standardmäßige Proxmox-Status-API liefert CPU, RAM, Speicher und Laufzeit, soweit verfügbar. CPU/GPU-Temperaturen oder GPU-Auslastung liefert sie dieser Integration nicht; verwenden Sie dafür eine unterstützte Sensorquelle wie Glances.