Тема
Переход на новую систему прав
Новая система прав (роли, группы, выдачи в проектах и пространствах, запреты) включается при обновлении DoQA. Права, выданные в прежней модели, переносятся автоматически, во время обычного обновления: отдельных команд запускать не нужно. Прежние возможности сохраняются; что меняется осознанно, описано в разделе Что меняется для людей.
Перед обновлением
- Убедитесь, что обновление идёт по обычному порядку: Обновление (update). Утилита сама создаёт резервную копию базы и файлов перед обновлением; если она не создаётся (изменённые настройки, внешнее хранилище, несоответствие требованиям), сделайте копию вручную: Резервное копирование (backup).
- Предупредите администраторов: после обновления раздел администрирования выглядит иначе, см. Администрирование.
- Приложение недоступно на время обновления, обычно несколько минут.
Что происходит при обновлении
- Создаются узлы дерева: организация, все проекты и пространства, включая архивные.
- Создаются системные роли, см. Роли и права.
- Прежние роли и доступы переводятся в выдачи по таблице ниже.
- Для каждого человека сравниваются прежние и новые разрешённые действия. Если перевод какой-то прежней роли или доступа даёт больше, чем она давала, это ошибка перевода: обновление останавливается, ничего не переносится, прежняя система остаётся рабочей. Если у человека пропало прежнее действие, он попадает в отчёт с перечнем потерянных действий.
- Итоговые права пересчитываются.
- Таблицы прежней системы переименовываются в
legacy_bouncer_*и остаются на 30 дней.
При каждом следующем обновлении системные роли сами приводятся к составу новой версии, права людей с этими ролями пересчитываются.
Отчёт о переходе записывается в журнал аудита записью «Переход на новую систему прав». В нём по людям перечислены расширения и сужения из раздела ниже, расхождения и потерянные действия.
Соответствие
| Было | Стало |
|---|---|
| Владелец системы | Владелец организации |
| Роль «Супер админ» | «Администратор организации» и «Администратор проектов» на организации |
| Роль «Администратор пользователей» | «Администратор пользователей» (с правами лицензий и оплаты, так что покупка и продление остаются доступны) |
| Роль «Создатель проектов» | «Создатель проектов» |
| «Администрирование» для всех проектов | «Тест-лид» на организации |
| «Редактирование» для всех проектов | «Тестировщик» на организации |
| «Просмотр» для всех проектов | «Наблюдатель» на организации |
| «Администрирование» одного проекта | «Тест-лид» на проекте |
| «Редактирование» одного проекта | «Тестировщик» на проекте |
| «Просмотр» одного проекта | «Наблюдатель» на проекте |
| Все три раздела пространства (кейсы, чек-листы, прогоны) | «Тестировщик» на пространстве |
| Часть разделов пространства | Своя роль вида «Тестировщик (только кейсы)», «Тестировщик (кейсы и прогоны)» и подобные, на пространстве. Создаются только для встречающихся сочетаний |
| «Скрыть» проект | Запрет «весь доступ» на проекте |
| Лицензия | Без изменений |
| Токен проекта | Сервисный аккаунт с ролью «Агент CI» на проекте, секрет тот же: переменные CI менять не нужно |
| Личный API-токен | Личный токен с правами владельца на всех его местах, срок действия не меняется: токен без срока остаётся бессрочным |
Что меняется для людей
Права в новой системе складываются: всё, что выдано человеку на организации, проекте и пространстве, действует вместе. Поэтому есть два осознанных изменения, оба попадают в отчёт перехода по людям.
Расширение: было погашено ролью, стало действует. В прежней модели общая роль «Просмотр» (view_role) отключала доступы «Администрирование» и «Редактирование» проекта и правку кейсов, прогонов и чек-листов в пространствах, даже если они были выданы человеку отдельно. Роль «Редактор пространств» (spaces_editor_role) так же отключала «Администрирование» проекта. Теперь такие доступы работают: человек с «Наблюдателем» на организации и «Тест-лидом» на проекте может править этот проект. В отчёте перехода это класс «было погашено ролью, стало действует»: кто, какой ролью было погашено, какие доступы и где. Если расширение не нужно, уберите лишнюю выдачу в карточке человека.
Сужение: интеграции и настройки ИИ организации. Подключение и отключение интеграций и трекеров и настройки ИИ на уровне организации теперь доступны только администраторам организации. Раньше интеграциями могли управлять также люди с «Администрированием» любого проекта, с ролями «Редактор проектов» и «Создатель проектов», а настройками ИИ также «Администратор пользователей», «Редактор проектов» и люди с «Администрированием» проекта. Эти люди перечислены в отчёте перехода как сужения. Если кому-то из них нужно управлять интеграциями или ИИ, выдайте роль с правами integration.manage или ai_settings.manage на организации, см. Роли и права.
Остальные изменения закрывают дефекты прежних прав:
- держатели прежних общих уровней «Просмотр» и «Редактирование» больше не могут выдавать права в проектах: управление доступом даёт право
access.manage, которого нет у ролей «Наблюдатель» и «Тестировщик»; - администратор пользователей не может выдать себе или другим полный доступ в проектах: выдача роли требует, чтобы все её права были у выдающего.
Подробно о правах для выдачи ролей: Роли и права. Прежнюю схему с уровнями замещают роли, доступ на всю организацию и доступ к проектам.
Команды
При обновлении ничего запускать не нужно: перенос, системные роли и пересчёт прав выполняет само обновление. Команды ниже нужны для диагностики и выполняются на сервере приложения (серверная версия).
| Команда | Назначение |
|---|---|
access:migrate --dry-run | Пробный перенос: показать отчёт, ничего не сохраняя. Флаг --report=<файл> сохраняет отчёт в JSON, включая расширения и сужения по людям |
access:migrate | Повторный перенос. Ничего не дублирует |
access:sync-system-roles | Принудительно привести системные роли к составу текущей версии |
access:reconcile | Пересчитать итоговые права всех пользователей |
access:legacy-restore | Вернуть таблицам прежней системы прежние имена (откат в окне 30 дней) |
access:purge-legacy | Удалить таблицы legacy_bouncer_*, когда прошло 30 дней после перехода |
access:grant-org-admin <почта> | Выдать человеку «Администратора организации» и «Администратора проектов» на организации |
После обновления
- Откройте администрирование и проверьте раздел «Пользователи» и «Роли»: у администраторов должны быть те же возможности.
- Просмотрите отчёт «Переход на новую систему прав» в журнале аудита: расширения (было погашено ролью), сужения (интеграции и настройки ИИ) и людей с потерянными действиями.
- Настройте группы и переведите повторяющиеся личные роли в них: отчёт «Доступ вне групп» в пересмотре доступа покажет кандидатов.
- Проверьте токены проектов и интеграции CI.
Откат
В течение 30 дней таблицы прежней системы сохраняются. Откат на предыдущую версию приложения возможен командой access:legacy-restore и восстановлением из резервной копии. Выдачи и роли, созданные в новой системе после перехода, в прежней версии не действуют. Токены проектов, в том числе выпущенные после перехода, в прежней версии продолжают работать. При повторном обновлении перенос выполняется заново: права, выданные в прежней версии за время отката, тоже переносятся. По истечении 30 дней access:purge-legacy удаляет таблицы окончательно.