アプリケーションのAIセキュリティトラブルシューティング

概観

このプレイブックは、CMAにおけるアプリケーション向けAIセキュリティに関する全範囲の問題を網羅しています。これには、ガードがエージェント/LLMトラフィックを検査または処理しない、AIゲートウェイの統合がイベントを転送しない、管理されたエージェント統合が接続または同期に失敗する、ガードポリシールールが期待どおりに発動しない問題が含まれます。

影響を受けるコンポーネントには、AIセキュリティガード（プロキシ、API、AIゲートウェイモード）、ガードポリシールールおよびそのエンジンプライフィル、AIゲートウェイの統合、管理されたエージェント統合、および基盤となるアプリケーション向けAIセキュリティライセンスが含まれます。これらのいずれかが失敗すると、顧客はエージェント/LLMトラフィックおよび管理されたエージェント活動への可視性を失い、ポリシーの施行ができず、ガバナンスおよびコンプライアンスの目標が達成されません。

症状

接続済みアプリケーションがトラフィックを積極的に送信しているのに、CMAのGuardは呼び出しがゼロと表示されます
設定済みのガードポリシールールが一致しない、または類似の要求で不一致が発生する
ブロックまたは匿名化＆ブロックルールがマッチするが、要求はモニタされるだけで、目立った操作は適用されない
AIゲートウェイ統合（Portkey、LiteLLM、またはKong）が設定済みですが、ゲートウェイを通過したトラフィックがCMAに検査されたとして表示されることはない
マネージドエージェント統合が切断されたと表示され、接続テストに失敗するか、セットアップスクリプト/CloudFormationスタックのインストール中に失敗します
マネージドエージェント統合がアクティブと表示されるが、CMAにエージェント設定またはエージェントセッションは表示されない

原因の可能性

AIアプリケーションのライセンスの期限が切れているか、有効になっていません
グローバルガードポリシー有効化のトグルスイッチがCMAでオフにされている
ガードが作成されていますが、実際にはトラフィックを受信していません。アプリケーションまたはゲートウェイがGuardのエンドポイント（プロキシ/APIモード）を指していないか、AIゲートウェイガードレールがゲートウェイ設定に含まれていません。
ガードのインタラクションポリシールールが無効、発行されていない、または間違ったエンジンプラットフォーム、方向（ユーザー、アシスタント、ツール入力、ツール出力）、またはアクションにスコープされている
管理エージェントの可視性に必要なプラットフォーム固有の設定が有効化されていない
予想されるデータの更新遅延がまだ経過していません。
該当するLLMプロバイダー、エージェントプラットフォーム、またはゲートウェイタイプが、該当するガードまたは管理エージェント統合でサポートされていない

初期評価

より深いトラブルシューティングを行う前に、これらのチェックを完了してください。ほとんどの問題はこれらの前提条件の1つに起因します。

AIセキュリティライセンスの確認

AIセキュリティエンドユーザーライセンス（これはエージェントのAIセキュリティをカバーしています）が有効であり、期限切れでないことを確認します。 CMA > アカウント > ライセンス > プレミアムセキュリティ へ移動し、ライセンスが存在し、アクティブで有効期間内にあることを確認してください。
{height="" width=""}
ライセンスが存在しない、無効、または期限切れの場合、ガード作成、ガードインタラクションポリシーの施行、AIゲートウェイ統合、および管理エージェント統合を含む、アプリのAIセキュリティ機能は、設定に関係なく機能しません。本書の手順を続行する前に、ライセンスに関する問題を解決してください。

安全ポリシーが有効であることを検証してください

CMA > AIセキュリティ > 安全ポリシー に移動し、トグルが安全ポリシー有効であることを確認してください。これは見落としやすい簡単な手順であり、停止中はルールが機能しません。

ガードのデプロイメントとトラフィックのルーティングを検証

ガードは実際に受信したトラフィックのみを検査します。ポリシーまたは検出の問題を推測する前に、ガードが正しくトラフィックのパスにあることを確認してください。

