fix(installer): 설치 상태 파일에 관리자 비밀번호가 평문으로 잔존하는 문제

비밀을 state.json(0664, 실패 시 무기한 잔존)에 기록하지 않고
runtime.php(0600, finalize 시 삭제)로 채널을 일원화한다.

정상 완료 경로에서는 finalize 가 state.json 을 삭제하지만, finalize
미호출 / unlink 실패 / 설치 중단 시에는 평문이 영구히 남았고, finalize
가드가 재호출을 410 차단해 자가 회복도 불가능했다. 삭제라는 단일 경로에
의존해 평문을 보호하던 구조 자체를 제거한다.

SSE 워커는 세션에 접근할 수 없어 파일 경유가 불가피한데, 그 파일이 0664 의
state.json 이었던 것이 구조적 원인이다. 세션을 보유한 유일한 공통 시작점인
install-process.php 를 비밀 이송 지점으로 삼고, db_seed 가 소비한 즉시
제거한다. 레거시 / 실패 경로는 완료·중단·초기화·finalize 시점 redact 로 방어.

동반 수정:
- 세션 config 재병합으로 무력화되던 기존 DB 비밀번호 마스킹 복구
- db_seed 후 putenv 미해제로 모든 exec 자식에 평문이 ENV 상속되던 누출 차단
- runtime read 비밀번호 폴백이 write 값으로 잘못 대체되던 문제 ( 인접)

이미 설치된 사이트는 7.0.4 업그레이드 스텝이 잔존 파일을 정리한다.
완료 증거가 있으면 삭제하고, 설치 진행 중일 수 있으면 비밀만 제거한다.
This commit is contained in:
HeuJung committed 2026-07-13 17:00:59 +09:00
1 parent ae447c9cc4
commit 9be8faaea2
16 files changed
+1534 -119

No files matched your search

