Intégrations

Proxmox VE

Créer un API token limité et superviser un nœud, une VM ou un LXC.

NasDash appelle l'API HTTPS Proxmox sur le port 8006. Il construit l'en-tête d'autorisation à partir du Token ID et du Token Secret saisis séparément.

Créer le token

Un utilisateur dédié en lecture seule et son propre jeton, avec la séparation des privilèges (Privilege Separation) laissée active. Le jeton n’a alors que les permissions qu’on lui donne, jamais plus que son utilisateur. Dans Proxmox VE, sous Datacenter → Permissions :

  1. Users → Add : un utilisateur comme nasdash dans le domaine pve (pas de mot de passe nécessaire pour l’API).
  2. Add → User Permission : chemin /, cet utilisateur, rôle PVEAuditor, Propagate activé.
  3. API Tokens → Add : cet utilisateur, Token ID monitoring, Privilege Separation cochée. Copiez le secret tout de suite : il n’est affiché qu’une fois.
  4. Add → API Token Permission : chemin /, le jeton nasdash@pve!monitoring, rôle PVEAuditor, Propagate activé.

PVEAuditor est en lecture seule et comprend Sys.Audit, VM.Audit et Datastore.Audit. Pour restreindre la portée, donnez les deux permissions sur /nodes/<node> et les /vms/<vmid> à surveiller plutôt que sur /. La même chose depuis le shell d’un nœud :

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 PVEAuditor

L’étape 4 est la plus souvent oubliée : un jeton avec séparation des privilèges et sans permission propre ne lit rien, même si son utilisateur le peut (l’API répond alors 403). Décocher Privilege Separation fonctionne aussi, mais le jeton porte alors tous les droits de son utilisateur ; préférez la permission du jeton. Les jetons sont décrits dans le guide d’administration de Proxmox VE.

Champs NasDash

Dans Paramètres → Intégrations, saisissez l’hôte, par exemple pve.example.com, sans protocole, port ni chemin d’API. Saisissez séparément 8006 dans Port, l’identifiant complet tel que nasdash@pve!monitoring dans Token ID, et son secret dans Token Secret. NasDash ajoute HTTPS et le chemin d’API. Ajoutez ensuite une machine et sélectionnez la connexion, le nom exact du nœud et, si nécessaire, l’ID VM/LXC et le type qemu ou lxc.

Le stockage du nœud est lu si le jeton l’autorise. 401/403 indiquent identifiants ou permissions ; délais/refus sont retentés. Pour un certificat local autosigné, activez explicitement Accepter les certificats autosignés sur cette connexion. Sinon, la validation TLS normale s’applique. Ne la désactivez pas globalement.

La détection fonctionne mais la machine est hors ligne

Tester et lister les machines vérifie la détection, pas les droits de lecture des mesures de chaque machine. Proxmox peut renvoyer un nœud online via /nodes et refuser /nodes/<node>/status avec 403. Dans l’éditeur de l’appareil, choisissez la machine puis Tester les mesures pour lire les mêmes mesures que le widget.

Vérifiez les permissions effectives dans Proxmox, sous Datacenter → Permissions :

  • CPU, RAM et durée de fonctionnement du nœud : Sys.Audit sur /nodes/<node>.
  • Mesures d’une VM ou d’un LXC : VM.Audit sur /vms/<vmid>.
  • Statistiques de stockage facultatives : Datastore.Audit sur chaque /storage/<storage-id> nécessaire. Un refus du stockage n’empêche pas le chargement du CPU, de la RAM ou de la durée de fonctionnement.

Avec Privilege Separation activé, attribuez les droits de lecture nécessaires à l’utilisateur (ou à son groupe) et au jeton API, sur les chemins appropriés. Les droits effectifs du jeton sont l’intersection de ces permissions. Conservez la séparation des privilèges ; les droits d’administration ou d’écriture ne sont pas nécessaires. Recréer un jeton ne lui accorde pas les permissions manquantes.

401 indique un problème d’authentification ; 403 signifie que l’API refuse l’accès à la ressource demandée et peut survenir sans échec de connexion dans les journaux. Retestez le nœud ou la VM/LXC choisi après avoir modifié ses permissions. NasDash réessaie automatiquement la supervision. Un 403 seul ne démontre pas une incompatibilité avec une version de Proxmox.

L’API standard de statut Proxmox fournit CPU, RAM, stockage et durée de fonctionnement selon les données disponibles. Elle ne fournit pas les températures CPU/GPU ni l’utilisation GPU à cette intégration ; utilisez une source de capteurs prise en charge, telle que Glances, pour ces mesures.