Bekerja dengan Simulator Playbook
Simulator Playbook menyediakan pendekatan yang disederhanakan untuk mengembangkan playbook dengan waktu dan upaya yang lebih sedikit.
Simulator Playbook menawarkan beberapa fitur utama, yang memungkinkan Anda:
- Bekerja di lingkungan praproduksi, sehingga Anda dapat menguji tindakan dan mengamati hasilnya tanpa memengaruhi data produksi aktif (terutama saat playbook dinonaktifkan).
- Memfasilitasi pengujian setiap langkah atau blok playbook untuk mengonfirmasi bahwa alur kerja beroperasi sesuai yang diinginkan.
- Uji semua kemungkinan cabang kondisi dalam playbook Anda, dengan mengonfirmasi cakupan yang komprehensif dan perilaku yang dapat diprediksi.
Menggunakan Simulator Playbook dengan playbook Anda
Saat Anda bekerja dengan playbook—baik menggunakan playbook yang sudah ada maupun membuat playbook baru—selalu mulai dengan mengaktifkan Simulator Playbook. Anda akan melihat indikator hijau di bagian atas yang mengonfirmasi bahwa fitur ini aktif.
Jika Anda menggunakan Simulator Playbook pada playbook yang aktif, hal ini akan memengaruhi semua pemberitahuan masuk yang memicu playbook tersebut. Hal ini karena menyimpan playbook dengan data simulasi akan menerapkan data tersebut ke kasus aktif dalam produksi, yang berpotensi memengaruhi hasil di dunia nyata.
- Arahkan kursor ke pemberitahuan kasus, klik more_vert Opsi Pemberitahuan, lalu pilih Serap pemberitahuan sebagai kasus pengujian. Tindakan ini akan membuat kasus pengujian untuk menjalankan playbook simulasi Anda. Entitas yang diubah dalam kasus pengujian tidak memengaruhi entitas dalam kasus reguler.
- Arahkan kursor ke bagian bawah halaman Playbook, lalu pilih kasus pengujian. Pastikan kasus pengujian yang dipilih cocok dengan playbook yang ingin Anda jalankan. Untuk mengonfirmasi, klik Entitas dan verifikasi bahwa playbook dapat memproses entitas yang ada dalam kasus pengujian tersebut.
- Klik Run. Simulator memproses langkah-langkah, menjalankan tindakan yang ditentukan, dan memberikan hasilnya.
Menafsirkan hasil simulator untuk setiap langkah
Setelah Anda mengklik Run, baris pertama di konsol akan ditampilkan seolah-olah itu adalah playbook aktif. Setiap langkah simulasi menyajikan opsi, biasanya mencakup Data Kasus, Lihat Hasil, dan Sematkan Hasil (atau Sisipkan Hasil). Langkah manual akan memicu tombol untuk memasukkan parameter, memberikan respons, dan menjalankan langkah.
Data Kasus
Ikon Data Kasus akan membuka dialog untuk menampilkan informasi kasus pada tahap tertentu—setelah tindakan saat ini selesai dijalankan. Dialog ini diperbarui secara dinamis dengan hasil langkah saat ini. Jika tindakan menambahkan pengayaan ke kasus, Anda akan melihatnya tercermin di sini. Karena menampilkan status kasus setelah eksekusi langkah, data bervariasi untuk setiap langkah di konsol simulasi. Memeriksa data kasus di berbagai langkah membantu Anda memahami perubahan yang diterapkan pada kasus selama eksekusi playbook. Beberapa tab dalam dialog memberikan detail tambahan.
Lihat Hasil
Opsi Lihat Hasil menampilkan hasil tindakan spesifik dari langkah saat ini. Informasi yang ditampilkan serupa dengan ringkasan kasus atau dinding kasus, dan juga mencakup detail tentang pengayaan apa pun.
Anda dapat mengakses jenis informasi berikut:
- Tab utama menampilkan pesan output, tabel, link, dan lampiran.
- Tab detail teknis memberikan hasil tindakan dan hasil JSON (jika ada).
Serupa dengan opsi lainnya, Anda dapat mengklik data untuk pemeriksaan yang lebih mendalam. Di halaman Lihat Hasil, Anda juga dapat mengklik Tetapkan hasil JSON. Dengan fitur ini, Anda dapat mengganti sampel JSON tindakan saat ini. Anda dapat mengubah contoh JSON ini langsung dari Lingkungan Pengembangan Terintegrasi (IDE), lalu membangunnya dalam Pembuat Ekspresi untuk mengekstrak data tertentu dari hasil JSON.
Sematkan Hasil
Opsi Sematkan Hasil tersedia saat langkah berhasil dijalankan. Ini adalah fitur yang sangat berguna yang memungkinkan Anda memperlakukan hasil tindakan sebagai tetap.
Menyematkan hasil dapat menghemat waktu Anda dengan:
- Tidak perlu menunggu hasil dari layanan pihak ketiga.
- Mengurangi jumlah kueri yang dibuat ke layanan ini, yang membantu menghemat kredensial.
Pada dasarnya, saat Anda menjalankan ulang playbook, setiap langkah dengan hasil yang disematkan akan "dilewati": kodenya tidak dijalankan lagi, dan hasil yang disematkan digunakan apa adanya. Anda juga dapat mengubah hasil ini dengan memasukkan data tiruan Anda sendiri. Saat Anda mengaktifkan Sematkan Hasil, tindakan akan memasuki mode simulasi, dan representasi visual langkah biasanya berubah dari latar belakang biru menjadi abu-abu, yang menunjukkan dengan jelas bahwa mode Simulasi aktif untuk langkah tersebut.
Sisipkan Hasil
Opsi Sisipkan Hasil akan tersedia jika langkah gagal. Fitur ini memungkinkan Anda memasukkan data simulasi secara manual. Saat Anda menjalankan langkah khusus ini lagi, langkah ini akan menampilkan data yang Anda berikan secara manual sebagai hasilnya.
Setelah Anda mengklik opsi ini, tindakan akan otomatis mengaktifkan mode Simulasi. Representasi visual langkah berubah dari latar belakang biru ke abu-abu, yang menunjukkan dengan jelas bahwa mode Simulasikan aktif. Kolom Hasil Skrip wajib diisi untuk semua langkah saat dalam mode Simulasi.
Menyisipkan data tiruan
Untuk menyisipkan data tiruan, ada beberapa kasus penggunaan yang perlu dipertimbangkan:
- Membuat dan menguji playbook saat bepergian: Anda dapat menjalankan langkah, melihat hasilnya, dan langsung memahami cara menggunakan data tersebut lebih lanjut dalam playbook.
- Menghemat waktu setelah berhasil dijalankan: Anda mungkin ingin menyematkan hasil langkah. Tindakan ini menghemat waktu Anda dengan mencegah langkah dijalankan berulang kali terhadap API pihak ketiga selama pengujian berikutnya.
- Menguji berbagai skenario: Anda dapat mengubah hasil langkah untuk menguji playbook dalam berbagai kondisi. Dengan menetapkan data simulasi yang berbeda, Anda dapat memengaruhi kondisi dan tindakan berikutnya yang mengandalkan hasil sebelumnya. Misalnya, jika playbook Anda memiliki kondisi yang bercabang menjadi dua jalur atau lebih, Anda dapat bereksperimen dengan data simulasi untuk "memaksa" playbook mengambil cabang tertentu.
Menyisipkan data simulasi
Anda dapat memasukkan data simulasi (tiruan) ke dalam playbook dengan dua cara utama: melalui dialog konfigurasi langkah Playbook atau dengan menggunakan Sematkan Hasil (atau Sisipkan Hasil) setelah menjalankan simulator.
Menggunakan dialog konfigurasi langkah Playbook
- Klik dialog konfigurasi langkah dalam playbook Anda.
- Aktifkan Simulate mode untuk mengaktifkannya. Representasi visual tindakan berubah menjadi abu-abu, yang menunjukkan bahwa tindakan berada dalam mode Simulasi.
- Di bagian Hasil tindakan, Anda dapat memasukkan data simulasi (tiruan). Hal ini mencakup:
- Hasil skrip: Berikan hasil tiruan untuk tindakan berbasis skrip.
- Hasil JSON: Masukkan data JSON, yang berpotensi dengan mengekstrak data tertentu dari kode JSON. Anda juga dapat memuat output contoh dengan mengklik Muat Contoh. Tindakan ini memuat hasil JSON yang diharapkan, yang sangat berguna jika:
- Simulasi belum berjalan, dan outputnya kosong.
- Simulasi gagal, dan tidak ada hasil yang ditampilkan.
- Anda ingin mengganti hasil yang ada (dari penyematan atau penyisipan sebelumnya) dengan sampel.
- Pengayaan: Anda dapat menggunakan pengayaan dari simulasi sebelumnya atau membuat kunci pengayaan kustom Anda sendiri.
Menggunakan hasil setelah menjalankan simulator
Sematkan Hasil
Jika langkah berhasil dijalankan, Anda dapat mengklik Pin Results di samping tindakan tersebut. Hal berikut terjadi setelah:
- Langkah akan otomatis terbuka dalam mode Simulasi .
- Hasil dari simulasi yang berhasil dijalankan terakhir disematkan ke langkah. Anda dapat menggunakan hasil ini atau mengeditnya.
- Anda dapat mengedit hasil JSON menggunakan editor JSON atau mengklik Muat Contoh untuk mengganti.
- Anda dapat menggunakan pengayaan dari simulasi sebelumnya atau membuat kunci pengayaan kustom.
Sisipkan Hasil
Jika langkah gagal, Anda dapat mengklik Sisipkan Hasil di samping tindakan tersebut. Hal berikut terjadi setelah:
- Data ini kini akan ditampilkan setiap kali langkah dijalankan.
Menonaktifkan Simulator Playbook
Saat Anda menonaktifkan Simulator Playbook, konsol bawah akan disembunyikan, dan setiap langkah dalam mode Simulasi akan kembali ke mode 'live' reguler. Pengecualiannya adalah blok playbook—Anda harus menonaktifkan simulator blok untuk menutup mode simulasinya. Data simulasi (tiruan) yang dimasukkan akan disimpan untuk digunakan saat Anda mengaktifkan simulator berikutnya.
Bekerja dengan blok playbook
Anda juga dapat menggunakan Simulator Playbook untuk membuat dan menguji blok playbook baru. Jika suatu blok berada dalam mode simulasi, semua playbook induk yang menggunakan blok ini juga menggunakan data tiruan blok.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.