Тема
Как устроены права
Эта страница объясняет, из чего складывается доступ в DoQA. Подробности по каждому понятию - на отдельных страницах раздела.
Модель в четырёх правилах
- Права живут только в ролях. Человеку отдельное право не выдаётся.
- Доступ - это роль, выданная в каком-то месте. Роль, выданная выше, действует ниже, в том числе в новых проектах и пространствах. Исключение - закрытый проект или пространство.
- Доступ дают группам, исключения выдают лично. Человек получает роли своих групп и свои личные роли. Итог - их сумма. Запрет сильнее любой роли.
- Без лицензии - только просмотр. Лицензия не меняет ролей, она включает права на изменение.
Понятия
| Понятие | Что это |
|---|---|
| Право | Одно действие над одним видом объекта, например case.edit. Полный перечень: Справочник прав |
| Роль | Именованный набор прав. Бывает системной (от DoQA) и своей |
| Группа | Набор пользователей. Состав ведётся вручную, берётся из SSO или LDAP либо задаётся правилом |
| Сервисный аккаунт | Не человек: CI, скрипт, интеграция. Получает роли как человек, в интерфейс войти не может |
| Место (узел) | Организация, проект или пространство |
| Выдача | Роль, выданная человеку, группе или сервисному аккаунту в определённом месте |
| Запрет | Отнимает набор прав или весь доступ в месте и ниже |
| Условие | Сужает право внутри роли: только свои, назначенные мне, в нужных статусах |
| Лицензия | Включает права на изменение. Выдаётся пользователю |
| Владелец организации | Один человек с полным доступом, который нельзя отозвать или ограничить. Это свойство организации, а не роль |
Дерево мест
Организация
├── Проект «Мобильный банк»
│ ├── Пространство «Android»
│ └── Пространство «iOS»
└── Проект «CRM»
└── Пространство «Core»Роль на организации действует во всех проектах и пространствах, роль на проекте - во всех его пространствах, роль на пространстве - только в нём. Архивный проект остаётся в дереве, его права действуют после восстановления.
У каждого права есть уровень: организация, проект или пространство. Право организации (например, user.invite) работает только при роли, выданной на всю организацию.
Как принимается решение
| Шаг | Проверка | Если не прошла |
|---|---|---|
| 1 | Вы владелец организации? | Можно |
| 2 | Есть запрет на это право в этом месте или выше? | Нельзя, причина: запрет |
| 3 | Есть ли среди ролей (личных и групповых) в этом месте и выше, но не выше ближайшего закрытого, роль с этим правом, и выполнены ли условия? | Нельзя, причина: нет роли или место закрыто |
| 4 | Право требует лицензии, а её нет? | Нельзя, причина: нет лицензии |
| 5 | Иначе | Можно |
Причину отказа видно в интерфейсе и на странице Проверка доступа.
Где что настраивать
| Задача | Страница |
|---|---|
| Пригласить людей, выдать лицензию | Пользователи |
| Собрать набор прав | Роли и права |
| Дать доступ команде | Группы |
| Дать доступ к проекту или пространству | Доступ к проектам и пространствам |
| Спрятать проект или пространство | Закрытые проекты и пространства |
| Исключить человека из доступа | Запреты |
| Ответить на просьбу о доступе | Запросы доступа |
| Регулярно проверять выданное | Пересмотр доступа |
| Понять, почему доступ есть или нет | Проверка доступа |
| Доступ для CI и скриптов | Сервисные аккаунты, API-токены |
| Посмотреть свои права | Мой доступ |