Fungsi transformasi kustom dan operator logika

Didukung di:

Google secops SOAR

Catatan: Fitur ini tercakup dalam Persyaratan Penawaran Pra-GA dari Persyaratan Khusus Layanan Google Security Operations. Fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat panduan Layanan Dukungan Teknis Google SecOps dan Persyaratan Khusus Layanan Google SecOps.

Anda dapat membuat fungsi transformasi berbasis Python kustom dan operator logis langsung dalam IDE dan menggunakannya di playbook untuk kasus penggunaan yang kompleks dan serbaguna.

Paket Ekstensi

Paket ekstensi adalah jenis integrasi khusus yang dirancang untuk bertindak sebagai penampung fungsi transformasi kustom dan operator logis. Tidak seperti integrasi standar, paket ekstensi tidak memerlukan konfigurasi instance dan dapat dibuat langsung dari IDE.

Praktik terbaik untuk paket ekstensi

• Konsolidasi: Buat satu paket ekstensi utama dan tambahkan beberapa fungsi transformasi atau operator logis ke dalamnya.
• Pemisahan: Buat paket ekstensi baru saat Anda memerlukan kumpulan library Python (dependensi) yang berbeda yang mungkin berkonflik dengan paket utama.

Penting: Membuat paket ekstensi di IDE memerlukan izin Semua lingkungan.

Membuat Paket Ekstensi

Untuk membuat paket ekstensi baru, ikuti langkah-langkah berikut:

1. Buka Response > IDE.
2. Klik tambahkan Buat Item Baru.
3. Pilih Extension Pack dari drop-down.
4. Berikan Nama unik untuk Paket Ekstensi.
Catatan: Nama tidak dapat diubah setelah dibuat.
5. Klik Simpan.

Mengupload dependensi

Seperti integrasi standar, paket ekstensi berjalan di lingkungan virtual tempat Anda dapat mengelola library Python.

Untuk mengelola perpustakaan Anda, ikuti langkah-langkah berikut:

1. Buka setelan Paket Ekstensi di IDE.
2. Tambahkan library Python yang diperlukan dari PyPi atau upload dari komputer Anda.

Dependensi ini tersedia untuk semua transformer dan operator logis yang ada dalam paket ekstensi tertentu ini.

Impor dan Ekspor

Anda dapat mengimpor dan mengekspor paket ekstensi secara manual langsung dalam antarmuka IDE.

Catatan: Impor dan ekspor mungkin tidak tersedia untuk pelanggan yang belum menyelesaikan migrasi tahap 2. Untuk mengetahui informasi selengkapnya, lihat ringkasan migrasi SOAR.

Transformer Kustom

Transformer Kustom adalah fungsi Python yang ditentukan pengguna yang memperluas fungsi bawaan di Pembuat Ekspresi. Anda dapat membuatnya langsung dalam IDE untuk mengekstrak dan memanipulasi data, dan dapat digunakan bersama fungsi bawaan yang ada.

Membuat transformer kustom

Untuk menentukan transformer kustom baru, ikuti langkah-langkah berikut:

1. Di IDE, cari paket ekstensi target Anda.
2. Pilih paket ekstensi target untuk menambahkan item baru di bawah paket.
3. Pilih Custom Transformation Function.
4. Beri nama.
Catatan: Nama tidak dapat diubah setelah dibuat.
5. Opsional: Tambahkan deskripsi. Ini ditampilkan saat Anda mengarahkan kursor ke transformator kustom di Pembuat Ekspresi.
6. Tentukan logika skrip menggunakan Python. Anda dapat menggunakan template default yang disediakan sebagai titik awal.
   • Skrip harus menyertakan fungsi main seperti yang ditunjukkan dalam template standar.
   • Skrip harus menampilkan hasil ke builder ekspresi dengan menggunakan fungsi end SDK.
   • Input transformer kustom dapat berupa berbagai jenis (misalnya, string atau daftar). Pastikan Anda mengonversinya ke jenis yang diharapkan dalam fungsi main.
   • Anda hanya dapat menggunakan sebagian kecil metode SDK dalam IDE untuk transformer:
     • transformer.extract_param("ParamName"): Untuk mengambil nilai input.
     • transformer.LOGGER: Untuk menulis log untuk proses debug.
     • transformer.end(result): Untuk menampilkan nilai yang ditransformasi.
7. Buat parameter:
   • Setiap fungsi transformer kustom menyertakan parameter Input default. Parameter ini mewakili data input, yang merupakan placeholder yang diterapkan fungsi. Anda tidak dapat menghapus parameter ini.
   • Selain itu, Anda dapat menambahkan parameter opsional untuk digunakan dalam fungsi Anda.
8. Dokumentasi (Opsional): Tentukan dokumentasi dalam produk untuk Pembuat Ekspresi:
   • Input yang Diharapkan: Jelaskan jenis data yang diharapkan diterima oleh fungsi untuk transformer ini (misalnya, "String" atau "List string").
   • Output yang Diharapkan: Jelaskan jenis data yang diharapkan fungsi untuk ditampilkan untuk transformer ini (misalnya, "boolean").
   • Contoh Penggunaan: Berikan contoh cara memanggil fungsi (misalnya, if_empty("new_value")).

