C#でPDFをサニタイズする方法 with IronPDF

クイックスタートIronPDFでPDFをサニタイズする

IronPDFのCleanerクラスを使用して、PDF文書のセキュリティを強化してください。 このクイックスタートガイドは、C# .NETで最小限のコードでPDFをサニタイズする方法を示します。 ScanPdf メソッドを活用することで、埋め込まれたスクリプトやメタデータなどの脆弱性を排除し、PDFの完全性とセキュリティを確保できます。 コードスニペットに従ってPDFをクリーンアップし、潜在的な脅威から保護してください。

PDFをサニタイズするにはどうすればよいですか?

PDFのサニタイズは、PDFドキュメントを画像形式に変換し、JavaScriptコード、埋め込みオブジェクト、ボタンを削除した後、PDFドキュメントに戻すことで機能します。 SVGの画像形式を提供しています。このアプローチは、信頼できないソースからのPDFを扱う場合や、AzureやAWS Lambdaなどのクラウドプラットフォーム上で安全にデプロイするためのドキュメントを準備する場合に特に有用です。 SVGとBitmapの主な違いは以下の通りです：

• ビットマップでの洗浄より速い
• 検索可能なPDFを生成
• レイアウトが不一致になる可能性あり

:path=/static-assets/pdf/content-code-examples/how-to/sanitize-pdf-sanitize-pdf.cs

using IronPdf;

// Import PDF document
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Sanitize with Bitmap
PdfDocument sanitizeWithBitmap = Cleaner.SanitizeWithBitmap(pdf);

// Sanitize with SVG
PdfDocument sanitizeWithSvg = Cleaner.SanitizeWithSvg(pdf);

// Export PDFs
sanitizeWithBitmap.SaveAs("sanitizeWithBitmap.pdf");
sanitizeWithSvg.SaveAs("sanitizeWithSvg.pdf");

Imports IronPdf

' Import PDF document
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Sanitize with Bitmap
Private sanitizeWithBitmap As PdfDocument = Cleaner.SanitizeWithBitmap(pdf)

' Sanitize with SVG
Private sanitizeWithSvg As PdfDocument = Cleaner.SanitizeWithSvg(pdf)

' Export PDFs
sanitizeWithBitmap.SaveAs("sanitizeWithBitmap.pdf")
sanitizeWithSvg.SaveAs("sanitizeWithSvg.pdf")

ビットマップとSVGのサニタイズのどちらかを選択する場合は、特定の要件を考慮してください。 SVGのサニタイズはテキストの検索性を維持するため、サニタイズ後も検索性を維持する必要があるドキュメントに最適です。 これは、PDFから抽出したテキストを扱う場合や、PDF/UAのようなPDFアクセシビリティ機能を実装する場合に特に重要です。

:path=/static-assets/pdf/content-code-examples/how-to/santize-pdf-sanitize-chrome-render-options.cs

using IronPdf;

// Customize Chrome render options
var options = new ChromePdfRenderOptions();

// Set bottom margin to 50 pixels
options.MarginBottom = 50;

// Import PDF document
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Sanitize with Bitmap with Chrome render options
PdfDocument sanitizeWithBitmap = Cleaner.SanitizeWithBitmap(pdf, options);

// Sanitize with SVG with Chrome render options
PdfDocument sanitizeWithSvg = Cleaner.SanitizeWithSvg(pdf, options);

// Export PDFs
sanitizeWithBitmap.SaveAs("sanitizeWithBitmap.pdf");
sanitizeWithSvg.SaveAs("sanitizeWithSvg.pdf");

Imports IronPdf

' Customize Chrome render options
Dim options As New ChromePdfRenderOptions()

' Set bottom margin to 50 pixels
options.MarginBottom = 50

' Import PDF document
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Sanitize with Bitmap with Chrome render options
Dim sanitizeWithBitmap As PdfDocument = Cleaner.SanitizeWithBitmap(pdf, options)

' Sanitize with SVG with Chrome render options
Dim sanitizeWithSvg As PdfDocument = Cleaner.SanitizeWithSvg(pdf, options)

' Export PDFs
sanitizeWithBitmap.SaveAs("sanitizeWithBitmap.pdf")
sanitizeWithSvg.SaveAs("sanitizeWithSvg.pdf")

脆弱性のためにPDFをスキャンするにはどうすればよいですか?

PDFに潜在的な脆弱性がないかを確認するには、ScanPdfメソッドを使用してください。 この方法では、デフォルトのYARAファイルでチェックします。しかし、要件を満たすカスタムYARAファイルをメソッドの2番目のパラメータにアップロードすることができます。 このスキャン機能は、特に埋め込み添付ファイルやフォームフィールドを含む可能性のあるPDFを扱う場合、ドキュメントのセキュリティを維持するために不可欠です。

PDF文書用のYARAファイルには、悪意のあるPDFファイルに関連する特徴を識別するためのルールやパターンが含まれています。 これらのルールは、潜在的な脅威の検出を自動化し、リスクを軽減するための適切な行動を取るためにセキュリティアナリストを支援します。 YARAは特に効果的に検出します：

• 埋め込みJavaScriptのエクスプロイト
• 疑わしいフォームアクション
• 隠れた悪意のあるコンテンツ
• 既知の脆弱性パターン
• 未許可の埋め込みファイルまたはストリーム

:path=/static-assets/pdf/content-code-examples/how-to/sanitize-pdf-scan-pdf.cs

using IronPdf;
using System;

// Import PDF document
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Scan PDF
CleanerScanResult result = Cleaner.ScanPdf(pdf);

// Output the result
Console.WriteLine(result.IsDetected);
Console.WriteLine(result.Risks.Count);

Imports IronPdf
Imports System

' Import PDF document
Private pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Scan PDF
Private result As CleanerScanResult = Cleaner.ScanPdf(pdf)

' Output the result
Console.WriteLine(result.IsDetected)
Console.WriteLine(result.Risks.Count)

:path=/static-assets/pdf/content-code-examples/how-to/sanitize-pdf-custom-yara.cs

// このコードスニペットは利用できません！

' このコードスニペットは利用できません！

PDFのサニタイズのベストプラクティス

アプリケーションにPDFのサニタイズを実装する際には、以下のベストプラクティスを考慮してください：

1.処理の前に必ずスキャンする：特に外部ソースやユーザーがアップロードしたものなど、すべての受信PDFに対して脆弱性スキャンを実行してください。

2. 適切なサニタイズ方法を選択する：テキストの検索性が重要な場合は、SVG サニタイズを使用してください； 機密性の高い文書を扱う際は、最大限のセキュリティを確保するために bitmap サニタイズ機能を使用してください。

3.元のファイルを保存する：監査証跡やリカバリの目的で、サニタイズ前の元のPDFのコピーを保管してください。

4.ロギングの実装: セキュリティ監査とコンプライアンス要件のために、すべてのサニタイズ操作を追跡します。

5.定期的な更新: 最新のPDFベースの脅威と脆弱性を検出するために、YARAルールを常に更新してください。

PDFのサニタイズは、包括的なPDFセキュリティの一側面に過ぎません。 さらなるセキュリティ対策として、PDFのパスワードとアクセス許可を設定する、または電子署名を実装して、文書の真正性と完全性を確保することを検討してください。

次に何ができるのかを見てみましょうか？ こちらのチュートリアルページをご覧ください: PDFの署名とセキュリティの確保