Роли и права в кабинете клиента
Роли и права доступа в кабинете клиента определяют, кто видит проекты, загружает документы, подтверждает изменения и управляет участниками. Если ограничиться названиями «клиент» и «администратор», важные различия останутся неописанными. Например, бухгалтеру могут требоваться счета, а сотруднику проекта — только задачи и материалы по его направлению.
Начинать стоит с рабочих действий и границ данных, а не со списка экранов. Затем эти правила превращаются в матрицу доступа и проверяются в интерфейсе и на сервере. Ниже — практический порядок подготовки требований для нового кабинета или доработки существующего. Он помогает договориться о полномочиях до появления спорных ситуаций с документами и ответственностью.
1. Опишите участников и задачи
Составьте список людей, которые действительно будут пользоваться кабинетом: представитель заказчика, сотрудник проекта, бухгалтер, менеджер и администратор. Это примеры, а не обязательный набор ролей. Для каждого участника запишите задачи и данные, без которых он не сможет их выполнить. Не выдавайте доступ ко всему разделу только потому, что одна его функция нужна конкретному человеку.
Отдельно уточните, может ли один человек работать с несколькими организациями или проектами. В таком случае роли недостаточно: важно, в рамках какой организации действует пользователь сейчас. Ответы удобно добавить к перечню функций первой версии личного кабинета. Это позволит связать каждое разрешение с понятной рабочей задачей, а не с предположением разработчика.
2. Составьте матрицу конкретных действий
В строках матрицы перечислите действия: открыть проект, скачать документ, загрузить файл, изменить статус, подтвердить смету, пригласить сотрудника и отозвать приглашение. В столбцах укажите роли. Для каждого пересечения запишите разрешение и условия: например, только собственный проект, только документы организации или только назначенные задачи. Общей отметки «доступ к документам» часто недостаточно.
Разделите просмотр, создание, изменение и удаление. Право скачать счёт не означает право заменить его файлом, а загрузка материала не обязана давать возможность удалить документ менеджера. Для подтверждений и финансовых действий определите, кто может выполнять их от имени организации. Матрица должна быть достаточно короткой для обсуждения с владельцем процесса и достаточно точной, чтобы по ней можно было проверить результат.
3. Проверяйте ограничения на сервере
Скрытая кнопка помогает объяснить интерфейс, но не защищает данные сама по себе. Сервер должен проверять право на конкретное действие и конкретный объект. Вход в учётную запись подтверждает личность пользователя, но ещё не даёт ему права открыть любой проект. Правило должно действовать и для страницы, и для отдельного запроса загрузки файла или смены статуса.
В руководстве OWASP по авторизации сформулированы базовые принципы: минимально необходимые полномочия, отказ по умолчанию и проверка разрешений при каждом запросе. Для кабинета это означает, что новый раздел не становится общедоступным из-за отсутствующего условия. При изменении правил нужно проверить все связанные пути, включая поиск, экспорт и вложения, а не только основную карточку проекта.
4. Отделите принадлежность данных от роли
Два пользователя с ролью «клиент» могут иметь совершенно разные проекты. Поэтому проверка должна учитывать связь пользователя с организацией и объектом. Отдельно определите поведение общих проектов, приглашённых участников и архивных материалов. Условия должны быть одинаковыми для списка, карточки, поиска и скачивания: нельзя скрыть проект в списке, но оставить документ доступным по прямой ссылке.
Файл требует такого же правила доступа, как и запись в кабинете. Если документ хранится по общедоступному адресу, проверка при открытии страницы не решит проблему его дальнейшего распространения. Способ хранения и выдачи документов нужно выбрать под назначение материалов. В требованиях укажите, какие файлы предназначены для публичного просмотра, а какие выдаются только после проверки действующего доступа пользователя.
5. Продумайте приглашения и отзыв доступа
Приглашение должно связывать человека с нужной организацией или проектом и заранее определённой ролью. Запишите, кто вправе его отправлять, можно ли отменить приглашение и что происходит после истечения его срока. Не делайте регистрацию по приглашению автоматическим основанием для выдачи расширенных прав. После принятия приглашения пользователь должен понимать, в какой рабочей области он находится.
Увольнение сотрудника или завершение участия в проекте требует отдельного сценария. Определите, как отзывается доступ, что происходит с действующими сеансами и временными ссылками. Уже скачанные файлы технически нельзя вернуть простым удалением роли. История действий при этом должна сохранять понятного исполнителя; не стоит подменять старые записи именем нового сотрудника, которому передали задачи.
6. Разделите администрирование и работу
Обычная работа менеджера и настройка правил доступа — разные полномочия. Если человек только обрабатывает заявки, ему не обязательно выдавать возможность назначать администраторов. Для изменения состава участников, массового экспорта и других чувствительных действий определите отдельные разрешения. У общей учётной записи трудно установить исполнителя, поэтому предпочтительнее индивидуальные аккаунты с понятным назначением.
Записывайте существенные изменения: кто выполнил действие, какой объект затронут, что изменилось и когда. Не превращайте журнал в копию всех документов или переписки. Доступ к самому журналу тоже нужно определить. Для срочных исключений укажите причину, согласовавшего человека и срок полномочий. Иначе временное решение может незаметно стать постоянным доступом, который уже никто не пересматривает.
7. Проверьте разрешённые и запрещённые сценарии
Подготовьте тестовые аккаунты разных ролей и двух независимых клиентов. Проверьте не только успешную работу, но и отказ: чужой проект, чужое вложение, недоступный экспорт и действие после отзыва роли. Переход по сохранённой ссылке не должен обходить изменённые ограничения. Такие проверки выполняют в согласованной тестовой среде с искусственными данными, а не на документах реальных клиентов.
Проверьте сочетания ролей и переход между организациями, если они предусмотрены. После удаления доступа вернитесь к уже открытой вкладке и попробуйте повторить действие. Отдельно убедитесь, что кэш не отдаёт ответ одного пользователя другому. Зафиксируйте ожидаемый результат каждого сценария и повторяйте связанные проверки после обновления прав, поиска, загрузки документов или API. Одного удачного входа администратора для приёмки кабинета недостаточно.
Что включить в задание на кабинет
Для старта подготовьте перечень участников, матрицу действий, правила принадлежности данных, порядок приглашения и отзыва доступа, а также примеры разрешённых и запрещённых сценариев. Для каждого правила назначьте человека, который подтверждает его со стороны бизнеса. Если ситуация не описана, безопаснее согласовать её отдельно, чем молча расширять права всем пользователям.
Общие требования к документам и этапам удобно оформить через практический чек-лист ТЗ, а проверки после изменений включить в план поддержки сайта. Опишите в брифе участников кабинета и действия, которые им нужны — это поможет согласовать структуру доступа до начала разработки.