AI セキュリティ > ガード に移動し、影響を受けたガードが存在し、正しい タイプ (プロキシ、API、またはAIゲートウェイ) で配置されていることを確認してください。
独自のエージェントからユーザープロンプトを生成します。 CMAに表示される呼び出し回数は、各プロンプトで増加するはずです。呼び出しが増えない場合は、アプリケーションが誤って設定されている可能性を示しています。
影響を受けたガードを開き、デプロイメントタブに移動します。ガードのタイプに応じて、このタブからの特定の値をアプリケーションの設定に含める必要があります。
- すべてのガードタイプについて、アプリケーションで設定されたAPIキーがCMAに表示される非無効な有効なキーと一致することを確認してください。必要であればCMAでAPIキーを再生成することができます。これは前のキーを無効にするので、再生成後すぐにアプリケーションを更新してください。
- プロキシとAPIガード については、アプリケーションがガードのエンドポイントURLを指していることを確認し、アプリケーションの設定ファイル（例：config.py）を編集して GUARD_API_KEY、BASE_URL、MODEL_IDを追加し、ガードがプロキシタイプで、CMAにLLMキーが提供されていない場合には LLM_PROVIDER_API_KEYも追加してください。
- すべての必要な リクエストヘッダー、特にアスタリスク (*) 記号でマークされたものを、アプリケーションのクライアントコード（例：client.py）に含めることを確認してください。ガードのデプロイメントに関する詳細な情報はチャットボットへのガード実装の例{target=_blank}を参照してください。
- AIゲートウェイガードの場合、対応するゲートウェイの統合（Portkey、LiteLLM、またはKong）がトラフィックをCato経由でルーティングするように設定されていることを確認してください。 Cato発行のAPIキーとガードレールは、ゲートウェイ自身の設定に追加する必要があります（例：LiteLLM用のconfig.yaml）。

管理されたエージェント統合接続を検証

管理されたエージェント統合は、サードパーティのエージェントプラットフォームとの読み取り専用の接続であり、ガードとは異なるモデルを使用します。トラフィックの検査は行われず、インベントリとセッションポーリングのみが行われます。

AI セキュリティ > 統合 > エージェント管理プラットフォーム に移動し、関連する統合（Amazon Bedrock、Amazon Quick、Microsoft Foundry、Copilot Studio、または Gemini Enterprise Agent Platform）が アクティブ ステータスを示しており、統合が完全に構成されていることを確認します。
Amazon Bedrock または Amazon Quick の場合、CloudFormation スタックが正しい AWS アカウント（またはマルチアカウントデプロイメントの場合、AWS Organizations 管理アカウント）で正常にインストールが完了し、すべての文書化された AWS 前提条件が満たされていることを確認します。
Microsoft Foundry または Copilot Studio については、すべての設定ステップが正しいロール保有者によって完了され、文書化された前提条件が満たされていることを確認してください。
- Entra ID 管理者（アプリケーション管理者、クラウドアプリケーション管理者、またはグローバル管理者）は、Cato Networks AI セキュリティ統合アプリケーションに対してテナント全体の同意を Cato Networks 管理者同意リンクを介して付与しました。
- Foundry の場合、サブスクリプション所有者またはユーザーアクセス管理者が Foundry リソースを含むすべてのサブスクリプションで Cato アプリケーションに Cognitive Services ユーザーロールを割り当てました。
- Copilot Studio の場合、Power Platform 管理者（またはグローバル管理者）が Azure Cloud Shell で PowerShell 登録スクリプトを使用して Cato アプリケーションを管理アプリケーションとして登録し、すべての関連する非開発者環境に対してエージェントセッションを有効にしました。
- Cato 管理者が CMA に正しい Microsoft Entra ID テナント ID を入力し、保存する前に 接続テスト を正常にクリックしました。テナント ID の不一致は、接続テストの失敗の一般的な原因です。
Gemini Enterprise Agent Platform については、Google Cloud 設定スクリプトが正しい Google Cloud プロジェクトで実行され（必要に応じて gcloud config set project PROJECT_ID を実行）、スクリプトを実行するアイデンティティが API の有効化と IAM/ワークロードアイデンティティフェデレーションリソースの作成の許可を持ち、スクリプトが実行される前にオンボーディングトークンが期限切れになっていないことを確認します。スクリプトが正常に実行された直後に接続を確認できない場合、再試行する前に Google Cloud IAM の変更が伝播するのを数分待ってください。
統合が破損していると結論付ける前に、予想されるデータ更新のタイミングを確認してください。
- Foundry と Copilot Studio は接続時にデータを即座に取得し、以降は毎時取得します
- Bedrock AgentCore の活動は AWS が CloudWatch トレースを提供することに依存し、最初のエージェントの呼び出し後に時間がかかる場合があります。

