feat(settings): 코어 아웃바운드 HTTP 프록시 설정 추가

접속 IP 를 제한하는 결제사 API 를 로컬·스테이징에서 연동하려면 서버가
내보내는 요청의 출발지 IP 를 바꿔야 한다. 브라우저 프록시로는 바뀌지 않는
축이라 코어 환경설정으로 도입한다.

게이트는 디버그 모드이며 판정은 OutboundProxy 한 곳이 소유한다. 화면의
조건부 렌더링은 편의일 뿐이라 저장 API 직접 호출을 막지 못하므로, 실질
게이트를 판정 지점에 둔다. 주입·적용 지점은 결과만 소비한다.

적용은 Http::globalOptions 전역 옵션이라 확장의 Http:: 호출까지 함께
경유한다. 외부 연동 규약상 curl 핸들을 직접 다뤄야 하는 확장은
OutboundProxy::curlOptions 로 같은 프록시를 탄다 — KG이니시스 본인인증
승인 요청과 CBT 연결 점검을 이 통로로 편입했다. CBT 의 TCP 443 확인은
원시 소켓으로는 프록시를 태울 수 없어 curl CONNECT_ONLY 로 교체했다.

저장 전 연결 테스트는 저장값이 아니라 제출값을 검사하고, 그 프록시를
거쳤을 때 외부에 보이는 IP 를 함께 보고한다. 운영자가 결제사에 등록할
값이라 저장하고 나서 되짚지 않도록 했다. 적용과 같은 조립을 거치므로
확인한 구성과 저장 후 적용되는 구성이 어긋나지 않는다.
This commit is contained in:
HeuJung
2026-08-20 17:01:27 +09:00
parent 0e8b625436
commit a7b7c64573
55 changed files with 2040 additions and 30 deletions
+1 -1
View File
@@ -231,7 +231,7 @@ return [
|
*/
'version' => env('APP_VERSION', '7.0.7'),
'version' => env('APP_VERSION', '7.1.0'),
/*
|--------------------------------------------------------------------------
+21
View File
@@ -105,6 +105,27 @@ return [
'max_page' => 1000,
],
/*
|--------------------------------------------------------------------------
| 아웃바운드 프록시 연결 테스트
|--------------------------------------------------------------------------
| 운영자가 환경설정에 입력한 프록시가 실제로 동작하는지, 그리고 그 프록시를 거쳐
| 나갔을 때 상대편에 어떤 IP 로 보이는지 확인하는 데 쓰는 조회 대상입니다.
|
| 출발지 IP 는 운영자가 결제사·외부 서비스에 등록해야 하는 값이라, 프록시를 켠 상태의
| 실제 값을 알려주는 것이 이 테스트의 목적입니다. 목록은 순차 시도하며 먼저 유효한
| IP 를 돌려준 곳에서 멈춥니다. 폐쇄망 등 외부 조회가 불가능한 환경에서는 목록을
| 비워 두면 도달성만 확인하고 IP 는 보고하지 않습니다.
*/
'outbound_proxy' => [
'egress_lookup_urls' => [
'https://api.ipify.org',
'https://ifconfig.me/ip',
'https://icanhazip.com',
],
'test_timeout_seconds' => 10,
],
/*
|--------------------------------------------------------------------------
| 검색 — DBMS 별 부분일치 연산자
+6 -2
View File
@@ -102,7 +102,9 @@
"debug": {
"mode": false,
"sql_query_log": false,
"log_level": "error"
"log_level": "error",
"outbound_proxy": "",
"outbound_proxy_bypass": []
},
"core_update": {
"github_url": "",
@@ -270,7 +272,9 @@
"_comment": "debug 설정은 advanced 카테고리에 병합",
"fields": {
"mode": { "type": "boolean", "sensitive": false, "frontend_key": "debug_mode" },
"sql_query_log": { "type": "boolean", "sensitive": false, "expose": false }
"sql_query_log": { "type": "boolean", "sensitive": false, "expose": false },
"outbound_proxy": { "type": "string", "sensitive": true },
"outbound_proxy_bypass": { "type": "array", "sensitive": false, "expose": false }
}
},
"core_update": {