+65 -45
View File
@@ -1,4 +1,5 @@
<?php
/**
* G7 인스톨러 - 롤백 함수 모음
*
@@ -8,8 +9,8 @@
/**
* 중단된 작업을 롤백합니다.
*
* @param string $taskId 롤백할 작업 식별자
* @param array $state 현재 설치 상태
* @param string $taskId 롤백할 작업 식별자
* @param array $state 현재 설치 상태
* @return array ['success' => bool, 'message' => string] 롤백 결과
*/
function rollbackTask(string $taskId, array $state): array
@@ -25,7 +26,7 @@ function rollbackTask(string $taskId, array $state): array
case 'complete_flag':
return rollbackCompleteFlag();
// 롤백 불필요한 작업들 (새로 생성하면 되는 것들)
// 롤백 불필요한 작업들 (새로 생성하면 되는 것들)
case 'composer_check':
case 'composer_install':
case 'env_create':
@@ -38,7 +39,7 @@ function rollbackTask(string $taskId, array $state): array
'message' => lang('rollback_not_needed_recreatable'),
];
// 롤백 불필요한 확장 작업 (재설치/재활성화 시 덮어쓰기 가능)
// 롤백 불필요한 확장 작업 (재설치/재활성화 시 덮어쓰기 가능)
case 'template_install':
case 'template_activate':
case 'module_install':
@@ -55,14 +56,15 @@ function rollbackTask(string $taskId, array $state): array
default:
return [
'success' => false,
'message' => lang('rollback_unknown_task', ['task' => $taskId])
'message' => lang('rollback_unknown_task', ['task' => $taskId]),
];
}
} catch (Exception $e) {
addLog(lang('rollback_error', ['task' => $taskId, 'error' => $e->getMessage()]));
return [
'success' => false,
'message' => lang('rollback_exception', ['error' => $e->getMessage()])
'message' => lang('rollback_exception', ['error' => $e->getMessage()]),
];
}
}
@@ -70,14 +72,14 @@ function rollbackTask(string $taskId, array $state): array
/**
* 마이그레이션 롤백을 실행합니다 (migrate:rollback --force)
*
* @param string|null $logPrefix 로그 접두사 (null이면 lang('log_prefix_rollback') 사용)
* @param string|null $logPrefix 로그 접두사 (null이면 lang('log_prefix_rollback') 사용)
* @return array ['success' => bool, 'message' => string, 'output' => array]
*/
function executeMigrateRollback(?string $logPrefix = null): array
{
$logPrefix = $logPrefix ?? lang('log_prefix_rollback');
try {
addLog("{$logPrefix} " . lang('rollback_migrate_start'));
addLog("{$logPrefix} ".lang('rollback_migrate_start'));
$output = [];
$returnCode = 0;
@@ -90,7 +92,7 @@ function executeMigrateRollback(?string $logPrefix = null): array
exec($command, $output, $returnCode);
addLog("{$logPrefix} " . lang('rollback_migrate_result', ['result' => implode("\n", $output)]));
addLog("{$logPrefix} ".lang('rollback_migrate_result', ['result' => implode("\n", $output)]));
if ($returnCode === 0) {
return [
@@ -100,7 +102,7 @@ function executeMigrateRollback(?string $logPrefix = null): array
];
}
addLog("{$logPrefix} " . lang('rollback_migrate_failed_code', ['code' => $returnCode]));
addLog("{$logPrefix} ".lang('rollback_migrate_failed_code', ['code' => $returnCode]));
return [
'success' => false,
@@ -129,16 +131,24 @@ function rollbackDbMigrate(): array
/**
* 시드 데이터 TRUNCATE를 실행합니다 (PDO 세션 내 FOREIGN_KEY_CHECKS 제어)
*
* @param array $config DB 연결 설정
* @param bool $force true: 무조건 TRUNCATE, false: 미완료 시에만 TRUNCATE
* @param string|null $logPrefix 로그 접두사 (null이면 lang('log_prefix_rollback') 사용)
* @param array $config DB 연결 설정
* @param bool $force true: 무조건 TRUNCATE, false: 미완료 시에만 TRUNCATE
* @param string|null $logPrefix 로그 접두사 (null이면 lang('log_prefix_rollback') 사용)
* @return array ['success' => bool, 'message' => string]
*/
function executeSeedTruncate(array $config, bool $force = false, ?string $logPrefix = null): array
{
// state.config 에는 DB 비밀번호가 기록되지 않으므로(이슈 #465) runtime.php 에서 복원한다.
// 호출자(rollbackDbSeed / forceRollbackDbSeed) 가 state['config'] 를 그대로 넘기므로
// 각 호출자 대신 함수 진입부 1곳에서 처리한다. 롤백은 env_update 이후에만 발생하여
// runtime.php 가 항상 존재하며, 부재 시 헬퍼가 원본 config 를 그대로 반환한다.
require_once __DIR__.'/../includes/installer-runtime.php';
$config = hydrateDbSecretsFromRuntime($config);
$logPrefix = $logPrefix ?? lang('log_prefix_rollback');
if (empty($config['db_write_host']) || empty($config['db_write_database'])) {
addLog("{$logPrefix} " . lang('rollback_seed_no_config'));
addLog("{$logPrefix} ".lang('rollback_seed_no_config'));
return ['success' => true, 'message' => lang('rollback_seed_no_config')];
}
@@ -146,7 +156,8 @@ function executeSeedTruncate(array $config, bool $force = false, ?string $logPre
foreach (['db_write_host', 'db_write_port', 'db_write_database'] as $field) {
$val = (string) ($config[$field] ?? '');
if ($val !== '' && preg_match('/[;=\0\r\n]/', $val)) {
addLog("{$logPrefix} " . lang('rollback_seed_no_config'));
addLog("{$logPrefix} ".lang('rollback_seed_no_config'));
return ['success' => true, 'message' => lang('rollback_seed_no_config')];
}
}
@@ -164,18 +175,19 @@ function executeSeedTruncate(array $config, bool $force = false, ?string $logPre
]);
// 강제 모드가 아니면 완료 여부 확인
if (!$force) {
if (! $force) {
$stmt = $pdo->query("SHOW TABLES LIKE 'roles'");
if ($stmt->rowCount() > 0) {
$count = $pdo->query("SELECT COUNT(*) FROM roles")->fetchColumn();
$count = $pdo->query('SELECT COUNT(*) FROM roles')->fetchColumn();
if ($count > 0) {
addLog("{$logPrefix} " . lang('rollback_seed_already_done'));
addLog("{$logPrefix} ".lang('rollback_seed_already_done'));
return ['success' => true, 'message' => lang('rollback_seed_already_done')];
}
}
addLog("{$logPrefix} " . lang('rollback_seed_interrupted'));
addLog("{$logPrefix} ".lang('rollback_seed_interrupted'));
} else {
addLog("{$logPrefix} " . lang('rollback_seed_force_truncate'));
addLog("{$logPrefix} ".lang('rollback_seed_force_truncate'));
}
$pdo->exec('SET FOREIGN_KEY_CHECKS = 0');
@@ -184,9 +196,9 @@ function executeSeedTruncate(array $config, bool $force = false, ?string $logPre
foreach ($tables as $table) {
try {
$pdo->exec("TRUNCATE TABLE `{$table}`");
addLog("{$logPrefix} " . lang('rollback_table_truncated', ['table' => $table]));
addLog("{$logPrefix} ".lang('rollback_table_truncated', ['table' => $table]));
} catch (PDOException $e) {
addLog("{$logPrefix} " . lang('rollback_table_truncate_skipped', ['table' => $table, 'error' => $e->getMessage()]));
addLog("{$logPrefix} ".lang('rollback_table_truncate_skipped', ['table' => $table, 'error' => $e->getMessage()]));
}
}
@@ -197,7 +209,8 @@ function executeSeedTruncate(array $config, bool $force = false, ?string $logPre
if ($force) {
return ['success' => false, 'message' => lang('rollback_db_connection_failed', ['error' => $e->getMessage()])];
}
addLog("{$logPrefix} " . lang('rollback_db_connection_failed_skip'));
addLog("{$logPrefix} ".lang('rollback_db_connection_failed_skip'));
return ['success' => true, 'message' => lang('rollback_db_connection_failed_skip')];
}
}
@@ -205,7 +218,7 @@ function executeSeedTruncate(array $config, bool $force = false, ?string $logPre
/**
* db_seed 작업 롤백: 중단된 경우에만 TRUNCATE
*
* @param array $state 현재 설치 상태
* @param array $state 현재 설치 상태
* @return array ['success' => bool, 'message' => string]
*/
function rollbackDbSeed(array $state): array
@@ -230,7 +243,7 @@ function forceRollbackDbMigrate(): array
/**
* db_seed 작업 강제 롤백 (설정으로 돌아갈 때 사용)
*
* @param array $state 현재 설치 상태
* @param array $state 현재 설치 상태
* @return array ['success' => bool, 'message' => string]
*/
function forceRollbackDbSeed(array $state): array
@@ -252,10 +265,10 @@ function forceRollbackDbSeed(array $state): array
function rollbackCompleteFlag(): array
{
try {
require_once __DIR__ . '/../includes/installer-runtime.php';
require_once __DIR__.'/../includes/installer-runtime.php';
$envPath = BASE_PATH . '/.env';
$installedFlagPath = BASE_PATH . '/storage/app/g7_installed';
$envPath = BASE_PATH.'/.env';
$installedFlagPath = BASE_PATH.'/storage/app/g7_installed';
$results = [];
@@ -289,12 +302,12 @@ function rollbackCompleteFlag(): array
return [
'success' => true,
'message' => lang('rollback_complete_flag_removed', ['details' => implode(', ', $results)])
'message' => lang('rollback_complete_flag_removed', ['details' => implode(', ', $results)]),
];
} catch (Exception $e) {
return [
'success' => false,
'message' => lang('rollback_complete_flag_error', ['error' => $e->getMessage()])
'message' => lang('rollback_complete_flag_error', ['error' => $e->getMessage()]),
];
}
}
@@ -306,13 +319,13 @@ function rollbackCompleteFlag(): array
* 이는 인스톨러가 프로젝트 구조에 필수적인 파일/디렉토리를
* 실수로 삭제하는 것을 방지합니다.
*
* @param string $dir 삭제할 디렉토리 경로
* @param bool $removeDir true이면 디렉토리 자체도 삭제 (기본: false, 내용만 삭제)
* @param string $dir 삭제할 디렉토리 경로
* @param bool $removeDir true이면 디렉토리 자체도 삭제 (기본: false, 내용만 삭제)
* @return bool 삭제 성공 여부
*/
function deleteDirectory(string $dir, bool $removeDir = false): bool
{
if (!is_dir($dir)) {
if (! is_dir($dir)) {
return false;
}
@@ -323,7 +336,7 @@ function deleteDirectory(string $dir, bool $removeDir = false): bool
$hasPreservedFiles = false;
foreach ($items as $item) {
$path = $dir . DIRECTORY_SEPARATOR . $item;
$path = $dir.DIRECTORY_SEPARATOR.$item;
if (is_dir($path)) {
deleteDirectory($path, true);
@@ -331,6 +344,7 @@ function deleteDirectory(string $dir, bool $removeDir = false): bool
// 보존 대상 파일은 건너뛰기
if (in_array($item, $preserveFiles, true)) {
$hasPreservedFiles = true;
continue;
}
@unlink($path);
@@ -338,7 +352,7 @@ function deleteDirectory(string $dir, bool $removeDir = false): bool
}
// 보존 파일이 남아있거나 removeDir이 false이면 디렉토리 유지
if ($hasPreservedFiles || !$removeDir) {
if ($hasPreservedFiles || ! $removeDir) {
return true;
}
@@ -348,15 +362,16 @@ function deleteDirectory(string $dir, bool $removeDir = false): bool
/**
* 현재 진행 중인 작업을 롤백합니다. (abort.php에서 사용)
*
* @param array $state 현재 설치 상태
* @param array $state 현재 설치 상태
* @return array ['success' => bool, 'message' => string, 'task' => string|null]
*/
function rollbackCurrentTask(array $state): array
{
$currentTask = $state['current_task'] ?? null;
if (!$currentTask) {
if (! $currentTask) {
addLog(lang('rollback_no_current_task'));
return [
'success' => true,
'message' => lang('rollback_no_current_task'),
@@ -366,6 +381,7 @@ function rollbackCurrentTask(array $state): array
if (in_array($currentTask, $state['completed_tasks'] ?? [])) {
addLog(lang('rollback_task_already_completed', ['task' => $currentTask]));
return [
'success' => true,
'message' => lang('rollback_task_already_completed', ['task' => $currentTask]),
@@ -378,6 +394,7 @@ function rollbackCurrentTask(array $state): array
if ($rollbackResult['success']) {
addLog(lang('abort_rollback_success', ['message' => $rollbackResult['message']]));
return [
'success' => true,
'message' => lang('abort_rollback_success', ['message' => $rollbackResult['message']]),
@@ -385,6 +402,7 @@ function rollbackCurrentTask(array $state): array
];
} else {
addLog(lang('abort_rollback_failed', ['message' => $rollbackResult['message']]));
return [
'success' => false,
'message' => lang('failed_rollback_failed', ['message' => $rollbackResult['message']]),
@@ -396,9 +414,9 @@ function rollbackCurrentTask(array $state): array
/**
* 완료된 작업들을 역순으로 롤백합니다. (reset-state.php에서 사용)
*
* @param array $completedTasks 완료된 작업 목록
* @param array $rollbackableTasks 롤백 가능한 작업 목록
* @param array $state 현재 설치 상태
* @param array $completedTasks 완료된 작업 목록
* @param array $rollbackableTasks 롤백 가능한 작업 목록
* @param array $state 현재 설치 상태
* @return array ['results' => array, 'errors' => array]
*/
function rollbackCompletedTasks(array $completedTasks, array $rollbackableTasks, array $state): array
@@ -408,6 +426,7 @@ function rollbackCompletedTasks(array $completedTasks, array $rollbackableTasks,
if (empty($completedTasks)) {
addLog(lang('rollback_no_completed_tasks'));
return ['results' => $results, 'errors' => $errors];
}
@@ -419,6 +438,7 @@ function rollbackCompletedTasks(array $completedTasks, array $rollbackableTasks,
if (empty($tasksToRollback)) {
addLog(lang('rollback_no_matching_tasks'));
return ['results' => $results, 'errors' => $errors];
}
@@ -436,10 +456,10 @@ function rollbackCompletedTasks(array $completedTasks, array $rollbackableTasks,
}
if ($result['success']) {
$results[] = $taskId . ': ' . $result['message'];
$results[] = $taskId.': '.$result['message'];
addLog(lang('rollback_task_success', ['task' => $taskId]));
} else {
$errors[] = $taskId . ': ' . $result['message'];
$errors[] = $taskId.': '.$result['message'];
addLog(lang('rollback_task_failed', ['task' => $taskId, 'error' => $result['message']]));
}
}
@@ -450,8 +470,8 @@ function rollbackCompletedTasks(array $completedTasks, array $rollbackableTasks,
/**
* 실패한 작업에 대한 수동 명령어를 생성합니다.
*
* @param string $taskId 작업 ID
* @param string|null $target 대상 (확장 식별자)
* @param string $taskId 작업 ID
* @param string|null $target 대상 (확장 식별자)
* @return array 수동 명령어 배열
*/
function getManualCommands(string $taskId, ?string $target = null): array
@@ -530,7 +550,7 @@ function getManualCommands(string $taskId, ?string $target = null): array
break;
case 'create_settings_json':
$commands[] = '# ' . lang('manual_cmd_settings_json');
$commands[] = '# '.lang('manual_cmd_settings_json');
break;
case 'cache_clear':