この問題のトラブルシューティング

管理者やユーザーが遭遇する可能性のある症状をトラブルシューティングする手順は以下の通りです。これらの手順は直面する問題の可能性を特定することを目的としています。

呼び出しのないガードを表示している場合のトラブルシューティング

Guard ページ（AI セキュリティ > Guard）が CMA にゼロの呼び出しを表示する場合に適用されます。

アプリケーションセキュリティのAIライセンスが有効であること、およびユーザーのプロンプトが該当するアプリケーションから生成されていることを確認してください。
プロキシガードについては、CatoによってサポートされるAIプロバイダであることをAIセキュリティガードとの連携で確認してください。
ホーム > イベント に移動し、イベントタイプ = アプリケーションセキュリティ でフィルタリングし、ガード関連のイベントが生成されているかどうかを確認してください。どのイベントも生成されていない場合は、ガードがアプリケーションの設定に配備されていることをガード配備とトラフィックルーティングの検証を参考に確認してください。
CLIで curl -v https://api.aisec.catonetworks.com を実行して、AIセキュリティ API の接続状態を確認してください。出力にFQDNの解決、成功したTLSハンドシェイク、およびHTTPレスポンス（通常はHTTP 404）が表示されるべきです。
特定のガードが到達可能で応答することを確認するため、AI Security > Guards > Deployment のリクエスト例（有効なガードキーを含める）を使用してcurlコマンドを実行してください。成功した応答には、マッチングしたガードポリシーのルールと適用されるアクションが含まれている必要があります。
アプリケーションにガードが正しく設定され、curlでガードに到達可能で、CMAイベントが生成されない場合、ガードのタイプ/設定（プロキシ、API、AIゲートウェイ）、アプリケーションの詳細および設定ファイル（APIキーを編集）を添えてCatoサポートにエスカレーションしてください

ガードポリシーが有効にならない問題のトラブルシューティング

これは、「ガード」ページに呼び出しが表示されるが、ガードポリシールールが設定されたアクションを実行しない場合に適用されます。

AI Security > ガードポリシー に移動し、ガードポリシーを有効化 がチェックされ、該当のルールが公開されているかを確認してください。
ルールに添付されたエンジンプロファイルが、該当するコンテンツを検出するために期待されている検出器を実際に含んでいることを確認してください。エンジンプログラウンドを使用して、プロンプトの内容がエンジンプロファイルの中で検出器をトリガーすることを検証し、さらなるトラブルシューティングを行ってください。
ルールの方向が、実際にコンテンツが現れる場所に一致することを確認してください。ツール出力を目指した検出器は、ユーザ方向のプロンプトを評価しません。逆も同様です。
ルールに設定されているアクションが、期待されるアクションであることを確認してください。ルールが 匿名化とブロック または 匿名化とモニタ に設定されている場合、プロンプト内で検出されたコンテンツのタイプに基づいてアクションを適用します（予期しないポリシーによるアクション適用を参照してください）
複数のルールが同じイベントに適用される可能性がある場合、イベントの詳細を確認して実際にどのルールがトリガーされたかを確認してください。ルールは独立して評価され、順序に依存しません。複数のルールが一致する場合、より厳しいアクションが適用されます。予想より厳しくないアクションが行われたイベントは、通常、厳しいルールの範囲、エンジンプロファイル、または方向がそのイベントに実際に一致しなかったことを意味します。
ルールが有効で、正しくスコープされ、コンテンツが一致するはずなのに、期待するアクションが適用されない場合は、イベントID、ルールのスクリーンショット（エンジンプロファイル、方向、アクション）、およびトラフィックが受信されたガードまたは統合方法とともにCatoサポートにエスカレートしてください。

