Product SiteDocumentation Site

⁠42.5. Управление доступом

Чтобы пользователь мог выполнять действия в PVE, например просматривать, изменять или удалять ВМ, ему необходимо предоставить соответствующие разрешения.
PVE использует ролевую модель управления доступом, основанную на путях к объектам. Запись в таблице разрешений назначает пользователю, группе или API-токену роль для указанного пути. Таким образом, правило доступа задаётся сочетанием пути, субъекта доступа и роли. Роль определяет набор привилегий, доступных субъекту при обращении к соответствующему объекту.
Роль — это набор привилегий. В PVE предусмотрены встроенные роли, предназначенные для выполнения типовых административных задач:
  • Administrator — полный набор привилегий;
  • NoAccess — роль без привилегий, используемая для ограничения доступа;
  • PVEAdmin — выполнение большинства административных операций, за исключением изменения системных настроек (Sys.PowerMgmt, Sys.Modify, Realm.Allocate) и разрешений (Permissions.Modify);
  • PVEAuditor — доступ только для чтения;
  • PVEDatastoreAdmin — создание и выделение места для резервного копирования и шаблонов;
  • PVEDatastoreUser — просмотр хранилищ и выделение места для резервного копирования;
  • PVEMappingAdmin — управление сопоставлениями ресурсов;
  • PVEMappingUser — просмотр и использование сопоставлений ресурсов;
  • PVEPoolAdmin — управление пулами ресурсов;
  • PVEPoolUser — просмотр пулов ресурсов;
  • PVESDNAdmin — управление конфигурацией SDN;
  • PVESDNUser — доступ к мостам и виртуальным сетям SDN;
  • PVESysAdmin — просмотр системной информации, доступ к системной консоли и журналам;
  • PVETemplateUser — просмотр и клонирование шаблонов;
  • PVEUserAdmin — управление пользователями;
  • PVEVMAdmin — управление ВМ;
  • PVEVMUser — просмотр ВМ, резервное копирование, управление виртуальным CD/DVD-приводом, доступ к консоли и управление питанием ВМ.
Просмотреть список встроенных ролей в веб-интерфейсе можно, выбрав Центр обработки данных → Разрешения → Роли:
Список предопределенных ролей
Создать пользовательскую роль можно:
  • в веб-интерфейсе: Центр обработки данных → Разрешения → Роли нажать кнопку Создать:
    Добавление роли Sys_Power-only
  • в командной строке:
    # pveum role add VM_Power-only --privs "VM.PowerMgmt VM.Console"
    

Примечание

Имена встроенных ролей с префиксом PVE зарезервированы. Пользовательские роли не должны использовать этот префикс.
Привилегия — право на выполнение определенного действия. Для упрощения управления привилегии объединены в роли, которые назначаются пользователям, группам или API-токенам через таблицу разрешений. Отдельные привилегии напрямую субъектам доступа не назначаются: они предоставляются в составе роли.
⁠

Таблица 42.1. Привилегии, используемые в PVE

Привилегия
Описание
Привилегии узла/системы
Group.Allocate
Создание/удаление/изменение групп
Mapping.Audit
Просмотр сопоставлений ресурсов
Mapping.Modify
Управление сопоставлениями ресурсов
Mapping.Use
Использование сопоставлений ресурсов
Permissions.Modify
Изменение прав доступа
Pool.Allocate
Создание/удаление/изменение пулов
Pool.Audit
Просмотр пула
Realm.Allocate
Создание/удаление/изменение областей аутентификации
Realm.AllocateUser
Создание пользователей в области аутентификации
SDN.Allocate
Управление конфигурацией SDN
SDN.Audit
Просмотр конфигурации SDN
Sys.AccessNetwork
Просмотр информации о сетевых интерфейсах, использование сетевых ресурсов
Sys.Audit
Просмотр состояния и конфигурации узла, конфигурации Corosync и HA
Sys.Console
Консольный доступ к узлу
Sys.Incoming
Разрешение приёма потоков данных из других кластеров (экспериментальная привилегия)
Sys.Modify
Изменение конфигурации узла
Sys.PowerMgmt
Управление питанием узла (запуск, остановка, сброс, выключение)
Sys.Syslog
Просмотр Syslog
User.Modify
Создание/удаление/изменение пользователя
Права, связанные с ВМ
SDN.Use
Доступ к виртуальным сетям SDN и локальным сетевым мостам
VM.Allocate
Создание/удаление ВМ
VM.Audit
Просмотр конфигурации ВМ
VM.Backup
Резервное копирование/восстановление ВМ
VM.Clone
Клонирование/копирование ВМ
VM.Config.CDROM
Извлечение и изменение настроек виртуального CD/DVD-привода
VM.Config.CPU
Изменение настроек процессора
VM.Config.Cloudinit
Изменение параметров Cloud-init
VM.Config.Disk
Добавление/изменение/удаление дисков ВМ
VM.Config.HWType
Изменение типа виртуального оборудования
VM.Config.Memory
Изменение настроек памяти
VM.Config.Network
Добавление/изменение/удаление сетевых устройств
VM.Config.Options
Изменение любой другой конфигурации ВМ
VM.Console
Консольный доступ к ВМ
VM.GuestAgent.Audit
Выполнение информационных команд QEMU Guest Agent
VM.GuestAgent.FileRead
Чтение файлов в гостевой системе через QEMU Guest Agent
VM.GuestAgent.FileSystemMgmt
Замораживание, размораживание и выполнение TRIM для файловых систем гостевой ОС через QEMU Guest Agent
VM.GuestAgent.FileWrite
Запись файлов в гостевой системе через QEMU Guest Agent
VM.GuestAgent.Unrestricted
Выполнение произвольных команд QEMU Guest Agent без ограничений
VM.Migrate
Миграция ВМ на другой узел кластера
VM.PowerMgmt
Управление питанием (запуск, остановка, сброс, выключение)
VM.Replicate
Настройка и выполнение репликации гостевой ВМ
VM.Snapshot.Rollback
Откат ВМ к одному из её снимков
VM.Snapshot
Создание/удаление снимков ВМ
Права, связанные с хранилищем
Datastore.Allocate
Создание/удаление/изменение хранилища данных
Datastore.AllocateSpace
Выделение места в хранилище
Datastore.AllocateTemplate
Размещение шаблонов контейнеров и ISO-образов в хранилище
Datastore.Audit
Просмотр хранилища данных

