fix(security): KVE-2026-1914/1915/1919 remediation 전건

위임 관리자(부관리자)가 권한·역할·표현식·비밀 콘텐츠 경계를 우회하던
결함군을 계층 대칭성 원칙으로 전건 차단한다. 약한 경로가 정상 응답을
내보내는 것이 유일한 증상이라, 게이트를 생산 지점 한 곳(SSoT)에 두고
같은 데이터를 내보내는 소비 경로 전부가 그 게이트를 경유하도록 맞췄다.

- 등급 상한(rank ceiling): 슈퍼관리자 보호·역할/사용자 역할 배정(추가·제거
 대칭)·일괄 상태변경·순서변경을 상세 경로와 동일 강도로 재적용. 가드는
 DB 쓰기에 선행하여 거부 시 상태 불변.
- 레이아웃 표현식: new Function/with 실행을 AST 화이트리스트 평가기로 교체.
 비-문자열 computed 키 정규화(normalizeKey)·Object facade(리플렉션 static
 제거)·legacy 접근자 차단. 저장측 검증·정적 검사와 3계층 동형.
- secret 게이트: 비밀글의 댓글·첨부·문의 독립 경로 재적용, hash 파일서빙
 소유권·비밀·발행 상태 검사 통일.
- 신뢰 스크립트 호스트: 확장 선언 기반 + same-origin 브라우저 정규화를
 런타임·저장측·정적검사 3층 동형화.
- 회귀 감지: 단위·Feature·E2E·시나리오 매니페스트 전축 + audit 룰 4종 신설.
This commit is contained in:
HeuJung committed 2026-08-17 01:45:09 +09:00
1 parent cd84b63d2b
commit 71abdeaf60
249 files changed
+14354 -1134

No files matched your search

