Доступ и сущности
Права доступа
Иерархическая модель прав 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>— делегированный доступ к конкретному пользователю или отделу.
Правила наследования и сопоставления
Матчер проверяет права по трём правилам сверху вниз:
rootоткрывает доступ ко всему.- Иерархия по точкам в
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.
- Отсутствие
operationилиscopeозначает «любой».- Право без
operation(authservice.users) разрешает все операции для этогоbaseи его потомков. - Право без
scope(authservice.users.sessions:read) разрешает чтение сессий любого пользователя, включаяselfи любой<uuid>.
- Право без
| Выданное право | Требуемое право | Результат |
|---|---|---|
root | любое | Разрешено |
authservice.users | authservice.users.sessions:read:self | Разрешено |
authservice.users.sessions:read | authservice.users.sessions:read:<uuid> | Разрешено |
authservice.users.sessions:read:self | authservice.users.sessions:read:<чужой-uuid> | Запрещено |
authservice.departments:read:it | authservice.departments.members:read:it | Разрешено |
authservice.departments:read:it | authservice.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) описан на странице Отделы.