Menggunakan Agen Engineering Deteksi

Panduan ini ditujukan untuk engineer keamanan dan analis SOC yang ingin mengevaluasi dan memperkuat postur keamanan Google Security Operations mereka terhadap ancaman baru dan yang sudah ada, menggunakan Agen Rekayasa Deteksi yang didukung AI di Google SecOps.

Anda dapat mengakses agen menggunakan alat Model Context Protocol (MCP) yang dioperasikan oleh klien AI yang kompatibel (misalnya, Google Antigravity atau Claude Code). Dengan menggunakan Detection Engineering Agent, Anda dapat mengekstrak threat intelligence dan otomatis membuat draf aturan YARA-L, yang meningkatkan time-to-value untuk otomatisasi keamanan kustom dan mempercepat mitigasi risiko.

Terminologi utama

  • Agen Rekayasa Deteksi: Asisten rekayasa yang didukung AI yang disematkan di Google SecOps, dioperasikan oleh klien AI (misalnya, Antigravity atau Claude Code) menggunakan alat MCP.
  • Model Context Protocol (MCP): Standar open source untuk menghubungkan aplikasi AI ke sistem eksternal, yang digunakan di seluruh layanan Google Cloud untuk menghubungkan agen AI dan aplikasi AI secara aman ke berbagai sumber data dan alat infrastruktur.
  • Peluang Deteksi Ancaman (TDO): Model data formal yang dirancang untuk mengidentifikasi, melacak, dan memprioritaskan aturan atau analisis deteksi baru yang potensial.
  • Peristiwa sintetis: Log Model Data Terpadu (UDM) yang dibuat untuk menyimulasikan TDO input.

Sebelum memulai

Sebelum memulai, pastikan prasyarat berikut terpenuhi:

Pemeriksaan lingkungan — klien AI

Anda harus mengoperasikan klien AI (seperti Antigravity atau Claude Code) yang mampu berinteraksi dengan alat MCP.

Peran dan izin yang diperlukan

Bagian ini mencantumkan izin Identity and Access Management (IAM) yang diperlukan dan peran bawaan yang direkomendasikan untuk pengguna manusia dan akun layanan.

Peran yang diperlukan untuk semua pengguna utama

Setiap akun utama yang memanggil Detection Engineering Agent harus memiliki peran berikut: MCP Tool User dan Chronicle API Viewer. Pastikan administrator sistem memperbarui peran ini untuk semua pengguna utama.

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi MCP.

Izin inti yang diperlukan

Izin berikut diperlukan untuk menjalankan Detection Engineering Agent:

  • chronicle.ade.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.operations.get

Izin pengelolaan aturan dan parser yang diperlukan

Izin berikut diperlukan untuk mengelola aturan dan parser:

  • 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

Izin penggunaan layanan project dan server MCP jarak jauh yang diperlukan

Izin berikut diperlukan untuk memanggil server MCP jarak jauh dan menggunakan layanan project untuk alat MCP:

  • mcp.tools.call (diberikan oleh peran roles/mcp.toolUser)
  • serviceusage.services.use (diberikan oleh peran roles/serviceusage.serviceUsageConsumer)

Peran yang telah ditetapkan berikut memberikan izin yang diperlukan untuk pengguna manusia dan akun layanan:

  • roles/chronicle.admin (atau roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/serviceusage.serviceUsageConsumer

Menyiapkan server MCP

Untuk membuat file settings.json, lihat Mengonfigurasi MCP. Setelah Anda mengumpulkan nilai yang diperlukan, pastikan konten file settings.json Anda terlihat seperti berikut:

{
  "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"
      }
    }
  }
}

Menyiapkan file konteks

Untuk memulai, siapkan file konteks guna memastikan bahwa Gemini menargetkan instance Google SecOps yang benar untuk setiap permintaan.

Agar semuanya tetap ringan, Google merekomendasikan untuk memulai dengan konten berikut dalam file GEMINI.md Anda, lalu membangunnya dari sana. Ganti nilai placeholder dengan informasi yang benar untuk instance dan lingkungan Google SecOps Anda:

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

Menyiapkan skill untuk berinteraksi dengan alat

Google sangat merekomendasikan penggunaan skill detection-engineering-coverage-evaluation untuk berinteraksi dengan alat. Keterampilan ini mencegah AI meringkas atau menyingkat output alat yang penting.

Kemampuan ini sudah ada sebagai detection-engineering-coverage-evaluation dan dihosting secara publik di repositori GitHub Google Agent Skills.

Kemampuan utama

