💡 전체 작동 예제는 GitHub에서 확인할 수 있습니다: secure-untrusted-document-upload-conversion-dotnet

회계-지불 부서의 과제: 공급업체 업로드 변환이 규모에 따라 실패하는 이유

서버가 청구서를 변환하고, 공급업체의 HTML이 다음에 무엇을 읽을지 결정합니다. GroupDocs.Conversion for .NET을 사용한 안전한 공급업체 업로드 변환은 업로드된 파일을 PDF로 변환하면서 파일 자체의 참조가 서버가 다음에 가져오거나 읽을 내용을 선택하지 못하도록 합니다.

공급업체 청구서 포털은 승인된 공급업체가 청구서를 업로드하도록 허용합니다—보통 HTML 또는 PDF 형태이며, 때때로 시설 또는 건설 라인 항목을 위한 SVG 도면이 첨부되기도 합니다—그리고 회계-지불 시스템은 이를 PDF로 변환하여 보관 및 승인 라우팅을 수행합니다. HTML은 공급업체가 작성했으며, 귀하의 팀이 만든 것이 아니고, 웹 페이지가 참조할 수 있는 모든 것을 참조할 수 있습니다: 스타일시트, 스크립트, 공급업체 자체 CDN에 호스팅된 이미지, 혹은 공급업체 계정이 침해된 경우 귀하의 네트워크에서 전혀 접근해서는 안 되는 주소까지도 말이죠.

공급업체 수는 계속 증가합니다. 몇몇 공급업체에서 수백 개로 늘어날 때, 한때 한 회사의 파일만 보관하던 업로드 폴더는 이제 모든 파일을 보관하게 되고, 한 공급업체 청구서 안의 상대 이미지 참조가 바로 옆에 있는 다른 공급업체 파일로 해석될 수 있습니다.

회계-지불 팀이 실제로 필요로 하는 것은 네트워크 방화벽 규칙이 아니라, 업로드 내부의 모든 참조를 기본적으로 신뢰하지 않으며, 공급업체 로고와 같은 검토된 자산은 의도적으로 통과시키고, 화이트리스트 항목이 잘못 작성되었을 때는 조용히 실패하지 않고 크게 실패하는 변환 단계입니다.

현실 점검: 단일 <img> 태그가
http://169.254.169.254/latest/meta-data/iam/security-credentials/ 를 가리키면 변환 서버가 클라우드 메타데이터 서비스에 호출을 시도하게 됩니다—업로드자는 외부에서 절대 이 요청을 만들 수 없습니다. 이는 서버 측 요청 위조이며, HTML 업로드만으로도 발생합니다.

일반적인 해결책이 이 문제를 메우지 못하는 이유

회계-지불 팀은 자체 리소스 정책을 가진 변환 라이브러리를 도입하기 전에 보통 다음 중 하나를 시도합니다:

  • 변환 호스트에 대한 네트워크 아웃바운드 차단: 원격 가져오기를 차단하지만, 상대 경로 참조가 해결될 수 있는 동일 폴더 파일에 대해서는 아무 것도 하지 않습니다—업로드가 저장된 경로에서 바로 변환될 때 정확히 발생하는 상황입니다.
  • 변환 전 태그 제거: 새로운 참조 유형(\<link>, SVG \<image>, CSS @import)에 취약하고, 업로드 형식이 바뀔 때마다 다시 감사해야 합니다.
  • 공급업체 포털 자체 업로드 스캐너 신뢰: 악성코드 서명을 검사하지만, 귀하의 인프라를 가리키는 URL은 검사하지 않습니다.

GroupDocs.Conversion은 가장 중요한 시점, 즉 문서가 변환을 위해 로드되는 순간, 출력이 생성되기 전에 이 격차를 메웁니다.

해결책: 공급업체 청구서 워크플로우에서 GroupDocs.Conversion 사용

GroupDocs.Conversion for .NET 26.10은 SkipExternalResources를 통해 외부 리소스를 기본적으로 차단하고, WhitelistedResources를 통해 신뢰하는 위치를 정확히 지정하게 하며, IExternalResourceHandler를 통한 리소스별 콜백을 제공하여 리소스의 바이트를 직접 확인, 재정의 또는 제공할 수 있습니다—검토된 공급업체 로고가 네트워크 요청 없이도 출력 PDF에 나타날 수 있게 합니다.

