Product SiteDocumentation Site

⁠Глава 42. Пользователи и их права

42.1. API-токены
42.2. Пулы ресурсов
42.3. Области аутентификации
42.3.1. Стандартная аутентификация Linux PAM
42.3.2. Сервер аутентификации PVE
42.3.3. LDAP-аутентификация
42.3.4. Аутентификация AD
42.4. Двухфакторная аутентификация
42.5. Управление доступом
PVE поддерживает несколько областей аутентификации, в том числе Linux PAM, встроенную область аутентификации PVE, LDAP, Active Directory и OpenID Connect:
Выбор области аутентификации в веб-интерфейсе
Ролевая модель управления доступом позволяет назначать разрешения на объекты PVE (ВМ, хранилища, узлы и т. д.) и настраивать многоуровневый доступ.
PVE хранит данные пользователей в файле /etc/pve/user.cfg:
# cat /etc/pve/user.cfg
user:root@pam:1:0::::::
user:test@pve:1:0::::::
user:testuser@pve:1:0::::Just a test::
user:user@pam:1:0::::::

group:admin:user@pam::
group:testgroup:test@pve::
Запись о пользователе содержит его идентификатор, состояние учётной записи, срок действия и другие атрибуты, в том числе имя, фамилию, адрес электронной почты и комментарий. Членство в группах описывается отдельными записями.
Идентификатор пользователя включает имя пользователя и область аутентификации и имеет формат <user>@<realm>.
ПВ стандартной конфигурации PVE предусмотрена учётная запись root@pam, соответствующая суперпользователю операционной системы. Удалить эту учётную запись нельзя. По умолчанию системные письма отправляются на адрес электронной почты, назначенный этому пользователю. Суперпользователь обладает неограниченными правами, поэтому для повседневного администрирования рекомендуется создавать дополнительные учётные записи с ограниченными правами.
Пользователь может входить в несколько групп. Для упрощения управления доступом рекомендуется назначать разрешения группам, а не отдельным пользователям, когда это соответствует принятой модели разграничения доступа

⁠42.1. API-токены

API-токены позволяют аутентифицироваться при обращении к REST API из внешних приложений и систем без передачи пароля пользователя. Для каждого пользователя можно создавать отдельные токены. Токенам можно назначать собственные разрешения и задавать срок действия, чтобы ограничить объём и продолжительность доступа. Если токен скомпрометирован, его можно отозвать, не отключая учётную запись пользователя.
API-токены бывают двух типов:
  • токен с разделением привилегий — для него необходимо явно назначить разрешения с помощью списков контроля доступа (ACL). Эффективные разрешения токена определяются пересечением разрешений пользователя и разрешений, назначенных токену;
  • токен с полными привилегиями — обладает теми же разрешениями, что и связанный с ним пользователь.
API-токен состоит из двух частей:
  • идентификатора токена (Token ID), включающего идентификатор пользователя, область аутентификации и имя токена: user@realm!tokenid;
  • секрета — секретного значения, используемого для аутентификации.
Для создания API-токена в веб-интерфейсе необходимо в окне Центр обработки данных → Разрешения → Токены API нажать кнопку Добавить. В открывшемся окне следует выбрать пользователя и указать идентификатор токена:
Генерация API-токена в веб-интерфейсе

Примечание

Если необходимо, чтобы токен наследовал все разрешения пользователя, снимите отметку Разделение привилегий. В противном случае токену необходимо явно назначить разрешения ACL. Подробнее см. Управление доступом.
После нажатия кнопки Добавить будет создан API-токен:
PVE. API-токен
Отображаемый секрет токена необходимо сохранить.

Примечание

Секрет токена отображается только один раз — при его создании. Впоследствии получить его повторно через API нельзя

Примечание

Можно повторно сгенерировать секрет существующего API-токена, не удаляя сам токен (кнопка Сгенерировать секрет заново). Это позволяет выполнить ротацию секрета, например, в случае компрометации токена, при этом связанные с токеном записи ACL сохраняются.
Если создан токен разделением привилегий, ему необходимо назначить разрешения:
  1. В окне Центр обработки данных → Разрешения нажать кнопку Добавить → Разрешения токена API:
    PVE. Добавление разрешений
  2. В открывшемся окне указать путь, токен и роль и нажать кнопку Добавить:
    Назначение разрешений API-токену
Для создания API-токена в консоли используется команда:
# pveum user token add <userid> <tokenid> [ОПЦИИ]
Доступные параметры:
  • --comment <строка> — комментарий к токену;
  • --expire <целое число> — время истечения срока действия API-токена в секундах с начала эпохи Unix. По умолчанию срок действия API-токена совпадает со сроком действия пользователя. Значение 0 означает отсутствие ограничения срока действия токена;
  • --privsep <логическое значение> —  определяет, используется ли разделение привилегий. Значение 1 включает разделение привилегий (по умолчанию), а значение 0 позволяет токену использовать разрешения связанного с ним пользователя.
Примеры команд для работы с токенами:
  • создать токен t2 для пользователя user@pam без разделения привилегий:
    # pveum user token add user@pam t2 --privsep 0
    ┌──────────────┬──────────────────────────────────────┐
    │ key          │ value                                │
    ╞══════════════╪══════════════════════════════════════╡
    │ full-tokenid │ user@pam!t2                          │
    ├──────────────┼──────────────────────────────────────┤
    │ info         │ {"privsep":"0"}                      │
    ├──────────────┼──────────────────────────────────────┤
    │ value        │ 3c749375-e189-493d-8037-a1179317c406 │
    └──────────────┴──────────────────────────────────────┘
    
  • вывести список токенов пользователя:
    # pveum user token list user@pam
    ┌─────────────┬─────────┬────────┬─────────┐
    │ tokenid     │ comment │ expire │ privsep │
    ╞═════════════╪═════════╪════════╪═════════╡
    │ monitoring  │         │      0 │ 1       │
    ├─────────────┼─────────┼────────┼─────────┤
    │ t2          │         │      0 │ 0       │
    └─────────────┴─────────┴────────┴─────────┘
    
  • вывести эффективные разрешения токена:
    # pveum user token permissions user@pam t2
    
    Можно использовать опцию --path, чтобы вывести разрешения только для определённого пути, а не всё дерево разрешений:
    # pveum user token permissions user@pam t2 --path /storage
    
  • назначить разрешения токену с разделением привилегий:
    # pveum acl modify /vms --tokens 'user@pam!monitoring' --roles PVEAdmin,PVEAuditor
    
  • удалить токен пользователя:
    # pveum user token remove user@pam t2
    

Примечание

Разрешения API-токена не могут превышать разрешения соответствующего пользователя. Поэтому токен нельзя использовать для выполнения действий, на которые у пользователя нет разрешений.
Пример:
  1. Назначить пользователю test@pve роль PVEVMAdmin для всех ВМ:
    # pveum acl modify /vms --users test@pve --roles PVEVMAdmin
    
  2. Создать API-токен с разделением привилегий
    # pveum user token add test@pve monitoring --privsep 1
    
  3. Назначить токену права на просмотр информации о ВМ:
    # pveum acl modify /vms --tokens 'test@pve!monitoring' --roles PVEAuditor
    
  4. Проверить разрешения пользователя и API-токена:
    # pveum user permissions test@pve
    # pveum user token permissions test@pve monitoring
    
Для аутентификации с помощью API-токена в HTTP-запросе необходимо указать заголовок Authorization со значением следующего формата:
PVEAPIToken=USER@REALM!TOKENID=UUID