HeuJung
a7b7c64573
접속 IP 를 제한하는 결제사 API 를 로컬·스테이징에서 연동하려면 서버가 내보내는 요청의 출발지 IP 를 바꿔야 한다. 브라우저 프록시로는 바뀌지 않는 축이라 코어 환경설정으로 도입한다. 게이트는 디버그 모드이며 판정은 OutboundProxy 한 곳이 소유한다. 화면의 조건부 렌더링은 편의일 뿐이라 저장 API 직접 호출을 막지 못하므로, 실질 게이트를 판정 지점에 둔다. 주입·적용 지점은 결과만 소비한다. 적용은 Http::globalOptions 전역 옵션이라 확장의 Http:: 호출까지 함께 경유한다. 외부 연동 규약상 curl 핸들을 직접 다뤄야 하는 확장은 OutboundProxy::curlOptions 로 같은 프록시를 탄다 — KG이니시스 본인인증 승인 요청과 CBT 연결 점검을 이 통로로 편입했다. CBT 의 TCP 443 확인은 원시 소켓으로는 프록시를 태울 수 없어 curl CONNECT_ONLY 로 교체했다. 저장 전 연결 테스트는 저장값이 아니라 제출값을 검사하고, 그 프록시를 거쳤을 때 외부에 보이는 IP 를 함께 보고한다. 운영자가 결제사에 등록할 값이라 저장하고 나서 되짚지 않도록 했다. 적용과 같은 조립을 거치므로 확인한 구성과 저장 후 적용되는 구성이 어긋나지 않는다.
259 lines
9.8 KiB
PHP
259 lines
9.8 KiB
PHP
<?php
|
|
|
|
namespace Tests\Unit\Support;
|
|
|
|
use App\Support\OutboundProxy;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* 아웃바운드 프록시 적용 판정을 고정합니다.
|
|
*
|
|
* 이 판정은 코어가 바깥으로 내보내는 모든 HTTP 요청의 경로를 정합니다. 잘못 열리면 결제 승인
|
|
* 요청까지 운영자가 지정한 제3의 서버를 경유하게 되고, 그 사실이 예외나 로그로 드러나지
|
|
* 않습니다 — 요청은 정상 성공하고 상대편에 보이는 출발지 IP 만 달라집니다.
|
|
*
|
|
* 그래서 관리자 화면에서 입력칸을 감추는 것은 게이트가 아닙니다. 저장 API 를 직접 호출하면
|
|
* 값은 그대로 저장되므로, 실질 게이트는 이 판정 하나입니다.
|
|
*
|
|
* 축 조합은 각 테스트 메서드의 @scenario 주석이 담당한다.
|
|
*/
|
|
class OutboundProxyTest extends TestCase
|
|
{
|
|
/**
|
|
* 디버그 모드가 꺼져 있으면 저장값이 남아 있어도 적용하지 않습니다.
|
|
*
|
|
* @scenario debug_mode=off, proxy_value=valid, bypass_list=empty
|
|
*
|
|
* @effects proxy_not_applied_when_debug_mode_off
|
|
*/
|
|
public function test_proxy_is_not_applied_when_debug_mode_is_off(): void
|
|
{
|
|
$resolved = OutboundProxy::resolve([
|
|
'mode' => false,
|
|
'outbound_proxy' => 'socks5h://127.0.0.1:1080',
|
|
'outbound_proxy_bypass' => ['internal.example'],
|
|
]);
|
|
|
|
$this->assertNull(
|
|
$resolved,
|
|
'디버그 모드가 꺼진 상태에서 프록시가 적용되었습니다 — 화면 조건부 렌더링은 저장 API 직접 호출을 막지 못하므로 이 판정이 유일한 게이트입니다.'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* mode 키 자체가 없는 설정도 미적용으로 판정합니다.
|
|
*
|
|
* @scenario debug_mode=off, proxy_value=valid, bypass_list=empty
|
|
*
|
|
* @effects proxy_not_applied_when_debug_mode_off
|
|
*/
|
|
public function test_proxy_is_not_applied_when_mode_key_is_absent(): void
|
|
{
|
|
$this->assertNull(
|
|
OutboundProxy::resolve(['outbound_proxy' => 'http://proxy.internal:3128']),
|
|
'mode 키 부재를 디버그 모드 ON 으로 해석했습니다 — 판정은 fail-closed 여야 합니다.'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 디버그 모드가 켜져 있고 주소가 유효하면 http/https 양쪽에 적용합니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=empty
|
|
*
|
|
* @effects proxy_applied_when_debug_mode_on
|
|
*/
|
|
public function test_proxy_is_applied_for_both_schemes_when_debug_mode_is_on(): void
|
|
{
|
|
$resolved = OutboundProxy::resolve([
|
|
'mode' => true,
|
|
'outbound_proxy' => 'socks5h://127.0.0.1:1080',
|
|
]);
|
|
|
|
$this->assertSame([
|
|
'http' => 'socks5h://127.0.0.1:1080',
|
|
'https' => 'socks5h://127.0.0.1:1080',
|
|
'no' => [],
|
|
], $resolved);
|
|
}
|
|
|
|
/**
|
|
* 값이 비어 있으면 프록시를 쓰지 않는 상태로 판정합니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=empty, bypass_list=empty
|
|
*
|
|
* @effects proxy_applied_when_debug_mode_on
|
|
*/
|
|
public function test_empty_proxy_value_disables_proxy(): void
|
|
{
|
|
$this->assertNull(OutboundProxy::resolve(['mode' => true, 'outbound_proxy' => '']));
|
|
$this->assertNull(OutboundProxy::resolve(['mode' => true, 'outbound_proxy' => ' ']));
|
|
$this->assertNull(OutboundProxy::resolve(['mode' => true]));
|
|
}
|
|
|
|
/**
|
|
* 허용 목록에 없는 스킴과 호스트 없는 주소는 적용하지 않습니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=invalid, bypass_list=empty
|
|
*
|
|
* @effects proxy_rejects_disallowed_scheme
|
|
*
|
|
* @dataProvider invalidProxyUrls
|
|
*/
|
|
public function test_invalid_proxy_url_is_not_applied(string $url, string $why): void
|
|
{
|
|
$this->assertNull(
|
|
OutboundProxy::resolve(['mode' => true, 'outbound_proxy' => $url]),
|
|
$why
|
|
);
|
|
$this->assertFalse(OutboundProxy::isValidUrl($url), $why);
|
|
}
|
|
|
|
/**
|
|
* 적용 불가 주소 목록.
|
|
*
|
|
* @return array<string, array{0: string, 1: string}>
|
|
*/
|
|
public static function invalidProxyUrls(): array
|
|
{
|
|
return [
|
|
'스킴 없음' => ['127.0.0.1:1080', '스킴 없는 주소가 통과했습니다 — cURL 이 프록시로 해석하지 못합니다.'],
|
|
'파일 스킴' => ['file:///etc/passwd', 'file 스킴이 통과했습니다.'],
|
|
'ftp 스킴' => ['ftp://proxy.internal:21', '허용 목록에 없는 스킴이 통과했습니다.'],
|
|
'호스트 없음' => ['http://', '호스트 없는 주소가 통과했습니다.'],
|
|
'빈 문자열' => ['', '빈 값이 유효 주소로 판정됐습니다.'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 허용 스킴은 모두 적용 가능해야 합니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=empty
|
|
*
|
|
* @effects proxy_applied_when_debug_mode_on
|
|
*/
|
|
public function test_every_allowed_scheme_is_accepted(): void
|
|
{
|
|
foreach (OutboundProxy::ALLOWED_SCHEMES as $scheme) {
|
|
$this->assertTrue(
|
|
OutboundProxy::isValidUrl($scheme.'://proxy.internal:1080'),
|
|
"허용 목록의 스킴 {$scheme} 이 거부됐습니다 — 목록과 판정이 어긋나면 저장은 되는데 적용되지 않습니다."
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 예외 목록은 공백 제거·빈 항목 제거·중복 제거 후 순번을 다시 매깁니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=normalizable
|
|
*
|
|
* @effects proxy_bypass_list_normalized
|
|
*/
|
|
public function test_bypass_list_is_normalized(): void
|
|
{
|
|
$resolved = OutboundProxy::resolve([
|
|
'mode' => true,
|
|
'outbound_proxy' => 'http://proxy.internal:3128',
|
|
'outbound_proxy_bypass' => [' g7.dev ', '', 'g7.dev', 'localhost', 42, null],
|
|
]);
|
|
|
|
$this->assertSame(['g7.dev', 'localhost'], $resolved['no']);
|
|
$this->assertSame(
|
|
[0, 1],
|
|
array_keys($resolved['no']),
|
|
'예외 목록 키가 비연속입니다 — JSON 직렬화 시 객체가 되어 목록으로 읽히지 않습니다.'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 예외 목록이 배열이 아니면 빈 목록으로 취급합니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=normalizable
|
|
*
|
|
* @effects proxy_bypass_list_normalized
|
|
*/
|
|
public function test_non_array_bypass_list_becomes_empty(): void
|
|
{
|
|
$resolved = OutboundProxy::resolve([
|
|
'mode' => true,
|
|
'outbound_proxy' => 'http://proxy.internal:3128',
|
|
'outbound_proxy_bypass' => 'g7.dev',
|
|
]);
|
|
|
|
$this->assertSame([], $resolved['no']);
|
|
}
|
|
|
|
/**
|
|
* 적용 중인 프록시는 curl 옵션 형태로도 제공됩니다.
|
|
*
|
|
* `Http::` 파사드를 쓰지 못하는 호출 지점(외부 SDK 규약상 curl 핸들을 직접 다뤄야 하는
|
|
* 경우)이 같은 프록시를 타려면 이 통로가 필요합니다. 이 통로가 없으면 그 경로만 조용히
|
|
* 직접 나가고, 요청은 정상 성공하므로 아무 신호도 남지 않습니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=normalizable
|
|
*
|
|
* @effects proxy_exposed_as_curl_options
|
|
*/
|
|
public function test_resolved_proxy_is_exposed_as_curl_options(): void
|
|
{
|
|
config(['g7.outbound_proxy' => OutboundProxy::resolve([
|
|
'mode' => true,
|
|
'outbound_proxy' => 'socks5h://127.0.0.1:1080',
|
|
'outbound_proxy_bypass' => ['g7.dev', 'localhost'],
|
|
])]);
|
|
|
|
$this->assertSame([
|
|
CURLOPT_PROXY => 'socks5h://127.0.0.1:1080',
|
|
CURLOPT_NOPROXY => 'g7.dev,localhost',
|
|
], OutboundProxy::curlOptions());
|
|
}
|
|
|
|
/**
|
|
* 프록시 미적용 상태에서는 빈 배열이라 curl_setopt_array 에 그대로 넘겨도 무해합니다.
|
|
*
|
|
* @scenario debug_mode=off, proxy_value=valid, bypass_list=empty
|
|
*
|
|
* @effects proxy_exposed_as_curl_options
|
|
*/
|
|
public function test_curl_options_are_empty_when_proxy_is_not_applied(): void
|
|
{
|
|
config(['g7.outbound_proxy' => OutboundProxy::resolve([
|
|
'mode' => false,
|
|
'outbound_proxy' => 'socks5h://127.0.0.1:1080',
|
|
])]);
|
|
|
|
$this->assertSame([], OutboundProxy::curlOptions());
|
|
}
|
|
|
|
/**
|
|
* 저장 전 연결 테스트와 실제 적용이 같은 조립·정규화를 거칩니다.
|
|
*
|
|
* 이 테스트의 목적은 "저장 전에 확인한다" 는 기능의 전제를 지키는 것입니다. 조립을 두 곳에서
|
|
* 각각 하면 예외 목록의 공백·빈 항목·중복 처리가 어긋나, 운영자가 확인한 구성과 저장 후
|
|
* 실제로 적용되는 구성이 달라집니다. 두 구성 모두 정상 동작하므로 어긋남 자체는 아무런
|
|
* 오류도 남기지 않습니다.
|
|
*
|
|
* @scenario debug_mode=on, proxy_value=valid, bypass_list=normalizable
|
|
*
|
|
* @effects proxy_bypass_list_normalized
|
|
*/
|
|
public function test_connection_test_and_applied_config_share_the_same_assembly(): void
|
|
{
|
|
$url = ' socks5h://127.0.0.1:1080 ';
|
|
$bypass = [' g7.dev ', '', 'g7.dev', 'localhost'];
|
|
|
|
// 실제 적용 경로 (SettingsServiceProvider → config('g7.outbound_proxy'))
|
|
$applied = OutboundProxy::resolve([
|
|
'mode' => true,
|
|
'outbound_proxy' => $url,
|
|
'outbound_proxy_bypass' => $bypass,
|
|
]);
|
|
|
|
// 저장 전 연결 테스트 경로 (OutboundProxyTester)
|
|
$tested = OutboundProxy::options($url, $bypass);
|
|
|
|
$this->assertSame($applied, $tested);
|
|
$this->assertSame(['g7.dev', 'localhost'], $tested['no']);
|
|
$this->assertSame('socks5h://127.0.0.1:1080', $tested['https']);
|
|
}
|
|
}
|