Files
Gnuboard7/tests/Playwright/specs/admin/settings-outbound-proxy.spec.ts
T
HeuJung a7b7c64573 feat(settings): 코어 아웃바운드 HTTP 프록시 설정 추가
접속 IP 를 제한하는 결제사 API 를 로컬·스테이징에서 연동하려면 서버가
내보내는 요청의 출발지 IP 를 바꿔야 한다. 브라우저 프록시로는 바뀌지 않는
축이라 코어 환경설정으로 도입한다.

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

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

저장 전 연결 테스트는 저장값이 아니라 제출값을 검사하고, 그 프록시를
거쳤을 때 외부에 보이는 IP 를 함께 보고한다. 운영자가 결제사에 등록할
값이라 저장하고 나서 되짚지 않도록 했다. 적용과 같은 조립을 거치므로
확인한 구성과 저장 후 적용되는 구성이 어긋나지 않는다.
2026-08-20 17:01:27 +09:00

153 lines
6.8 KiB
TypeScript

/**
* E2E: 환경설정 > 고급 — 아웃바운드 HTTP 프록시 (#600)
*
* 시나리오 매니페스트: tests/scenarios/outbound-http-proxy.yaml — 마킹은 각 테스트의
* scenario(k=v 조합)·effects 주석이 담당하며, 헤더 요약 마킹은 파서 형식이 아니다
*
* 배경: 접속 IP 를 제한하는 결제사 API 를 로컬에서 테스트하려면 서버가 내보내는 요청의
* 출발지 IP 를 바꿔야 한다. 브라우저 프록시로는 바뀌지 않는 축이라 코어 설정으로 도입했다.
*
* 검증:
* 1. 디버그 모드가 꺼져 있으면 프록시 입력칸이 화면에 없다
* 2. 디버그 모드를 켜면 프록시 주소 Input 과 예외 목록 TagInput 이 마운트된다
* 3. 적용할 수 없는 형태의 주소는 저장이 거부되고 해당 필드에 inline 에러가 표시된다
*/
import { test, expect, issueToken, authenticatePage } from '../../fixtures/auth';
/**
* 관리자 환경설정 고급 탭 진입.
*
* 이 화면은 하드 로드 시 설정 응답이 도착하기 전에도 폼이 렌더되어 조작할 수 있고,
* 그 조작은 뒤늦게 도착한 `initLocal` 시드에 덮인다(실측 노출 창 300~430ms).
* 제품 차원의 잠금은 두지 않기로 했으므로(#600 PO 결정), 테스트가 시드 완료를
* 기다린 뒤에 조작한다.
*/
async function gotoAdvancedTab(page: import('@playwright/test').Page): Promise<void> {
await page.goto('/admin/settings?tab=advanced');
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
await expect(page.locator('#card_debug_settings')).toBeAttached({ timeout: 20_000 });
await expect
.poll(
() =>
page.evaluate(
() => Object.keys((window as any).G7Core?.state?.getLocal?.()?.form?.advanced ?? {}).length
),
{ timeout: 20_000 }
)
.toBeGreaterThan(0);
}
/** 디버그 모드 토글을 켠다 (이미 켜져 있으면 그대로 둔다) */
async function enableDebugMode(page: import('@playwright/test').Page): Promise<void> {
const checkbox = page.locator('input[name="advanced.debug_mode"]').first();
await expect(checkbox).toBeAttached({ timeout: 10_000 });
if (!(await checkbox.isChecked())) {
// Toggle 은 sr-only checkbox 를 감싼 wrapper 가 클릭 대상이다
await page.locator('#toggle_debug_mode .toggle-switch-wrapper').first().click();
}
await expect(page.locator('#outbound_proxy_settings')).toBeAttached({ timeout: 10_000 });
}
// @scenario debug_mode=off, proxy_value=valid, bypass_list=empty
// @effects proxy_inputs_hidden_when_debug_mode_off
test('#600 - 디버그 모드가 꺼져 있으면 프록시 입력칸이 없다', async ({ page }) => {
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoAdvancedTab(page);
expect(page.url()).not.toMatch(/\/admin\/login/);
// 존재 확정: 같은 카드의 SQL 쿼리 로그 토글은 조건 없이 렌더된다.
// 이 확인이 없으면 아래 부재 단언이 "아직 렌더 전" 과 구분되지 않는다.
await expect(page.locator('[name="advanced.sql_query_log"]').first()).toBeAttached();
await expect(page.locator('#outbound_proxy_settings')).toHaveCount(0);
await expect(page.locator('input[name="advanced.outbound_proxy"]')).toHaveCount(0);
});
// @scenario debug_mode=on, proxy_value=valid, bypass_list=empty
// @effects proxy_inputs_visible_when_debug_mode_on
test('@smoke #600 - 디버그 모드를 켜면 프록시 주소와 예외 목록이 마운트된다', async ({ page }) => {
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoAdvancedTab(page);
await enableDebugMode(page);
const proxyInput = page.locator('input[name="advanced.outbound_proxy"]').first();
await expect(proxyInput).toBeAttached();
await proxyInput.fill('socks5h://127.0.0.1:1080');
await expect(proxyInput).toHaveValue('socks5h://127.0.0.1:1080');
// 예외 목록은 TagInput — 자유 입력 후 Enter 로 항목이 된다
await expect(page.locator('#input_outbound_proxy_bypass')).toBeAttached();
});
// @scenario debug_mode=on, proxy_value=invalid, bypass_list=empty
// @effects proxy_setting_rejects_invalid_url
test('#600 - 허용되지 않는 형태의 프록시 주소는 저장이 거부된다', async ({ page }) => {
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoAdvancedTab(page);
await enableDebugMode(page);
const proxyInput = page.locator('input[name="advanced.outbound_proxy"]').first();
await proxyInput.fill('ftp://proxy.internal:21');
const saveResponse = page.waitForResponse(
(response) => response.request().method() === 'POST' && /\/api\/admin\/settings\/?$/.test(new URL(response.url()).pathname),
{ timeout: 20_000 }
);
await page.getByRole('button', { name: /저장|Save/ }).first().click();
const response = await saveResponse;
expect(response.status()).toBe(422);
await expect(page.locator('#input_outbound_proxy .form-error')).toBeVisible({ timeout: 10_000 });
});
// @scenario debug_mode=on, proxy_value=valid, bypass_list=empty
// @effects proxy_connection_test_button_wired
test('#600 - 연결 테스트가 프록시를 거친 출발지 IP 를 화면에 보고한다', async ({ page }) => {
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoAdvancedTab(page);
await enableDebugMode(page);
// 프록시 주소를 비운 상태에서는 테스트 버튼이 잠겨 있다 (보낼 값이 없다)
await expect(page.locator('#btn_test_outbound_proxy')).toBeDisabled();
await page.locator('input[name="advanced.outbound_proxy"]').first().fill('socks5h://127.0.0.1:1080');
await expect(page.locator('#btn_test_outbound_proxy')).toBeEnabled();
// 외부 프록시 서버는 E2E 환경에 없으므로 응답만 스텁한다 —
// 버튼 배선·요청 페이로드·결과 렌더는 전부 실경로다.
await page.route('**/api/admin/settings/test-outbound-proxy', async (route) => {
const body = route.request().postDataJSON();
expect(body.outbound_proxy).toBe('socks5h://127.0.0.1:1080');
await route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({
success: true,
message: '프록시 연결에 성공했습니다. 외부 서비스에는 이 IP 로 보입니다.',
data: { success: true, egress_ip: '203.0.113.9', elapsed_ms: 120, error: null },
}),
});
});
await page.locator('#btn_test_outbound_proxy').click();
const result = page.locator('#outbound_proxy_test_result');
await expect(result).toBeVisible({ timeout: 10_000 });
await expect(result).toContainText('203.0.113.9');
});