💡 Ví dụ hoạt động đầy đủ có sẵn trên GitHub: secure-untrusted-document-upload-conversion-dotnet
Thách thức trong Kế toán phải trả: Tại sao việc chuyển đổi tải lên của nhà cung cấp lại gặp sự cố khi quy mô lớn
Máy chủ của bạn chuyển đổi hoá đơn; HTML của nhà cung cấp quyết định những gì khác nó sẽ đọc. Việc chuyển đổi tải lên an toàn của nhà cung cấp với GroupDocs.Conversion for .NET chuyển đổi tệp đã tải lên thành PDF mà không cho phép các tham chiếu trong tệp tự quyết định máy chủ của bạn sẽ truy xuất hoặc đọc gì tiếp theo.
Cổng thông tin hoá đơn của nhà cung cấp cho phép bất kỳ nhà cung cấp nào đã được phê duyệt tải lên hoá đơn — thường là dưới dạng HTML hoặc PDF, đôi khi kèm theo bản vẽ SVG cho mục cơ sở vật chất hoặc xây dựng — và hệ thống kế toán phải trả chuyển đổi nó sang PDF để lưu trữ và định tuyến phê duyệt. HTML đó được viết bởi nhà cung cấp, không phải đội ngũ của bạn, và nó có thể tham chiếu bất kỳ thứ gì mà một trang web có thể tham chiếu: một stylesheet, một script, một hình ảnh được lưu trữ trên CDN của nhà cung cấp, hoặc — nếu tài khoản của nhà cung cấp bị xâm nhập — một địa chỉ mà không bao giờ được phép truy cập từ mạng của bạn.
Khối lượng nhà cung cấp chỉ tăng lên. Khi số lượng chuyển từ vài nhà cung cấp thành hàng trăm, thư mục tải lên mà trước đây chỉ chứa tệp của một công ty giờ chứa tệp của mọi người — và một tham chiếu hình ảnh tương đối trong hoá đơn của một nhà cung cấp có thể giải quyết thành tệp thuộc về một nhà cung cấp khác nằm ngay bên cạnh.
Điều mà đội ngũ kế toán phải trả thực sự cần không phải là một quy tắc tường lửa mạng, mà là một bước chuyển đổi xử lý mọi tham chiếu trong tệp tải lên như không đáng tin cậy theo mặc định, cho phép một tài sản đã được xem xét như logo của nhà cung cấp một cách có chủ đích, và thất bại một cách rõ ràng — không im lặng — khi mục whitelist được viết sai.
Kiểm tra thực tế: một thẻ
<img>duy nhất trỏ tớihttp://169.254.169.254/latest/meta-data/iam/security-credentials/yêu cầu máy chủ chuyển đổi gọi dịch vụ siêu dữ liệu đám mây — một yêu cầu mà người tải lên không bao giờ có thể thực hiện từ bên ngoài. Đó là tấn công giả mạo yêu cầu phía máy chủ, và một tải lên HTML là đủ để thực hiện.
Tại sao các giải pháp chung không khắc phục được lỗ hổng này
Các đội kế toán thường hướng tới một trong những cách sau trước khi áp dụng một thư viện chuyển đổi có chính sách tài nguyên riêng:
- Chặn lưu lượng ra mạng trên máy chủ chuyển đổi: ngăn chặn việc truy xuất từ xa, nhưng không ảnh hưởng gì đến tệp cùng thư mục mà một tham chiếu tương đối có thể giải quyết — chính là những gì xảy ra khi một tải lên được chuyển đổi trực tiếp từ đường dẫn đã lưu.
- Xóa các thẻ trước khi chuyển đổi: dễ bị phá vỡ khi có các loại tham chiếu mới (
<link>, SVG<image>, CSS@import) và phải được kiểm tra lại mỗi khi định dạng tải lên thay đổi. - Tin tưởng vào trình quét tải lên của cổng nhà cung cấp: chỉ quét các chữ ký phần mềm độc hại, không quét các URL trỏ tới hạ tầng của bạn.
GroupDocs.Conversion khắc phục lỗ hổng này ngay tại thời điểm quan trọng nhất: ngay khi tài liệu được tải để chuyển đổi, trước khi bất kỳ đầu ra nào được tạo ra.
Giải pháp: GroupDocs.Conversion trong quy trình hoá đơn nhà cung cấp
GroupDocs.Conversion for .NET 26.10 từ chối tài nguyên bên ngoài theo mặc định thông qua SkipExternalResources, cho phép bạn chỉ định chính xác các vị trí bạn tin cậy qua WhitelistedResources, và cung cấp một callback cho mỗi tài nguyên qua IExternalResourceHandler có thể xác nhận, ghi đè, hoặc cung cấp trực tiếp byte của tài nguyên — vì vậy một logo nhà cung cấp đã được xem xét vẫn có thể xuất hiện trong PDF đầu ra mà không cần thực hiện bất kỳ yêu cầu mạng nào.
Để theo dõi triển khai dưới đây, bạn sẽ cần:
- .NET 8.0 hoặc mới hơn
- GroupDocs.Conversion for .NET (nhận bản dùng thử miễn phí)
- Một mẫu HTML hoặc SVG tải lên mà bạn không kiểm soát
dotnet add package GroupDocs.Conversion --version 26.10.0
Triển khai bước chuyển đổi tải lên nhà cung cấp từng bước
Ví dụ dưới đây mô phỏng một kịch bản cổng nhà cung cấp thực tế: chuyển đổi một hoá đơn đã tải lên (invoice-upload.html) mà tham chiếu tới một logo, một địa chỉ nội bộ, một tệp cục bộ, và một tệp nằm cạnh nó.
Hầu hết các đoạn mã dưới đây truyền một đối tượng ResourceAudit — một IExternalResourceHandler nhỏ ghi lại mỗi quyết định tải và có thể cung cấp byte của tài sản đáng tin cậy. Mã đầy đủ của nó nằm trong
Program.cs của kho mẫu.
Bước 1 - Tải và Chuyển đổi từ Đường dẫn Đã Lưu của Tải lên
Đây là cách một cổng có thể chuyển đổi tải lên ngay sau khi lưu nó vào một thư mục chia sẻ — và là bước mà một tệp cùng thư mục có thể rò rỉ vào.
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;
Việc tải trực tiếp từ uploadPath đưa toàn bộ thư mục của hoá đơn vào phạm vi, không chỉ tệp duy nhất bên trong. Phạm vi, không phải độ tin cậy, quyết định những gì được tải. Trong lần chạy này, mọi tham chiếu từ xa và file:/// trong hoá đơn đều bị chặn, nhưng other-customer-signature.svg — một tệp khác được lưu trong cùng thư mục — vẫn được tải, vì SkipExternalResources chỉ loại trừ các tham chiếu nằm ngoài thư mục đó.
Bước 2 - Cấu hình cho Yêu cầu Tải lên Nhà cung cấp
Đối với tải lên nhà cung cấp, loại bỏ hoàn toàn thư mục gốc bằng cách tải từ một stream thay vì từ một đường dẫn:
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;
Tại sao cài đặt này quan trọng đối với cổng nhà cung cấp:
- Đầu vào dạng Stream: tài liệu được chuyển đổi từ một stream không có thư mục, vì vậy một tham chiếu tương đối bên trong không thể giải quyết thành tệp của nhà cung cấp khác.
ExternalResourceHandler: vẫn chạy cho mọi tài nguyên, vì vậy bạn vẫn giữ bản ghi chính xác những gì mỗi tải lên nhà cung cấp yêu cầu.
Bước 3 - Thực thi và Cung cấp một Tài sản Đã Được Xem xét
Logo của nhà cung cấp là một tham chiếu mà bạn thực sự muốn giữ — được cung cấp từ một bản sao mà bạn kiểm soát, không phải tải về từ URL của nhà cung cấp:
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;
Trình xử lý của ResourceAudit kiểm tra URL yêu cầu so với từ điển các tài sản đáng tin cậy; khi khớp, nó đặt ExternalResourceLoadingArgs.Data thành byte cục bộ và Skipped thành false, vì vậy logo xuất hiện trong PDF đầu ra trong khi năm tham chiếu còn lại của hoá đơn vẫn bị chặn.
Bước 4 - Từ chối sớm một mục whitelist được cấu hình sai
Một mục whitelist chỉ là tên máy chủ, không phải tiền tố URI tuyệt đối, sẽ khiến quá trình chuyển đổi thất bại thay vì im lặng khớp quá nhiều:
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;
}
Việc truyền cdn.example.com thay vì https://cdn.example.com/brand/ sẽ ném InvalidLoadOptionsException với thông điệp: 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/'. Bắt lỗi này ở thời điểm chuyển đổi, trong quá trình rà soát cấu hình hoặc kiểm tra khởi động, rẻ hơn rất nhiều so với việc phát hiện nó từ một tài nguyên bị khớp sai trong môi trường sản xuất. Hãy bắt nó trước khi đưa vào vận hành.
Tại sao một mục whitelist URL lại có thể bị từ chối?
WhitelistedResources chỉ chấp nhận các tiền tố URI tuyệt đối, chẳng hạn https://cdn.example.com/brand/ hoặc file:///C:/assets/. Các phiên bản trước đây khớp một mục ở bất kỳ vị trí nào trong URL, vì vậy cdn.example.com cũng khớp với địa chỉ của kẻ tấn công chỉ chứa những từ đó. Từ phiên bản 26.10 trở đi, mục này sẽ thất bại với InvalidLoadOptionsException, và phương pháp cuối cùng trong mẫu sẽ in ra thông điệp chính xác.
Tệp SVG Đính kèm của Nhà cung cấp Cũng Mang Rủi ro Tương tự
Một bản vẽ cơ sở vật chất đính kèm hoá đơn xây dựng vẫn chỉ là một tệp SVG, và nó được xử lý qua SvgLoadOptions thay vì WebLoadOptions. Hợp đồng giống nhau, chỉ khác thành phần: ExternalResourceHandler áp dụng cho các tham chiếu <image> của nó giống như nó đã áp dụng cho các thẻ <img> của hoá đơn, và bất kỳ <script> nội tuyến nào trong bản vẽ cũng không được thực thi:
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;
Đây chính là kịch bản hoá đơn xây dựng đã nêu ở phần mở đầu: một bản vẽ trông chỉ như một sơ đồ mặt bằng vẫn có thể mang một tham chiếu tới điểm cuối siêu dữ liệu đám mây của bạn, một tệp cục bộ, hoặc máy chủ của kẻ tấn công. Trong mẫu hoạt động, cả ba đều bị chặn, và chú thích được hiển thị đúng như bản vẽ, vì script đính kèm không bao giờ chạy.
Hành vi Trước và Sau
| Kiểm tra | Chuyển đổi trực tiếp từ đường dẫn đã lưu | Cách tiếp cận này |
|---|---|---|
| Tệp cùng thư mục | Tự động tải | Bị chặn — đầu vào dạng stream loại bỏ thư mục gốc |
| Logo nhà cung cấp | Bị chặn; PDF chỉ hiển thị văn bản alt | Cung cấp từ tệp cục bộ đã được xem xét |
| Siêu dữ liệu đám mây / địa chỉ nội bộ | Bị chặn theo mặc định | Bị chặn theo mặc định |
| Mục whitelist chỉ có tên máy chủ | Bị từ chối với InvalidLoadOptionsException |
Bị từ chối tương tự, bắt được trong kiểm tra khởi động |
| Script nội tuyến trong tải lên | Không chạy | Không chạy |
Hai hàng thay đổi: logo và tệp cùng thư mục. Tệp cùng thư mục là thứ mà một đánh giá ở mức mạng sẽ không bao giờ bắt được, vì không có yêu cầu mạng nào liên quan.
Các Kịch bản Tài liệu Nhà cung cấp Khác mà Điều này Áp dụng
Thuộc tính ExternalResourceHandler giống nhau cũng tồn tại trên các tùy chọn tải cho một số định dạng khác mà các cổng nhà cung cấp thường chấp nhận, vì vậy mẫu trên không giới hạn chỉ ở HTML và SVG:
- Tệp Word hoặc Excel do nhà cung cấp gửi:
WordProcessingLoadOptionsvàSpreadsheetLoadOptionscung cấp cùng hợp đồng handler. - Hoá đơn được gửi qua email:
EmailLoadOptionscung cấp cùng handler cho các hình ảnh từ xa mà phần thân email tham chiếu. - Báo cáo tài chính XBRL:
FinanceLoadOptionsbao phủ các tham chiếu taxonomy trong tài liệu XBRL do nhà cung cấp nộp.
Bắt đầu với Quy trình Tải lên Nhà cung cấp của Bạn
Bạn đã thấy GroupDocs.Conversion xử lý các tải lên nhà cung cấp không đáng tin cậy một cách an toàn. Các bước tiếp theo:
- Bắt đầu miễn phí: nhận giấy phép tạm thời để loại bỏ giới hạn dùng thử
- Đọc chính sách tài nguyên đầy đủ: bỏ qua việc tải tài nguyên bên ngoài bao gồm
WhitelistedResources,IExternalResourceHandler, và xử lý script chi tiết - Kiểm tra những gì tiếp xúc với mạng: truy cập mạng và bảo mật dữ liệu
- Theo dõi hướng dẫn từng bước: chuyển đổi tải lên không đáng tin cậy một cách an toàn - trường hợp sử dụng
- Duyệt mẫu hoạt động: secure-untrusted-document-upload-conversion-dotnet trên GitHub