コンテンツへスキップ
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ICAP コンテンツ検証連携

ICAP コンテンツ検証の統合:ICAP プロトコルで Web Chat にアップロードされたファイルを外部サービスに転送し、ウイルススキャン、コンテンツフィルタリング、DLP を実行します。統合アーキテクチャ、プロトコルの実装、スキャン記録、デプロイ設定について説明します。

本ドキュメントでは、MaiAgent プラットフォームが ICAP (Internet Content Adaptation Protocol) を統合し、ユーザーがアップロードしたファイルと会話内容のセキュリティスキャンおよび検証を行い、マルウェアや不適切なコンテンツを防ぐ仕組みを説明します。

1. ICAP とは?

ICAP (Internet Content Adaptation Protocol) は、コンテンツを外部サービスに転送して、ウイルススキャン、コンテンツフィルタリング、情報漏えい防止などの処理を行う軽量なプロトコルです。

1.1 ICAP の主な価値

観点
コンテンツ検証なし
ICAP コンテンツ検証あり

セキュリティ

ユーザーがマルウェアや不適切なコンテンツをアップロードする可能性があります

悪意のあるファイルやコンテンツを自動でスキャンし、ブロックします

コンプライアンス

企業の情報セキュリティポリシーの要件を満たすことが困難です

エンタープライズ向けのウイルス対策および DLP ソリューションを統合します

柔軟性

コンテンツ検出ロジックを独自に開発する必要があります

標準プロトコルで専門的なサードパーティサービスを統合します

保守性

ウイルス定義と検出ルールを継続的に更新する必要があります

専門ベンダーが検出エンジンを保守します

1.2 主な利用シーン

  • ファイルアップロードの安全性: ナレッジベースにアップロードするドキュメントは、事前にウイルススキャンを行います

  • 会話内容のフィルタリング: 会話に不適切な発言や機密情報が含まれていないか検出します

  • 情報漏えい防止 (DLP): 機密情報を含むファイルのアップロードを防ぎます

  • コンプライアンスチェック: コンテンツが GDPR、HIPAA などの法規制の要件を満たしているか確認します


2. MaiAgent の ICAP 統合アーキテクチャ

2.1 主要コンポーネントの説明

  • ICAP クライアント: MaiAgent に組み込まれた ICAP プロトコルの実装で、ICAP サーバーとの通信を担当します

  • ICAP サーバー: Symantec、McAfee、Trend Micro のウイルス対策ゲートウェイなど、サードパーティのコンテンツスキャンサービスです

  • 処理キュー: ファイルのアップロードとスキャンタスクを非同期で処理し、ユーザー操作のブロックを防ぎます

  • スキャン記録: ファイルのハッシュ、スキャン時刻、結果など、すべてのスキャン結果を保存します

2.2 ICAP リクエストの流れ


3. ICAP プロトコル実装の詳細

3.1 ICAP リクエストの形式

MaiAgent は REQMOD (Request Modification) モードでファイルを ICAP サーバーに送信します:

主要フィールドの説明:

  • REQMOD: リクエスト変更モードです。コンテンツを保存する前に検査します

  • Encapsulated: HTTP リクエストのカプセル化形式を記述します

  • Allow: 204: コンテンツの変更が不要な場合、ICAP サーバーがそのまま 204 を返せることを伝えます

  • Chunked Encoding: チャンク転送エンコーディングでファイルの内容を送信します

3.2 チャンク転送エンコーディング (Chunked Transfer Encoding)

MaiAgent は HTTP チャンク転送エンコーディングを正しく実装しています:

正しいチャンクエンコーディングが必要な理由

  • ICAP プロトコルでは、リクエストとレスポンスのボディの送信に HTTP チャンク転送エンコーディングが必要です

  • エンコーディング形式が正しくないと、ICAP サーバーはファイルの内容を正しく解析できません

  • MaiAgent はチャンクサイズの16進数表記を修正し、ICAP 標準との互換性を確保しました

3.3 ICAP レスポンスの処理

ICAP サーバーは次のレスポンスを返す場合があります:

ステータスコード
意味
MaiAgent の処理

200 OK

コンテンツを検査または変更しました

変更後のコンテンツ(変更がある場合)を受け入れ、ファイルを保存します

204 No Content

コンテンツの変更は不要です

元のファイルをそのまま保存します

403 Forbidden

コンテンツは禁止されています(ウイルスを含む場合など)

保存を拒否し、クライアントに ICAP_BLOCKED イベントを送信します

500 Internal Error

ICAP サーバーエラーです

エラーを記録し、クライアントに ICAP_ERROR イベントを送信します


4. WebChat との統合

ICAP スキャンが完了すると、システムはスキャン結果をリアルタイムでユーザーに通知します:

  • ファイルのブロック: わかりやすいエラーメッセージを表示し、ファイルが拒否された理由(ウイルスの検出など)を説明します

  • システムエラー: ユーザーにしばらくしてから再試行するよう案内し、エラーログを記録します