エージェントの設定やセッションの欠落に関するトラブルシューティング

これは、CMAで予想される管理エージェントの設定またはエージェントセッションが欠落しているか不完全な場合に適用されます。

統合自体がアクティブとして表示されていることを確認し、それから内部の欠落しているデータをトラブルシューティングする前に、管理エージェント統合接続の検証を確認してください。
プラットフォームの通常の更新頻度を許可します：Microsoft Foundry と Copilot Studio には少なくとも毎時のサイクル、そしてAWSによってBedrock AgentCoreのCloudWatch トレースが生成されて配信されるのに必要な時間まで対応
CMAで影響を受けた管理アプリケーションに対するエージェントセッションの可視性がサポートされていることを確認します。詳しくは管理エージェントとの連携{target=_blank}を参照してください。
Amazon Bedrock AgentCoreの場合、CloudWatchトランザクション検索が有効であることを確認します（AWSコンソール > アプリケーションシグナル（APM）> トランザクション検索、スパンの取り込みが構造化ログとして行われます）。これなしでは、CatoはインベントリでAgentCoreエージェントを表示できますが、その活動は表示できません。
Copilot Studioの場合、エージェントセッションが欠落した特定の環境に対して有効になっていることを確認し、環境がこの設定をサポートしない開発者環境でないことを確認します（Power Platform管理センター > 管理 > 環境 > [環境] > 設定 > 製品 > 機能 > Copilot Studioエージェント）。
Microsoft Foundryの場合、欠落しているFoundryリソースを含む特定のサブスクリプションにCatoアプリケーションに割り当てられたCognitive Servicesユーザーロールがあることを確認します。ロールの割り当てはテナント全体に適用されず、サブスクリプションごとに繰り返す必要があります。
Gemini Enterprise Agent Platformの場合、期待に応じて確認します：エージェントセッションとセッションイベントのみが表示されます。セッション内のツール、統合、外部サービスの使用は設計上収集されません。
関連する更新間隔が経過し、プラットフォーム特有のトレース／ロール／セッション設定がすべて正しく確認された場合は、統合タイプ、特定のサブスクリプション／環境／プロジェクトの影響を受け、期待されるデータと実際に観測されたデータをCatoサポートにエスカレートします。

Catoサポートへのケースを提出

Catoサポートへの案件をあげる前に、このプレイブックで概説されている関連するすべてのトラブルシューティング手順が完了していることを確認してください。問題が解決されない場合は、次の情報を使用してCatoサポートにエスカレートしてください：

問題の説明 — 観察された症状と期待される動作の明確で簡潔な説明
影響を受けるコンポーネント — ガードの名前とタイプ（プロキシ、API、またはAIゲートウェイ）、AIゲートウェイの統合（Portkey、LiteLLM、またはKong）、または管理エージェントの統合（Amazon Bedrock、Amazon Quick、Microsoft Foundry、Copilot Studio、またはGemini Enterprise Agent Platform）
環境の詳細 — ガード用: アプリケーションの詳細と設定ファイル (APIキーを削除)。管理対象エージェントの統合について: 文書化された前提条件が満たされていることを確認し、観測された設定エラーを提供します。
接続/ポリシーの詳細 — ガードポリシーのルール名、エンジンプロファイル、方向、およびアクション。または、最後に完了した特定の統合設定ステップとその結果
完了したトラブルシューティングステップ — このプレイブックから既に行われた手順と各手順の結果の概要
サポート証拠 — AIセキュリティイベントへのリンク、ルールまたは統合設定のスクリーンショット、CloudFormationスタックステータスまたは接続テストエラーメッセージ、正確なタイムスタンプ (UTC および顧客タイムゾーン)

事前に提供された文脈と証拠が多ければ多いほど、Catoサポートは迅速に問題を調査し、解決することができます。