Перейти к основному содержимому
Версия: 0.4 · текущая

Модель безопасности

КонцепцияПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Наблюдатель, Оператор, Редактор, Администратор сущности, Суперадминистратор
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

У Excubius нет собственных паролей для вашей команды: пользователи входят с учетной записью Microsoft или Google, которой уже управляет ваша организация. То, что они затем могут видеть и делать, зависит от роли в каждой ветви дерева сущностей и проверяется заново при каждом запросе. Секреты, которые нужны сборщику, хранятся в зашифрованном виде, и прочитать их обратно невозможно. В этой статье описан каждый уровень защиты.

Вход​

Excubius использует OpenID Connect с Microsoft Entra ID (один клиент Microsoft Entra) и Google через поток кода авторизации с PKCE, state и nonce. Пакеты SDK поставщиков и платные службы удостоверений не используются.

  • Токен идентификатора проверяется при каждом входе: его подпись — по ключам, которые публикует поставщик, а также издатель (для Entra ID — ваш клиент Microsoft Entra), аудитория, срок действия и nonce этого входа.
  • Выполняемый вход хранится в подписанном файле cookie HttpOnly, который действует 10 минут. Страница, на которую нужно вернуться после входа, должна относиться к тому же сайту, поэтому специально созданная ссылка не может перенаправить пользователя на другой сайт.
  • Учетные записи определяются по поставщику и субъекту — идентификатору объекта пользователя в Entra ID или субъекту Google, но никогда только по адресу электронной почты.
  • Кто может получить учетную запись, решается в каждой сущности: по приглашению или по разрешенному домену электронной почты. Учетная запись Google засчитывается для домена, только если это учетная запись Google Workspace в этом домене; для личных учетных записей Google всегда требуется приглашение.
  • Секреты поставщиков берутся только из конфигурации сервера. Ни они, ни коды авторизации, ни токены никогда не хранятся в базе данных, не возвращаются через API и не записываются в журналы.
ПоставщикПланы
GoogleFree, Core, Pro, Enterprise
Microsoft Entra IDCore, Pro, Enterprise
Группы Microsoft Entra ID как носители ролейEnterprise

Многофакторная проверка подлинности​

MFA обеспечивает ваш поставщик удостоверений: условный доступ Entra ID или двухэтапная проверка Google. Excubius пока не проверяет утверждения MFA, поэтому требуйте MFA на стороне поставщика для всех, кто может входить, и прежде всего для администраторов сущностей.

Сеансы и токены​

После успешного входа устанавливаются два файла cookie, оба с атрибутами HttpOnly, Secure (при работе по HTTPS) и SameSite=Lax:

ТокенСрок действияНазначение
Токен доступа15 минутПодтверждает вашу личность при каждом запросе
Токен обновления14 днейПозволяет получить новую пару токенов; каждое обновление выдает новую пару

Разрешения в токене не передаются. Они считываются из базы данных при каждом запросе, поэтому деактивация пользователя, удаление роли или изменение назначения группы вступает в силу при следующем запросе этого человека. Членство в группах каталога считывается заново при каждом входе.

примечание

Отзывать токены обновления по одному пока нельзя. Чтобы прекратить доступ человека до истечения его сеанса, деактивируйте пользователя. Выход из Excubius не выполняет выход из Microsoft или Google.

Ключей API пока нет: в этом выпуске скрипты и другие инструменты не могут вызывать API от своего имени.

Роли в дереве сущностей​

Роль назначается человеку или группе каталога в сущности и действует в этой сущности и во всем, что находится ниже нее. Один человек может иметь роль Entity admin для одного клиента и Operator для другого. В любой сущности действующей считается самая высокая роль, найденная в этой сущности и ее предках, с учетом собственных ролей человека и ролей его групп.

РольВозможности
Viewer (наблюдатель)Читать панели мониторинга, оповещения, замечания и сведения о ресурсах; изменять собственные параметры
Operator (оператор)Все, что может наблюдатель, а также подтверждать, отключать уведомления, назначать и разрешать оповещения, создавать задачи Jira и планировать окна обслуживания
Editor (редактор)Все, что может оператор, а также изменять проверки и пороговые значения ресурсов и принимать риски безопасности
Entity admin (администратор сущности)Все, что может редактор, а также управлять сущностями ветви, значениями по умолчанию сущностей, ресурсами, учетными данными, источниками, людьми, ролями, приглашениями, каналами уведомлений, параметрами Jira и страницей состояния
Super admin (суперадминистратор)Все во всех ветвях, а также параметры всей установки. Назначается только в корне и только другим суперадминистратором

Что это означает на практике:

  • Каждый список ограничен вашими ветвями: сущности, ресурсы, оповещения, панель мониторинга Overview, учетные данные, каналы и люди. Если ваши роли начинаются с ООО «Лукоморье», видимое вам дерево сущностей тоже начинается там.
  • Все, что находится за пределами ваших ветвей, для вас не существует: при открытии адреса такого объекта отображается сообщение Not found, or no longer visible to you. Для того, что вы можете видеть, но не можете изменить, отображается Your role does not allow this.
  • Назначение ролей не выходит за пределы вашей ветви и уровня: администратор сущности может приглашать людей и назначать роли только в сущностях, которые он администрирует, и никогда не может назначить роль выше своей.
  • Учетные данные принадлежат сущности-владельцу и могут использоваться ресурсами этой сущности и сущностей ниже. Чтобы направить сборщик на узел с этими учетными данными, нужна роль администратора сущности в сущности, которой принадлежат учетные данные, поэтому администратор одного клиента не может направить имя входа, предоставленное сверху, на любой узел по своему выбору.

Само дерево описано в статье Сущности, теги и наследование.

Секреты​

Учетные данные для мониторинга, ключи API источников, секреты клиентов и ключи отправленных сертификатов доступны только для записи:

  • Они шифруются в базе данных с помощью AES и подписи HMAC (Fernet) ключом, который создает программа установки и который хранится в файле конфигурации сервера, а не в базе данных. Дамп базы данных сам по себе не раскрывает ни одного секрета.
  • Экраны и API сообщают только, задан ли секрет, например stored — leave empty to keep it. Никто не может прочитать секрет обратно, независимо от роли.
  • Секрет расшифровывается на сервере или передается сборщику по внутренней сети сервера, когда он нужен для проверки. Сборщик хранит его в памяти и никогда не записывает в журнал.
  • Контейнер сборщика получает только собственный токен и параметры: никогда не получает пароль базы данных, секрет для подписи сеансов или ключ шифрования. Маршруты сборщика отклоняются на границе сервера, поэтому к нему можно обратиться только изнутри.

Сами учетные данные создаются без прав на запись и установку в отслеживаемых системах; см. статью Архитектура.

Аудит​

Каждое изменение, выполненное через API, записывается в журнал аудита с указанием пользователя, времени и IP-адреса запроса. Для входа и доступа записываются следующие события:

СобытиеЗапись
Входlogin
Отказ после ответа поставщика с указанием причиныlogin.failed
Учетная запись создана при первом входеuser.create
Приглашение создано, принято или удаленоinvitation.create, invitation.accept, invitation.delete
Роль назначена или удаленаrole.grant, role.revoke
Изменен режим регистрацииregistration.update, registration.reset
Изменен пользователь или его настройкиuser.update, user.preferences

Действия с оповещениями, изменения пороговых значений и источников, окна обслуживания и изменения страницы состояния регистрируются в аудите так же. Журнал аудита хранится в базе данных платформы.