HeuJung
b6c5e1f323
TLS 가 앞단에서 종단되고 앱에는 HTTP 로 전달되는 구성에서 X-Forwarded-* 가 전부 무시되어 화면 백지·IP 왜곡·webhook 403 이 함께 발생했다. 코어에 신뢰 프록시 설정 지점이 아예 없던 것이 원인이다. - config/trustedproxy.php 로 내장 TrustProxies 미들웨어에 값을 공급한다. bootstrap/app.php 는 건드리지 않는다 — withMiddleware 클로저는 .env 로드 전에 평가되어 env 가 항상 null 이 되는 조용한 no-op 이다. - 판정은 App\Support\TrustedProxyDiagnostic 단일 SSoT 에서 계산하고 대시보드 알림·환경설정 고급 탭·설치 마법사·trusted-proxy:status 네 면이 소비한다. 판정식은 "HTTPS 인식 실패" 가 아니라 "X-Forwarded-* 수신 중 AND 신뢰 프록시 미설정" 이다 — HTTP 전용 사이트가 프록시 뒤에 있으면 화면은 정상인 채로 나머지만 조용히 어긋나기 때문이다. - 값 편집 UI 와 쓰기 엔드포인트는 두지 않는다(잠금 역설 + XFF 위조 경로). - 혼합 콘텐츠 차단을 부트스트랩 폴백의 별도 사유로 가른다. 새로고침으로 낫지 않으므로 버튼을 렌더하지 않고, 원인·조치는 콘솔로 운영자에게 보낸다. - 대시보드 알림을 심각도로 배치한다 — warning 은 상단 배너, 그 외는 하단 카드. 같은 알림이 두 곳에 뜨지 않으며, 여러 건은 간격을 두고 쌓인다. 공개 이슈: (@lyg-kaban 제보)
391 lines
14 KiB
PHP
391 lines
14 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\Admin;
|
|
|
|
use App\Http\Controllers\Api\Base\AdminBaseController;
|
|
use App\Http\Requests\Settings\RegenerateAppKeyRequest;
|
|
use App\Http\Requests\Settings\RestoreSettingsRequest;
|
|
use App\Http\Requests\Settings\SaveSettingsRequest;
|
|
use App\Http\Requests\Settings\TestDriverConnectionRequest;
|
|
use App\Http\Requests\Settings\TestMailRequest;
|
|
use App\Http\Requests\Settings\TestOutboundProxyRequest;
|
|
use App\Http\Requests\Settings\UpdateSettingRequest;
|
|
use App\Http\Resources\SettingsResource;
|
|
use App\Services\DriverConnectionTester;
|
|
use App\Services\DriverRegistryService;
|
|
use App\Services\OutboundProxyTester;
|
|
use App\Services\SettingsService;
|
|
use App\Support\TrustedProxyDiagnostic;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
/**
|
|
* 관리자용 시스템 설정 컨트롤러
|
|
*
|
|
* 관리자가 시스템 설정을 관리할 수 있는 기능을 제공합니다.
|
|
*/
|
|
class SettingsController extends AdminBaseController
|
|
{
|
|
public function __construct(
|
|
private SettingsService $settingsService,
|
|
private DriverConnectionTester $driverConnectionTester,
|
|
private DriverRegistryService $driverRegistryService,
|
|
private OutboundProxyTester $outboundProxyTester
|
|
) {
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* 모든 시스템 설정을 조회합니다.
|
|
*
|
|
* @return JsonResponse 시스템 설정 목록을 포함한 JSON 응답
|
|
*/
|
|
public function index(): JsonResponse
|
|
{
|
|
try {
|
|
$settings = $this->settingsService->getAllSettings();
|
|
$settings['available_drivers'] = $this->driverRegistryService->getAllAvailableDrivers();
|
|
$settings['_meta'] = ['limits' => config('core.settings_limits', [])];
|
|
|
|
return $this->success('settings.fetch_success',
|
|
(new SettingsResource($settings))->toArray(request())
|
|
);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 여러 시스템 설정을 일괄 저장합니다.
|
|
*
|
|
* 저장 성공 시 전체 settings를 응답에 포함하여
|
|
* 프론트엔드에서 새로고침 없이 전역 상태를 업데이트할 수 있도록 합니다.
|
|
*
|
|
* @param SaveSettingsRequest $request 설정 저장 요청 데이터
|
|
* @return JsonResponse 저장 결과 JSON 응답
|
|
*/
|
|
public function store(SaveSettingsRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->settingsService->saveSettings($request->validated());
|
|
|
|
if ($result) {
|
|
// 저장 후 전체 설정 반환 (관리자 UI 상태 업데이트용)
|
|
$allSettings = $this->settingsService->getAllSettings();
|
|
$allSettings['available_drivers'] = $this->driverRegistryService->getAllAvailableDrivers();
|
|
$allSettings['_meta'] = ['limits' => config('core.settings_limits', [])];
|
|
|
|
return $this->success('settings.save_success', [
|
|
'settings' => $allSettings,
|
|
]);
|
|
} else {
|
|
return $this->error('settings.save_failed');
|
|
}
|
|
} catch (ValidationException $e) {
|
|
return $this->error('settings.save_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.save_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 키의 시스템 설정을 조회합니다.
|
|
*
|
|
* @param string $key 조회할 설정 키
|
|
* @return JsonResponse 설정 값을 포함한 JSON 응답
|
|
*/
|
|
public function show(string $key): JsonResponse
|
|
{
|
|
try {
|
|
$value = $this->settingsService->getSetting($key);
|
|
|
|
return $this->success('settings.fetch_success', [
|
|
'key' => $key,
|
|
'value' => $value,
|
|
]);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 키의 시스템 설정을 업데이트합니다.
|
|
*
|
|
* @param string $key 업데이트할 설정 키
|
|
* @param UpdateSettingRequest $request 설정 업데이트 요청 데이터
|
|
* @return JsonResponse 업데이트 결과 JSON 응답
|
|
*/
|
|
public function update(string $key, UpdateSettingRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->settingsService->setSetting($key, $request->validated()['value']);
|
|
|
|
if ($result) {
|
|
return $this->success('settings.update_success');
|
|
} else {
|
|
return $this->error('settings.update_failed');
|
|
}
|
|
} catch (ValidationException $e) {
|
|
return $this->error('settings.update_failed', 422, $e->errors());
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.update_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 시스템 환경 정보를 조회합니다.
|
|
*
|
|
* @return JsonResponse 시스템 정보를 포함한 JSON 응답
|
|
*/
|
|
public function systemInfo(): JsonResponse
|
|
{
|
|
try {
|
|
$systemInfo = $this->settingsService->getSystemInfo();
|
|
|
|
return $this->success('common.success', $systemInfo);
|
|
} catch (\Throwable $e) {
|
|
Log::error('시스템 정보 조회 실패', ['error' => $e->getMessage()]);
|
|
|
|
return $this->error('common.error_occurred', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 신뢰 프록시(리버스 프록시) 설정 진단 결과를 조회합니다 (#124).
|
|
*
|
|
* 읽기 전용이다 — 값 편집 엔드포인트는 두지 않는다. 이 값은 "앱이 프록시 없이 도달
|
|
* 가능한가" 라는 배포 구조 지식이 있어야 정할 수 있고, 웹에서 편집 가능해지면 관리자
|
|
* 계정 탈취가 곧 X-Forwarded-For 위조 경로가 된다. 편집은 `.env` 전용이다.
|
|
*
|
|
* 판정 대상은 관리자 브라우저의 **실제 요청**이므로 현재 요청을 그대로 쓴다.
|
|
* 입력을 받지 않는 읽기 전용 조회라 FormRequest 를 두지 않는다.
|
|
*
|
|
* @return JsonResponse 진단 결과 JSON 응답
|
|
*/
|
|
public function trustedProxy(): JsonResponse
|
|
{
|
|
return $this->success('common.success', TrustedProxyDiagnostic::forRequest(request()));
|
|
}
|
|
|
|
/**
|
|
* 시스템 캐시를 정리합니다.
|
|
*
|
|
* @return JsonResponse 캐시 정리 결과 JSON 응답
|
|
*/
|
|
public function clearCache(): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->settingsService->clearCache();
|
|
|
|
if ($result) {
|
|
return $this->success('settings.cache_clear_success');
|
|
} else {
|
|
return $this->error('settings.cache_clear_failed');
|
|
}
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.cache_clear_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 시스템을 최적화합니다 (캐시 생성).
|
|
*
|
|
* @return JsonResponse 최적화 결과 JSON 응답
|
|
*/
|
|
public function optimizeSystem(): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->settingsService->optimizeSystem();
|
|
|
|
if ($result) {
|
|
return $this->success('settings.optimize_success');
|
|
} else {
|
|
return $this->error('settings.optimize_failed');
|
|
}
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.optimize_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 데이터베이스 백업 — 아직 제공하지 않는 기능임을 알립니다.
|
|
*
|
|
* 코어에는 DB 덤프 수단이 없어 이 엔드포인트는 구현된 적이 없다.
|
|
* 종전에는 존재하지 않는 `SettingsService::backupDatabase()` 를 호출했고,
|
|
* PHP 가 던지는 `Error` 는 `catch (\Exception)` 에 걸리지 않아 그대로 500 이 되면서
|
|
* 내부 메서드 이름까지 응답에 실려 나갔다 (공개 #115 부록 B3).
|
|
*
|
|
* 기능 부재는 서버 고장이 아니므로 501(Not Implemented)로 답한다.
|
|
* 설정 파일 백업은 `POST /api/admin/settings/backup` 이 담당한다.
|
|
*
|
|
* @return JsonResponse 미제공 안내 JSON 응답 (501)
|
|
*/
|
|
public function backupDatabase(): JsonResponse
|
|
{
|
|
return $this->error('settings.database_backup_unavailable', 501);
|
|
}
|
|
|
|
/**
|
|
* 현재 앱 키를 조회합니다 (마스킹된 형태).
|
|
*
|
|
* @return JsonResponse 마스킹된 앱 키 JSON 응답
|
|
*/
|
|
public function getAppKey(): JsonResponse
|
|
{
|
|
try {
|
|
$maskedKey = $this->settingsService->maskAppKey();
|
|
|
|
return $this->success('common.success', [
|
|
'app_key' => $maskedKey,
|
|
]);
|
|
} catch (\Exception $e) {
|
|
return $this->error('common.error_occurred', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 앱 키를 재생성합니다.
|
|
*
|
|
* @param RegenerateAppKeyRequest $request 앱 키 재생성 요청 데이터
|
|
* @return JsonResponse 재생성된 앱 키 JSON 응답
|
|
*/
|
|
public function regenerateAppKey(RegenerateAppKeyRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->settingsService->regenerateAppKey($request->password);
|
|
|
|
if (! $result['success']) {
|
|
return $this->error($result['error'], 401);
|
|
}
|
|
|
|
return $this->success('settings.app_key_regenerated', [
|
|
'app_key' => $result['app_key'],
|
|
]);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.app_key_regenerate_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 설정을 백업합니다.
|
|
*
|
|
* @return JsonResponse 백업 결과 JSON 응답
|
|
*/
|
|
public function backup(): JsonResponse
|
|
{
|
|
try {
|
|
$backupPath = $this->settingsService->backupSettings();
|
|
|
|
return $this->success('settings.backup_success', [
|
|
'backup_path' => $backupPath,
|
|
]);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.backup_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 백업에서 설정을 복원합니다.
|
|
*
|
|
* @param RestoreSettingsRequest $request 복원 요청 데이터 (백업 경로)
|
|
* @return JsonResponse 복원 결과 JSON 응답
|
|
*/
|
|
public function restore(RestoreSettingsRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$backupPath = $request->validated('backup_path');
|
|
|
|
$result = $this->settingsService->restoreSettings($backupPath);
|
|
|
|
if ($result) {
|
|
return $this->success('settings.restore_success');
|
|
}
|
|
|
|
return $this->error('settings.restore_failed');
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.restore_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 테스트 메일을 발송합니다.
|
|
*
|
|
* @param TestMailRequest $request 테스트 메일 발송 요청 데이터
|
|
* @return JsonResponse 발송 결과 JSON 응답
|
|
*/
|
|
public function testMail(TestMailRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$validated = $request->validated();
|
|
$toEmail = $validated['to_email'];
|
|
$mailSettings = collect($validated)->except('to_email')->filter(fn ($v) => $v !== null)->toArray();
|
|
|
|
$result = $this->settingsService->sendTestMail($toEmail, $mailSettings);
|
|
|
|
if ($result['success']) {
|
|
return $this->success($result['message'], [
|
|
'subject' => $result['subject'],
|
|
'body' => $result['body'],
|
|
]);
|
|
}
|
|
|
|
return $this->error($result['message'], 500, $result['error'] ?? null);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.test_mail_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 드라이버 연결을 테스트합니다.
|
|
*
|
|
* S3, Redis, Memcached, Websocket 등 외부 서비스 드라이버의
|
|
* 연결 상태를 테스트합니다.
|
|
*
|
|
* @param TestDriverConnectionRequest $request 드라이버 테스트 요청 데이터
|
|
* @return JsonResponse 테스트 결과 JSON 응답
|
|
*/
|
|
public function testDriverConnection(TestDriverConnectionRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$settings = $request->validated();
|
|
$result = $this->driverConnectionTester->testAll($settings);
|
|
|
|
if ($result['all_passed']) {
|
|
return $this->success('settings.driver_test_success', $result);
|
|
}
|
|
|
|
// 일부 테스트 실패 시에도 결과 반환 (성공 상태지만 all_passed가 false)
|
|
return $this->success('settings.driver_test_partial', $result);
|
|
} catch (\Exception $e) {
|
|
return $this->error('settings.driver_test_error', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 아웃바운드 프록시 연결을 테스트합니다.
|
|
*
|
|
* 저장하기 전에 프록시가 실제로 동작하는지, 그리고 그 프록시를 거쳐 나갔을 때 상대편에
|
|
* 어떤 IP 로 보이는지 확인합니다. 출발지 IP 는 운영자가 결제사·외부 서비스에 등록해야
|
|
* 하는 값이라 결과의 핵심입니다.
|
|
*
|
|
* 검사 대상은 저장된 설정이 아니라 이번 요청이 제출한 값입니다.
|
|
*
|
|
* @param TestOutboundProxyRequest $request 검증된 요청
|
|
* @return JsonResponse 검사 결과
|
|
*/
|
|
public function testOutboundProxy(TestOutboundProxyRequest $request): JsonResponse
|
|
{
|
|
$validated = $request->validated();
|
|
|
|
$result = $this->outboundProxyTester->test(
|
|
(string) $validated['outbound_proxy'],
|
|
(array) ($validated['outbound_proxy_bypass'] ?? [])
|
|
);
|
|
|
|
// 연결 실패는 요청 처리 실패가 아니라 진단 결과다 — 200 으로 결과를 돌려주고
|
|
// 성공 여부는 페이로드가 말한다 (드라이버 연결 테스트와 같은 규약).
|
|
return $this->success($result['message_key'], $result);
|
|
}
|
|
}
|