@@ -11,6 +11,7 @@ use App\Http\Resources\AttachmentResource;
use App\Models\Attachment;
use App\Services\AttachmentService;
use Exception;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Http\JsonResponse;
/**
@@ -21,7 +22,7 @@ class AttachmentController extends AdminBaseController
/**
* AttachmentController 생성자
*
* @param AttachmentService $attachmentService 첨부파일 서비스
* @param AttachmentService $attachmentService 첨부파일 서비스
*/
public function __construct(
private AttachmentService $attachmentService
@@ -32,7 +33,7 @@ class AttachmentController extends AdminBaseController
/**
* 단일 파일 업로드
*
* @param UploadAttachmentRequest $request 업로드 요청
* @param UploadAttachmentRequest $request 업로드 요청
* @return JsonResponse
*/
public function upload(UploadAttachmentRequest $request): JsonResponse
@@ -64,7 +65,7 @@ class AttachmentController extends AdminBaseController
/**
* 여러 파일 일괄 업로드
*
* @param UploadBatchAttachmentRequest $request 일괄 업로드 요청
* @param UploadBatchAttachmentRequest $request 일괄 업로드 요청
* @return JsonResponse
*/
public function uploadBatch(UploadBatchAttachmentRequest $request): JsonResponse
@@ -117,7 +118,7 @@ class AttachmentController extends AdminBaseController
/**
* 순서 변경
*
* @param ReorderAttachmentsRequest $request 순서 변경 요청
* @param ReorderAttachmentsRequest $request 순서 변경 요청
* @return JsonResponse
*/
public function reorder(ReorderAttachmentsRequest $request): JsonResponse
@@ -126,9 +127,12 @@ class AttachmentController extends AdminBaseController
$this->attachmentService->reorder($request->input('order'));
return $this->success('attachment.reorder_success');
} catch (AuthorizationException $e) {
// 스코프 밖 첨부가 포함된 경우. 아래 제네릭 catch 보다 앞에 둬야 한다 —
// 뒤에 두면 인가 거부가 500 으로 뭉개져 상세 경로(403)와 응답이 갈린다.
return $this->error('auth.scope_denied', 403, $e->getMessage());
} catch (Exception $e) {
return $this->error('attachment.reorder_failed', 500, $e->getMessage());
}
}
}
@@ -12,6 +12,7 @@ use App\Http\Resources\MenuCollection;
use App\Http\Resources\MenuResource;
use App\Models\Menu;
use App\Services\MenuService;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Auth;
use Illuminate\Validation\ValidationException;
@@ -222,6 +223,10 @@ class MenuController extends AdminBaseController
}
} catch (ValidationException $e) {
return $this->error('menu.order_update_failed', 422, $e->errors());
} catch (AuthorizationException $e) {
// 스코프 밖 메뉴가 포함된 경우. 제네릭 catch 보다 앞에 둬야 인가 거부가 500 으로
// 뭉개지지 않고 상세 경로(403)와 같은 응답이 된다.
return $this->error('auth.scope_denied', 403, $e->getMessage());
} catch (\Exception $e) {
return $this->error('menu.update_error', 500, $e->getMessage());
}
@@ -2,20 +2,23 @@
namespace App\Http\Controllers\Api\Admin;
use App\Exceptions\CannotModifyProtectedRoleException;
use App\Exceptions\ExtensionOwnedRoleDeleteException;
use App\Exceptions\PermissionEscalationException;
use App\Exceptions\SystemRoleDeleteException;
use App\Helpers\PermissionHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use App\Http\Requests\Role\ActiveRolesRequest;
use App\Http\Requests\Role\RoleListRequest;
use App\Http\Requests\Role\StoreRoleRequest;
use App\Http\Requests\Role\UpdateRoleRequest;
use App\Http\Resources\RoleCollection;
use App\Http\Resources\RoleResource;
use App\Models\Role;
use App\Models\User;
use App\Services\RoleService;
use Exception;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\ValidationException;
/**
@@ -60,13 +63,13 @@ class RoleController extends AdminBaseController
* core.permissions.read 권한 보유 시 전체 활성 역할을 반환하고,
* 미보유 시 현재 사용자에게 부여된 역할만 반환합니다.
*
* @param Request $request HTTP 요청 객체
* @param ActiveRolesRequest $request 활성 역할 조회 요청
* @return JsonResponse 활성화된 역할 목록을 포함한 JSON 응답
*/
public function active(Request $request): JsonResponse
public function active(ActiveRolesRequest $request): JsonResponse
{
try {
/** @var \App\Models\User $user */
/** @var User $user */
$user = $request->user();
// 역할 관리 권한(core.permissions.read) 보유 → 전체 활성 역할 (사용자 관리용)
@@ -78,7 +81,10 @@ class RoleController extends AdminBaseController
return $this->success('role.fetch_success', [
'data' => RoleResource::collection($roles),
'abilities' => [
'can_assign_roles' => PermissionHelper::check('core.permissions.update'),
// 역할 부여는 "사용자 관리"(core.users.update)의 일부다 — "역할 정의 수정"
// (core.permissions.update)이 아니다. 부여 가능한 개별 역할의 범위는 서버
// 상한(PermissionEscalationGuard)이 역할별로 강제한다.
'can_assign_roles' => PermissionHelper::check('core.users.update'),
],
]);
} catch (Exception $e) {
@@ -122,6 +128,8 @@ class RoleController extends AdminBaseController
new RoleResource($role),
201
);
} catch (PermissionEscalationException $e) {
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
} catch (ValidationException $e) {
return $this->error('role.create_failed', 422, $e->errors());
} catch (Exception $e) {
@@ -145,6 +153,10 @@ class RoleController extends AdminBaseController
'role.update_success',
new RoleResource($updatedRole)
);
} catch (CannotModifyProtectedRoleException $e) {
return $this->error('exceptions.cannot_modify_protected_role', 403);
} catch (PermissionEscalationException $e) {
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
} catch (ValidationException $e) {
return $this->error('role.update_failed', 422, $e->errors());
} catch (Exception $e) {
@@ -174,6 +186,8 @@ class RoleController extends AdminBaseController
} else {
return $this->error('role.update_failed');
}
} catch (CannotModifyProtectedRoleException $e) {
return $this->error('exceptions.cannot_modify_protected_role', 403);
} catch (Exception $e) {
return $this->error('role.update_failed', 500, $e->getMessage());
}
@@ -3,6 +3,8 @@
namespace App\Http\Controllers\Api\Admin;
use App\Exceptions\CannotDeleteSuperAdminException;
use App\Exceptions\CannotModifySuperAdminException;
use App\Exceptions\PermissionEscalationException;
use App\Http\Controllers\Api\Base\AdminBaseController;
use App\Http\Requests\User\BulkUpdateUserStatusRequest;
use App\Http\Requests\User\CheckEmailRequest;
@@ -74,6 +76,8 @@ class UserController extends AdminBaseController
new UserResource($user),
201
);
} catch (PermissionEscalationException $e) {
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
} catch (ValidationException $e) {
return $this->error('user.create_failed', 422, $e->errors());
} catch (Exception $e) {
@@ -122,6 +126,10 @@ class UserController extends AdminBaseController
'user.update_success',
new UserResource($updatedUser)
);
} catch (CannotModifySuperAdminException $e) {
return $this->error('exceptions.cannot_modify_super_admin', 403);
} catch (PermissionEscalationException $e) {
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
} catch (ValidationException $e) {
return $this->error('user.update_failed', 422, $e->errors());
} catch (Exception $e) {
@@ -148,6 +156,8 @@ class UserController extends AdminBaseController
'auth.account_unlocked',
new UserResource($unlocked)
);
} catch (CannotModifySuperAdminException $e) {
return $this->error('exceptions.cannot_modify_super_admin', 403);
} catch (Exception $e) {
return $this->error('user.update_failed', 500, $e, ['error' => $e->getMessage()]);
}
@@ -7,8 +7,10 @@ use App\Models\Template;
use App\Models\TemplateLayout;
use App\Rules\ComponentExists;
use App\Rules\NoExternalUrls;
use App\Rules\SafeLayoutExpressions;
use App\Rules\ValidLayoutStructure;
use App\Rules\WhitelistedEndpoint;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
@@ -24,6 +26,8 @@ class StoreLayoutRequest extends FormRequest
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*
* @return bool 항상 true (권한은 미들웨어가 담당)
*/
public function authorize(): bool
{
@@ -33,7 +37,7 @@ class StoreLayoutRequest extends FormRequest
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
* @return array<string, ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
@@ -67,6 +71,8 @@ class StoreLayoutRequest extends FormRequest
new WhitelistedEndpoint,
// 4. 외부 URL 차단
new NoExternalUrls,
// 5. 표현식 샌드박스 우회/원격 스크립트 저장측 차단
new SafeLayoutExpressions,
],
];
@@ -5,6 +5,7 @@ namespace App\Http\Requests\Layout;
use App\Contracts\Repositories\TemplateRepositoryInterface;
use App\Extension\HookManager;
use App\Rules\NoExternalUrls;
use App\Rules\SafeLayoutExpressions;
use App\Rules\ValidDataSourceMerge;
use App\Rules\ValidLayoutStructure;
use App\Rules\ValidParentLayout;
@@ -265,6 +266,14 @@ class UpdateLayoutContentRequest extends FormRequest
'required',
'array',
new ValidLayoutStructure,
// 표현식 샌드박스 우회/원격 스크립트 저장측 차단 (KVE-2026-1915).
// content 트리 전체를 재귀 순회해야 하므로 배열 규칙에 부착한다 — 문자열
// 필드(endpoint)에 부착하면 is_array 가드로 early-return 되어 무력화된다.
new SafeLayoutExpressions,
// props·actions·init_actions 의 외부 URL 차단. 편집기 저장 경로이므로
// Store/UpdateLayoutRequest 와 동일 강도여야 한다 — 여기 누락 시 다른
// 경로에서 막히는 외부 URL 이 편집기 저장으로는 통과한다.
new NoExternalUrls,
],
// 버전 필드
@@ -426,6 +435,8 @@ class UpdateLayoutContentRequest extends FormRequest
'string',
new WhitelistedEndpoint,
new NoExternalUrls,
// SafeLayoutExpressions 는 content 배열 규칙에서 트리 전체를 순회하므로 여기(문자열
// endpoint)에는 부착하지 않는다 — 문자열에 부착 시 is_array 가드로 no-op 이 된다.
];
if (! $isExtending && ! $isBaseLayout) {
@@ -4,6 +4,7 @@ namespace App\Http\Requests\Layout;
use App\Extension\HookManager;
use App\Rules\NoExternalUrls;
use App\Rules\SafeLayoutExpressions;
use App\Rules\ValidDataSourceMerge;
use App\Rules\ValidLayoutExtensionStructure;
use App\Rules\WhitelistedEndpoint;
@@ -62,6 +63,11 @@ class UpdateLayoutExtensionContentRequest extends FormRequest
'required',
'array',
new ValidLayoutExtensionStructure,
// 표현식 샌드박스 우회/원격 스크립트 저장측 차단 (KVE-2026-1915).
// content 트리 전체(data_sources·scripts·표현식 문자열)를 재귀 순회한다.
new SafeLayoutExpressions,
// props·actions·init_actions 의 외부 URL 차단 (Store/UpdateLayoutRequest 와 동일 강도)
new NoExternalUrls,
],
// 우선순위 (선택 — content.priority 와 별개로 직접 지정 가능)
@@ -74,6 +80,8 @@ class UpdateLayoutExtensionContentRequest extends FormRequest
'content.data_sources' => ['nullable', 'array', new ValidDataSourceMerge],
// 데이터소스 endpoint 검증
// SafeLayoutExpressions 는 content 배열 규칙이 트리 전체를 순회하며 data_sources[].endpoint
// same-origin 까지 검사하므로 여기(문자열)에는 부착하지 않는다 (문자열 부착 시 no-op).
'content.data_sources.*.endpoint' => [
'nullable',
'string',
@@ -7,8 +7,10 @@ use App\Models\Template;
use App\Models\TemplateLayout;
use App\Rules\ComponentExists;
use App\Rules\NoExternalUrls;
use App\Rules\SafeLayoutExpressions;
use App\Rules\ValidLayoutStructure;
use App\Rules\WhitelistedEndpoint;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
@@ -24,6 +26,8 @@ class UpdateLayoutRequest extends FormRequest
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 권한 체크는 라우트의 permission 미들웨어에서 수행됩니다.
*
* @return bool 항상 true (권한은 미들웨어가 담당)
*/
public function authorize(): bool
{
@@ -33,7 +37,7 @@ class UpdateLayoutRequest extends FormRequest
/**
* 요청에 적용할 검증 규칙
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
* @return array<string, ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
@@ -71,6 +75,8 @@ class UpdateLayoutRequest extends FormRequest
new WhitelistedEndpoint,
// 4. 외부 URL 차단
new NoExternalUrls,
// 5. 표현식 샌드박스 우회/원격 스크립트 저장측 차단
new SafeLayoutExpressions,
],
];
@@ -0,0 +1,36 @@
<?php
namespace App\Http\Requests\Role;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Foundation\Http\FormRequest;
/**
* 활성 역할 목록(선택 옵션용) 조회 요청
*
* 별도 검증 규칙 없이 인증 컨텍스트만 전달하는 엔드포인트지만, 컨트롤러가 base
* Illuminate\Http\Request 를 직접 주입받지 않도록 전용 FormRequest 서브클래스를 둔다.
* 인증/권한은 permission 미들웨어 체인이 담당하므로 authorize() 는 true 고정.
*/
class ActiveRolesRequest extends FormRequest
{
/**
* Determine if the user is authorized to make this request.
*
* @return bool 항상 true (권한은 미들웨어 체인이 검증)
*/
public function authorize(): bool
{
return true;
}
/**
* Get the validation rules that apply to the request.
*
* @return array<string, ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
return [];
}
}
+8 -4
View File
@@ -4,6 +4,7 @@ namespace App\Http\Resources;
use App\Http\Resources\Traits\HasAbilityCheck;
use Illuminate\Http\Request;
use Illuminate\Pagination\LengthAwarePaginator;
class UserCollection extends BaseApiCollection
{
@@ -20,7 +21,10 @@ class UserCollection extends BaseApiCollection
'can_create' => 'core.users.create',
'can_update' => 'core.users.update',
'can_delete' => 'core.users.delete',
'can_assign_roles' => 'core.permissions.update',
// 역할 부여는 "사용자 관리"(core.users.update)의 일부다 — "역할 정의 수정"
// (core.permissions.update)이 아니다. 부여 가능한 개별 역할의 범위는 서버
// 상한(PermissionEscalationGuard)이 역할별로 강제한다.
'can_assign_roles' => 'core.users.update',
];
}
@@ -36,7 +40,7 @@ class UserCollection extends BaseApiCollection
'data' => $this->mapWithRowNumber(function ($user) {
return (new UserResource($user))->toListArray(request());
}),
'pagination' => $this->when($this->resource instanceof \Illuminate\Pagination\LengthAwarePaginator, [
'pagination' => $this->when($this->resource instanceof LengthAwarePaginator, [
'current_page' => $this->resource->currentPage(),
'last_page' => $this->resource->lastPage(),
'per_page' => $this->resource->perPage(),
@@ -56,7 +60,7 @@ class UserCollection extends BaseApiCollection
*/
public function withStatistics(array $statistics = []): array
{
$isPaginator = $this->resource instanceof \Illuminate\Pagination\LengthAwarePaginator;
$isPaginator = $this->resource instanceof LengthAwarePaginator;
return [
'data' => $this->mapWithRowNumber(function ($user) {
@@ -87,7 +91,7 @@ class UserCollection extends BaseApiCollection
'data' => $this->mapWithRowNumber(function ($user) {
return (new UserResource($user))->withAdminInfo();
}),
'pagination' => $this->when($this->resource instanceof \Illuminate\Pagination\LengthAwarePaginator, [
'pagination' => $this->when($this->resource instanceof LengthAwarePaginator, [
'current_page' => $this->resource->currentPage(),
'last_page' => $this->resource->lastPage(),
'per_page' => $this->resource->perPage(),
+4 -1
View File
@@ -204,7 +204,10 @@ class UserResource extends BaseApiResource
'can_create' => 'core.users.create',
'can_update' => 'core.users.update',
'can_delete' => 'core.users.delete',
'can_assign_roles' => 'core.permissions.update',
// 역할 부여는 "사용자 관리"(core.users.update)의 일부다 — "역할 정의 수정"
// (core.permissions.update: 역할에 권한을 가감)이 아니다. 부여 가능한 개별 역할의
// 범위는 서버 상한(PermissionEscalationGuard)이 역할별로 강제한다.
'can_assign_roles' => 'core.users.update',
];
}
@@ -14,6 +14,7 @@ use App\Services\ModuleSettingsService;
use App\Services\PluginSettingsService;
use App\Services\SettingsService;
use App\Services\TemplateService;
use App\Support\TrustedScriptHosts;
use Illuminate\View\View;
class TemplateComposer
@@ -103,6 +104,10 @@ class TemplateComposer
// 확장 프론트엔드 병합 번들 URL (상시 ON — 활성 에셋이 없으면 null)
$bundleUrls = $this->buildExtensionBundleUrls($moduleAssets, $pluginAssets, $extensionCacheVersion);
// 신뢰 외부 스크립트 호스트 — 레이아웃 scripts[].src same-origin 예외 허용목록
// (KVE-2026-1915: 확장이 manifest 로 선언한 CDN 호스트만 런타임 로더가 허용)
$trustedScriptHosts = TrustedScriptHosts::hosts();
$view->with('activeAdminTemplate', $activeTemplate);
$view->with('extensionCacheVersion', $extensionCacheVersion);
$view->with('frontendSettings', $frontendSettings);
@@ -115,5 +120,6 @@ class TemplateComposer
$view->with('activePluginsMeta', $activePluginsMeta);
$view->with('appConfig', $appConfig);
$view->with('templateExternals', $templateExternals);
$view->with('trustedScriptHosts', $trustedScriptHosts);
}
}
@@ -14,6 +14,7 @@ use App\Services\ModuleSettingsService;
use App\Services\PluginSettingsService;
use App\Services\SettingsService;
use App\Services\TemplateService;
use App\Support\TrustedScriptHosts;
use Illuminate\View\View;
/**
@@ -109,6 +110,10 @@ class UserTemplateComposer
// 확장 프론트엔드 병합 번들 URL (상시 ON — 활성 에셋이 없으면 null)
$bundleUrls = $this->buildExtensionBundleUrls($moduleAssets, $pluginAssets, $extensionCacheVersion);
// 신뢰 외부 스크립트 호스트 — 레이아웃 scripts[].src same-origin 예외 허용목록
// (KVE-2026-1915: 확장이 manifest 로 선언한 CDN 호스트만 런타임 로더가 허용)
$trustedScriptHosts = TrustedScriptHosts::hosts();
$view->with('activeUserTemplate', $activeTemplate);
$view->with('extensionCacheVersion', $extensionCacheVersion);
$view->with('frontendSettings', $frontendSettings);
@@ -121,5 +126,6 @@ class UserTemplateComposer
$view->with('activePluginsMeta', $activePluginsMeta);
$view->with('appConfig', $appConfig);
$view->with('templateExternals', $templateExternals);
$view->with('trustedScriptHosts', $trustedScriptHosts);
}
}