We’re pleased to announce GroupDocs.Annotation for .NET 26.10, released in October 2026. This is a security‑focused release: documents no longer pull in remote images, style sheets or linked files on their own, and new LoadOptions members let you decide exactly what may be loaded. The release also upgrades the underlying document engines, updates a vulnerable dependency and fixes several issues.
このリリースの新機能
| キー | カテゴリ | 概要 |
|---|---|---|
| ANNOTATIONNET-2663 | ⚠️ 機能強化 | 外部リソースはデフォルトでロードされなくなります(新しい LoadOptions コントロール) |
| ANNOTATIONNET-2687 | ✨ 機能強化 | 基盤となるドキュメントエンジンをアップグレード |
| ANNOTATIONNET-2672 | 🔒 セキュリティ | System.Security.Cryptography.Pkcs を 8.0.2 に更新(CVE-2026-84008 / CVE-2026-70162) |
| ANNOTATIONNET-2102 | 🔧 修正 | EML ドキュメントからの注釈抽出時に発生した FileTypeNotSupportedException を修正 |
| ANNOTATIONNET-1903 | 🔧 修正 | 古いバージョンで注釈されたドキュメントが .NET 8 で開けない問題を修正 |
| ANNOTATIONNET-2689 | 🔧 修正 | PDF ページの 90 度回転が保存時に失われる問題を修正 |
外部リソースはデフォルトでロードされなくなります
ドキュメントは自身の外部リソースを参照できます。HTML ページやメール本文の <img src="https://...">、Word 文書のリンク画像、リモートスタイルシート、外部ブックリンクなどです。これまで、このようなドキュメントを開く・プレビューする・保存する際に、GroupDocs.Annotation がネットワークやファイル共有からリソースを取得していました。
信頼できないドキュメントを処理するサーバーでは、サーバーサイドリクエストフォージェリ(SSRF) のリスクがあります。ドキュメントがサーバーに内部アドレスへのアクセスをさせたり、UNC パスがプロセスの Windows 資格情報を漏洩させたりする可能性があります。
26.10 以降、Word 処理、HTML、メール、プレゼンテーション、スプレッドシート ドキュメントに対して 外部リソースはデフォルトでスキップ されます。
- リクエストなし。 ドキュメントが参照するリソースに対して、
Get、Add、Save、GeneratePreview、GetDocumentInfoのいずれの操作でもネットワークやファイル共有へのリクエストは行われません。 - 空のプレースホルダー。 スキップされた画像は透明なプレースホルダーとして描画され、元のリンクは保存されたドキュメントに保持されます。
- 埋め込みコンテンツは引き続き機能します。 メールの
cid:部分、data:URI、埋め込み画像は常にロードされます。 - 画像アノテーションは影響を受けません。
ImageAnnotation.ImagePathは URL からロードされます。
これは動作の変更です。 ドキュメントがリモート画像やスタイルシートのレンダリングに依存している場合は、新しい LoadOptions メンバーで明示的に許可してください。
| メンバー | デフォルト | 説明 |
|---|---|---|
SkipExternalResources |
true |
外部リソースをスキップします。false に設定すると 26.10 以前の動作に戻ります。 |
WhitelistedResources |
empty | リソースがスキップされてもロードされるホスト名または絶対 URI プレフィックス。 |
ExternalResourceHandler |
null |
すべての外部リソースに対して呼び出されます。許可、スキップ、またはコンテンツの提供が可能です。 |
信頼できるホストのみを許可してください(推奨):
LoadOptions loadOptions = new LoadOptions
{
// SkipExternalResources stays true (the default)
WhitelistedResources = { "cdn.example.com", "https://intranet.example.com/images/" }
};
using (Annotator annotator = new Annotator("input.html", loadOptions))
{
annotator.Save("output.html"); // only images from the two whitelisted locations are loaded
}
ハンドラで各リソースを検査、許可、または置き換えます:
class AuditingResourceHandler : ExternalResourceHandler
{
public override void OnLoading(ExternalResourceLoadingArgs args)
{
Console.WriteLine($"{args.Uri}: {(args.Skipped ? "skipped" : "loaded")}");
// serve a local copy instead of going to the network
if (args.Uri == "https://example.com/logo.png")
args.Data = File.ReadAllBytes("logo.png");
}
}
ドキュメントエンジンのアップグレード
バンドルされたワードプロセッシング、スプレッドシート、プレゼンテーション、PDF、ダイアグラム、メール、イメージング、CAD、グラフィックレンダリングエンジンは、2026年10月のリリースに更新されました。再生成されたドキュメントやページプレビューは、バイトまたはピクセルレベルで若干差異が生じる可能性がありますが、視覚的には同等です。
.NET 6 と .NET 8 プロジェクトでは、ランタイムパッケージが SkiaSharp 4.152.1 に依存するようになりました。プロジェクトが SkiaSharp 3.x を直接参照している場合は、4.x に更新してください。
セキュリティ更新
ドキュメントエンジンは System.Security.Cryptography.Pkcs 8.0.0 または 8.0.1 を取り込みますが、これらは CVE-2026-84008 と CVE-2026-70162 の影響を受けます。GroupDocs.Annotation はすべてのターゲットフレームワークでパッチ適用済みの 8.0.2 を参照するようになりました。コードの変更は不要です。
修正点
- ストリームからの EML。
MIME-Version: 1.0で始まる EML メッセージが MHT アーカイブとして検出され、ストリームから開くとFileTypeNotSupportedExceptionがスローされていました。このようなメッセージはストリームでもファイルでも同様に開くようになり、MHT ファイルがメールドキュメントとしてサポートされるようになりました。 - .NET 8 上の古いドキュメント。 26.6 以前のバージョンでアノテーションされたドキュメントは .NET 8 で
NotSupportedExceptionが発生して開けませんでしたが、現在は開くことができます。レガシーアノテーションはログ警告とともにスキップされ、新しいアノテーションは追加・保存可能です。再保存されたプレゼンテーション(PPTX)でアノテーションが読み戻せない問題もすべてのフレームワークで修正されました。 - PDF の 90 度回転。
Annotator.Rotationで PDF ページを回転させると 180 度と 270 度は機能していましたが、90 度回転は保存時に失われていました。現在はすべての角度で保持されます:
using (Annotator annotator = new Annotator("input.pdf"))
{
annotator.ProcessPages = 1; // the page to rotate
annotator.Rotation = RotationDocument.on90; // previously ignored
annotator.Save("output.pdf");
}
パブリック API の変更
このリリースでは以下のメンバーが追加されました:
LoadOptions.SkipExternalResourcesLoadOptions.WhitelistedResourcesLoadOptions.ExternalResourceHandlerExternalResourceHandlerクラスExternalResourceLoadingArgsクラス
公開メンバーは削除または変更されていません。
アップデートの取得方法
NuGet
NuGet を使用して GroupDocs.Annotation 26.10.0 をインストールまたはアップグレードしてください。パッケージは対象フレームワーク (.NET Framework 4.6.2、.NET 6、.NET 8) に合わせてランタイムパッケージを自動的に解決します。
dotnet add package GroupDocs.Annotation --version 26.10.0
直接ダウンロード
リリースは GroupDocs.Annotation for .NET 26.10 ページからダウンロードしてください。