아래 구현을 따라하려면 다음이 필요합니다:

  • .NET 8.0 이상
  • GroupDocs.Conversion for .NET (무료 체험판 받기)
  • 제어할 수 없는 샘플 HTML 또는 SVG 업로드
dotnet add package GroupDocs.Conversion --version 26.10.0

공급업체 업로드 변환 단계 구현하기 (Step by Step)

아래 예시는 실제 공급업체 포털 시나리오에 맞춰져 있습니다: 로고, 내부 주소, 로컬 파일, 그리고 옆에 있는 파일을 참조하는 업로드된 청구서(invoice-upload.html)를 변환합니다.

아래 대부분의 스니펫은 ResourceAudit 객체—각 로드 결정을 기록하고 신뢰된 자산의 바이트를 제공할 수 있는 작은 IExternalResourceHandler—를 전달합니다. 전체 코드는 Program.cs of the sample repository에 있습니다.

단계 1 - 업로드된 파일의 저장 경로에서 로드하고 변환하기

포털이 업로드를 저장 직후 바로 변환하는 방식이며, 형제 파일이 유출될 수 있는 단계입니다.

var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };

using (var converter = new Converter(uploadPath, (LoadContext _) => loadOptions))
{
    converter.Convert(outputPath, new PdfConvertOptions());
}

return audit.Loaded;

uploadPath에서 바로 로드하면 청구서 전체 폴더가 범위에 포함되어, 해당 폴더 안의 파일 하나만 신뢰되는 것이 아니라 전체가 로드 대상이 됩니다. 범위가 신뢰를 결정합니다. 이 실행에서는 청구서에 있는 모든 원격 및 file:/// 참조가 차단되지만, 같은 폴더에 저장된 other-customer-signature.svg는 SkipExternalResources가 해당 폴더 외부의 참조만 제외하기 때문에 로드됩니다.

단계 2 - 공급업체 업로드 요구사항에 맞게 구성하기

공급업체 업로드의 경우, 경로 대신 스트림으로 로드하여 기본 폴더를 완전히 제거합니다:

var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };

using (var converter = new Converter(
    () => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
    converter.Convert(outputPath, new PdfConvertOptions());
}

return audit.Loaded;

이 설정이 공급업체 포털에 중요한 이유:

  • 스트림 입력: 스트림에서 변환된 문서는 폴더가 없으므로 내부 상대 참조가 다른 공급업체 파일로 해석될 수 없습니다.
  • ExternalResourceHandler: 여전히 모든 리소스에 대해 실행되므로 각 공급업체 업로드가 무엇을 요청했는지 정확히 기록할 수 있습니다.

단계 3 - 검토된 자산을 실행하고 캡처하기

공급업체 로고는 실제로 유지하고 싶은 참조 중 하나이며, 공급업체 자체 URL에서 가져오는 것이 아니라 제어 가능한 복사본에서 제공됩니다:

var trustedAssets = new Dictionary<string, byte[]>
{
    [assetUrl] = File.ReadAllBytes(assetPath)
};
var audit = new ResourceAudit(trustedAssets);
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };

using (var converter = new Converter(
    () => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
    converter.Convert(outputPath, new PdfConvertOptions());
}

return audit.Loaded;

ResourceAudit의 핸들러는 요청된 URL을 신뢰된 자산 사전과 비교합니다; 일치하면 ExternalResourceLoadingArgs.Data에 로컬 바이트를 설정하고 Skipped를 false로 지정해 로고가 출력 PDF에 나타나게 하고, 청구서의 다른 다섯 개 참조는 차단된 상태로 유지됩니다.

단계 4 - 잘못 구성된 화이트리스트 항목을 초기에 거부하기

호스트 이름만 포함하고 절대 URI 접두사가 아닌 화이트리스트 항목은 조용히 과다 매칭되는 대신 변환 자체를 실패시킵니다:

var loadOptions = new WebLoadOptions
{
    WhitelistedResources = new List<string> { entry }
};

try
{
    using var converter = new Converter(
        () => File.OpenRead(uploadPath), (LoadContext _) => loadOptions);
    converter.Convert(outputPath, new PdfConvertOptions());
    return null;
}
catch (InvalidLoadOptionsException exception)
{
    return exception.Message;
}

cdn.example.com 대신 https://cdn.example.com/brand/를 사용해야 한다는 InvalidLoadOptionsException 메시지가 발생합니다: Whitelisted resource 'cdn.example.com' is not valid. Expected an absolute URI prefix without a query, fragment or encoded '/', '\' or '.', such as 'https://cdn.example.com/assets/' or 'file:///C:/assets/'. 변환 시점, 구성 검토 또는 시작 시점에서 이를 잡아내는 것이 잘못 매칭된 리소스를 프로덕션에서 발견하는 것보다 훨씬 비용이 적게 듭니다. 배포 전에 잡아내세요.

URL 화이트리스트 항목이 거부되는 경우는 언제인가?

WhitelistedResources는 절대 URI 접두사만 허용합니다—예: https://cdn.example.com/brand/ 또는 file:///C:/assets/. 이전 버전은 URL 어디에든 일치시켰기 때문에 cdn.example.com이 공격자의 주소에 포함되기만 해도 매칭되었습니다. 26.10부터는 해당 항목이 InvalidLoadOptionsException과 함께 로드를 실패합니다. 샘플의 마지막 메서드는 정확한 메시지를 출력합니다.

공급업체 SVG 첨부 파일도 동일한 위험을 가짐

건설 청구서에 첨부된 시설 도면도 여전히 SVG 파일이며, SvgLoadOptions를 통해 처리됩니다. 계약은 동일하지만 요소가 다릅니다: ExternalResourceHandler는 청구서의 <img> 태그에 적용된 방식과 동일하게 <image> 참조에 적용되며, 도면에 포함된 인라인 <script>는 실행되지 않습니다:

var audit = new ResourceAudit();
var loadOptions = new SvgLoadOptions { ExternalResourceHandler = audit };

using (var converter = new Converter(
    () => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
    converter.Convert(outputPath, new PdfConvertOptions());
}

return audit.Loaded;

이는 서두의 건설 청구서 시나리오와 정확히 동일합니다: 평면도처럼 보이는 도면도 클라우드 메타데이터 엔드포인트, 로컬 파일, 혹은 공격자 서버를 가리키는 참조를 포함할 수 있습니다. 작동 샘플에서는 세 가지 모두 차단되고, 캡션은 그대로 그려집니다—스크립트가 절대 실행되지 않기 때문입니다.

전후 동작 비교

검사 저장된 경로에서 바로 변환 이 접근 방식
동일 폴더 형제 파일 자동으로 로드 차단됨 – 스트림 입력으로 기본 폴더 제거
공급업체 로고 차단; PDF에 alt 텍스트만 표시 검토된 로컬 파일에서 제공
클라우드 메타데이터 / 내부 주소 기본 설정으로 차단 기본 설정으로 차단
호스트명만 있는 화이트리스트 항목 InvalidLoadOptionsException으로 거부 동일하게 거부, 시작 시점 체크로 포착
업로드 내 인라인 스크립트 실행되지 않음 실행되지 않음

두 행이 변경됩니다: 로고와 형제 파일. 형제 파일은 네트워크 요청이 전혀 없기 때문에 네트워크 수준 검토로는 절대 잡히지 않습니다.

이 패턴이 적용되는 기타 공급업체 문서 시나리오

ExternalResourceHandler 속성은 공급업체 포털에서 흔히 허용하는 여러 다른 형식의 로드 옵션에도 존재하므로, 위 패턴은 HTML 및 SVG에만 국한되지 않습니다:

  • 공급업체가 제출한 Word 또는 Excel 첨부 파일: WordProcessingLoadOptions와 SpreadsheetLoadOptions가 동일한 핸들러 계약을 노출합니다.
  • 이메일로 전송된 청구서: EmailLoadOptions가 이메일 본문이 참조하는 원격 이미지를 위한 동일한 핸들러를 제공합니다.
  • XBRL 재무 보고서: FinanceLoadOptions가 공급업체가 제출한 XBRL 문서의 분류 체계 참조를 다룹니다.

공급업체 업로드 파이프라인 시작하기

GroupDocs.Conversion이 신뢰할 수 없는 공급업체 업로드를 안전하게 처리하는 방식을 확인했습니다. 다음 단계는 다음과 같습니다:

리소스