検出エンジニアリング エージェントを使用する
このガイドは、Google SecOps の AI 搭載の検出エンジニアリング エージェントを使用して、新規および既存の脅威に対する Google Security Operations のセキュリティ ポスチャーを評価して強化することを目的とするセキュリティ エンジニアと SOC アナリストを対象としています。
エージェントにアクセスするには、互換性のある AI クライアント(Google Antigravity や Claude Code など)が操作する Model Context Protocol(MCP)ツールを使用します。Detection Engineering Agent を使用すると、脅威インテリジェンスを抽出して YARA-L ルールを自動的に作成できます。これにより、カスタム セキュリティ自動化の価値実現までの時間を短縮し、リスク軽減を加速できます。
主な用語
- 検出エンジニアリング エージェント: Google SecOps に組み込まれた AI 搭載のエンジニアリング アシスタント。MCP ツールを使用して AI クライアント(Antigravity や Claude Code など)によって操作されます。
- Model Context Protocol(MCP): AI アプリケーションを外部システムに接続するためのオープンソース標準。 Google Cloud サービス全体で使用され、AI エージェントとアプリケーションをさまざまなデータソースやインフラストラクチャ ツールに安全に接続します。
- 脅威検出機会(TDO): 新しい検出ルールや分析を特定、追跡、優先順位付けするために設計された、正式なデータモデル。
- 合成イベント: 入力 TDO をシミュレートするために生成された統合データモデル(UDM)ログ。
始める前に
開始する前に、次の前提条件を満たしていることを確認してください。
環境チェック - AI クライアント
MCP ツールと連携できる AI クライアント(Antigravity や Claude Code など)を操作する必要があります。
必要なロールと権限
このセクションでは、人間のユーザーとサービス アカウントの両方に必要な Identity and Access Management(IAM)権限と、推奨される事前定義ロールについて説明します。
すべてのプリンシパル ユーザーに必要なロール
Detection Engineering Agent を呼び出すプリンシパルには、MCP ツールユーザーと Chronicle API 閲覧者のロールが必要です。システム管理者がすべてのプリンシパル ユーザーに対してこれらのロールを更新するようにしてください。
詳細については、MCP を構成するをご覧ください。
必要なコア権限
Detection Engineering Agent を実行するには、次の権限が必要です。
chronicle.ade.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
必要なルール管理とパーサーの権限
ルールとパーサーを管理するには、次の権限が必要です。
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.logTypes.list
必要なリモート MCP サーバーとプロジェクト サービスの使用権限
リモート MCP サーバーを呼び出し、MCP ツールにプロジェクト サービスを使用するには、次の権限が必要です。
mcp.tools.call(roles/mcp.toolUserロールによって付与)serviceusage.services.use(roles/serviceusage.serviceUsageConsumerロールによって付与)
必須および推奨の事前定義ロール
次の事前定義ロールは、人間のユーザーとサービス アカウントの両方に必要な権限を付与します。
roles/chronicle.admin(またはroles/chronicle.editor)roles/mcp.toolUserroles/serviceusage.serviceUsageConsumer
MCP サーバーを設定する
settings.json ファイルを作成するには、MCP を構成するをご覧ください。必要な値を収集したら、settings.json ファイルの内容が次のようになっていることを確認します。
{
"name": "my_extension_name",
"version": "1.0.0",
"mcpServers": {
"GoogleSecOps": {
"httpUrl": "https://us-chronicle.googleapis.com/mcp",
"authProviderType": "google_credentials",
"oauth": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/chronicle"
]
},
"timeout": 300000,
"headers": {
"x-goog-user-project": "my-cloud-project-name"
}
}
}
}
コンテキスト ファイルを設定する
まず、コンテキスト ファイルを設定して、Gemini がすべてのリクエストで正しい Google SecOps インスタンスをターゲットに設定するようにします。
すべてを軽量に保つため、GEMINI.md ファイルに次のコンテンツを追加して、そこからビルドすることをおすすめします。プレースホルダの値を、Google SecOps インスタンスと環境の正しい情報に置き換えます。
When using the Google SecOps MCP server, use these parameters for EVERY request: Customer ID: aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa Region: us Project ID: my-cloud-project-name
ツールとやり取りするためのスキルを設定する
Google では、detection-engineering-coverage-evaluation スキルを使用してツールを操作することを強くおすすめします。このスキルにより、AI が重要なツールの出力を要約または省略することを防ぎます。
このスキルは detection-engineering-coverage-evaluation として組み込まれており、Google Agent Skills GitHub リポジトリで一般公開されています。
主な機能
このセクションでは、Detection Engineering Agent が提供する脅威分析とルール生成の主な機能について説明します。
脅威検出の機会を生成する
generate_threat_detection_opportunity ツールは、ソース(セキュリティ ブログや内部調査結果など)から未加工の脅威インテリジェンスを抽出して拡充し、分析用に優先順位付けされた TDO を作成します。このステップで生成された TDO は、後続の検出エンジニアリング エージェントのステップに通知され、既存のルールのカバレッジを評価したり、新しいルールを生成したりします。
generate_threat_detection_opportunityツールを使用するには、curlを使用してテキストを抽出するように Gemini に指示するか、脅威レポートから未加工のテキストをコピーしてツールに貼り付けます。
合成イベントを生成する
TDO の合成イベントを生成するには、Google SecOps インスタンスが、その TDO でサポートされているログタイプの少なくとも 1 つについて、未加工ログとアクティブなパーサーを取り込んでいる必要があります。
サポートされているログタイプ
合成イベントの生成では、次の 8 つのログタイプがサポートされています。
| カテゴリ | ベンダーまたはプロダクト | ログタイプ |
|---|---|---|
| エンドポイントの検出と対応(EDR) | CrowdStrike Falcon | CS_EDR |
| エンドポイントの検出と対応(EDR) | Microsoft Defender for Endpoint | MICROSOFT_DEFENDER_ENDPOINT |
| エンドポイントの検出と対応(EDR) | SentinelOne EDR | SENTINEL_EDR |
| ウイルス対策とエンドポイント | Windows Defender ATP | WINDOWS_DEFENDER_ATP |
| DNS | Zscaler DNS | ZSCALER_DNS |
| Google Cloud | Google Workspace のアクティビティ | WORKSPACE_ACTIVITY |
| Identity and Access Management | Okta | OKTA |
| SaaS アプリケーション | Microsoft 365(Office 365) | OFFICE_365 |
カバレッジを評価する
Detection Engineering Agent は、Google SecOps インスタンスの既存のルールが、イベント シミュレーションで取り込まれたシミュレーション イベントでトリガーされるかどうかを確認します。シミュレートされたイベントに一致するルールがある場合、ツールは一致するルールの識別子とカバレッジ結果のメタデータを返します。一致するルールがない場合は、空の結果が返され、カバレッジ ギャップが示されます。
下書きルールを生成する
検出エンジニアリング エージェントは、ユーザー入力または自然言語から YARA-L ルールのドラフトを作成して、カバレッジ評価中に特定されたギャップに対処することで、検出ロジックをコード化します。detection-engineering-coverage-evaluation スキルを使用すると、エージェントは、既存のルールが一致しない TDO に対してのみ、すべての TDO のカバレッジ評価が完了した後にのみ、下書きルールを生成します。これにより、既存のルールですでにカバーされている脅威に対して重複するルールが作成されるのを防ぐことができます。
generate_rules ツールは、下書きルールを Google SecOps インスタンスに自動的に追加しません。下書きルールを確認したら、次のいずれかの方法で追加できます。
- AI クライアントを使用する:
detection-engineering-coverage-evaluationスキルは、各下書きルールを承認または拒否するように求めます。承認したルールごとに、AI クライアントは Google SecOps MCP サーバーのcreate_ruleツールを呼び出して、インスタンスにルールを作成します。 - ルールを手動で作成する: ツール出力からルールテキストをコピーし、ルールエディタでルールを作成します。
トラブルシューティング
評価プロセス中に発生する一般的な問題については、次の表を参照して自己修復してください。
| 問題 | 説明 | 修正 |
|---|---|---|
| ツールの不具合 | generate_synthetic_events ツールが繰り返し失敗する。 |
TDO にサポートされているログタイプが少なくとも 1 つ含まれていること、Google SecOps インスタンスが未加工ログと、そのログタイプのアクティブなパーサーを取り込んでいることを確認します。それ以外の場合は、その TDO の合成イベントの生成をスキップし、残りの TDO を続行します。 |
| 要約エラー | AI がログタイプを省略したり、実行中にショートカットを使用したりする。 | detection-engineering-coverage-evaluation スキルがシステムとのインターフェースとして積極的に使用されていることを確認します。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。