Menggunakan IDE

Didukung di:

Dokumen ini menjelaskan mode produksi Lingkungan Pengembangan Terintegrasi (IDE). IDE adalah framework untuk melihat, mengedit, dan menguji kode. Anda dapat melihat kode integrasi komersial dan membuat integrasi kustom dari awal atau dengan menduplikasi kode integrasi komersial.

IDE adalah tempat Anda mengelola, mengimpor, dan mengekspor integrasi kustom.

Membuka IDE

Untuk membuka IDE, ikuti langkah-langkah berikut:

  • Untuk membuka IDE, di menu utama, buka Automation > IDE. Halaman IDE akan terbuka.

Di halaman IDE, Anda dapat mengakses opsi berikut:

Opsi Deskripsi
Jenis Integrasi
Pilih antara Integrations atau Types (konektor, tindakan, tugas, pengelola).
Ekspor
Impor
Mengekspor satu atau beberapa item dari integrasi. Item dependen disertakan saat mengekspor item satu per satu, tetapi tidak saat mengekspor paket lengkap.
File yang diekspor adalah file ZIP yang berisi file JSON. Saat mengimpor, Anda dapat menambahkan item satu per satu ke integrasi yang ada atau mengimpor paket lengkap. Untuk format ekspor/impor lama (V1 - dataplane dinonaktifkan), paket harus menyertakan file integrations.def dan folder: ActionsDefinitions, ActionsScripts, Dependencies, dan Managers. Untuk format ekspor/impor baru (V2 - dataplane diaktifkan), folder paket harus menyertakan file metadata.json dan dapat menyertakan folder: actions, connectors, jobs, dan dependencies.
Perhatikan bahwa mengekspor integrasi dari lingkungan dengan dataplane diaktifkan dan mengimpornya ke lingkungan tempat dataplane tidak diaktifkan tidak didukung. Sebaliknya (mengekspor dari lingkungan tempat dataplane tidak diaktifkan ke lingkungan tempat dataplane diaktifkan) didukung.
Klik tombol Hide Inactive/Show All ke Show atau Hide item yang dinonaktifkan (tindakan, konektor).
Tambahkan integrasi, konektor, tindakan, tugas, atau pengelola kustom baru.

Menambahkan konektor

Untuk menambahkan konektor, ikuti langkah-langkah berikut:

  1. Klik Create New Item dan pilih Connector.
  2. Masukkan nama dan integrasi yang diperlukan.
  3. Klik Create.
  4. Tambahkan detail integrasi.
  5. Tambahkan parameter yang diperlukan.
  6. Klik tombol Connector untuk mengaktifkan konektor.
  7. Klik Simpan setelah selesai, atau tekan Ctrl + S.

Opsi berikut tersedia di tab Detail:

Opsi Deskripsi
Hapus Hanya tersedia untuk item dalam integrasi kustom.
Play Menjalankan metode pengujian skrip. Hasil akan muncul di tab Testing, dan output debug akan muncul di bagian Debug Output.
file_json Kelola sampel JSON Dalam dialog impor/ekspor contoh JSON, pastikan Include JSON Result diaktifkan. Kemudian, Anda dapat mengimpor atau mengekspor sampel hasil JSON untuk tindakan.
DetailMasukkan input yang diberikan pengguna dan parameter lainnya, seperti nama integrasi.
Kontrol Versi Kontrol Versi - Pilih tindakan/tugas/konektor dan klik untuk melihat opsi berikut: Simpan sebagai Versi Baru: Simpan objek sebagai versi baru dengan komentar opsional. Melihat Histori Versi: Melihat dan memulihkan versi sebelumnya. Hanya tersedia jika setidaknya satu versi telah disimpan. Klik Pulihkan untuk kembali ke versi sebelumnya kapan saja. Opsi ini hanya tersedia jika Anda telah mengklik Save as New Version pada tindakan/tugas/konektor/pengelola sebelumnya.
Item duplikat Menduplikasi item (tugas, tindakan, konektor, pengelola). Setelah disimpan, duplikat akan muncul dalam daftar tanpa ikon gembok Gembok.

Membuat integrasi kustom

  1. Klik Create New Item dan pilih Integration.
  2. Masukkan nama, lalu klik Buat.
  3. Pilih integrasi yang dibuat dari daftar dan berikan informasi berikut:
    • Deskripsi: muncul di Content Hub dan dapat dilihat oleh semua pengguna Google Security Operations.
    • Ikon SVG: upload ikon SVG yang muncul bersama integrasi.
    • Image: upload gambar Content Hub untuk pengguna Google SecOps.
    • Library: tambahkan library Python menggunakan pip.
    • Dependensi skrip: Upload file `.WHL`, `.PY`, `.TAR`, atau `.GZ`. Skrip ini menambahkan lebih banyak fungsi ke integrasi Anda.
    • Parameter: Tambahkan kolom yang dapat dikonfigurasi dengan jenis yang ditentukan, nilai default, dan status wajib diisi.
  4. Klik Simpan setelah selesai.

Buat tugas

Untuk membuat tugas, ikuti langkah-langkah berikut:

  1. Klik Create New Item, lalu pilih Job.
  2. Masukkan nama dan integrasi yang diperlukan.
  3. Klik Create.
  4. Opsional: Tambahkan parameter untuk input pengguna atau skrip.
  5. Klik Simpan atau tekan Ctrl + S.
  6. Klik arrow_right Play Item untuk menjalankan skrip.
  7. Buka Automation > Jobs Scheduler.
  8. Klik add Create New Job dan pilih tugas yang baru saja Anda buat.
  9. Di Response >Jobs Scheduler, pilih waktu yang diperlukan untuk menjalankan tugas (skrip) yang Anda buat.

Membuat tindakan baru untuk digunakan dalam playbook

Untuk membuat tindakan baru untuk playbook, ikuti langkah-langkah berikut:

  1. Klik Create New Item, lalu pilih Action.
  2. Masukkan nama dan integrasi yang diperlukan > klik Create.
  3. Edit kode sesuai kebutuhan.
  4. Aktifkan Sertakan Hasil JSON jika tindakan harus menampilkan hasil JSON dalam playbook.
  5. Opsional: Tambahkan parameter untuk ditampilkan sebagai kolom input.
  6. Aktifkan tindakan, lalu klik Simpan.
  7. Di Polling Configuration, Anda dapat menetapkan waktu tunggu dan nilai yang ditampilkan secara default jika waktu tunggu tindakan habis. Anda juga dapat menetapkan nilai default untuk ditampilkan jika tindakan tidak selesai dalam periode waktu tunggu yang ditentukan.

Tindakan ini kini tersedia untuk digunakan di Playbook > Actions.

Membuat pengelola kustom

Untuk membuat pengelola kustom, ikuti langkah-langkah berikut:

  1. Klik Create New Item, lalu pilih Manager. Masukkan nama dan integrasi yang diperlukan.
  2. Klik Create.
  3. Edit kode sesuai kebutuhan.
  4. Klik Simpan.

Keamanan kode kustom IDE

Untuk memastikan lingkungan eksekusi kode yang aman, semua kode Python kustom dalam IDE dijalankan di lingkungan sandbox. Lingkungan ini diisolasi dari server utama dan beroperasi dengan pengguna yang memiliki hak istimewa rendah. Akses ke sistem operasi yang mendasarinya sangat dibatasi pada daftar perintah dan direktori non-administratif yang diizinkan, yang diperlukan untuk tugas integrasi dan otomatisasi umum. Pendekatan sandbox ini memungkinkan keamanan yang kuat sekaligus memberikan fleksibilitas untuk mengeksekusi berbagai kode Python.

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