Files
Gnuboard7/tests/Playwright/specs/production-sourcemap-exposure.spec.ts
T
HeuJung 90f154ecc0 fix(security): 배포본 소스맵 노출 차단 + 관리자 설정 탭 지연로딩 + 동반 결함 수정
## 소스맵 노출 차단 (공개 이슈 )

배포본에 .map 이 포함돼 원본 TS/TSX 전문(sourcesContent, 한글 주석 포함)이
그대로 노출됐다. 생성·서빙·저장소 유입 3계층을 모두 막는다.

- 빌드 config 15곳(코어 3 + _bundled 12): sourcemap 하드코딩 제거.
 G7_BUILD_SOURCEMAP 판정식으로 교체 — 미설정(로컬 npm run build)이면 생성해
 개발 디버깅 경험을 보존하고, 0 이면 미생성.
- Build{Core,Module,Plugin,Template}Command: 죽어 있던 --production 플래그 복구.
 $productionMode 를 콘솔 문자열에만 쓰고 npm 프로세스에 env 를 넘기지 않아
 산출물이 개발 빌드와 동일했다. runNpmCommand 에 $env 를 추가해 주입
 (--watch 에는 미주입). Symfony Process 는 부모 환경에 병합하므로 PATH 유실 없음.
- Allowed{Module,Plugin}FileType / {Module,Plugin}Service::getMimeType:
 허용 확장자 map 제거 — 익명 200 서빙 차단(템플릿은 원래 미허용, 3종 정책 일치).
- ExtensionBundleService: CSS 번들의 /*# sourceMappingURL=... */ strip 추가.
 CSS 는 블록 주석이라 JS 의 //# 패턴으로는 검출되지 않던 구멍.
- 추적 .map 13개 삭제 + .gitignore 전역 *.map 규칙(경로 한정 시 새 확장에서 누락).

실측: 산출 JS 의 sourceMappingURL 13 → 0, 추적 .map 13 → 0,
확장 디렉토리 npm run build 는 여전히 map 생성(개발 경험 회귀 없음).

## 관리자 환경설정 탭 지연 로딩

코어/이커머스/게시판 환경설정 화면이 진입 즉시 전 탭의 데이터소스를 한꺼번에
호출했다. 각 데이터소스에 활성 탭 조건(if)을 걸어 해당 탭에서만 fetch 하도록
변경하고, 결제 플러그인 3종의 테스트모드 상태 조회도 주문설정 탭으로 한정.

## 동반 결함 수정 (무관 결함 — 재발 방지 목적으로 같은 세션 처리)

- 나이스페이먼츠: 체크아웃 캐시 프리페치가 라우트를 가리지 않아 플러그인 번들이
 로드되는 모든 페이지(홈/게시판/로그인)에서 주문서를 조회 → 비회원 매번 422.
 형제 플러그인(kginicis)의 기존 가드 패턴을 적용해 체크아웃 경로로 한정.
- admin smoke 8건: 대부분 구현이 아니라 테스트 결함이었다 — URL 오타(단수 board),
 존재하지 않는 권한키, 앱 로케일이 en 인데 한국어 라벨 로케이터, DataGrid 버튼을
 먼저 잡던 휴리스틱 로케이터. 레이아웃에는 sticky className / 안정 id 를 부여.
- PHPDoc ↔ Pint 충돌 3건: 설명 없는 @param 은 no_superfluous_phpdoc_tags 가
 삭제해 audit phpdoc-public-method 와 무한 충돌. 한국어 설명을 붙여 양쪽 충족
 (리스너 3종의 설명 누락 메서드도 전수 보강).
- Log::spy 500 3건: spy 가 Log::channel('activity') 를 null 로 만들고
 logActivity 가 null->info 로 \Error → 같은 줄 catch(\Exception) 은 못 잡아
 통과. 운영에선 채널이 항상 로거이므로 제품 무결 → 테스트에 activity 채널
 보존 헬퍼 추가.
