Инструкция для администратора площадки: как создать учётную запись сотрудника,
назначить ему роль ClashFlow, сбросить пароль или отключить доступ.
Сейчас учётные записи создаёт администратор площадки: он назначает роли и
выдаёт сотрудникам данные для входа. Самостоятельная регистрация пока не
предусмотрена; в будущем она может быть добавлена.
Каждый пользователь realm collisions по умолчанию получает роль Engineer.
Если специалист внедрения подключил вход через Yandex ID, VK ID, Mail.ru или
OK, сотрудник при первом входе через такую кнопку появляется в Keycloak сам
и сразу работает с ролью Engineer; расширенные роли назначает администратор.
Такой пользователь входит в веб и плагин Revit, но для Navisworks и установщика
Worker нужна учётная запись с паролем Keycloak.
https://<адрес-Keycloak>/admin/.Administrator в ClashFlow сама по себеcollisions и клиенты приложения. Если realm илиДля обычной работы ClashFlow используйте realm collisions. Realm
collisions-license предназначен для лицензирования сайта и Windows Worker;
не создавайте в нём учётные записи сотрудников ClashFlow и не назначайте
им роли приложения.
https://<адрес-Keycloak>/admin/ — используйте адрес IdP,collisions. Перед изменениями проверьте,master или collisions-license.Встроенный master обычно используется для администрирования самого Keycloak.
Не выдавайте сотрудникам доступ в master ради доступа к ClashFlow.
ClashFlow использует эти realm roles в realm collisions. Имена
чувствительны к написанию: создавайте их точно, включая дефис и регистр.
Одноимённые client roles не заменяют эти realm roles.
| Realm role | Доступ в веб-интерфейсе ClashFlow |
|---|---|
Administrator |
Все страницы, включая настройки сервера и лицензию. Это роль продукта, а не право администратора Keycloak. |
Bim-engineer |
Настройки выгрузки, диспетчер задач, модели и коллизии. |
Chief-engineer |
Модели и коллизии; согласование и подтверждение фиктивных коллизий. |
Engineer |
Модели и коллизии; работа со статусами в пределах прав роли. |
Права роли действуют и при обращении к API. В частности, Administrator и
Bim-engineer имеют доступ к удалению коллизий и ручной перепривязке исходных
моделей; для отдельных операций дополнительно проверяются условия выполнения.
Учитывайте эти полномочия при назначении Bim-engineer, даже если сотруднику
прежде всего нужны выгрузка и модели. Выдавайте Administrator только тем,
кому нужны административные функции ClashFlow.
В выбранном realm откройте Realm roles → Create role. В поле имени
создайте одну из четырёх ролей из таблицы выше, затем сохраните. Повторите
для остальных отсутствующих ролей. Создавайте роли в collisions; не
создавайте их как роли клиента и не меняйте написание.
Обычно роли уже создаются при настройке realm специалистом внедрения.
Если не уверены, попросите его проверить конфигурацию, прежде чем добавлять
роль вручную.
collisions.Username, рабочий email, имя и фамилию.Не включайте в Required user actions обязательное подтверждение email,
настройку OTP или другие действия, если площадка не настроила и не проверила
этот процесс. Иначе сотрудник может не завершить вход. Для временного пароля
см. следующий раздел.
У пользователя может быть несколько ролей. Его доступ складывается из всех
эффективных назначений: прямых, полученных через группы и составные роли.
При проверке смотрите не только прямые назначения пользователя, но и группы
и вложенные роли. Несколько ролей могут расширить набор доступных действий;
назначайте только те, которые нужны сотруднику.
Чтобы новые учётные записи автоматически получали одну из ролей ClashFlow,
добавьте её в состав стандартной роли default-roles-collisions. Это работает
и для учётных записей, которые создаёт администратор; включать самостоятельную
регистрацию для этого не требуется. Настройку выполняет администратор Keycloak
с правами менять состав realm-ролей.
Например, по умолчанию можно выдавать Engineer, а более широкие роли
назначать отдельно по необходимости.
Изменение затронет и существующих пользователей, которым уже назначена
default-roles-collisions: они будут наследовать добавленную роль. Учитывайте
это при выборе роли по умолчанию, особенно если она даёт административные
права. Порядок настройки описан в
руководстве Keycloak.
Для проверки откройте пользователя → Role mapping, снимите флажок
Hide inherited roles и нажмите Refresh. Добавленная роль должна быть
видна как унаследованная (Inherited = True). Попросите пользователя выйти
из ClashFlow и войти снова, чтобы получить токен с обновлёнными ролями.
Унаследованная роль управляется через источник назначения: в данном случае
через состав default-roles-collisions. Снятие прямого назначения той же роли
у пользователя не убирает её наследование.
Не используйте опубликованные примеры, общие или стандартные пароли. Если на
площадке настроена отправка писем из Keycloak, можно выслать сотруднику ссылку
для смены пароля: откройте карточку пользователя → Credentials →
Credential Reset или Send reset email (название зависит от версии),
выберите Update Password и нажмите Send email. Это действие отправляет
письмо; оно не устанавливает пароль вручную. Отправка работает только при
настроенной и проверенной SMTP-доставке.
Учётные записи из LDAP/Active Directory или другого подключённого источника
могут управлять паролями на стороне этого источника. В таком случае задавайте
или сбрасывайте пароль там, следуя правилам вашей организации.
Windows Worker и прямой вход Navis могут использовать парольную
аутентификацию, которая не проходит интерактивные обязательные действия
Keycloak. Для такой учётной записи завершите смену временного пароля через
браузер до настройки установщика. Не используйте личную учётную запись
сотрудника как техническую; отдельную техническую учётную запись и её права
согласуйте с ответственным за IdP и внедрение.
Engineer приходит через default-roles-collisions и снятиемУже выданный access token может оставаться действительным до истечения срока
его действия. Отключение пользователя и выход из сессий не обязательно
немедленно прекращают все запросы с ранее выданным токеном.
| Симптом | Что проверить |
|---|---|
| Учётная запись создана, но пользователь не входит | Выбраны ли collisions и нужный клиент; включена ли учётная запись; не истёк ли временный пароль; завершены ли обязательные действия. |
| Пользователь вошёл, но не видит нужные страницы | Назначена ли точная realm role в collisions; нет ли назначения только в другом realm или роли клиента; учтены ли группы и вложенные роли. Попросите пользователя выйти и войти снова. |
| Не приходит письмо | Проверьте SMTP и адрес email. Пока почтовая доставка не подтверждена, установите временный пароль и передайте его защищённым индивидуальным каналом. |
| Установщик или Navis отвергает пароль после его сброса | Войдите этой учётной записью через браузер и завершите обязательную смену пароля. Проверьте, что парольная аутентификация разрешена для настроенного клиента и учётной записи. |
| Пароль нельзя изменить в Keycloak | Учётная запись может быть связана с LDAP/AD или другим внешним источником; проверьте порядок управления паролями у администратора IdP. |
Подробнее о входе и доступе пользователей см. страницу Вход и роли.