💡 전체 작업 예제가 GitHub에 있습니다: merge-untrusted-html-uploads-dotnet
신뢰할 수 없는 HTML 문서를 안전하게 병합하는 것은 .NET용 GroupDocs.Merger 워크플로우로, 업로드가 참조하는 외부 리소스(원격 URL, UNC 경로 및 로컬 파일)를 명시적으로 허용하지 않는 한 차단합니다.
이전 방식은 고통스러웠다
청구 포털이 고객이 업로드한 청구서와 동일 주문의 배송 메모를 하나의 HTML 문서로 병합해 보관한다고 상상해 보세요. 청구서는 단순 HTML이며 스타일시트 링크, 로고 이미지, 몇 개의 단락으로 구성되어 있지만, 이를 직접 작성한 것이 아니라 고객의 브라우저나 내보내기 도구가 만든 것입니다. GroupDocs.Merger 26.10 이전에는 병합 과정에서 HTML이 참조하는 외부 리소스(원격 스타일시트, 원격 이미지, 절대 로컬 파일 경로)를 모두 로드했으며 이를 중단할 옵션이 없었습니다.
업로드가 완전히 신뢰되지 않을 때 이는 문제가 됩니다. 스타일시트 URL이 추적 픽셀일 수도 있습니다. 이미지 src가 http://169.254.169.254/latest/meta-data/iam/security-credentials/와 같은 클라우드 메타데이터 주소를 가리키면, 병합 단계에서 업로드자를 대신해 해당 주소에 요청을 보냅니다. 절대 file:/// 경로도 읽혀서 다른 고객의 업로드를 병합 결과에 포함시킬 수 있습니다.
맹목적인 병합의 실제 비용: 업로드가 요청하는 모든 것을 가져오는 병합 작업은 서버를 SSRF 프록시로 만들고,
file:///참조는 한 고객의 병합이 다른 고객의 파일을 읽는 경로가 됩니다.
더 나은 방법이 있습니다
GroupDocs.Merger for .NET은 기본값으로 이를 해결합니다. 26.10 버전부터 모든 LoadOptions 생성자는 SkipExternalResources = true를 설정하고, 로드 옵션 없이 생성된 Merger도 동일한 기본값을 사용합니다—별도로 지정하지 않는 한 외부 리소스는 로드되지 않습니다.
필수 조건:
- .NET (GroupDocs.Merger for .NET이 지원하는 네 가지 대상 프레임워크 중 하나)
- GroupDocs.Merger for .NET 26.10 이상 (임시 라이선스 받기)
- 결합할 두 개의 HTML 문서, 최소 하나는 완전히 신뢰할 수 없는 소스
한 명령으로 설치:
dotnet add package GroupDocs.Merger --version 26.10.0
새로운 방법: 신뢰하지 않는 HTML 병합
두 개의 HTML 업로드를 안전한 기본값으로 결합하고, 모든 결정을 기록하는 핸들러와 두 번째 단계에서 신뢰할 수 있는 자산을 제공하는 핸들러를 사용하는 예시입니다.
1단계 - 형식에 대한 Load Options 생성
LoadOptions는 매개변수 없는 생성자가 없으며 26.10부터 sealed입니다; 샘플에서는 형식을 명시적으로 지정합니다.
// LoadOptions(FileType.HTML) already denies everything external by default
var audit = new ResourceAudit();
var loadOptions = new LoadOptions(FileType.HTML) { ExternalResourceHandler = audit };
2단계 - 업로드를 결합하고 결정 검토
// Both uploads follow the options of the Merger they are joined to
using (var merger = new Merger(firstUpload, loadOptions))
{
merger.Join(secondUpload);
merger.Save(outputPath);
}
foreach (string decision in audit.Decisions)
{
Console.WriteLine(decision);
}
핵심 포인트:
SkipExternalResources: 여기서는 암묵적으로true이며, 모든 원격 URL, UNC 경로 및 로컬 파일 참조가 차단됩니다. 업로드 자체 폴더에 있는 파일도 포함됩니다.- 결합당 하나의
LoadOptions: 두 번째 업로드는 자체 옵션을 갖지 않으며, 결합된Merger가 생성될 때 사용된 옵션을 그대로 상속합니다.
3단계 - 정확히 하나의 신뢰할 수 있는 리소스 허용
// Supply the logo's bytes directly instead of requesting it over the network
var trustedAssets = new Dictionary<string, byte[]>
{
[logoUrl] = File.ReadAllBytes(logoPath)
};
var audit = new ResourceAudit(trustedAssets);
var loadOptions = new LoadOptions(FileType.HTML) { ExternalResourceHandler = audit };
핸들러의 OnLoading 메서드는 요청된 URI가 일치할 때 args.Skipped = false와 args.Data를 해당 바이트로 설정하므로, 문서는 네트워크 요청 없이 로고를 삽입합니다.
기본 병합을 청구서와 배송 메모 업로드에 적용했을 때, 두 파일에 걸친 7개의 외부 참조가 모두 차단되었습니다—원격 스타일시트, 원격 로고, 메타데이터 스타일 URL, 형제 폴더 이미지, file:/// 경로, UNC 경로, 쿼리 문자열이 포함된 추적 URL. joined.html은 두 업로드의 텍스트를 유지하고, 차단된 각 이미지 자리에 자리표시자가 들어갑니다. 신뢰할 수 있는 로고 핸들러를 연결하면 로고는 supplied 상태가 되고 나머지 여섯 개는 blocked 상태를 유지합니다.
나란히 비교: 이전 vs. 이후
| 이전 (옵션 없음) | 이후 (GroupDocs.Merger 26.10) | |
|---|---|---|
| 외부 요청 | 모든 참조가 자동으로 로드됨 | 명시적으로 허용하지 않으면 차단 |
| 절대 로컬 파일 경로 | 출력에 포함됨 | 다른 모든 참조와 동일하게 차단 |
| 신뢰 예외 | 필요 없음—모두 로드됨 | 핸들러를 통한 하나의 리소스 또는 허용된 접두사 |
| 잘못된 허용 목록 항목 | 허용 목록이 존재하지 않음 | 생성 시 ArgumentException으로 거부 |
| 필요한 코드 | 로드 제한 방법이 없음 | LoadOptions 몇 줄 |
가능한 것과 편리한 것 사이의 차이입니다. 26.10 이전에는 로드를 중단하는 설정이 없었고, 이후에는 차단이 기본이며 모든 예외가 명시적입니다.
이미 원격 이미지를 로드하도록 의존하던 HTML이 깨질까요?
기본 LoadOptions로 해당 HTML을 계속 병합한다면, 예—이미지가 로드되지 않고 자리표시자가 출력에 나타납니다. 해결 방법은 명시적이며 우회가 아닙니다: WhitelistedResources에 신뢰할 수 있는 소스를 나열하거나, 여전히 렌더링하고 싶은 특정 자산을 제공하는 IExternalResourceHandler를 연결합니다. 어느 쪽이든 병합은 계속 진행되지만, 명시되지 않은 모든 것을 가져오는 것은 중단됩니다.
실제 사례: 청구서 및 배송 메모 통합
고객이 제출한 HTML을 보관용 복사본으로 병합하는 문서 파이프라인은 이 페이지의 샘플 프로젝트가 모델링한 정확한 시나리오입니다: 동일 주문의 청구서 업로드와 배송 메모를 하나의 파일로 결합합니다. 두 업로드 모두 파이프라인 팀이 작성한 것이 아니므로 문자 그대로 안전하다고 가정할 수 없습니다. 청구서에는 금액, 고객(Northwind Traders) 정보와 로고 참조, 추적 스타일시트, 클라우드 메타데이터 스타일 URL, 동일 폴더 이미지 참조, file:/// 경로가 포함되어 있어 두 업로드 사이에 7개의 외부 참조가 존재하지만, 보관 파이프라인이 고객을 대신해 가져서는 안 됩니다.
병합 작업을 실서비스에 적용하기 전에, 문서 유형별로 예외가 필요한지 여부를 결정하는 것이 좋습니다. 이 샘플 청구 시나리오에서는 정확히 하나가 필요했습니다: 원격 URL이 아니라 디스크에 이미 존재하는 파일에서 제공되는 회사 로고. 나머지—추적 스타일시트, 메타데이터 스타일 주소, 형제 파일, UNC 및 file:/// 경로—는 가져올 정당한 이유가 없었으므로 기본값만으로도 올바른 답이었습니다.
// Reject a whitelist entry that is not an absolute URI prefix
var loadOptions = new LoadOptions(FileType.HTML)
{
WhitelistedResources = new List<string> { "cdn.example.com" }
};
절대 URI 접두사가 아닌 단순 호스트 이름(https://cdn.example.com/brand/와 같은)으로 전달하면 Whitelisted resource 'cdn.example.com' must be an absolute URI without a query, fragment or encoded '/', '\' or '.'. (Parameter 'WhitelistedResources') 메시지와 함께 예외가 발생합니다—업로드가 열리기 전 단계에서입니다. 시작 시점에 잘못 구성된 허용 목록을 잡아내는 것이, 프로덕션에서 리소스가 조용히 로드 실패하는 것을 잡아내는 것보다 훨씬 가치 있습니다.
GroupDocs.Merger for .NET로 할 수 있는 다른 일은 무엇인가요?
- 허용 목록 항목을 일찍 검증: 형식이 잘못된
WhitelistedResources항목은Merger생성 시 실패하므로, 배포 시작 시점 검증으로 문서가 처리되기 전에 문제를 발견할 수 있습니다. - 디스크에서 신뢰 자산 제공:
IExternalResourceHandler는 이미 보유한 바이트를 반환하여 네트워크 접근 없이 요청을 처리합니다. - 모든 결합 문서에 하나의 정책 적용:
LoadOptions를Merger에 한 번 설정하면 이후에 결합되는 모든 문서가 동일한 규칙을 따릅니다. - HTML 외에도 지원: 워드 프로세싱, HTML/MHTML, 프레젠테이션, 스프레드시트, SVG 및 EPUB 문서도 동일한 옵션을 따릅니다.
결론
직접 작성하지 않은 HTML을 병합한다고 해서 그 안의 모든 것을 신뢰해야 하는 것은 아닙니다. GroupDocs.Merger for .NET은 26.10 버전부터 기본적으로 외부 리소스를 차단하며, 예외를 부여하는 두 가지 방법—신뢰 자산 핸들러와 WhitelistedResources—을 통해 파이프라인에 필요한 만큼만 접근을 허용하고 그 이상은 차단합니다.
직접 시도해 보시겠습니까?
- 무료 임시 라이선스 사용해 보기
- 외부 리소스 로드 건너뛰기 방법 읽기
- GroupDocs.Merger가 네트워크에 접근하는 시점 알아보기
- 단계별 사용 사례 가이드 살펴보기
- GitHub에서 샘플 프로젝트 확인하기