Files
api/services/nginx/app/routes/moduleActionLogsRoute.php
T
OpenClaw 51a87655d6 feat(auth): add scope-based access control to all existing routes (TRU-149)
Adds a scope-based access control layer to all 81 existing API routes.
Sits alongside existing session-cookie auth (does not replace it).

What this PR does:
- Audits every existing route and documents required scope per route
  (see documentation/auth/route-scope-audit.md)
- Adds classes/auth/scope.php with 10 scope constants and role→scope defaults
- Adds classes/auth/scope_middleware.php with requireScope/requireAnyScope/requireRole
- Applies require*() calls to all 81 existing routes
- Adds ScopeMiddlewareTest (unit, 178 lines) and RouteScopeTest (integration, 212 lines)

Coexistence note:
This branch's classes/auth/scope.php is a stub that will be replaced
by classes/auth/scope_registry.php (from TRU-145 / PR #396) when that
PR merges first. The two have compatible APIs.

Refs: TRU-149
2026-08-17 11:43:13 +00:00

50 lines
1.4 KiB
PHP

<?php
namespace routes;
use classes\authentication;
use objects\logs_o;
use objects\module_action_logs_o;
use traits\route_t;
use app\auth\Scope;
use app\auth\ScopeMiddleware;
class moduleActionLogsRoute
{
use route_t;
public function run(): void
{
/** Modules > Action Logs > List */
$this->get('/modules/action-logs', function () {
ScopeMiddleware::requireScope(Scope::SUPERUSER_READ, '/modules/action-logs');
global $response;
$this->requirePermission('modules_action_logs_view');
// Get the user object
$user = (new authentication())->get_user();
if (!$user) {
$response->error('Invalid session', 401);
}
// Log the incident
(new logs_o())->add('modules_action_logs', 'global', 1, $user->id, 'LIST_MODULES_ACTION_LOGS', 'User listed module action logs');
$module_action_logs_o = new module_action_logs_o();
$response->success(
$module_action_logs_o->listObjectsWithPaginationIfSet(
function ($log) {
return (new module_action_logs_o())->select((int)$log['id'])->asArray();
}
)
);
},
[
'modules_action_logs_view' => 'View module action logs',
]
);
}
}