keyРоли и права доступа

Что разрешено каждому сотруднику, определяют роли. Роль — это список прав: открыть раздел, создать документ, закрыть смену на кассе. В статье — как собрать роль, найти нужное право и назначить роль пользователю.

У каждого права, набора и роли два имени:

По началу системного имени видно, к чему относится право: console.… — панель управления, pos.… — касса, tsd.… — терминал сбора данных, shop.… — интернет-витрина.

Откройте Администрирование → Пользователи, нажмите «Действия» → Управление доступом. В разделе три вкладки: Роли, Наборы прав и Права.

В списке ролей:

Список сортируется по любой колонке. Строка поиска над списком ищет и по названию, и по системному имени.

В системе уже есть готовые роли — например, «Продавец» (shopman) и «Администратор магазина» (shopManager). Их можно менять или взять за основу для своих.

На странице роли все права собраны в один список и разбиты по разделам: «Поступления», «Продажи», «Касса» и так далее. Отмеченное право выдано роли. Рядом с названием раздела — счётчик: сколько прав раздела выдано.

1. Нажмите на название раздела, чтобы развернуть его. «Развернуть» и «Свернуть» над списком открывают и закрывают все разделы сразу.
2. Отметьте нужные права. «отметить все» и «снять все» в заголовке раздела меняют все права раздела разом.
3. Изменённые строки подсвечиваются, а над списком появляется счётчик несохранённых изменений.

1. Нажмите «Сохранить». Кнопка «Отменить» возвращает список к сохранённому состоянию.

Над списком есть переключатель: Все, Выданные, Не выданные. Вариант Выданные показывает роль целиком — удобно, чтобы проверить, что в неё входит.

В статьях справки права указаны системными именами — например, в разделе «Права доступа» статьи Отгрузка со склада. Чтобы выдать такое право:

Искать можно и по части имени: запрос console.inflow. покажет все права раздела поступлений. Так же работает поиск по названию: «возврат», «закрытие смены».

Системное имя под каждым правом можно скопировать: нажмите на него.

Наборы прав собраны в первом разделе списка — Наборы прав. Отметьте набор, и роль получит все права из него. Ссылка «состав» показывает, какие права входят в набор.

Права, которые роль получила через набор, отмечены серой галочкой с пометкой «входит в «…»». Снять такое право отдельно нельзя: снимите набор и отметьте нужные права по одному.

Четыре права ограничивают не действие, а набор полей или колонок. Какие именно поля открыты, настраивается отдельно в каждой роли.

1. Отметьте право в роли и нажмите «Сохранить».
2. У отмеченного права появится ссылка «настроить поля» — нажмите её.
3. Отметьте поля, которые сотрудник может менять, или колонки, которые он должен видеть.

1. Нажмите «Сохранить».

Пока набор в роли не настроен, действует набор по умолчанию. Кнопка «Вернуть по умолчанию» отменяет настройку роли.

Пользовательские поля в списке идут по отдельности, каждое со своим названием и пометкой «пользовательское поле». Поле, добавленное позже, для ролей с настроенным набором закрыто, пока его не отметят; новая колонка списка, наоборот, видна, пока её не скроют.

1. Откройте Администрирование → Пользователи и выберите сотрудника.
2. Нажмите «Изменить» и прокрутите форму до блока Управление доступом.
3. Отметьте роли. В колонке Прав видно, сколько прав даёт каждая.

1. Нажмите «Сохранить».

Пользователю можно назначить несколько ролей — он получит права всех.

Если роль нужно выдать нескольким сотрудникам, удобнее делать это со страницы роли — на вкладке Пользователи. На ней же видно, кому роль уже назначена.

Чтобы снять роль, нажмите «снять» напротив сотрудника в списке Роль назначена и подтвердите действие. Если сотрудников много, найдите нужного строкой поиска над списком — по Ф.И.О. или логину. Снять роль superAdmin с самого себя нельзя.

Какие отчёты видит сотрудник, тоже задаёт роль. Откройте роль и перейдите на вкладку Доступ к отчетам.

После изменений нажмите «Сохранить».

Кнопки в шапке страницы роли, справа от названия:

Три роли нужны для работы системы. Они отмечены меткой «системная», удалить их нельзя.

Вкладки Наборы прав и Права показывают все наборы и все права системы — с поиском по названию и системному имени. Колонка В ролях показывает, в сколько ролей входит право или набор.

Вкладки на странице права и набора прав:

Вкладка Пользователи — быстрый способ узнать, кому доступно действие: например, кто может удалять товары или закрывать смену. Пользователи с ролью superAdmin есть в списке всегда: им доступно всё. Список выводится по 50 записей на страницу, сортируется по колонкам, а строка поиска над ним ищет по Ф.И.О. и логину.

Пользователь с ролью superAdmin может изменить состав набора на вкладке Состав — так же, как состав роли, — и ссылкой «убрать» на вкладке Где используется исключить право из роли или набора.

Настройку ролей можно доверить сотруднику, не давая ему полного доступа: включите в его роль набор прав «Управление доступом» (console.auth.*) из раздела Наборы прав. Такой сотрудник выдаёт только те права, которые есть у него самого. Без этого набора менять роли и права нельзя совсем.

В готовых ролях «Администратор 1300» (admin1300) и «Администратор 500» (admin500) набор «Управление доступом» уже есть.

Новая роль, созданная таким сотрудником, пуста — в неё он добавляет свои права. Чтобы он мог назначать роли в карточках пользователей, ему нужны и права на раздел Пользователи — набор «Управление пользователями» (adminUsers).