- 在多个控制器中将权限检查从 hasAdminPermission 更新为 hasPermissionCode,以增强权限管理的灵活性。 - 引入 AdminScopePolicy,优化基于代理节点的权限和数据过滤逻辑,确保管理员能够更精确地控制访问权限。 - 在请求验证中添加 agent_node_id 字段,确保 API 接口支持代理节点的相关操作。 - 更新 AdminUser 模型,新增 hasPermissionCode 方法,以支持更细粒度的权限检查。 - 优化审计日志记录逻辑,确保在处理请求时能够准确记录管理员的操作。
92 lines
2.5 KiB
PHP
92 lines
2.5 KiB
PHP
<?php
|
|
|
|
namespace App\Support;
|
|
|
|
use App\Models\AdminRole;
|
|
use App\Models\AdminUser;
|
|
use App\Models\AgentNode;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
final class AgentRoleAuthorization
|
|
{
|
|
public static function roleVisibleTo(AdminUser $admin, AdminRole $role): bool
|
|
{
|
|
if ($admin->isSuperAdmin()) {
|
|
return true;
|
|
}
|
|
|
|
if ($role->scope_type !== AdminRole::SCOPE_AGENT || $role->owner_agent_id === null) {
|
|
return false;
|
|
}
|
|
|
|
$owner = AgentNode::query()->find((int) $role->owner_agent_id);
|
|
if ($owner === null) {
|
|
return false;
|
|
}
|
|
|
|
return AdminAgentScope::nodeVisibleTo($admin, $owner);
|
|
}
|
|
|
|
public static function roleManageableBy(AdminUser $admin, AdminRole $role): bool
|
|
{
|
|
if ($role->delegated_from_role_id !== null) {
|
|
return false;
|
|
}
|
|
|
|
if (! self::roleVisibleTo($admin, $role)) {
|
|
return false;
|
|
}
|
|
|
|
return $admin->isSuperAdmin() || $admin->hasPermissionCode('agent.node.manage');
|
|
}
|
|
|
|
/**
|
|
* @param list<string> $permissionSlugs
|
|
*/
|
|
public static function assertSlugsWithinActor(AdminUser $actor, array $permissionSlugs): void
|
|
{
|
|
if ($actor->isSuperAdmin()) {
|
|
return;
|
|
}
|
|
|
|
$allowed = $actor->adminPermissionSlugs();
|
|
$invalid = array_values(array_diff($permissionSlugs, $allowed));
|
|
if ($invalid !== []) {
|
|
throw ValidationException::withMessages([
|
|
'permission_slugs' => ['permission_exceeds_actor: '.implode(', ', $invalid)],
|
|
]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param list<string> $permissionSlugs
|
|
*/
|
|
public static function assertSlugsForAgentRole(
|
|
AdminUser $actor,
|
|
AgentNode $ownerAgent,
|
|
array $permissionSlugs,
|
|
): void {
|
|
if ($actor->isSuperAdmin()) {
|
|
return;
|
|
}
|
|
|
|
self::assertSlugsWithinActor($actor, $permissionSlugs);
|
|
AgentDelegationAuthorization::assertRoleSlugsWithinAgentCeiling($ownerAgent, $permissionSlugs, $actor);
|
|
}
|
|
|
|
public static function denyUnlessRoleManageable(AdminUser $admin, AdminRole $role): ?\Illuminate\Http\JsonResponse
|
|
{
|
|
if (self::roleManageableBy($admin, $role)) {
|
|
return null;
|
|
}
|
|
|
|
return ApiMessage::errorResponse(
|
|
request(),
|
|
'admin.agent_role_manage_denied',
|
|
\App\Lottery\ErrorCode::AdminForbidden->value,
|
|
null,
|
|
403,
|
|
);
|
|
}
|
|
}
|