Доступ и сущности

Права доступа

Иерархическая модель прав base:operation:scope, скоупы self и делегирование по UUID, справочник прав Julia.

Авторизация в Julia и подключённых сервисах строится на иерархических строковых правах формата base:operation:scope.

Формат права

<base>[:<operation>[:<scope>]]
  • base — путь ресурса через точку (например, authservice.users.profile).
  • operation (опционально) — действие над ресурсом (read, write, delete, edit, manage и т. д.).
  • scope (опционально) — область действия:
    • не указан — глобальный доступ ко всем ресурсам данного типа;
    • self — доступ только к собственным ресурсам пользователя;
    • public — доступ к публичным данным (например, authservice.departments:read:public);
    • <uuid> или <department-slug> — делегированный доступ к конкретному пользователю или отделу.

Правила наследования и сопоставления

Матчер проверяет права по трём правилам сверху вниз:

  1. root открывает доступ ко всему.
  2. Иерархия по точкам в base. Более общее право покрывает все вложенные пути:
    • authservice.users → покрывает authservice.users:read, authservice.users.profile:write, authservice.users.sessions:delete и т. д.
    • authservice.departments:read:dev-team → покрывает authservice.departments.members:read:dev-team, authservice.departments.roles:read:dev-team и authservice.departments.permissions:read:dev-team.
  3. Отсутствие operation или scope означает «любой».
    • Право без operation (authservice.users) разрешает все операции для этого base и его потомков.
    • Право без scope (authservice.users.sessions:read) разрешает чтение сессий любого пользователя, включая self и любой <uuid>.
Выданное правоТребуемое правоРезультат
rootлюбоеРазрешено
authservice.usersauthservice.users.sessions:read:selfРазрешено
authservice.users.sessions:readauthservice.users.sessions:read:<uuid>Разрешено
authservice.users.sessions:read:selfauthservice.users.sessions:read:<чужой-uuid>Запрещено
authservice.departments:read:itauthservice.departments.members:read:itРазрешено
authservice.departments:read:itauthservice.departments.members:read:mediaЗапрещено
Владение ресурсом (self) вычисляется динамически из идентификатора субъекта (sub), а не хранится отдельной записью на каждый объект.

Справочник основных прав Julia

Пользователи

ПравоНазначение
authservice.users:readЧтение пользователей (включая gRPC Users.GetUser)
authservice.users.profile:readЧтение полного профиля любого пользователя
authservice.users.profile:read:selfЧтение собственного профиля (GET /v1/users/@me)
authservice.users.profile:writeРедактирование профиля и медиа любого пользователя
authservice.users.profile:write:selfРедактирование собственного профиля, аватара и баннера
authservice.users.permissions:readПросмотр прав любого пользователя
authservice.users.permissions:read:selfПросмотр собственных прав
authservice.users.sessions:readПросмотр сессий любого пользователя
authservice.users.sessions:read:selfПросмотр собственных сессий
authservice.users.sessions:deleteЗавершение сессий любого пользователя
authservice.users.sessions:delete:selfЗавершение собственных сессий

API-ключи

ПравоНазначение
authservice.apitokens:readПросмотр всех API-ключей в системе
authservice.apitokens:read:selfПросмотр собственных API-ключей
authservice.apitokens:writeВыпуск и отзыв любых ключей, включая сервисные (svc)
authservice.apitokens:write:selfВыпуск и отзыв собственных пользовательских ключей (pat)
authservice.apitokens:introspectПроверка предъявленного API-ключа через IntrospectApiKey (только для сервисных ключей)

Отделы

ПравоНазначение
authservice.departments:writeПолное администрирование всех отделов, включая корневые
authservice.departments:readПолное чтение всех отделов (включая скрытые, приватных участников и роли)
authservice.departments:read:publicЧтение публичных участников видимых отделов
authservice.departments.permissions:manageУправление правами членства отдела (выдача новых прав временно отключена)

Полный каталог ролевых прав отделов (:edit, .members:*, .roles:*, .children:*, .descendants:manage) описан на странице Отделы.