Microsoft Defender for Cloudの AI サービスに対する脅威保護を使用すると、エンドユーザーとアプリケーションの両方のコンテキストを提供することで、生成された AI アラートのアクション可能性とセキュリティの価値を高めることができます。
ほとんどの AI サービス シナリオはアプリケーションの一部として構築されているため、AI サービスへの API 呼び出しは Web アプリケーション、コンピューティング インスタンス、または AI ゲートウェイから発生します。 このアプリケーション主導のアーキテクチャは、調査者がAIリクエストをレビューしてビジネスアプリケーションやエンドユーザーを特定する際に文脈を欠くため、複雑さを生み出します。
Microsoft Defender for CloudとAzure AI を組み合わせることで、AI API 呼び出しAzureにパラメーターを追加して、Defender for Cloudが AI アラート内の重要なエンドユーザーまたはアプリケーション コンテキストをキャプチャできるようにします。 AIアラートでエンドユーザーとアプリケーションのコンテキストを捉えることで、より効果的なトリアージと結果が得られます。 たとえば、エンド ユーザーの IP または ID を追加するときに、そのユーザーをブロックしたり、そのユーザーによるインシデントとアラートを関連付けたりすることができます。 アプリケーション コンテキストを追加するときに、組織内のそのアプリケーションの疑わしい動作が標準であるかどうかを優先順位付けまたは判断できます。
前提条件
AI の脅威の防止に関する記事を参照してください。
Azure OpenAI サービスを介して直接、Azure OpenAI 基になるモデルを使用して、AI アプリケーションで AI サービスの脅威保護を有効にします。 この機能は、Azure AIモデル推論APIを通じて利用されたモデルを適用する場合には現在サポートされていません。
Azure OpenAI 呼び出しにセキュリティ パラメーターを追加する
より詳しい文脈を含むAIセキュリティアラートを受け取りたい場合は、以下のサンプルUserSecurityContextパラメータのいずれかまたはすべてをAzure OpenAI APIコールに追加してください。
UserSecurityContext内のフィールドはすべてオプションです。エンドユーザーのコンテキストとして、
EndUserIdとSourceIPフィールドは最低でも渡してください。EndUserIdおよびSourceIP分野は、セキュリティオペレーションセンター(SOC)アナリストに、AIリソースや生成AIアプリケーションを用いるセキュリティインシデントを調査する能力を提供します。アプリケーションの文脈として、
applicationNameフィールドを単純な文字列として渡します。
UserSecurityContextフィールドの名前を誤って綴っても、Azure OpenAIのAPI呼び出しは成功します。
注
EndUserIdは生成AIアプリケーションでエンドユーザーを認証するために使われるMicrosoft Entra IDユーザーオブジェクトIDです。 この分野では機密性の高い個人情報は含めないでください。
UserSecurityContext スキーマ
正確なスキーマはAzure OpenAI REST APIの参考ドキュメントで確認できます。
ユーザー セキュリティ コンテキスト オブジェクトは、チャット入力候補 API の要求本文の一部です。
現在、APIはAzure AIモデル推論APIを通じて展開したモデルを適用した際Defender for Cloudアラート強化のためのUserSecurityContextパラメータを追加することをサポートしていません。
対応APIおよびSDKバージョン
以下の表は、 UserSecurityContextでサポートされているAPIとSDKバージョンを示しています。
| Source | バージョンのサポート | コード例 | コメント |
|---|---|---|---|
| Azure OpenAI REST API | 2025-01-01 バージョン | - | - |
| Azure .NET SDK | v2.2.0-beta.1 (2025-02-07) 以降 | GitHub のコード例 | - |
| Azure SDK for Python | v1.61.1 以降 | GitHub のコード例 | サポートは、 extra_body オブジェクトに追加することによって提供されます。 |
| AZURE JS/Node SDK | v4.83.0 以降 | GitHub のコード例 | サポートは、 extra_body オブジェクトに追加することによって提供されます。 |
| Azure Go SDK | v0.7.2 以降 | - | - |