* [pve-devel] [PATCH docs 1/2] pveum: add missing roles and privileges
@ 2023-07-10 15:10 Max Carrara
2023-07-10 15:10 ` [pve-devel] [PATCH docs 2/2] pveum: sort roles and privileges alphabetically Max Carrara
2023-07-17 14:11 ` [pve-devel] applied: [PATCH docs 1/2] pveum: add missing roles and privileges Thomas Lamprecht
0 siblings, 2 replies; 3+ messages in thread
From: Max Carrara @ 2023-07-10 15:10 UTC (permalink / raw)
To: pve-devel
Signed-off-by: Max Carrara <m.carrara@proxmox.com>
---
pveum.adoc | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/pveum.adoc b/pveum.adoc
index 3f6c997..6a806ef 100644
--- a/pveum.adoc
+++ b/pveum.adoc
@@ -772,7 +772,10 @@ of predefined roles, which satisfy most requirements.
* `PVEAuditor`: has read only access
* `PVEDatastoreAdmin`: create and allocate backup space and templates
* `PVEDatastoreUser`: allocate backup space and view storage
+* `PVEMappingAdmin`: manage resource mappings
+* `PVEMappingUser`: view and use resource mappings
* `PVEPoolAdmin`: allocate pools
+* `PVEPoolUser`: view pools
* `PVESysAdmin`: audit, system console and system logs
* `PVETemplateUser`: view and clone templates
* `PVEUserAdmin`: manage users
@@ -828,6 +831,9 @@ Node / System related privileges::
* `User.Modify`: create/modify/remove user access and details.
* `SDN.Allocate`: manage SDN configuration
* `SDN.Audit`: view SDN configuration
+* `Mapping.Modify`: manage resource mappings
+* `Mapping.Audit`: view resource mappings
+* `Mapping.Use`: use resource mappings
Virtual machine related privileges::
@@ -848,6 +854,7 @@ Virtual machine related privileges::
* `VM.Config.Options`: modify any other VM configuration
* `VM.Config.Cloudinit`: modify Cloud-init parameters
* `VM.Snapshot`: create/delete VM snapshots
+* `VM.Snapshot.Rollback`: rollback VM to one of its snapshots
* `SDN.Use`: access SDN vnets and local network bridges
Storage related privileges::
--
2.39.2
^ permalink raw reply [flat|nested] 3+ messages in thread
* [pve-devel] [PATCH docs 2/2] pveum: sort roles and privileges alphabetically
2023-07-10 15:10 [pve-devel] [PATCH docs 1/2] pveum: add missing roles and privileges Max Carrara
@ 2023-07-10 15:10 ` Max Carrara
2023-07-17 14:11 ` [pve-devel] applied: [PATCH docs 1/2] pveum: add missing roles and privileges Thomas Lamprecht
1 sibling, 0 replies; 3+ messages in thread
From: Max Carrara @ 2023-07-10 15:10 UTC (permalink / raw)
To: pve-devel
Signed-off-by: Max Carrara <m.carrara@proxmox.com>
---
NOTE: Thought it would make these two little sections a little more
readable if their list items were sorted alphabetically; if that's not
desired, then this commit can be dropped.
pveum.adoc | 48 ++++++++++++++++++++++++------------------------
1 file changed, 24 insertions(+), 24 deletions(-)
diff --git a/pveum.adoc b/pveum.adoc
index 6a806ef..3ff7f43 100644
--- a/pveum.adoc
+++ b/pveum.adoc
@@ -776,13 +776,13 @@ of predefined roles, which satisfy most requirements.
* `PVEMappingUser`: view and use resource mappings
* `PVEPoolAdmin`: allocate pools
* `PVEPoolUser`: view pools
+* `PVESDNAdmin`: manage SDN configuration
+* `PVESDNUser`: access to bridges/vnets
* `PVESysAdmin`: audit, system console and system logs
* `PVETemplateUser`: view and clone templates
* `PVEUserAdmin`: manage users
* `PVEVMAdmin`: fully administer VMs
* `PVEVMUser`: view, backup, configure CD-ROM, VM console, VM power management
-* `PVESDNAdmin`: manage SDN configuration
-* `PVESDNUser`: access to bridges/vnets
You can see the whole set of predefined roles in the GUI.
@@ -816,46 +816,46 @@ We currently support the following privileges:
Node / System related privileges::
-* `Permissions.Modify`: modify access permissions
-* `Sys.PowerMgmt`: node power management (start, stop, reset, shutdown, ...)
-* `Sys.Console`: console access to node
-* `Sys.Syslog`: view syslog
-* `Sys.Audit`: view node status/config, Corosync cluster config, and HA config
-* `Sys.Modify`: create/modify/remove node network parameters
-* `Sys.Incoming`: allow incoming data streams from other clusters (experimental)
* `Group.Allocate`: create/modify/remove groups
+* `Mapping.Audit`: view resource mappings
+* `Mapping.Modify`: manage resource mappings
+* `Mapping.Use`: use resource mappings
+* `Permissions.Modify`: modify access permissions
* `Pool.Allocate`: create/modify/remove a pool
* `Pool.Audit`: view a pool
-* `Realm.Allocate`: create/modify/remove authentication realms
* `Realm.AllocateUser`: assign user to a realm
-* `User.Modify`: create/modify/remove user access and details.
+* `Realm.Allocate`: create/modify/remove authentication realms
* `SDN.Allocate`: manage SDN configuration
* `SDN.Audit`: view SDN configuration
-* `Mapping.Modify`: manage resource mappings
-* `Mapping.Audit`: view resource mappings
-* `Mapping.Use`: use resource mappings
+* `Sys.Audit`: view node status/config, Corosync cluster config, and HA config
+* `Sys.Console`: console access to node
+* `Sys.Incoming`: allow incoming data streams from other clusters (experimental)
+* `Sys.Modify`: create/modify/remove node network parameters
+* `Sys.PowerMgmt`: node power management (start, stop, reset, shutdown, ...)
+* `Sys.Syslog`: view syslog
+* `User.Modify`: create/modify/remove user access and details.
Virtual machine related privileges::
+* `SDN.Use`: access SDN vnets and local network bridges
* `VM.Allocate`: create/remove VM on a server
-* `VM.Migrate`: migrate VM to alternate server on cluster
-* `VM.PowerMgmt`: power management (start, stop, reset, shutdown, ...)
-* `VM.Console`: console access to VM
-* `VM.Monitor`: access to VM monitor (kvm)
-* `VM.Backup`: backup/restore VMs
* `VM.Audit`: view VM config
+* `VM.Backup`: backup/restore VMs
* `VM.Clone`: clone/copy a VM
-* `VM.Config.Disk`: add/modify/remove disks
* `VM.Config.CDROM`: eject/change CD-ROM
* `VM.Config.CPU`: modify CPU settings
+* `VM.Config.Cloudinit`: modify Cloud-init parameters
+* `VM.Config.Disk`: add/modify/remove disks
+* `VM.Config.HWType`: modify emulated hardware types
* `VM.Config.Memory`: modify memory settings
* `VM.Config.Network`: add/modify/remove network devices
-* `VM.Config.HWType`: modify emulated hardware types
* `VM.Config.Options`: modify any other VM configuration
-* `VM.Config.Cloudinit`: modify Cloud-init parameters
-* `VM.Snapshot`: create/delete VM snapshots
+* `VM.Console`: console access to VM
+* `VM.Migrate`: migrate VM to alternate server on cluster
+* `VM.Monitor`: access to VM monitor (kvm)
+* `VM.PowerMgmt`: power management (start, stop, reset, shutdown, ...)
* `VM.Snapshot.Rollback`: rollback VM to one of its snapshots
-* `SDN.Use`: access SDN vnets and local network bridges
+* `VM.Snapshot`: create/delete VM snapshots
Storage related privileges::
--
2.39.2
^ permalink raw reply [flat|nested] 3+ messages in thread
* [pve-devel] applied: [PATCH docs 1/2] pveum: add missing roles and privileges
2023-07-10 15:10 [pve-devel] [PATCH docs 1/2] pveum: add missing roles and privileges Max Carrara
2023-07-10 15:10 ` [pve-devel] [PATCH docs 2/2] pveum: sort roles and privileges alphabetically Max Carrara
@ 2023-07-17 14:11 ` Thomas Lamprecht
1 sibling, 0 replies; 3+ messages in thread
From: Thomas Lamprecht @ 2023-07-17 14:11 UTC (permalink / raw)
To: Proxmox VE development discussion, Max Carrara
Am 10/07/2023 um 17:10 schrieb Max Carrara:
> Signed-off-by: Max Carrara <m.carrara@proxmox.com>
> ---
> pveum.adoc | 7 +++++++
> 1 file changed, 7 insertions(+)
>
>
The grouping is a bit odd for a few points, like SDN.Use and Mapping.Use are
roughly about the same thing, but one is at guest level the other at node level.
This might profit from further rework and _maybe_ expansion of categories to
group into, but for now having those privs documented is worth something, so:
applied both patches, thanks!
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-07-17 14:11 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-07-10 15:10 [pve-devel] [PATCH docs 1/2] pveum: add missing roles and privileges Max Carrara
2023-07-10 15:10 ` [pve-devel] [PATCH docs 2/2] pveum: sort roles and privileges alphabetically Max Carrara
2023-07-17 14:11 ` [pve-devel] applied: [PATCH docs 1/2] pveum: add missing roles and privileges Thomas Lamprecht
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox