HeuJung
4b6adf4788
KISA 신고포상제 접수 3건(KVE-2026-1677/1678/1679)의 공통 원인은 하나다 — "위험한 것을 골라 막았고, 목록 밖으로 우회됐다". 세 지점 모두 판정을 뒤집는다. 예약 작업 Artisan (KVE-2026-1679) 차단 9개 / 허용 229개였던 구조를 허용목록으로 바꾸고 명령마다 허용 옵션을 선언한다. 검증 과정에서 보고서보다 짧은 경로를 추가로 발견했다 — 검증기는 preg_split 의 첫 토큰을 명령명으로 봤지만 실행부는 문자열째 넘겼고, parameters 가 비면 Laravel 이 StringInput 으로 재파싱한다. 따옴표 한 쌍이면 차단목록의 tinker 가 그대로 실행됐다 (마커 파일로 확인). 파서를 엄격 형태 하나로 고정하고 실행은 (명령명, 인자배열)로 넘겨 재해석 지점 자체를 없앴다. 언어팩 (KVE-2026-1678) 위험 함수 11개를 정규식으로 나열하던 검사를 토큰 상태기계로 교체해 "번역 배열만" 통과시킨다. 목록에 없는 함수도, 함수 이름을 아예 쓰지 않는 형태도 원리적으로 막힌다. 파일 형식·PHP 위치·심볼릭 링크도 화이트리스트로 뒤집었다. 활성 승격이 require 배선의 필수 조건이므로 설치와 활성화의 권한 경계를 네 설치 경로 전부에 같은 강도로 건다 — 경로별 면제는 곧 우회로가 되기 때문이다. 화면은 운영자의 활성화 권한을 보고 auto_activate 를 실을지 결정하므로 재설치 흐름은 그대로 동작한다. 인스톨러 (KVE-2026-1677) 실행 바이너리 자리에 인자가 들어가는 것을 형태 규칙으로 차단한다. escapeshellarg 는 "하나의 인자" 임만 보장할 뿐 그 인자가 실행 파일인지 스크립트인지는 보장하지 않는다. 판정을 의존성 0 공용 정책으로 모아 진단 API·설치 워커·저장 시점이 같은 규칙을 쓴다. stat 은 호출하지 않는다 — 접근이 제한된 서버에서 정상 경로가 거부되던 회귀를 재발시키지 않기 위함이다. 검증: 백엔드 392건 + 프론트 7건 green(skip 1, symlink 미지원 환경). PoC 마커로 red 를 먼저 확보하고, 수정 후 stash 역회귀로 다시 red 가 되는 것까지 확인했다.
81 lines
2.4 KiB
PHP
81 lines
2.4 KiB
PHP
<?php
|
|
|
|
namespace App\Exceptions;
|
|
|
|
use Exception;
|
|
|
|
/**
|
|
* 스케줄 실행 실패 예외
|
|
*
|
|
* 저장된 스케줄을 실행하는 시점에 차단 목록에 걸리거나(artisan/shell 화이트리스트, 내부망 URL),
|
|
* 실행 자체가 실패했을 때 발생합니다. `ScheduleService` 가 이 예외를 잡아 실행 이력에 기록합니다.
|
|
*/
|
|
class ScheduleExecutionException extends Exception
|
|
{
|
|
/**
|
|
* 거부 사유 코드 (`ScheduleCommandValidator::ARTISAN_REASON_*`).
|
|
*
|
|
* 관리자에게 보이는 메시지는 사유와 무관하게 동일하지만, 운영 진단 로그에는
|
|
* 어느 규칙에 걸렸는지가 남아야 한다 — 업그레이드 점검 스텝을 두지 않기로 했으므로
|
|
* 실행 이력과 로그가 유일한 통로다.
|
|
*/
|
|
public ?string $reasonCode = null;
|
|
|
|
/**
|
|
* 허용되지 않은 Artisan 명령
|
|
*
|
|
* @param string|null $reasonCode 거부 사유 코드 (`ScheduleCommandValidator::ARTISAN_REASON_*`)
|
|
* @return self 생성된 예외
|
|
*/
|
|
public static function artisanNotAllowed(?string $reasonCode = null): self
|
|
{
|
|
$exception = new self(__('schedule.artisan_not_allowed'));
|
|
$exception->reasonCode = $reasonCode;
|
|
|
|
return $exception;
|
|
}
|
|
|
|
/**
|
|
* 허용되지 않은 쉘 명령
|
|
*
|
|
* @return self 생성된 예외
|
|
*/
|
|
public static function shellNotAllowed(): self
|
|
{
|
|
return new self(__('schedule.shell_not_allowed'));
|
|
}
|
|
|
|
/**
|
|
* 쉘 명령 실행 실패
|
|
*
|
|
* @param string $errorOutput 프로세스 표준 에러 출력
|
|
* @param int $exitCode 프로세스 종료 코드
|
|
* @return self 생성된 예외
|
|
*/
|
|
public static function shellCommandFailed(string $errorOutput, int $exitCode): self
|
|
{
|
|
return new self($errorOutput !== '' ? $errorOutput : __('schedule.shell_command_failed'), $exitCode);
|
|
}
|
|
|
|
/**
|
|
* 공개되지 않은(내부망) URL 호출 차단
|
|
*
|
|
* @return self 생성된 예외
|
|
*/
|
|
public static function urlNotPublic(): self
|
|
{
|
|
return new self(__('schedule.url_not_public'));
|
|
}
|
|
|
|
/**
|
|
* HTTP 요청 실패
|
|
*
|
|
* @param int $status 응답 상태 코드
|
|
* @return self 생성된 예외
|
|
*/
|
|
public static function httpRequestFailed(int $status): self
|
|
{
|
|
return new self(__('schedule.http_request_failed', ['status' => $status]), $status);
|
|
}
|
|
}
|