ユーザー体験の改善

  • 即時フィードバック: ファイルのアップロード直後に「スキャン中」の状態を表示します

  • 進行状況の表示: 大きなファイルのアップロード時にプログレスバーを表示します

  • わかりやすいエラーメッセージ: ファイルが拒否された理由を平易な言葉で説明します

  • 再試行の仕組み: 一時的なエラーの場合、再アップロードの選択肢を提供します


5. スキャン記録の管理

5.1 記録の保存

MaiAgent はすべての ICAP スキャンの詳細な記録を保存します:

各スキャン記録には次の情報が含まれます:

フィールド
説明

ファイル識別子

スキャンしたファイルの一意の識別子です

ファイル名

元のファイル名です

ファイルハッシュ値

ファイルの整合性を確認するための SHA-256 ハッシュです

スキャン結果

PASS(合格)、BLOCKED(ブロック)、ERROR(エラー)です

スキャン理由

ファイルがブロックされた場合の具体的な理由を記録します

ICAP サーバー

スキャンを実行した ICAP サーバーのアドレスです

スキャン時刻

スキャン実行時のタイムスタンプです

ユーザー/組織

スキャンを開始したユーザーと所属組織です

5.2 期限切れ記録の削除

MaiAgent は期限切れのスキャン記録を定期的に削除する自動クリーンアップ機能を実装しています:

システムはバックグラウンドのスケジュールタスクを通じて、保存期間を超えたスキャン記録を自動で削除します。

クリーンアップ方針:

  • 保存期間: 組織の ICAP 設定の「記録保存日数」に従います。デフォルトは30日で、0を指定すると永久保存になります

  • 適用範囲: 保存日数は組織単位で設定し、同じ組織のすべてのスキャン記録に同一の期間を適用します


6. 設定とデプロイ

6.1 ICAP サーバーの設定

ICAP は MaiAgent がシステム管理側で組織ごとに設定します。管理画面には設定ページがありません。有効化や設定変更が必要な場合は、MaiAgent の担当窓口に連絡し、ICAP サーバーの情報を提供してください。各組織で設定できる項目は次のとおりです:

設定項目
説明

ICAP サーバー URL

ICAP サービスの接続 URL です。設定時に接続テストができます

有効化

有効にした場合のみ検査します。また、Agent が使用するモデルについても MaiAgent が ICAP 検査を有効にする必要があります。両方を有効にして初めて検査が行われます

ブロックメッセージ

コンテンツがブロックされたときにユーザーに表示するメッセージです

記録保存日数

スキャン記録の保存期間です。デフォルトは30日で、0は永久保存を意味します

6.2 対応する ICAP サービス

MaiAgent は次の主要な ICAP サービスと互換性があります:

  • Symantec Protection Engine: エンタープライズ向けのウイルス対策とコンテンツフィルタリングです

  • McAfee Web Gateway: ゲートウェイレベルのコンテンツスキャンです

  • Trend Micro IWSVA: Web セキュリティとコンテンツスキャンを統合したサービスです

  • Kaspersky Scan Engine: Kaspersky の ICAP スキャンエンジンです

  • ClamAV (c-icap 経由): オープンソースのウイルス対策ソリューションです

6.3 パフォーマンスに関する考慮事項

システムのパフォーマンスを確保するため、次の方法を推奨します:

  • 非同期スキャン: 大きなファイルをバックグラウンドタスクでスキャンし、アップロードのレスポンスをブロックしません

  • キャッシュ: 同一ファイル(ハッシュ値が同じファイル)のスキャン結果をキャッシュします

  • ICAP コネクションプール: ICAP サーバーとの永続接続を維持し、接続のオーバーヘッドを削減します

  • 負荷分散: 複数の ICAP サーバーインスタンスでスキャンの負荷を分散します


7. MaiAgent の ICAP 統合の技術的な利点

7.1 セキュリティ上の利点

  • 多層防御: ファイルの保存前にスキャンを行い、悪意のあるコンテンツを防ぎます

  • 即時ブロック: 脅威を検出すると即座にブロックし、システムへの保存を防ぎます

  • 専門エンジン: 業界をリードするウイルス対策および DLP エンジンを統合します

  • 完全な記録: すべてのスキャン活動を詳細に記録し、セキュリティ監査に役立てます

7.2 コンプライアンス上の利点

  • 標準プロトコル: 業界標準の ICAP プロトコルを使用し、既存の企業セキュリティ基盤と容易に統合できます

  • 監査証跡: 完全なスキャン記録でコンプライアンス要件を満たします

  • 柔軟な設定: 業界ごとのコンプライアンス要件に応じてスキャン方針を調整できます

  • データ保護: DLP エンジンに対応し、機密情報の漏えいを防ぎます

7.3 運用上の利点

  • 疎結合のアーキテクチャ: ICAP スキャンロジックをアプリケーションから分離し、保守を容易にします

  • 水平スケーリング: ICAP サーバーを容易に追加でき、より多くのスキャンリクエストを処理できます

  • 一元管理: 企業は既存の ICAP 基盤を使い、すべてのアプリケーションのコンテンツスキャンを一元管理できます

  • 詳細なログ: 完全なスキャンログで、トラブルシューティングとパフォーマンスの最適化を支援します


8. 関連ドキュメント

参考リンク

最終更新

役に立ちましたか?