💡 完全に動作する例がGitHubで利用可能です: secure-untrusted-document-upload-conversion-dotnet
支払勘定の課題: ベンダーアップロード変換がスケールで失敗する理由
サーバーは請求書を変換し、ベンダーのHTMLがそれ以外に何を読むかを決定します。GroupDocs.Conversion for .NET を使用した安全なベンダーアップロード変換は、アップロードされたファイルをPDFに変換し、ファイル自身の参照がサーバーが次に取得または読み取るものを選択することを防ぎます。
ベンダー請求書ポータルは、承認されたサプライヤーが請求書をアップロードできるようにします—通常はHTMLまたはPDFで、時には施設や建設の項目用に添付されたSVG図面もあります—そして支払勘定システムはそれをPDFに変換してアーカイブと承認ルーティングに使用します。HTMLを書いたのはベンダーであり、あなたのチームではありません。そしてそれはウェブページが参照できるものすべてを参照できます: スタイルシート、スクリプト、ベンダー独自のCDNにホストされた画像、あるいはベンダーのアカウントが侵害された場合、ネットワークからは決して到達すべきでなかったアドレスです。
ベンダーの取引量は増える一方です。数社のサプライヤーから数百社に増えると、かつては1社のファイルだけを保持していたアップロードフォルダーがすべてのファイルを保持するようになり、あるベンダーの請求書内の相対画像参照が別のベンダーのファイルに解決されてしまうことがあります。
支払勘定チームが実際に必要としているのはネットワークファイアウォールのルールではなく、アップロード内のすべての参照をデフォルトで信頼できないものとして扱い、ベンダーのロゴのようなレビュー済み資産は意図的に通過させ、ホワイトリストエントリが誤っている場合は黙って失敗せずに大きくエラーを出す変換ステップです。
現実チェック:
<img>タグがhttp://169.254.169.254/latest/meta-data/iam/security-credentials/を指していると、変換サーバーはクラウドメタデータサービスにリクエストを送ります—外部からは決して行えないリクエストです。これはサーバー側リクエスト偽装(SSRF)であり、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
ベンダーアップロード変換ステップの実装手順
以下の例は実際のベンダーポータルシナリオに対応しています: ロゴ、内部アドレス、ローカルファイル、隣接ファイルを参照するアップロード請求書 (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 に表示され、請求書の他の5つの参照はブロックされたままです。
手順 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/ のような絶対URIプレフィックスが期待されるため 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 ファイルであり、WebLoadOptions の代わりに SvgLoadOptions を通ります。契約は同じですが要素が異なります: ExternalResourceHandler は <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 で拒否 |
同様に拒否、起動時チェックで捕捉 |
| アップロード内のインラインスクリプト | 実行されない | 実行されない |
変わるのはロゴと兄弟ファイルの2行です。兄弟ファイルはネットワークレベルのレビューでは決して捕捉できません。なぜならネットワークリクエストが発生しないからです。
このパターンが適用できる他のベンダードキュメントシナリオ
ExternalResourceHandler プロパティは、ベンダーポータルが一般的に受け入れる他のフォーマットのロードオプションにも存在します。したがってこのパターンは HTML と SVG に限定されません:
- ベンダーが提出した Word または Excel 添付ファイル:
WordProcessingLoadOptionsとSpreadsheetLoadOptionsが同じハンドラ契約を公開します。 - メールで送られた請求書:
EmailLoadOptionsがメール本文が参照するリモート画像に対して同じハンドラを提供します。 - XBRL 財務申告書:
FinanceLoadOptionsがベンダー提出の XBRL 文書内のタクソノミー参照をカバーします。
ベンダーアップロードパイプラインの開始方法
GroupDocs.Conversion が信頼できないベンダーアップロードを安全に処理する方法をご理解いただけたと思います。次にすべきことは以下の通りです:
- 無料で開始: 一時ライセンスを取得 して評価制限を解除
- リソースポリシー全体を読む: 外部リソースの読み込みをスキップする では
WhitelistedResources、IExternalResourceHandler、スクリプト処理の詳細が説明されています - ネットワークに触れるものをすべて確認: ネットワークアクセスとデータプライバシー
- ステップバイステップガイドに従う: 信頼できないアップロードを安全に変換する - ユースケース
- 動作サンプルを閲覧: secure-untrusted-document-upload-conversion-dotnet on GitHub