Примечание

Следует внимательно обращаться с правами Permissions.Modify и Sys.Modify, так как они позволяют изменять важные и конфиденциальные аспекты системы и ее конфигурации.
Права доступа назначаются объектам, таким как ВМ, хранилища или пулы ресурсов. PVE использует файловую систему как путь к этим объектам. Эти пути образуют естественное дерево, и права доступа более высоких уровней (более короткий путь) могут распространяться вниз по этой иерархии.
Путь может представлять шаблон. Когда API-вызов требует разрешений на шаблонный путь, путь может содержать ссылки на параметры вызова API. Эти ссылки указываются в фигурных скобках. Некоторые параметры неявно берутся из URI вызова API. Например, путь /nodes/{node} при вызове /nodes/pve01/status требует разрешений на /nodes/pve01, в то время как путь {path} в запросе PUT к /access/acl ссылается на параметр метода path.
Примеры:
  • /nodes/{node} — доступ к узлам PVE;
  • /vms — распространяется на все ВМ;
  • /vms/{vmid} — доступ к определенным ВМ;
  • /storage/{storeid} — доступ к определенным хранилищам;
  • /pool/{poolid} — доступ к ресурсам из определенного пула ресурсов;
  • /access/groups — администрирование групп;
  • /access/realms/{realmid} — административный доступ к области аутентификации.
Используются следующие правила наследования:
  • разрешения для отдельных пользователей всегда заменяют разрешения для групп;
  • разрешения для групп применяются, если пользователь является членом этой группы;
  • разрешения на более глубоких уровнях перекрывают разрешения, унаследованные от верхнего уровня;
  • NoAccess отменяет все другие роли на данном пути.
Кроме того, токены с разделением привилегий (см. API-токены) не могут обладать разрешениями на пути, которых нет у связанного с ними пользователя.
Для назначения разрешений необходимо в окне Центр обработки данных → Разрешения нажать кнопку Добавить, в раскрывающемся списке выбрать Разрешения группы, если разрешения назначаются группе пользователей, или Разрешения пользователя, если разрешения назначаются пользователю:
Добавление разрешений
Далее в открывшемся окне выбрать путь, группу и роль и нажать кнопку Добавить:
Добавление разрешений группе
Примеры работы с разрешениями в командной строке:
  • предоставить группе admin полные права администратора:
    # pveum acl modify / --groups admin --roles Administrator
    
  • предоставить пользователю test@pve доступ к ВМ только для чтения:
    # pveum acl modify /vms --users test@pve --roles PVEAuditor
    
  • делегировать управление пользователями пользователю test@pve:
    # pveum acl modify /access --users test@pve --roles PVEUserAdmin
    
  • разрешить пользователю orlov@test.alt изменять пользователей в области test.alt, если они являются членами группы office-test.alt:
    # pveum acl modify /access/realm/test.alt --users orlov@test.alt --roles PVEUserAdmin
    # pveum acl modify /access/groups/office-test.alt --users orlov@test.alt --roles PVEUserAdmin
    
  • разрешить пользователям группы developers администрировать ресурсы, назначенные пулу IT:
    # pveum acl modify /pool/IT/ --groups developers --roles PVEAdmin
    
  • удалить у пользователя test@pve право на просмотр ВМ:
    # pveum acl delete /vms --users test@pve --roles PVEAuditor
    

Примечание

Назначение привилегий на токены см. в разделе API-токены.