Google Cloud API
Dokumen ini memberikan panduan untuk membantu Anda mengonfigurasi dan mengintegrasikan Google Cloud API dengan Google Security Operations.
Kasus penggunaan
Integrasi Google Cloud API menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:
Pengelolaan resource otomatis: Jalankan tindakan di berbagai layanan Google Cloud seperti Compute Engine atau Cloud Storage untuk memulihkan ancaman atau mengelola infrastruktur secara dinamis.
Tata kelola identitas dan akses: Menyesuaikan kebijakan atau peran Identity and Access Management secara terprogram sebagai respons terhadap insiden keamanan yang terdeteksi.
Orkestrasi API kustom: Berinteraksi dengan API Google Cloud yang diaktifkan yang tidak memiliki integrasi khusus, sehingga memberikan fleksibilitas maksimum untuk playbook yang kompleks.
Autentikasi tanpa kunci: Akses resource Google Cloud dengan aman menggunakan Workload Identity untuk menghilangkan risiko yang terkait dengan kunci akun layanan statis.
Sebelum memulai
Sebelum mengonfigurasi integrasi di platform Google SecOps, pastikan Anda memiliki hal berikut:
Target API diaktifkan: Identifikasi dan aktifkan layananGoogle Cloud tertentu yang ingin Anda otomatiskan.
Izin IAM: Pastikan identitas Anda memiliki peran yang diperlukan untuk tindakan tertentu yang ingin Anda lakukan.
Metode autentikasi: Pilih antara Workload Identity yang direkomendasikan atau kunci JSON akun layanan untuk autentikasi.
Mengidentifikasi dan mengaktifkan API target
Karena integrasi ini adalah gateway generik, tidak ada API tetap. Persyaratan bergantung pada kasus penggunaan spesifik Anda. Anda harus mengaktifkan API target (seperti Compute Engine, Cloud Storage, atau IAM) di project Anda untuk menjalankannya melalui integrasi.
Gunakan prosedur berikut untuk mengidentifikasi dan mengaktifkan API target:
Di konsol Google Cloud , buka APIs & Services > Library.
Telusuri dan aktifkan layanan yang diperlukan.
Mengonfigurasi izin IAM
Akun layanan atau identitas yang digunakan oleh integrasi ini harus memiliki peran IAM yang sesuai.
Prinsip hak istimewa terendah: Hanya berikan peran tertentu yang diperlukan untuk panggilan API yang Anda inginkan.
Persyaratan dinamis: Izin bervariasi berdasarkan operasi. Misalnya, mengelola resource memerlukan peran yang berbeda dengan mencantumkannya.
Memilih metode autentikasi
Google SecOps mendukung dua jalur autentikasi untuk integrasi ini:
Melakukan autentikasi menggunakan Workload Identity (direkomendasikan)
Workload Identity adalah metode yang paling aman karena menghilangkan kebutuhan untuk mengelola atau merotasi kunci JSON yang berumur panjang. Platform ini menggunakan peniruan akun layanan untuk mengizinkan platform mengakses resource Anda dengan aman.
Mengidentifikasi identitas instance Google SecOps
Ikuti langkah-langkah berikut untuk menemukan identitas unik untuk instance Anda:
Di Google SecOps, buka Content Hub > Response Integrations.
Pilih integrasi Google Cloud API.
Masukkan email akun layanan target ke kolom Workload Identity Email.
Klik Save, lalu klik Test. Pengujian diperkirakan akan gagal.
Klik close_small di sebelah kanan Test dan telusuri pesan error untuk email identitas yang diawali dengan
gke-init-python@...atausoar-python@....Salin alamat email unik ini.
Memberikan izin peniruan identitas
Izinkan identitas instance untuk mengakses resource Anda dengan menyelesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka IAM & Admin > Service Accounts.
Pilih akun layanan target dan buka Permissions > Grant Access.
Tempelkan alamat email unik ke kolom New principals dan tetapkan peran Service Account Token Creator (
roles/iam.serviceAccountTokenCreator).
Melakukan autentikasi menggunakan kunci JSON
Hanya gunakan metode ini jika Workload Identity tidak tersedia di lingkungan Anda.
Gunakan prosedur berikut untuk mengautentikasi integrasi menggunakan kunci JSON akun layanan:
Di konsol Google Cloud , buat akun layanan.
Buka tab Keys dan pilih Add key > Create new key.
Pilih
JSONsebagai jenis kunci dan download file.Salin seluruh konten file ini dan tempelkan ke
Service Account Json File Contentselama konfigurasi integrasi di Google SecOps.
Mengintegrasikan API Google Cloud dengan Google SecOps SOAR
Integrasi ini memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Test URL |
Opsional URL pengujian untuk memvalidasi autentikasi ke API Google Cloud . Parameter ini menggunakan permintaan GET. |
Service Account Json File Content |
Opsional Konten file JSON kunci akun layanan. Anda dapat mengonfigurasi parameter ini, parameter Untuk mengonfigurasi parameter ini, berikan konten lengkap file JSON kunci akun layanan yang telah Anda download saat membuat akun layanan. Untuk mengetahui informasi selengkapnya tentang penggunaan akun layanan sebagai metode autentikasi, lihat Ringkasan akun layanan dan Peniruan akun layanan. Dalam integrasi ini, autentikasi dengan file JSON kunci akun layanan memiliki prioritas lebih tinggi daripada email Workload Identity. |
Organization ID |
Opsional ID organisasi yang akan digunakan dalam integrasi. Untuk mengambil nilai dari parameter ini selama eksekusi tindakan,
tetapkan placeholder berikut: |
Project ID |
Opsional Project ID yang akan digunakan dalam integrasi. Untuk mengambil nilai dari parameter ini selama eksekusi tindakan,
tetapkan placeholder berikut:
|
Quota Project ID |
Opsional Google Cloud Project ID yang Anda gunakan untuk
API dan penagihan Google Cloud . Parameter ini mengharuskan Anda memberikan
peran Integrasi akan melampirkan nilai parameter ini ke semua permintaan API. Jika Anda tidak menetapkan nilai untuk parameter ini, integrasi akan mengambil project ID dari akun layanan Google Cloud Anda. |
Workload Identity Email |
Opsional Alamat email klien Akun Layanan Anda. Anda dapat mengonfigurasi parameter ini atau parameter Dalam integrasi ini, autentikasi dengan file JSON kunci akun layanan memiliki prioritas lebih tinggi daripada email Workload Identity. Untuk meniru identitas akun layanan dengan Workload Identity,
berikan peran |
OAuth Scopes |
Opsional Daftar cakupan OAuth yang dipisahkan koma yang diperlukan untuk menjalankan permintaan API Google Cloud . |
Verify SSL |
Wajib Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk terhubung ke layanan Google Cloud valid. Dipilih secara default. |
Untuk mengetahui petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.
Anda dapat melakukan perubahan pada tahap selanjutnya jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.
Tindakan
Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.
Menjalankan Permintaan HTTP
Gunakan tindakan Execute HTTP Request untuk membuat dan menjalankan permintaan HTTP API yang disesuaikan terhadap URL target.
Tindakan ini tidak berjalan di entity Google SecOps.
Perilaku tindakan
Tindakan ini mendukung perilaku kompleks termasuk polling asinkron, konstruksi payload dinamis, dan pengelolaan file.
Polling asinkron
Jika Expected Response Values disediakan, tindakan akan beroperasi dalam mode asinkron. Dalam mode ini, tindakan akan berulang kali melakukan polling pada endpoint target untuk melacak status respons (misalnya, menunggu tugas yang berjalan lama selesai).
Tindakan ini mengevaluasi isi respons terhadap kondisi JSON yang diberikan dalam parameter dan melanjutkan eksekusi hingga kondisi terpenuhi atau tindakan mencapai waktu tunggu.
Logika kondisi
Tindakan ini mendukung logika berikut untuk melacak status respons:
Pencocokan kolom tunggal: Tindakan menunggu kolom tertentu mencapai satu nilai.
{ "state": "finished" }Beberapa nilai (logika ATAU): Tindakan akan menghentikan eksekusi jika kolom cocok dengan nilai apa pun dalam daftar yang disediakan. Hal ini berguna untuk menghentikan status "berhasil" dan "error" guna menghindari polling yang tidak perlu.
{ "state": ["finished", "error"] }Beberapa kolom (logika AND): Tindakan akan menunggu hingga semua kolom yang ditentukan cocok dengan nilainya masing-masing secara bersamaan.
{ "state": "finished", "percentage": "100" }Logika gabungan: Anda dapat menggabungkan beberapa kondisi dalam objek JSON.
{ "state": ["finished", "error"], "percentage": "10" }
Perilaku penguraian JSON
Saat mengevaluasi kondisi, tindakan akan mengikuti aturan berikut:
Penelusuran global: Tindakan ini menelusuri seluruh objek respons JSON untuk menemukan kunci yang ditentukan. Berikan nama kunci persis seperti yang muncul di JSON tanpa menambahkan nama objek induk atau menggunakan awalan (misalnya, gunakan
"state", bukan"data_state"atau"data-state").Beberapa kunci yang identik: Jika respons berisi beberapa kunci dengan nama yang sama di berbagai tingkat hierarki JSON, output yang diharapkan hanya akan tercapai jika semua nama kunci yang cocok memenuhi nilai yang diharapkan yang identik.
Misalnya, untuk menelusuri status
finisheddalam respons JSON dan mengabaikan status lainnya, tetapkan semua kuncistatediExpected Response Valueskefinished:{ "data": { "state": "finished" }, "state": "finished" }
Konstruksi payload isi
Tindakan ini membuat isi permintaan berdasarkan header Content-Type
yang disediakan di Headers.
Ini adalah input Body Payload yang digunakan untuk
contoh konstruksi berikut:
{
"Id": "123123",
"sorting": "asc"
}
application/x-www-form-urlencoded: Tindakan ini menghasilkan payload sebagaiId=123123&sorting=asc.application/json: Tindakan ini menghasilkan payload JSON berikut:{ "Id": "123123", "sorting": "asc" }XML: Jika produk pihak ketiga memerlukan XML, berikan input berformat XML langsung diBody Payload:<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)"> <soap:Body> <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)"> <ubiNum>500</ubiNum> </NumberToWords> </soap:Body> </soap:Envelope>
Proses penanganan file
Tindakan ini mendukung alur kerja berikut untuk mengelola file:
Mendownload file:
Untuk menampilkan data file sebagai bagian dari hasil JSON dalam format base64, pilih
Base64 Output.Untuk menyimpan file langsung ke Case Wall sebagai file ZIP, pilih
Save To Case Wall.
Mengupload file: Untuk mengupload file, konversikan ke string berenkode base64 dan sertakan sebagai bagian dari nilai
Body Payload.Contoh berikut menunjukkan file gambar yang dikonversi menjadi string berenkode base64:
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: Untuk file sensitif (seperti malware), pilih
Password Protect Zip. Tindakan ini akan otomatis mengenkripsi file ZIP tersimpan yang dibuat menggunakanSave To Case Walldengan sandiinfected.
Konfigurasi blok playbook
Konfigurasi berikut menunjukkan cara menggunakan tindakan Execute HTTP Request dalam blok playbook. Gunakan contoh ini untuk memahami cara menerapkan placeholder dan awalan input.
Saat menggunakan input blok sebagai placeholder, Anda harus menyertakan awalan Input.
(misalnya, [Input.comment]).
Metode:
PUTJalur URL:
https://{API_URL}/[Input.table_name]/[Input.sys_id]Header:
{ "Content-type": "application/json; charset=utf-8", "Accept": "application/json", "User-Agent": "GoogleSecops" }Payload Isi:
{ "work_notes": "[Input.comment]" }
Input tindakan
Tindakan Execute HTTP Request memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Method |
Opsional Metode yang akan digunakan dalam permintaan. Nilai
defaultnya adalah
|
URL Path |
Opsional URL yang akan dijalankan. Nilai defaultnya adalah
|
URL Params |
Opsional Parameter URL. Tindakan ini menggunakan nilai apa pun yang diberikan bersama dengan nilai yang Anda berikan langsung di parameter Jalur URL. Parameter ini memerlukan format objek JSON sebagai input. Nilai defaultnya adalah sebagai berikut: {
"URL Field Name": "URL_FIELD_VALUE"
} |
Headers |
Opsional Header yang akan digunakan dalam permintaan HTTP. Parameter ini memerlukan format objek JSON sebagai input. Nilai defaultnya adalah sebagai berikut: {
"Content-Type": "application/json; charset=utf-8",
"Accept": "application/json",
"User-Agent" : "GoogleSecOps"
} |
Cookie |
Opsional Parameter yang akan digunakan di header Parameter ini menimpa cookie yang disediakan dalam parameter Header. Parameter ini memerlukan format objek JSON sebagai input. Nilai defaultnya adalah sebagai berikut: {
"Cookie_1": "COOKIE_1_VALUE"
} |
|
Opsional
Isi untuk permintaan HTTP. Tindakan ini membuat payload yang berbeda, bergantung pada nilai header Parameter ini memerlukan format objek JSON sebagai input, kecuali jika produk pihak ketiga memerlukan XML atau konten Nilai defaultnya adalah sebagai berikut: {
"Body Field Name": "BODY_FIELD_VALUE"
} |
Expected Response Values |
Opsional. Objek JSON yang berisi key-value pair yang menentukan status isi respons yang diperlukan. |
Save To Case Wall |
Opsional Jika dipilih, tindakan ini akan menyimpan file dan melampirkan
file yang disimpan ke repositori kasus. File diarsipkan dengan
ekstensi Tidak dipilih secara default. |
Password Protect Zip |
Opsional Jika dipilih, tindakan ini akan menambahkan sandi ke
file Gunakan parameter ini saat menangani file yang mencurigakan. Dipilih secara default. |
Follow Redirects |
Opsional Jika dipilih, tindakan akan mengikuti pengalihan. Dipilih secara default. |
Fail on 4xx/5xx |
Opsional Jika dipilih, tindakan akan gagal jika kode status respons adalah error 4xx atau 5xx. Dipilih secara default. |
Base64 Output |
Opsional Jika dipilih, tindakan akan mengonversi respons ke format base64. Gunakan parameter ini saat mendownload file. Hasil JSON tidak boleh melebihi 15 MB. Tidak dipilih secara default. |
Fields To Return |
Wajib Kolom yang akan ditampilkan. Kemungkinan nilainya adalah sebagai berikut:
|
Request Timeout |
Wajib Periode untuk menunggu server mengirim data sebelum tindakan gagal. Nilai default-nya adalah 120 detik. |
Output tindakan
Tindakan Execute HTTP Request memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tidak tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tidak tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Execute HTTP Request:
{
"response_data": {
"data": {
"relationships": {
"comment": [
{
"name": "item",
"description": "Object to which the comment belongs to."
},
{
"name": "author",
"description": "User who wrote the comment."
}
]
}
}
},
"redirects": [],
"response_code": 200,
"cookies": {},
"response_headers": {
"Content-Type": "application/json",
"X-Cloud-Trace-Context": "VALUE",
"Date": "Fri, 03 Nov 2023 16:14:13 GMT",
"Server": "Google Frontend",
"Content-Length": "36084"
},
"apparent_encoding": "ascii"
}
Pesan output
Tindakan Execute HTTP Request memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Failed to execute API request. Error:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Execute HTTP Request:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Ping
Gunakan tindakan Ping untuk menguji konektivitas ke Google Cloud.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tidak ada.
Output tindakan
Tindakan Ping memberikan output berikut:
| Jenis output tindakan | Ketersediaan |
|---|---|
| Lampiran repositori kasus | Tidak tersedia |
| Link repositori kasus | Tidak tersedia |
| Tabel repositori kasus | Tidak tersedia |
| Tabel pengayaan | Tidak tersedia |
| Hasil JSON | Tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Hasil JSON
Contoh berikut menjelaskan output hasil JSON yang diterima saat menggunakan tindakan Ping:
{
"endpoint": "TEST_URL"
}
Pesan output
Tindakan Ping memberikan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully tested connectivity. |
Tindakan berhasil. |
Failed to test connectivity. |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut menjelaskan nilai untuk output hasil skrip saat menggunakan tindakan Ping:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.