GroupDocs.Search & Redaction in .NET – 機密データをマスクする
大量のドキュメントを管理することは大変です。特に、機密データをマスクしながら高速な検索機能を提供する必要がある場合はなおさらです。このガイドでは、GroupDocs.Search と GroupDocs.Redaction の設定手順を解説し、ドキュメントをインデックスに追加する方法、大規模ドキュメントの検索を効率的に実行する方法、そしてプライバシー要件を遵守する方法をご紹介します。
クイック回答
- “機密データをマスク”とは何ですか? それは、ドキュメントから機密情報を永久に削除または隠すことを意味します。
- どのライブラリが必要ですか? .NET 用の GroupDocs.Search と GroupDocs.Redaction(NuGet 経由で入手可能)です。
- .NET プロジェクトを自動的にインデックスできますか? はい – “How to index .NET” セクションで手順をご確認ください。
- 大きなファイルはどう処理しますか? データを扱いやすいサイズに分割して処理するチャンクベース検索を使用します。
- 本番環境でライセンスは必要ですか? 本番利用には有効な GroupDocs ライセンスが必要です。無料トライアルも利用可能です。
機密データをマスクするとは何か?
機密データをマスクするとは、個人情報、財務情報、機密情報などをドキュメントから永久に削除または隠蔽し、権限のないユーザーが復元または閲覧できないようにするプロセスです。
なぜ GroupDocs.Search と Redaction を組み合わせるのか?
- 速度: ミリ秒単位で結果を返す検索可能なインデックスを構築します。
- セキュリティ: ドキュメントを共有または保存する前に赤字マスクルールを適用します。
- スケーラビリティ: チャンク検索により、メモリを使い果たすことなくテラバイト規模のテキストを処理できます。
- コンプライアンス: 機密データが漏洩しないようにすることで、GDPR、HIPAA などの規制を遵守します。
前提条件
- .NET 開発環境(Visual Studio 推奨)。
- 基本的な C# の知識。
- 必要なパッケージをインストールするための NuGet へのアクセス。
.NET 用 GroupDocs.Redaction の設定
.NET CLI でのインストール
dotnet add package GroupDocs.Redaction
パッケージマネージャーでのインストール
Install-Package GroupDocs.Redaction
NuGet パッケージマネージャー UI
“GroupDocs.Redaction” を検索し、最新バージョンをインストールします。
ライセンス取得手順
- 無料トライアル: 機能を試すために無料トライアルから始めます。
- 一時ライセンス: 期間延長用に一時ライセンスをリクエストします。
- 購入: 長期の本番利用のために購入を検討します。
基本的な初期化と設定
using GroupDocs.Redaction;
RedactorSettings settings = new RedactorSettings();
// Initialize with desired options or default ones
実装ガイド
GroupDocs.Search を使用した .NET プロジェクトのインデックス作成方法
以下では、実装を明確な番号付きステップに分割し、簡単に追従できるようにしています。
手順 1: インデックスフォルダーを指定する
string indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Searching/SearchByChunks";
なぜ? 専用フォルダーを定義することで、インデックスが整理され、生のドキュメントから分離されます。
手順 2: インデックスを作成および構成する
Index index = new Index(indexFolder);
目的: 指定した場所に新しい検索可能インデックスを作成します。
手順 3: ドキュメントをインデックスに追加
index.Add("YOUR_DOCUMENT_DIRECTORY/DocumentsPath1");
index.Add("YOUR_DOCUMENT_DIRECTORY/DocumentsPath2");
index.Add("YOUR_DOCUMENT_DIRECTORY/DocumentsPath3");
説明: 各呼び出しでファイル(またはフォルダー)をインデックスに追加し、その内容を検索可能にします。
チャンク検索による大規模ドキュメントの検索
チャンク検索を使用すると、巨大なファイルを小さな部分に分割でき、メモリ使用量を抑えることができます。
手順 1: 検索クエリを定義する
string query = "invitation";
目的: インデックスされたすべてのファイルで検索したい語句です。
手順 2: チャンク検索オプションを構成する
SearchOptions options = new SearchOptions();
options.IsChunkSearch = true;
説明: IsChunkSearch を有効にすると、エンジンはデータをチャンク単位で処理します。
手順 3: 初期検索を実行する
SearchResult result = index.Search(query, options);
Console.WriteLine("Document count: " + result.DocumentCount);
Console.WriteLine("Occurrence count: " + result.OccurrenceCount);
結果: 用語を含むドキュメント数と、見つかった総出現回数を示します。
手順 4: 後続のチャンクで続行する
while (result.NextChunkSearchToken != null)
{
result = index.SearchNext(result.NextChunkSearchToken);
Console.WriteLine("Document count: " + result.DocumentCount);
Console.WriteLine("Occurrence count: " + result.OccurrenceCount);
}
なぜこのループか? データセット全体が処理されるまで、すべてのチャンクから結果を取得できるようにします。
GroupDocs.Redaction を使用した機密データのマスク方法
保護すべき情報を特定したら、赤字マスクルールを適用します。
手順 1: 赤字マスク設定を初期化する
RedactorSettings settings = new RedactorSettings();
手順 2: 赤字マスクを適用する
Redactor クラス(ここでは元のコードを保持するため表示していません)を使用して、マスクしたいパターン、テキスト、画像を定義します。
プロのコツ: 誤ってデータが失われないよう、まずドキュメントのコピーで赤字マスクルールをテストしてください。
実用的な活用例
これらの機能は多くの業界で活躍します:
- 法務文書管理 – ケースファイルを迅速に検索し、クライアント機密情報をマスクします。
- 医療データ処理 – 患者の PHI を保護しつつ、医療従事者が関連レコードを検索できるようにします。
- 金融監査 – 大量の取引ログをインデックスし、口座番号や個人識別子をマスクします。
パフォーマンス上の考慮点
- インデックス最適化: 変更されたファイルのみを再インデックスし、不要な作業なくインデックスを最新に保ちます。
- リソース管理: サーバーの RAM に応じてチャンクサイズ(
options.ChunkSize)を調整します。 - 非同期操作: 大量バッチの場合、非同期インデックス作成を使用して UI の応答性を保ちます。
よくある質問
Q: 大きなファイルを効率的に処理するには?
A: IsChunkSearch = true のチャンクベース検索を使用してデータを小さな単位で処理し、メモリ負荷を軽減します。
Q: GroupDocs.Redaction は暗号化されたドキュメントでも使用できますか?
A: はい – まずファイルを復号し、赤字マスクを適用し、必要に応じて再暗号化します。
Q: 利用可能なライセンスオプションは?
A: 無料トライアル、評価用の一時ライセンス、そして本番用のフル商用ライセンスがあります。
Q: インデックスエラーをトラブルシュートするには?
A: インデックスフォルダーのパスが正しいか確認し、アプリケーションに読み書き権限があることを確認し、すべてのドキュメント形式がサポートされているかチェックします。
Q: 検索クエリをさらにカスタマイズできますか?
A: もちろんです。SearchOptions API を使用して、ブール演算子、ワイルドカード、近接検索を組み合わせることができます。
リソース
- ドキュメント: GroupDocs Redaction .NET
- API リファレンス: GroupDocs Redaction API
- ダウンロード: Latest Releases
- 無料サポート: GroupDocs Forum
- 一時ライセンス: Request Here
最終更新日: 2026-04-27
テスト環境: GroupDocs.Search 23.9 と GroupDocs.Redaction 23.9 for .NET
作者: GroupDocs