Skip to content

[BUG] - Proxmox app: Specific API Permissions needed #814

@chris400

Description

@chris400

Describe the bug
The documentation suggest only one permission currently:
Requires at least Sys.Audit permission for /nodes path (and propagated).
This will give you information about the node itself (CPU, RAM), but VMs/LXCs.

To Reproduce
Steps to reproduce the behavior:

  1. Set up API Permission with SysAudit on /nodes in Proxmox
  2. Test App in Heimdall
  3. It just displays CPU and RAM
  4. VM and LXC is just "0/0"

Expected behavior
I would expect

  1. Documentation mentioning the needed credentials
  2. The app not showing "0/0" per VMs and LXCs if the permissions are not right.

Screenshots
If permissions are missing:
Image

If permissions are right:
Image

Version info (please complete the following information):

  • Heimdall: 2.6.3
  • App: Proxmox
  • Version of remote application App tries to use: 8.3.3

Additional context
The API Token needs the following permissions:

  1. Sys.Audit on /nodes
  2. VM.Audit on /vms

This can be achieved with either the builtin role "PVEAuditor" or a custom role
See

  1. https://pve.proxmox.com/pve-docs/api-viewer/index.html#/nodes/{node}/status
    Required Permissions: Check: ["perm","/nodes/{node}",["Sys.Audit"]]
  2. https://pve.proxmox.com/pve-docs/api-viewer/index.html#/nodes/{node}/qemu.
    Required Permissions: Only list VMs where you have VM.Audit permissions on /vms/
  3. https://pve.proxmox.com/pve-docs/api-viewer/index.html#/nodes/{node}/lxc
    Required Permissions: Only list CTs where you have VM.Audit permission on /vms/.

While you could simple untick "Privilege Separation" when creating the API, it would inherit all the users permission. E.g. if you are using the root user, that API would be allowed to do everything on the PVE cluster.

https://pve.proxmox.com/pve-docs/chapter-pveum.html#pveum_tokens

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions