GroupDocs.Redaction .NET を使用して機密データを赤字化する方法
契約書、財務諸表、患者記録などの機密情報を保護することは、現代のアプリケーションにとって交渉の余地のない必須要件です。このガイドでは、GroupDocs.Redaction for .NET を使用して 機密データを赤字化する方法 を、SDK のインストールから任意のドキュメントタイプに適用できる再利用可能な XML ポリシーの定義まで学びます。
Quick answers
- 「create redaction policy」とは何ですか?」 それは、テキスト、正規表現、画像などのルールを定義し、GroupDocs.Redaction に機密コンテンツの非表示または置換方法を指示するプロセスです。
- どのライブラリが必要ですか? NuGet で入手可能な GroupDocs.Redaction for .NET です。
- ライセンスは必要ですか? 開発には無料トライアルで動作しますが、本番環境では永続ライセンスが必要です。
- ポリシーは再利用できますか? はい。XML として保存すれば、後でロードして任意のドキュメントに適用できます。
- サポートされている .NET バージョンは何ですか? .NET Framework 4.5 以上、.NET Core 3.1 以上、.NET 5/6/7。
赤字化ポリシーとは?
赤字化ポリシーは、何を削除または置換すべきか、そして置換後の形式を指定するルールの集合です。ポリシーを一度作成すれば、アプリケーションが処理するすべてのドキュメントに一貫したセキュリティ基準を適用できます。
赤字化ポリシーはどのように機能しますか?
Redactor エンジンでドキュメントを読み込み、1 つまたは複数の赤字化ルールを付与し、Apply を呼び出します。エンジンはドキュメントを走査し、マッチしたコンテンツをマスクし、必要に応じて新しいファイルを出力します。同じルールセットを XML にエクスポートできるため、コードを再コンパイルせずにポリシーを再利用できます。
なぜ GroupDocs.Redaction を使用して赤字化ポリシーを作成するのか?
GroupDocs.Redaction は、赤字化ポリシーの作成、管理、実行を簡素化する包括的な機能セットを提供し、さまざまなドキュメントタイプにわたって一貫したデータ保護を実現すると同時に、高性能で既存の .NET アプリケーションへの容易な統合をチームや組織向けに実現します。
- 幅広いフォーマットサポート – SDK は PDF、DOCX、XLSX、PPTX、画像フォーマットなど 30 種類以上のファイルを扱い、ファイル全体をメモリに読み込まずに最大 2 GB のファイルを処理できます。
- プログラム的な精度 – 正確なフレーズ、正規表現、またはカスタムロジックを定義して、隠す必要のあるデータだけを対象にできます。
- 再利用可能な XML ポリシー – ルールを一度エクスポートすれば、チームやサービス、マイクロサービス間で共有できます。
- パフォーマンス最適化エンジン – ライブラリは一般的なサーバハードウェア上で数百ページのドキュメントを 1 秒未満で処理でき、高スループットのパイプラインに適しています。
前提条件
- 使用している .NET ランタイムと互換性のある GroupDocs.Redaction ライブラリ。
- Visual Studio、VS Code、または C# をサポートする任意の IDE。
- C# と .NET プロジェクト構造に関する基本的な知識。
.NET 用 GroupDocs.Redaction のセットアップ
まず、ライブラリをプロジェクトに追加します。
Using .NET CLI
dotnet add package GroupDocs.Redaction
Using Package Manager
Install-Package GroupDocs.Redaction
または NuGet パッケージマネージャー UI で “GroupDocs.Redaction” を検索し、そこからインストールします。
ライセンス取得
- 機能を試すために 無料トライアル から開始します。
- 長期テスト用に 一時ライセンス を申請し、その後本番利用のためにフルライセンスを購入します。
基本的な初期化
ソースファイルに名前空間を追加します:
using GroupDocs.Redaction;
Redactor クラスは GroupDocs.Redaction のコアエンジンで、ドキュメントを読み込み赤字化ルールを適用します。
赤字化ポリシーをステップバイステップで作成する方法
以下は、プログラムで赤字化ポリシーを構築し、ルールを設定し、ドキュメントに適用し、最終的にポリシーを XML ファイルとして永続化して将来再利用できるようにする完全な手順です。これにより、複数のプロジェクトやドキュメントタイプにわたって一貫した赤字化が保証されます。
手順 1: ドキュメントディレクトリの準備
string sourceFile = Utils.PrepareOutputDirectory("YOUR_DOCUMENT_DIRECTORY");
"YOUR_DOCUMENT_DIRECTORY" を、保護したいドキュメントが格納されているフォルダーに置き換えてください。
手順 2: ドキュメントの読み込み
using (Redactor redactor = new Redactor(sourceFile))
{
// Further code will go here
}
Redactor オブジェクトがファイルを開き、そのライフサイクルを管理します。
手順 3: 赤字化の定義
ExactPhraseRedaction は特定のフレーズを置換するルールを定義し、RegexRedaction は正規表現を使用してパターンにマッチさせます。
var redactions = new List<Redaction>
{
new ExactPhraseRedaction("Sensitive Phrase", new ReplacementOptions("[REDACTED]")),
new RegexRedaction(@"\d{4}-\d{2}-\d{2}", new ReplacementOptions("[DATE REDACTED]"))
};
ここでは 2 つのルールを作成します:
- ExactPhraseRedaction – 既知のフレーズを “[REDACTED]” に置換します。
- RegexRedaction –
YYYY‑MM‑DD形式の日付を検出し、 “[DATE REDACTED]” に置換します。
手順 4: 赤字化の適用
redactor.Apply(redactions);
定義されたすべてのルールが、開かれたドキュメントに対して一度のパスで実行されます。
手順 5: ポリシーを XML ファイルとして保存
string policyFile = "policy.xml";
redactor.SavePolicy(policyFile, new SaveOptions());
XML ファイルは赤字化定義を保存し、コードを書き直すことなく同じポリシーを再利用できるようにします。
実用的な活用例
- 法律事務所 は、ドラフトを共有する前に事件番号やクライアント名を赤字化できます。
- 財務部門 は、レポート内の口座番号や取引日付をマスクできます。
- 医療機関 は、患者識別子を除去して HIPAA コンプライアンスを確保します。
パフォーマンスのヒント
- 1 つのドキュメントだけ を同時に開くことでメモリ使用量を抑えます。
- 効率的な正規表現 を記述し、処理時間が増加する過度に広いパターンは避けます。
- ライブラリを 最新の状態 に保ち、パフォーマンス向上や新しい赤字化タイプの恩恵を受けましょう。
よくある問題と解決策
| 問題 | 発生原因 | 解決方法 |
|---|---|---|
| ディレクトリの準備中に IO 例外が発生 | パスが間違っているか書き込み権限がありません | フォルダーが存在し、アプリケーションに読み書き権限があることを確認してください。 |
| 正規表現が期待したテキストにマッチしません | パターンが厳しすぎるかエスケープ文字が不足しています | オンラインテスターで正規表現をテストし、量指定子や特殊文字のエスケープを調整してください。 |
| ポリシーファイルが作成されません | SavePolicy が赤字化適用前に呼び出されたか、無効なパスが指定されています | 出力ディレクトリが書き込み可能であることを確認し、Apply 後に SavePolicy を呼び出してください。 |
よくある質問
Q: プログラムで構築する代わりに既存の XML ポリシーをロードできますか?
A: はい。redactor.LoadPolicy("policy.xml") を使用して、以前に保存したポリシーをインポートできます。
Q: GroupDocs.Redaction はパスワード保護された PDF をサポートしていますか?
A: もちろんです。パスワードを Redactor コンストラクタに渡します: new Redactor(sourceFile, "password")。
Q: 画像やメタデータを赤字化することは可能ですか?
A: SDK にはそれらのシナリオ用に ImageRedaction と MetadataRedaction クラスが用意されています。
Q: 数百 MB の大きなドキュメントはどう処理しますか?
A: チャンク単位で処理するか、ストリーミング API を使用してメモリ使用量を削減してください。エンジンはファイル全体を RAM にロードせずに最大 2 GB のファイルを処理できます。
Q: 商用利用にはどのライセンスモデルが必要ですか?
A: 本番環境での導入には有料ライセンスが必要です。開発・テストにはトライアルライセンスで問題ありません。
結論
これで、GroupDocs.Redaction for .NET を使用して任意のドキュメントに適用できる完全で再利用可能な 赤字化ポリシー が手に入りました。ポリシーを XML にエクスポートすることで、将来の更新が簡素化され、組織全体で一貫したデータ保護が保証されます。
次のステップ
ImageRedactionやMetadataRedactionなどの追加赤字化タイプを試してみてください。- ポリシーロードロジックをドキュメント管理ワークフローに統合し、自動赤字化を実現します。
- 高度なカスタマイズのために GroupDocs.Redaction API リファレンスを参照してください。
最終更新日: 2026-10-06
テスト対象: GroupDocs.Redaction 5.8 for .NET
作者: GroupDocs