検出エンジニアリング エージェントを使用する

このガイドは、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.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.operations.get

必要なルール管理とパーサーの権限

ルールとパーサーを管理するには、次の権限が必要です。

  • chronicle.rules.list
  • chronicle.rules.get
  • chronicle.rules.verify
  • chronicle.rules.create
  • chronicle.rules.update
  • chronicle.ruleDeployments.get
  • chronicle.ruleDeployments.update
  • chronicle.parsers.list
  • chronicle.parsers.get
  • chronicle.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.toolUser
  • roles/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 のプロフェッショナルから回答を得ることができます。