Files
HeuJung c341fe28a4 fix(core,admin_basic,basic): 공개 자산 CDN 교차 출처 요청의 토큰 노출·CORS 실패 수정 + S3 접속 필드 노출 조건 확장
공개 (S3 드라이버) × (공개 자산 CDN) 병합 결과를 실 AWS S3 로 교차 실측하다
발견한 결함과, 그 과정에서 드러난 설정 화면의 사각을 함께 처리한다.

## 교차 출처 공개 자산 요청

공개 자산 디스크를 켜면 첨부·이미지의 download_url 이 외부 origin 절대 URL 이 되는데,
API 클라이언트가 URL 출처를 보지 않고 Authorization 을 붙이고 있었다. 그 결과
① 세션 토큰이 제3자 origin 으로 전송되고(응답을 허용하는 CDN 에서는 접근 로그에 남는다)
② 안전목록 밖 헤더라 preflight 가 발생해 CORS 미설정 버킷에서는 이미지가 통째로 실패했다.
상점 화면은 <img> 라 무증상이고 관리자 화면에서만 발현해 발견이 늦었다.

- 코어: 동일 출처 요청에만 Authorization 첨부 (상대 경로는 항상 동일 출처로 간주)
- 템플릿 2종: 교차 출처 URL 은 인증 XHR 없이 그대로 사용 (썸네일·갤러리·다운로드 3지점씩)

로컬 public 디스크나 허용적 CORS 를 주는 오브젝트 스토리지에서는 재현되지 않는다 —
외부 origin 과 CORS 미제공이 겹쳐야 드러나므로 회귀 테스트는 두 조건을 모두 고정한다.

## S3 접속 필드 노출 조건

파일 스토리지는 로컬로 두고 공개 자산만 S3 로 보내는 구성에서 접속 정보를 넣을 화면이
없었다(도움말이 보이지 않는 필드를 가리켰다). 두 축 중 하나라도 s3 면 블록을 노출하고,
연결 테스트 게이트의 적용 대상도 같은 조건으로 넓힌다. 재검증 트리거는 S3 접속 설정
변경으로 한정한다 — 트리거까지 넓히면 "파일 스토리지=s3 에서 공개 자산만 변경" 하는
기존 흐름이 저장 불가가 된다.
2026-08-14 10:32:24 +09:00

103 lines
4.0 KiB
TypeScript

/**
* 공개 자산(S3/CDN) 교차 출처 URL 의 인증 요청 차단 회귀 테스트
*
* 공개 자산 스토리지를 켜면 첨부·이미지의 `download_url` 이 외부 origin 절대 URL 이 된다.
* 그 URL 을 인증 XHR(Blob)로 가져오면
* ① CORS 헤더를 주지 않는 CDN(기본 설정 S3 버킷 등)에서 이미지가 통째로 실패하고
* ② 응답을 읽을 수 있는 CDN 이라면 세션 토큰이 제3자 origin 으로 전송된다.
* 두 경로 모두 브라우저 실측으로 확인된 결함이므로, 교차 출처 URL 은
* 인증 요청 없이 그대로 사용해야 한다.
*/
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
import { render, screen, waitFor } from '@testing-library/react';
import React from 'react';
import { isCrossOriginAssetUrl } from '../../src/components/composite/assetOrigin';
import { SortableThumbnailItem } from '../../src/components/composite/FileUploader/SortableThumbnailItem';
const apiGet = vi.fn();
beforeEach(() => {
apiGet.mockReset();
apiGet.mockResolvedValue(new Blob(['x'], { type: 'image/png' }));
// 전역 G7Core 객체는 setup 이 만든 것을 그대로 쓰고 api 만 주입한다
// (컴포넌트가 모듈 로드 시점에 같은 객체 참조를 캡처하므로 교체하면 안 된다)
(window as any).G7Core.api = { get: apiGet };
(window as any).URL.createObjectURL = vi.fn(() => 'blob:mock-object-url');
(window as any).URL.revokeObjectURL = vi.fn();
});
afterEach(() => {
vi.clearAllMocks();
});
describe('isCrossOriginAssetUrl', () => {
it('상대 경로(API 스트리밍)는 동일 출처로 판정한다', () => {
expect(isCrossOriginAssetUrl('/api/modules/sirsoft-ecommerce/product-image/abc')).toBe(false);
});
it('동일 출처 절대 URL 은 동일 출처로 판정한다', () => {
expect(isCrossOriginAssetUrl(`${window.location.origin}/storage/a.png`)).toBe(false);
});
it('외부 CDN 절대 URL 은 교차 출처로 판정한다', () => {
expect(isCrossOriginAssetUrl('https://bucket.s3.ap-southeast-2.amazonaws.com/a.png')).toBe(true);
});
it('프로토콜 상대 URL 도 호스트가 다르면 교차 출처로 판정한다', () => {
expect(isCrossOriginAssetUrl('//cdn.example.com/a.png')).toBe(true);
});
it('빈 값은 동일 출처로 간주해 기존 경로를 유지한다', () => {
expect(isCrossOriginAssetUrl(undefined)).toBe(false);
expect(isCrossOriginAssetUrl('')).toBe(false);
});
});
/**
* 썸네일 항목 렌더용 첨부 픽스처를 만듭니다.
*
* @param downloadUrl 첨부의 download_url
* @returns 첨부 객체
*/
const makeAttachment = (downloadUrl: string) => ({
id: 1,
hash: 'h1',
original_filename: 'probe.png',
size: 100,
mime_type: 'image/png',
is_image: true,
download_url: downloadUrl,
});
// @scenario consumer=product, disk_setting=fake_cdn, e2e=drivers_tab_card, hook=unregistered, override=follow_core, row_state=legacy_local_row
// @effects cross_origin_asset_request_omits_session_token
describe('SortableThumbnailItem 의 공개 자산 URL 처리', () => {
it('동일 출처 URL 은 종전대로 인증 요청으로 이미지를 로드한다', async () => {
render(
<SortableThumbnailItem
file={makeAttachment('/api/modules/sirsoft-ecommerce/product-image/abc') as any}
onRemove={vi.fn()}
/>
);
await waitFor(() => expect(apiGet).toHaveBeenCalledTimes(1));
expect(apiGet).toHaveBeenCalledWith(
'/api/modules/sirsoft-ecommerce/product-image/abc',
{ responseType: 'blob' }
);
});
it('교차 출처 공개 자산 URL 은 인증 요청 없이 그대로 사용한다', async () => {
const cdnUrl = 'https://bucket.s3.ap-southeast-2.amazonaws.com/images/products/a.png';
render(<SortableThumbnailItem file={makeAttachment(cdnUrl) as any} onRemove={vi.fn()} />);
await waitFor(() => {
expect(screen.getByRole('img')).toHaveAttribute('src', cdnUrl);
});
expect(apiGet).not.toHaveBeenCalled();
});
});