mirror of
git://git.proxmox.com/git/pve-docs.git
synced 2025-02-16 09:57:30 +03:00
Reorder users and groups section above realms section.
You now first read about users, learning the fact that they're part of groups and realms, which are described afterwards. This seems more natural then starting with realms and then describing users in a "Terms and Definitions" section.
This commit is contained in:
parent
5462c16110
commit
c80b9ee6b4
72
pveum.adoc
72
pveum.adoc
@ -35,6 +35,45 @@ By using the role based user- and permission management for all
|
||||
objects (VMs, storages, nodes, etc.) granular access can be defined.
|
||||
|
||||
|
||||
Users
|
||||
-----
|
||||
|
||||
{pve} stores user attributes in `/etc/pve/user.cfg`.
|
||||
Passwords are not stored here, users are instead associated with
|
||||
<<authentication-realms,authentication realms>> described below.
|
||||
Therefore a user is internally often identified by its name and
|
||||
realm in the form `<userid>@<realm>`.
|
||||
|
||||
Each user entry in this file contains the following information:
|
||||
|
||||
* First name
|
||||
* Last name
|
||||
* E-mail address
|
||||
* Group memberships
|
||||
* An optional Expiration date
|
||||
* A comment or note about this user
|
||||
* Whether this user is enabled or disabled
|
||||
* Optional two factor authentication keys
|
||||
|
||||
|
||||
System administrator
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The system's root user can always log in via the Linux PAM realm and is an
|
||||
unconfined administrator. This user cannot be deleted, but attributes can
|
||||
still be changed and system mails will be sent to the email address
|
||||
assigned to this user.
|
||||
|
||||
|
||||
Groups
|
||||
~~~~~~
|
||||
|
||||
Each user can be member of several groups. Groups are the preferred
|
||||
way to organize access permissions. You should always grant permission
|
||||
to groups instead of using individual users. That way you will get a
|
||||
much shorter access control list which is easier to handle.
|
||||
|
||||
|
||||
[[authentication-realms]]
|
||||
Authentication Realms
|
||||
---------------------
|
||||
@ -148,39 +187,6 @@ Terms and Definitions
|
||||
---------------------
|
||||
|
||||
|
||||
Users
|
||||
~~~~~
|
||||
|
||||
A Proxmox VE user name consists of two parts: `<userid>@<realm>`. The
|
||||
login screen on the GUI shows them a separate items, but it is
|
||||
internally used as single string.
|
||||
|
||||
We store the following attribute for users (`/etc/pve/user.cfg`):
|
||||
|
||||
* first name
|
||||
* last name
|
||||
* email address
|
||||
* expiration date
|
||||
* flag to enable/disable account
|
||||
* comment
|
||||
|
||||
|
||||
Superuser
|
||||
^^^^^^^^^
|
||||
|
||||
The traditional unix superuser account is called `root@pam`. All
|
||||
system mails are forwarded to the email assigned to that account.
|
||||
|
||||
|
||||
Groups
|
||||
~~~~~~
|
||||
|
||||
Each user can be member of several groups. Groups are the preferred
|
||||
way to organize access permissions. You should always grant permission
|
||||
to groups instead of using individual users. That way you will get a
|
||||
much shorter access control list which is easier to handle.
|
||||
|
||||
|
||||
Objects and Paths
|
||||
~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user