HeuJung
9cf9c3ff8c
KISA 제보 취약점(KVE-2026-1914/1919/2019/2029/2041/2042/2043/2044)과 그 수정 과정에서 드러난 자격증명 전송로 결함을 함께 해소한다. globalHeaders 는 데이터소스와 apiCall 핸들러에만 적용되는데, 코어 ApiClient 를 직접 부르는 경로들이 그 사실을 모른 채 게이트된 엔드포인트를 호출하고 있었다. 서버는 정당한 사용자를 거부하고 화면은 이미 버튼을 내준 뒤라, 예외도 로그도 없이 그 자리만 비는 형태로만 드러났다. 전송로 10축을 전수 열거해 6건을 고치고, 같은 실수가 반복되지 않도록 규정과 coverage 에 등재했다. 아웃바운드 프록시가 사이트 자기 자신으로 가는 내부 요청까지 가로채 저장이 수십 초씩 걸리던 문제도 함께 고쳤다. 실패가 폴백으로 삼켜져 화면에는 지연으로만 나타났다.
346 lines
14 KiB
PHP
346 lines
14 KiB
PHP
<?php
|
|
|
|
/**
|
|
* 인스톨러 런타임 설정 헬퍼
|
|
*
|
|
* 설치 진행 중 동적 설정(DB 자격증명, APP_KEY) 을 .env 가 아닌
|
|
* storage/installer/runtime.php 에 PHP 배열로 기록한다.
|
|
*
|
|
* Laravel 부팅 시 InstallerRuntimeServiceProvider 가 이 파일을 읽어
|
|
* config('database.*') / config('app.key') 에 주입하므로,
|
|
* 설치 진행 중 .env 를 건드리지 않고도 마이그레이션/시더가 동작한다.
|
|
*
|
|
* 설치 완료 UI 노출 후 finalize-env.php 가 호출되면 이 파일의 내용을
|
|
* .env 에 머지하고 파일을 삭제한다.
|
|
*
|
|
* @see https://github.com/gnuboard/g7/issues/23
|
|
*/
|
|
if (! defined('BASE_PATH')) {
|
|
throw new RuntimeException('installer-runtime.php requires BASE_PATH constant.');
|
|
}
|
|
|
|
// .env 값 직렬화 정책 (개행 주입 차단) — functions.php 와 같은 관문을 공유한다.
|
|
require_once __DIR__.'/env-value.php';
|
|
|
|
if (! defined('INSTALLER_RUNTIME_PATH')) {
|
|
define('INSTALLER_RUNTIME_PATH', BASE_PATH.'/storage/installer/runtime.php');
|
|
}
|
|
|
|
if (! function_exists('readInstallerRuntime')) {
|
|
/**
|
|
* runtime.php 를 읽어 배열로 반환한다.
|
|
*
|
|
* @return array<string, mixed>|null 파일이 없거나 형식이 잘못된 경우 null
|
|
*/
|
|
function readInstallerRuntime(): ?array
|
|
{
|
|
if (! is_file(INSTALLER_RUNTIME_PATH)) {
|
|
return null;
|
|
}
|
|
|
|
$data = @include INSTALLER_RUNTIME_PATH;
|
|
|
|
return is_array($data) ? $data : null;
|
|
}
|
|
}
|
|
|
|
if (! function_exists('writeInstallerRuntime')) {
|
|
/**
|
|
* runtime.php 를 atomic 하게 작성한다.
|
|
*
|
|
* 디렉토리 부재 시 생성. 파일 권한은 0600 으로 설정.
|
|
*
|
|
* @param array<string, mixed> $data 저장할 배열
|
|
* @return bool 성공 여부
|
|
*/
|
|
function writeInstallerRuntime(array $data): bool
|
|
{
|
|
$dir = dirname(INSTALLER_RUNTIME_PATH);
|
|
|
|
if (! is_dir($dir) && ! @mkdir($dir, 0755, true) && ! is_dir($dir)) {
|
|
return false;
|
|
}
|
|
|
|
$php = "<?php\n\nreturn ".var_export($data, true).";\n";
|
|
|
|
$tmp = INSTALLER_RUNTIME_PATH.'.tmp';
|
|
if (@file_put_contents($tmp, $php, LOCK_EX) === false) {
|
|
return false;
|
|
}
|
|
|
|
// atomic rename
|
|
if (! @rename($tmp, INSTALLER_RUNTIME_PATH)) {
|
|
@unlink($tmp);
|
|
|
|
return false;
|
|
}
|
|
|
|
@chmod(INSTALLER_RUNTIME_PATH, 0600);
|
|
|
|
return true;
|
|
}
|
|
}
|
|
|
|
if (! function_exists('deleteInstallerRuntime')) {
|
|
/**
|
|
* runtime.php 를 삭제한다.
|
|
*
|
|
* @return bool 삭제 성공 또는 이미 부재 시 true
|
|
*/
|
|
function deleteInstallerRuntime(): bool
|
|
{
|
|
if (! is_file(INSTALLER_RUNTIME_PATH)) {
|
|
return true;
|
|
}
|
|
|
|
return @unlink(INSTALLER_RUNTIME_PATH);
|
|
}
|
|
}
|
|
|
|
if (! function_exists('generateAppKeyInline')) {
|
|
/**
|
|
* APP_KEY 문자열을 pure PHP 로 생성한다.
|
|
*
|
|
* Laravel 의 Encrypter::generateKey('AES-256-CBC') 와 동일한 32 byte 키를
|
|
* 'base64:' prefix 와 함께 반환한다. artisan key:generate 가 .env 를 직접
|
|
* 수정하므로 인스톨러는 본 함수를 사용해 .env 를 건드리지 않고 키를 확보.
|
|
*
|
|
* @return string Laravel 표준 형식 'base64:...'
|
|
*/
|
|
function generateAppKeyInline(): string
|
|
{
|
|
return 'base64:'.base64_encode(random_bytes(32));
|
|
}
|
|
}
|
|
|
|
if (! function_exists('mergeRuntimeIntoEnv')) {
|
|
/**
|
|
* runtime 배열을 .env 문자열에 머지하여 반환한다.
|
|
*
|
|
* .env.example 템플릿 기반 콘텐츠(generateEnvContent() 결과) 에 runtime 의
|
|
* DB 자격증명 + APP_KEY 를 치환하고 INSTALLER_COMPLETED=true 라인을 추가한다.
|
|
* 파일 IO 를 수행하지 않으므로 단위 테스트 가능.
|
|
*
|
|
* 안전망: generateEnvContent() 가 state.config 에서 DB 정보를 못 읽었을 때
|
|
* (예: state.json 결손) 에도 runtime 의 DB 정보로 .env 이 완성되도록 동작.
|
|
*
|
|
* @param string $envContent .env.example 기반 치환된 본문
|
|
* @param array<string, mixed> $runtime runtime.php 배열
|
|
* @return string 최종 .env 콘텐츠
|
|
*/
|
|
function mergeRuntimeIntoEnv(string $envContent, array $runtime): string
|
|
{
|
|
// DB 자격증명 치환 — state.config 결손 안전망
|
|
$write = $runtime['db']['write'] ?? null;
|
|
if (is_array($write)) {
|
|
$envContent = replaceEnvLine($envContent, 'DB_WRITE_HOST', serializeEnvValue((string) ($write['host'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_WRITE_PORT', serializeEnvValue((string) ($write['port'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_WRITE_DATABASE', serializeEnvValue((string) ($write['database'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_WRITE_USERNAME', serializeEnvValue((string) ($write['username'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_WRITE_PASSWORD', serializeEnvValue((string) ($write['password'] ?? '')));
|
|
}
|
|
|
|
// Read DB — runtime 에 read 키가 있을 때(use_read_db=true)만 명시 기록한다.
|
|
// 미지정 시 DB_READ_* 를 빈 값으로 남겨 config/database.php 의 write fallback(Elvis)
|
|
// 에 위임 → .env 에 write 값이 중복 기록되지 않고, write 변경 시 read stale 위험 제거.
|
|
// (이슈 #63)
|
|
$read = $runtime['db']['read'] ?? null;
|
|
if (is_array($read)) {
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_HOST', serializeEnvValue((string) ($read['host'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_PORT', serializeEnvValue((string) ($read['port'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_DATABASE', serializeEnvValue((string) ($read['database'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_USERNAME', serializeEnvValue((string) ($read['username'] ?? '')));
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_PASSWORD', serializeEnvValue((string) ($read['password'] ?? '')));
|
|
} else {
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_HOST', '');
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_PORT', '');
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_DATABASE', '');
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_USERNAME', '');
|
|
$envContent = replaceEnvLine($envContent, 'DB_READ_PASSWORD', '');
|
|
}
|
|
|
|
if (isset($runtime['db']['prefix'])) {
|
|
$envContent = replaceEnvLine($envContent, 'DB_PREFIX', serializeEnvValue((string) $runtime['db']['prefix']));
|
|
}
|
|
|
|
// APP_KEY 치환
|
|
$appKey = $runtime['app']['key'] ?? null;
|
|
if (is_string($appKey) && str_starts_with($appKey, 'base64:')) {
|
|
$envContent = replaceEnvLine($envContent, 'APP_KEY', $appKey);
|
|
}
|
|
|
|
// INSTALLER_COMPLETED 플래그 추가 (CachesModuleStatus 등이 사용)
|
|
if (! preg_match('/^INSTALLER_COMPLETED=/m', $envContent)) {
|
|
$envContent = rtrim($envContent)."\n\n# Installation Status\nINSTALLER_COMPLETED=true\n";
|
|
}
|
|
|
|
return $envContent;
|
|
}
|
|
}
|
|
|
|
if (! function_exists('escapeEnvValue')) {
|
|
/**
|
|
* .env 값 이스케이프 (functions.php 의 동일 함수 polyfill).
|
|
*
|
|
* 인스톨러 본 흐름은 functions.php 가 먼저 로드되므로 if 분기로 진입하지
|
|
* 않으나, 단위 테스트에서 functions.php 없이 installer-runtime.php 만
|
|
* 로드하는 경우를 위한 안전망.
|
|
*
|
|
* @param string $value 이스케이프할 값
|
|
* @return string 큰따옴표로 감싸고 내부 큰따옴표/백슬래시를 이스케이프한 값
|
|
*/
|
|
function escapeEnvValue(string $value): string
|
|
{
|
|
// 직렬화 정책은 serializeEnvValue 단일 관문이 소유한다 (KVE-2026-2042).
|
|
return serializeEnvValue($value);
|
|
}
|
|
}
|
|
|
|
if (! function_exists('replaceEnvLine')) {
|
|
/**
|
|
* .env 문자열에서 특정 키의 라인을 치환한다.
|
|
*
|
|
* 라인이 없으면 끝에 추가. 값에 공백/특수문자가 있는 경우 호출자가
|
|
* escapeEnvValue() 등으로 escape 후 전달.
|
|
*
|
|
* @param string $envContent .env 본문
|
|
* @param string $key 환경 변수 키
|
|
* @param string $value 대입할 값 (escape 처리된 상태)
|
|
* @return string 치환된 .env 본문
|
|
*/
|
|
function replaceEnvLine(string $envContent, string $key, string $value): string
|
|
{
|
|
$line = $key.'='.$value;
|
|
$pattern = '/^'.preg_quote($key, '/').'=.*$/m';
|
|
|
|
$replaced = preg_replace($pattern, $line, $envContent, 1, $count);
|
|
|
|
if ($count === 0) {
|
|
return rtrim($envContent)."\n".$line."\n";
|
|
}
|
|
|
|
return $replaced;
|
|
}
|
|
}
|
|
|
|
if (! function_exists('buildInstallerRuntimeFromState')) {
|
|
/**
|
|
* 설치 상태(state.json 의 config) 에서 runtime.php 용 배열을 생성한다.
|
|
*
|
|
* runtime.php 가 이미 존재하고 APP_KEY 가 있으면 재사용 (재시도 시 키 보존).
|
|
* 없으면 generateAppKeyInline() 으로 새 키 생성.
|
|
*
|
|
* @param array<string, mixed> $stateConfig state.json 의 config 섹션
|
|
* @return array<string, mixed> runtime.php 형식의 배열
|
|
*/
|
|
function buildInstallerRuntimeFromState(array $stateConfig): array
|
|
{
|
|
$existing = readInstallerRuntime();
|
|
$appKey = $existing['app']['key'] ?? null;
|
|
|
|
if (! $appKey || ! str_starts_with($appKey, 'base64:')) {
|
|
$appKey = generateAppKeyInline();
|
|
}
|
|
|
|
// state.config 에는 더 이상 비밀번호가 기록되지 않으므로(이슈 #465), 세션이 유실된
|
|
// 재개/재시도 경로에서는 기존 runtime.php 의 값을 보존해야 한다. app.key 보존과
|
|
// 동일한 패턴.
|
|
$writePassword = (string) ($stateConfig['db_write_password'] ?? ($stateConfig['db_password'] ?? ''));
|
|
if ($writePassword === '') {
|
|
$writePassword = (string) ($existing['db']['write']['password'] ?? '');
|
|
}
|
|
|
|
$runtime = [
|
|
'db' => [
|
|
'write' => [
|
|
'host' => $stateConfig['db_write_host'] ?? ($stateConfig['db_host'] ?? '127.0.0.1'),
|
|
'port' => $stateConfig['db_write_port'] ?? ($stateConfig['db_port'] ?? '3306'),
|
|
'database' => $stateConfig['db_write_database'] ?? ($stateConfig['db_database'] ?? ''),
|
|
'username' => $stateConfig['db_write_username'] ?? ($stateConfig['db_username'] ?? ''),
|
|
'password' => $writePassword,
|
|
],
|
|
'prefix' => $stateConfig['db_prefix'] ?? '',
|
|
],
|
|
'app' => [
|
|
'key' => $appKey,
|
|
],
|
|
'created_at' => date('c'),
|
|
];
|
|
|
|
// admin 비밀번호는 db_seed 가 소비할 때까지 runtime 에 보존한다. 호출자
|
|
// (install-process.php) 가 세션 값으로 덮어쓰는 경우를 제외하면, 재시도/재개 시
|
|
// 기존 runtime 의 값이 유실되지 않아야 한다 (유실 시 db_seed 재실행 불가).
|
|
if (isset($existing['admin']) && is_array($existing['admin'])) {
|
|
$runtime['admin'] = $existing['admin'];
|
|
}
|
|
|
|
// Read 커넥션은 use_read_db 플래그가 켜진 경우에만 포함한다 (판정 SSoT).
|
|
// 플래그가 꺼져 있으면 db_read_host 에 잔존 값이 있어도 무시 → runtime 에 read 키
|
|
// 미생성 → 하류(mergeRuntimeIntoEnv / InstallerRuntimeServiceProvider)가 write 로
|
|
// 자동 동기화. (이슈 #63: use_read_db=false 인데 db_read_host 를 참조하던 회귀 차단)
|
|
if (! empty($stateConfig['use_read_db'])
|
|
&& ! empty($stateConfig['db_read_host'])
|
|
&& $stateConfig['db_read_host'] !== ($stateConfig['db_write_host'] ?? null)) {
|
|
// read 비밀번호 폴백 순서: state.config → 기존 runtime 의 read 비밀번호 →
|
|
// write 비밀번호. 기존 runtime 을 건너뛰고 write 값으로 대체하면 read 전용
|
|
// 계정의 비밀번호가 write 값으로 오염된다 (이슈 #465 부수 수정).
|
|
$readPassword = (string) ($stateConfig['db_read_password'] ?? '');
|
|
if ($readPassword === '') {
|
|
$readPassword = (string) ($existing['db']['read']['password'] ?? '');
|
|
}
|
|
if ($readPassword === '') {
|
|
$readPassword = (string) $runtime['db']['write']['password'];
|
|
}
|
|
|
|
$runtime['db']['read'] = [
|
|
'host' => $stateConfig['db_read_host'],
|
|
'port' => $stateConfig['db_read_port'] ?? $runtime['db']['write']['port'],
|
|
'database' => $stateConfig['db_read_database'] ?? $runtime['db']['write']['database'],
|
|
'username' => $stateConfig['db_read_username'] ?? $runtime['db']['write']['username'],
|
|
'password' => $readPassword,
|
|
];
|
|
}
|
|
|
|
return $runtime;
|
|
}
|
|
}
|
|
|
|
if (! function_exists('hydrateDbSecretsFromRuntime')) {
|
|
/**
|
|
* state.config 에서 제거된 DB 비밀번호를 runtime.php 값으로 채운다 (이슈 #465).
|
|
*
|
|
* state.json 은 더 이상 DB 비밀번호를 보관하지 않으므로, state.config 로 DB 에
|
|
* 접속하던 소비처(db_cleanup / 롤백 seed truncate) 는 이 헬퍼로 자격증명을 복원해야
|
|
* 한다. 두 소비처 모두 env_update 태스크 이후에 실행되므로 runtime.php 는 항상 존재.
|
|
*
|
|
* runtime 부재 또는 config 에 이미 비밀번호가 있으면 원본을 그대로 반환.
|
|
*
|
|
* @param array<string, mixed> $config state.config (비밀번호 결손 가능)
|
|
* @return array<string, mixed> DB 비밀번호가 복원된 config
|
|
*/
|
|
function hydrateDbSecretsFromRuntime(array $config): array
|
|
{
|
|
$runtime = readInstallerRuntime();
|
|
|
|
if ($runtime === null) {
|
|
return $config;
|
|
}
|
|
|
|
if (empty($config['db_write_password'])) {
|
|
$writePassword = $runtime['db']['write']['password'] ?? '';
|
|
if ($writePassword !== '') {
|
|
$config['db_write_password'] = $writePassword;
|
|
}
|
|
}
|
|
|
|
if (empty($config['db_read_password'])) {
|
|
$readPassword = $runtime['db']['read']['password'] ?? '';
|
|
if ($readPassword !== '') {
|
|
$config['db_read_password'] = $readPassword;
|
|
}
|
|
}
|
|
|
|
return $config;
|
|
}
|
|
}
|