Anda dapat menguji logika fungsi transformasi kustom secara langsung dalam IDE sebelum menggunakannya dalam playbook. Dengan begitu, Anda dapat memverifikasi bahwa skrip Python Anda menangani berbagai jenis dan parameter input dengan benar serta menampilkan hasil yang diharapkan.

Waktu habis

• Waktu Tunggu Default: 1 menit.
• Waktu Tunggu Maksimum: 3 menit.

Catatan: Karena platform menunggu hingga fungsi selesai, Anda harus meminimalkan waktu eksekusi. Berfokus pada transformasi data langsung dan hindari pemrosesan berat atau membuat kueri sumber eksternal.

Menggunakan transformer kustom di Pembuat Ekspresi

Setelah disimpan, transformer kustom akan muncul dalam daftar fungsi Expression Builder bersama dengan fungsi bawaan. Hal tersebut diidentifikasi dengan format: ExtensionPackName.TransformerName. Mengarahkan kursor ke fungsi akan menampilkan dokumentasi yang dihasilkan dari deskripsi parameter Anda.

Dukungan untuk semua placeholder (JSON dan non-JSON)

Pembuat Ekspresi mendukung setiap placeholder yang ditampilkan di Desainer Playbook, termasuk hasil non-JSON.

Untuk placeholder non-JSON:

• Anda dapat memasukkan data sampel secara manual ke dalam Pembuat Ekspresi untuk menguji logika terhadap berbagai jenis input: string, daftar (nilai yang dipisahkan koma), dan JSON.
• Pengujian dengan jenis input tidak menjamin bahwa placeholder akan menampilkan jenis tertentu tersebut saat runtime.
• Sebagian besar placeholder diselesaikan sebagai string, kecuali untuk jenis tertentu yang diselesaikan sebagai string atau daftar berdasarkan jumlahnya (misalnya, entity.identifier). Untuk jenis ini, sebaiknya selalu perlakukan input sebagai daftar.

Catatan: Data sampel bersifat sementara dan tidak akan disimpan setelah Anda menutup Pembuat Ekspresi atau menyimpan ekspresi. Anda harus memasukkan kembali data contoh jika membuka kembali builder.

Penanganan Error

Jika fungsi transformasi kustom mengalami error selama eksekusi, tindakan playbook yang menggunakan transformer tersebut akan gagal. Pesan error spesifik yang dihasilkan oleh skrip Python ditampilkan di layar dalam tampilan playbook run, sehingga Anda dapat memecahkan masalah logika secara langsung.

Operator Logis Kustom

Operator Logika Kustom memungkinkan Anda menentukan logika boolean sendiri untuk membandingkan nilai.

Membuat operator logika kustom

Untuk menentukan operator logika baru, ikuti langkah-langkah berikut:

1. Di IDE, temukan Extension Pack target Anda.
2. Pilih Operator Logika Kustom.
3. Beri nama.
Catatan: Nama tidak dapat diubah setelah dibuat.
4. Opsional: Tambahkan deskripsi untuk menu operator logika di Playbook Designer.
5. Tentukan logika skrip menggunakan Python. Anda dapat menggunakan template standar yang disediakan sebagai titik awal.
   • Skrip harus menyertakan fungsi main.
   • Skrip harus menampilkan hasil boolean ke kondisi dengan menggunakan fungsi end SDK.
   • Anda hanya dapat menggunakan subset metode SDK dalam IDE untuk operator logika:
   • logical_operator.extract_param("ParamName"): Untuk mengambil nilai input.
   • logical_operator.LOGGER: Untuk menulis log untuk proses debug.
   • logical_operator.end(result): Hasilnya adalah nilai boolean (true atau false).

Anda dapat menguji logika operator logika kustom secara langsung dalam IDE. Hal ini memungkinkan Anda memasukkan nilai pengujian untuk argumen dan memverifikasi bahwa fungsi menampilkan hasil boolean (Benar atau Salah) yang benar berdasarkan kondisi yang Anda tentukan.

Parameter

Operator logika kustom menerima dua parameter: Sisi Kiri (wajib dan tidak dapat diedit) dan Sisi Kanan (opsional; dapat dinonaktifkan oleh pengguna).

• Contoh 1: if [left side] not in [right side].
• Contoh 2: if [left side] is greater than 80 (tanpa sisi kanan).

Waktu habis

• Waktu Tunggu Default: 1 menit.
• Waktu Tunggu Maksimum: 3 menit.

Catatan: Karena platform menunggu hingga fungsi selesai, Anda harus meminimalkan waktu eksekusi. Praktik terbaiknya adalah berfokus pada transformasi data langsung dan menghindari membuat kueri sumber eksternal atau melakukan pemrosesan berat.

Menggunakan di playbook

Operator logika kustom muncul di menu operator dalam Kondisi Playbook, Kondisi Tindakan Sebelumnya, dan Pemilihan Entitas.

Operator logika kustom dapat dipilih bersama operator standar (misalnya, "Sama dengan" atau "Berisi").

Penanganan Error

Jika fungsi operator logika kustom mengalami error selama eksekusi, kondisi atau langkah playbook yang menggunakan operator tersebut akan gagal. Pesan error yang ditampilkan oleh skrip Python ditampilkan dalam tampilan eksekusi playbook untuk membantu pemecahan masalah.

Batasan

• Fungsi transformasi kustom dan operator logika tidak didukung di Pemicu atau Webhook.

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