- NhnKcpApiServiceTest 5건: 스텁이 Unix 바이너리만 만들어 Windows 분기
 (pp_cli_exe.exe)에서만 실패. #!/bin/sh 는 Windows 실행 불가 → 파일 내 기존
 컨벤션대로 skip 가드.

## 테스트

- 소스맵 범위 130 passed (신규: BuildCommandSourcemapEnv, NoSourcemapArtifacts,
 ExtensionBundleService CSS strip, Allowed*FileType 반전, 자산 서빙 거부)
- 결제 3플러그인 505 passed / 0 failed (skipped 9 = Windows 전용 CLI, 사유 명시)
- 나이스페이먼츠 프론트 38 passed (가드 제거 시 red 실증 후 복원)
- E2E: production-sourcemap-exposure.spec.ts 6건 + 시나리오 매니페스트

버전: sirsoft-admin_basic 1.0.2 → 1.0.3, sirsoft-board 1.0.1 → 1.0.2
(각 manifest/package/lock/composer 동기화). 코어 7.0.4 는 미출시 누적.
2026-07-14 12:50:23 +09:00

150 lines
6.0 KiB
TypeScript

/**
* E2E: 프로덕션 소스맵 노출 차단 회귀 검증
*
* @scenario production-sourcemap-exposure
* @effects no_sourcemap_requests_from_loaded_bundles,
* page_renders_without_map_related_console_errors,
* module_sourcemap_asset_request_rejected_even_when_file_exists,
* plugin_sourcemap_asset_request_rejected_even_when_file_exists
*
* 배경: 소스맵(.map)에는 원본 TS/TSX 전문이 담긴다. 배포 산출물에서 (1) 맵 생성 자체를
* 막고, (2) 서빙을 거부하며, (3) 저장소 유입을 차단했다.
*
* 이 spec 은 브라우저 실측으로 두 가지를 고정한다:
* - 로드된 코어/확장 번들이 맵을 요청하지 않는다 (sourceMappingURL 주석 부재의 결과)
* - 맵 주석 제거가 번들을 깨뜨리지 않았다 (페이지 정상 렌더 + 콘솔 에러 없음)
*
* 주의: 맵 주석이 남아있는데 .map 만 지운 상태였다면 브라우저가 맵을 요청해 404 가
* 발생한다. 이 spec 은 그 회귀(주석/파일 불일치)도 함께 잡는다.
*/
import { test, expect } from '@playwright/test';
/** 소스맵 요청으로 간주할 URL 패턴 */
const MAP_REQUEST = /\.map(\?|$)/;
test.describe('프로덕션 소스맵 노출 차단', () => {
test('@smoke 사용자 페이지 로드 시 소스맵을 요청하지 않는다', async ({ page }) => {
const mapRequests: string[] = [];
page.on('request', (req) => {
if (MAP_REQUEST.test(req.url())) {
mapRequests.push(req.url());
}
});
await page.goto('/');
await page.waitForLoadState('networkidle', { timeout: 30_000 });
expect(
mapRequests,
`소스맵 요청이 발생했습니다(산출물에 sourceMappingURL 주석 잔존): ${mapRequests.join(', ')}`,
).toHaveLength(0);
});
test('@smoke 관리자 페이지 로드 시 소스맵을 요청하지 않는다', async ({ page }) => {
const mapRequests: string[] = [];
page.on('request', (req) => {
if (MAP_REQUEST.test(req.url())) {
mapRequests.push(req.url());
}
});
// 로그인 전 진입 화면이라도 코어 번들(template-engine)은 로드된다
await page.goto('/admin');
await page.waitForLoadState('networkidle', { timeout: 30_000 });
expect(
mapRequests,
`관리자 페이지에서 소스맵 요청 발생: ${mapRequests.join(', ')}`,
).toHaveLength(0);
});
test('@smoke 맵 주석 제거 후에도 페이지가 정상 렌더된다', async ({ page }) => {
const consoleErrors: string[] = [];
page.on('console', (msg) => {
if (msg.type() === 'error') {
consoleErrors.push(msg.text());
}
});
// 정적 에셋(JS/CSS/MAP) 로드 실패만 수집한다. 도메인 API 응답(예: 이커머스
// checkout 검증 422)은 소스맵 정책과 무관하므로 이 spec 의 판정 대상이 아니다.
const failedAssets: string[] = [];
page.on('response', (res) => {
if (res.status() >= 400 && /\.(js|css|map)(\?|$)/.test(res.url())) {
failedAssets.push(`${res.url()} → ${res.status()}`);
}
});
await page.goto('/');
await page.waitForLoadState('networkidle', { timeout: 30_000 });
// 렌더 성공 = 코어 엔진 + 확장 번들이 모두 정상 파싱/실행됨
await expect(page.getByTestId('nav-home')).toBeVisible({ timeout: 15_000 });
// 맵 주석만 남고 파일이 없으면 404 가 뜬다 (주석/파일 불일치 회귀)
expect(
failedAssets,
`에셋 로드 실패(맵/JS/CSS): ${failedAssets.join(' | ')}`,
).toHaveLength(0);
// 맵 주석 제거가 번들을 깨뜨렸다면 파싱/실행 에러가 뜬다.
const parseErrors = consoleErrors.filter((e) =>
/Unexpected token|SyntaxError|is not defined/i.test(e),
);
expect(parseErrors, `번들 실행 관련 콘솔 에러: ${parseErrors.join(' | ')}`).toHaveLength(0);
});
test('@smoke 확장 소스맵 에셋은 직접 요청해도 서빙되지 않는다', async ({ request }) => {
// 디스크에 맵이 없더라도, 허용 확장자에서 제외됐으므로 200 이 나오면 안 된다.
const targets = [
'/api/modules/assets/sirsoft-ecommerce/dist/js/module.iife.js.map',
'/api/plugins/assets/sirsoft-gdpr/dist/js/plugin.iife.js.map',
];
for (const target of targets) {
const res = await request.get(target, { maxRedirects: 0, failOnStatusCode: false });
expect(res.status(), `${target} 이 200 으로 서빙됨 — 소스맵 노출`).not.toBe(200);
const body = await res.text().catch(() => '');
expect(
body.includes('sourcesContent'),
`${target} 응답에 원본 코드(sourcesContent)가 포함됨`,
).toBe(false);
}
});
test('@smoke 결제 플러그인이 체크아웃 외 페이지에서 체크아웃을 프리페치하지 않는다', async ({ page }) => {
// 플러그인 번들은 모든 페이지에 로드된다. nicepayments 캐시 프리페치가 경로를
// 가리지 않으면 비회원이 모든 페이지에서 422(cart_key_required)를 받는다.
const checkoutRequests: string[] = [];
page.on('request', (req) => {
if (req.url().includes('/sirsoft-ecommerce/checkout')) {
checkoutRequests.push(req.url());
}
});
await page.goto('/');
await page.waitForLoadState('networkidle', { timeout: 30_000 });
expect(
checkoutRequests,
`홈에서 체크아웃 프리페치 발생: ${checkoutRequests.join(', ')}`,
).toHaveLength(0);
});
test('@smoke 코어 소스맵은 웹루트에서 서빙되지 않는다', async ({ request }) => {
const targets = [
'/build/core/template-engine.min.js.map',
'/build/core/layout-editor.min.js.map',
'/build/core/devtools.min.js.map',
];
for (const target of targets) {
const res = await request.get(target, { maxRedirects: 0, failOnStatusCode: false });
expect(res.status(), `${target} 이 200 으로 서빙됨 — 원본 코드 노출`).not.toBe(200);
}
});
});