Bagian ini menjelaskan kemampuan utama untuk analisis ancaman dan pembuatan aturan yang disediakan oleh Detection Engineering Agent.

Membuat Peluang Deteksi Ancaman

Alat generate_threat_detection_opportunity mengekstrak dan memperkaya threat intelligence mentah dari berbagai sumber (misalnya, blog keamanan dan temuan internal) untuk membuat TDO yang diprioritaskan untuk dianalisis. TDO yang dihasilkan dalam langkah ini akan menginformasikan langkah-langkah agen rekayasa deteksi berikutnya untuk mengevaluasi cakupan aturan yang ada atau membuat aturan baru.

  • Untuk menggunakan alat generate_threat_detection_opportunity, perintahkan Gemini untuk menggunakan curl guna mengekstrak teks, atau salin dan tempel teks mentah dari laporan ancaman ke dalam alat.

Membuat peristiwa sintetis

Untuk membuat peristiwa sintetis untuk TDO, instance Google SecOps Anda harus telah menyerap log mentah dan parser aktif untuk setidaknya salah satu jenis log yang didukung di TDO tersebut.

Jenis log yang didukung

Pembuatan peristiwa sintetis mendukung delapan jenis log berikut:

Kategori Vendor atau produk Jenis log
Deteksi dan respons endpoint (EDR) CrowdStrike Falcon CS_EDR
Deteksi dan respons endpoint (EDR) Microsoft Defender for Endpoint MICROSOFT_DEFENDER_ENDPOINT
Deteksi dan respons endpoint (EDR) SentinelOne EDR SENTINEL_EDR
Antivirus dan endpoint Windows Defender ATP WINDOWS_DEFENDER_ATP
DNS DNS Zscaler ZSCALER_DNS
Google Cloud Aktivitas Google Workspace WORKSPACE_ACTIVITY
Pengelolaan akses dan identitas Okta OKTA
Aplikasi SaaS Microsoft 365 (Office 365) OFFICE_365

Mengevaluasi cakupan

Detection Engineering Agent memeriksa apakah aturan yang ada di instance Google SecOps Anda dipicu pada peristiwa simulasi yang diserap melalui simulasi peristiwa. Jika ada aturan yang cocok dengan peristiwa yang disimulasikan, alat ini akan menampilkan ID aturan yang cocok dan metadata hasil cakupan. Jika tidak ada aturan yang cocok, hasil kosong akan ditampilkan, yang menandakan adanya kesenjangan cakupan.

Membuat draf aturan

Agen Rekayasa Deteksi mengodifikasi logika deteksi dengan membuat draf aturan YARA-L dari input pengguna atau bahasa alami untuk mengatasi kesenjangan yang diidentifikasi selama evaluasi cakupan. Saat Anda menggunakan detection-engineering-coverage-evaluation skill, agen hanya akan membuat aturan draf untuk TDO yang tidak cocok dengan aturan yang ada, dan hanya setelah evaluasi cakupan selesai untuk semua TDO. Tindakan ini mencegah aturan duplikat untuk ancaman yang sudah dicakup oleh aturan yang ada.

Alat generate_rules tidak otomatis menambahkan draf aturan ke instance Google SecOps Anda. Setelah meninjau draf aturan, Anda dapat menambahkannya dengan salah satu cara berikut:

  • Gunakan klien AI Anda: Skill detection-engineering-coverage-evaluation akan meminta Anda menyetujui atau menolak setiap aturan draf. Untuk setiap aturan yang Anda setujui, klien AI akan memanggil alat create_rule di server MCP Google SecOps untuk membuat aturan di instance Anda.
  • Membuat aturan secara manual: Salin teks aturan dari output alat dan buat aturan di Editor Aturan.

Pemecahan masalah

Gunakan tabel berikut untuk memperbaiki sendiri masalah umum selama proses evaluasi:

Masalah Deskripsi Perbaiki
Kegagalan alat Alat generate_synthetic_events berulang kali gagal. Pastikan TDO menyertakan setidaknya salah satu jenis log yang didukung dan instance Google SecOps Anda telah menyerap log mentah dan parser aktif untuk jenis log tersebut. Jika tidak, lewati pembuatan peristiwa sintetis untuk TDO tersebut dan lanjutkan dengan TDO yang tersisa.
Error pembuatan ringkasan AI menyingkat jenis log atau mengambil jalan pintas selama eksekusi. Pastikan keahlian detection-engineering-coverage-evaluation digunakan secara aktif untuk berinteraksi dengan sistem.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.