2026-07-04 23:08:05 +08:00
|
|
|
"""Security and permission helpers."""
|
|
|
|
|
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
from backend.dto.common import ApiError, ErrorCode
|
|
|
|
|
from core.identity import RequestContext
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def require_authenticated(ctx: RequestContext) -> None:
|
|
|
|
|
if not ctx.is_authenticated:
|
|
|
|
|
raise ApiError(
|
|
|
|
|
ErrorCode.UNAUTHORIZED,
|
2026-07-05 13:13:00 +08:00
|
|
|
"ImageStudio \u9700\u8981 AstrBot WebUI \u767b\u5f55\u6001",
|
2026-07-04 23:08:05 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def require_permission(ctx: RequestContext, permission: str) -> None:
|
|
|
|
|
require_authenticated(ctx)
|
|
|
|
|
if not ctx.has_permission(permission):
|
|
|
|
|
raise ApiError(
|
|
|
|
|
ErrorCode.FORBIDDEN,
|
2026-07-05 13:13:00 +08:00
|
|
|
"\u5f53\u524d\u7528\u6237\u6ca1\u6709\u6267\u884c\u8be5\u64cd\u4f5c\u7684\u6743\u9650",
|
2026-07-04 23:08:05 +08:00
|
|
|
{"permission": permission},
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def require_write(ctx: RequestContext) -> None:
|
|
|
|
|
require_permission(ctx, "can_write")
|
|
|
|
|
|
|
|
|
|
|
2026-07-11 21:50:34 +08:00
|
|
|
def require_task_retry(ctx: RequestContext) -> None:
|
|
|
|
|
require_write(ctx)
|
|
|
|
|
require_permission(ctx, "can_retry_tasks")
|
|
|
|
|
|
|
|
|
|
|
2026-07-04 23:08:05 +08:00
|
|
|
def require_config_manager(ctx: RequestContext) -> None:
|
|
|
|
|
require_permission(ctx, "can_manage_config")
|
2026-07-27 11:50:08 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
def can_access_owned_resource(owner_user_id: str | None, ctx: RequestContext) -> bool:
|
|
|
|
|
"""Whether ``ctx`` may act on a resource owned by ``owner_user_id``.
|
|
|
|
|
|
|
|
|
|
Single source of truth for ownership. ``ProfileService._require_owner`` and
|
|
|
|
|
``ResourceAccessService._can_access`` used to disagree -- the former
|
|
|
|
|
ignored ``can_manage_all_profiles`` entirely -- so the same actor could
|
|
|
|
|
reach a profile through the chat chain and be refused through the web
|
|
|
|
|
route. Any elevation rule belongs here and nowhere else.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
if ctx.has_permission("can_manage_all_profiles") or ctx.has_permission("*"):
|
|
|
|
|
return True
|
|
|
|
|
return bool(ctx.actor_id and owner_user_id and ctx.actor_id == owner_user_id)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def enforce_route_permission(ctx: RequestContext, permission: str) -> None:
|
|
|
|
|
"""Apply a route's declared ``PERMISSION_MATRIX`` entry.
|
|
|
|
|
|
|
|
|
|
``PERMISSION_MATRIX`` used to be documentation only: the dispatcher never
|
|
|
|
|
read ``RouteMatch.permission``, so a route's real protection was whichever
|
|
|
|
|
``require_*`` call its handler happened to contain. Declaration and
|
|
|
|
|
enforcement could drift silently, and a handler that simply forgot the call
|
|
|
|
|
was wide open.
|
|
|
|
|
|
|
|
|
|
Enforcing here makes the manifest the contract. Handlers keep their own
|
|
|
|
|
``require_*`` calls -- they run inside ``handle_request`` and produce the
|
|
|
|
|
same errors -- so this is an additional gate, never a replacement.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
# Imported lazily: backend.route_registry imports nothing from core, and
|
|
|
|
|
# keeping it that way avoids a core -> backend import cycle at module load.
|
|
|
|
|
from backend.route_registry import permission_requirement
|
|
|
|
|
|
|
|
|
|
requirement = permission_requirement(permission)
|
|
|
|
|
if requirement.get("auth_required", True):
|
|
|
|
|
require_authenticated(ctx)
|
|
|
|
|
required = requirement.get("required_permissions") or (
|
|
|
|
|
[requirement["required_permission"]] if requirement.get("required_permission") else []
|
|
|
|
|
)
|
|
|
|
|
for name in required:
|
|
|
|
|
if name:
|
|
|
|
|
require_permission(ctx, name)
|