Mengintegrasikan Vertex AI dengan Google SecOps
Dokumen ini menjelaskan cara mengintegrasikan Vertex AI dengan Google Security Operations.
Kasus penggunaan
Integrasi Vertex AI mendukung kasus penggunaan berikut:
Analisis email berbahaya otomatis: Menganalisis file EML mentah untuk mengekstrak tingkat ancaman, mengidentifikasi link phishing atau indikator manipulasi psikologis, dan merekomendasikan langkah-langkah verifikasi.
Pengayaan entity kontekstual: Buat ringkasan bahasa alami dari entity keamanan untuk mempercepat pemahaman investigator selama triase.
Orkestrasi playbook yang fleksibel: Jalankan perintah teks generatif tidak terstruktur di dalam playbook untuk membantu pertahanan prediktif atau analisis keamanan yang kompleks.
Transformasi data kustom: Mengotomatiskan transformasi terprogram dari struktur data JSON arbitrer menggunakan petunjuk bahasa alami.
Sebelum memulai
Sebelum Anda mengonfigurasi integrasi Vertex AI di Google SecOps, selesaikan langkah-langkah prasyarat berikut:
Berikan peran Identity and Access Management yang diperlukan ke akun layanan Anda.
Pilih dan konfigurasi salah satu metode autentikasi berikut:
Opsi 1: Workload Identity (direkomendasikan): Metode ini menggunakan token berumur pendek menggunakan peniruan akun layanan.
Opsi 2: Kunci JSON akun layanan: Metode ini mengandalkan file kunci rahasia statis yang berumur panjang.
Untuk mengetahui informasi mendetail terkait biaya layanan, tinjau harga Vertex AI.
Membuat akun layanan
Di konsol Google Cloud , buka IAM & Admin > Service Accounts.
Klik addCreate service account.
Berikan nama dan deskripsi, lalu klik Selesai. Catat Alamat email akun layanan.
Memberikan peran IAM
Untuk mengizinkan integrasi berinteraksi dengan layanan platform, Anda harus memberikan izin ke akun utama Anda.
Di konsol Google Cloud , buka IAM.
Temukan akun layanan Anda, lalu klik Edit principal (edit).
Klik Add another role dan pilih Vertex AI User (
roles/aiplatform.user).Klik Simpan.
Mengonfigurasi kredensial Workload Identity
Workload Identity adalah pendekatan yang direkomendasikan karena menggunakan token akses berumur pendek menggunakan peniruan akun layanan.
Mengidentifikasi identitas instance yang unik
Untuk membuat koneksi, Anda harus memberikan izin kepada instance Google SecOps untuk meniru identitas akun layanan Anda.
Di Google SecOps, buka Content Hub > Response Integrations.
Pilih integrasi Vertex AI dan masukkan email akun layanan Anda di Workload Identity Email.
Klik Save > Test. Pengujian diperkirakan akan gagal.
Klik close_small di samping tombol Test dan temukan email identitas yang diawali dengan
gke-init-python@...atausoar-python@....Salin alamat email unik ini.
Mengizinkan identitas instance di Google Cloud
Di konsol Google Cloud , buka IAM & Admin > Service Accounts.
Pilih akun layanan target dan buka Permissions > Grant Access.
Tempelkan alamat email unik ke New principals dan tetapkan peran Service Account Token Creator (
roles/iam.serviceAccountTokenCreator).
Mengonfigurasi kunci JSON
File kunci rahasia statis yang berumur panjang memerlukan rotasi manual. Hanya gunakan metode ini jika autentikasi Workload Identity tidak tersedia.
Di konsol Google Cloud , buka IAM & Admin > Service Accounts, lalu pilih akun layanan Anda.
Buka tab Keys dan klik Add key > Create new key.
Pilih JSON dan klik Create. Browser akan mendownload file JSON ke komputer Anda.
Parameter integrasi
Integrasi Vertex AI memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
API Root |
Wajib. Root API instance Vertex AI. Nilai defaultnya adalah
|
Workload Identity Email |
Opsional. Alamat email klien akun layanan Anda. Hanya konfigurasikan parameter ini jika Anda melakukan autentikasi menggunakan Workload
Identity. Jika dikonfigurasi, |
Service Account JSON File Content |
Opsional. Konten lengkap file JSON kunci akun layanan. Konfigurasikan parameter ini untuk autentikasi kunci akun layanan. |
Project ID |
Opsional. Project ID yang akan ditargetkan di Pub/Sub. Jika tidak ada nilai yang diberikan, integrasi akan mengambil ID dari kredensial akun layanan. |
Default Model |
Opsional. Nama model default yang akan ditargetkan. Nilai defaultnya adalah |
Location |
Opsional. ID lokasi untuk Vertex AI API. Jika tidak ada nilai yang diberikan, integrasi akan mengekstrak ID lokasi dari root API. |
Verify SSL |
Wajib. Memvalidasi sertifikat SSL untuk koneksi ke server. Diaktifkan secara default. |
Untuk mendapatkan 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.
Menganalisis EML
Gunakan tindakan Analyze EML untuk menganalisis file EML menggunakan Vertex AI. Tindakan ini akan mengirimkan setiap file satu per satu.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Analyze EML memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Model ID |
Opsional ID model yang akan digunakan, seperti
|
Temperature |
Opsional Nilai untuk mengontrol tingkat keacakan dalam
pemilihan token. Parameter ini menerima nilai jenis data Untuk mengetahui informasi selengkapnya tentang nilai suhu, lihat Bereksperimen dengan parameter value. |
Files To Analyze |
Wajib Daftar file EML yang dipisahkan koma untuk dikirimkan guna analisis. |
Max Output Tokens |
Opsional Jumlah maksimum token output yang akan dihasilkan dalam setiap respons. Token terdiri atas sekitar empat karakter. 100 token setara dengan sekitar 60-80 kata. Batas ini berlaku untuk setiap entitas individual. Untuk mengetahui informasi selengkapnya, lihat Bereksperimen dengan parameter value. Nilai defaultnya adalah |
Output tindakan
Tindakan Analyze EML 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 menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Analyze EML:
[{
"Entity": "file",
"EntityResult": {
"raw": "{\"threat_level\": \"High\", \"threats_found\": [{\"threat\": \"Phishing Links\", \"explanation\": \"Multiple links point",
"extracted_info": {
"threat_level": "High",
"threats_found": [
{
"threat": "Phishing Links",
"explanation": "Multiple links point to example.com, a suspicious domain likely used for phishing campaigns.",
"example": "URL"
},
{
"threat": "Social Engineering",
"explanation": "The email uses urgency and scarcity tactics, pressuring the recipient to click links quickly.",
"example": "Register Now and Save $1,000 on all 2-Day Project Management (Fundamentals)"
},
{
"threat": "Suspicious Domain",
"explanation": "The email uses the domain example.com', which is not commonly associated with legitimate businesses or organizations and may be a newly registered domain for malicious purposes. This should be checked for validity and legitimacy. The email also uses the domain pdu-xl.com which may also be suspicious.",
"example": "example.com"
}
],
"verification_steps": [
"Check the domain reputation of example.com using online tools like VirusTotal or URLVoid.",
"Analyze email headers to identify the true sender's IP address and location using email analysis tools.",
"Verify the legitimacy of mentioned products or services by independently contacting the companies mentioned."
],
"protection_measures": [
"Avoid clicking links in suspicious emails. Hover over links to check the actual URL in a separate tool.",
"Enable email filtering and anti-phishing features in your email client.",
"Regularly update your antivirus and anti-malware software.",
"Educate users about social engineering tactics and phishing schemes."
]
},
"usageMetadata": {
"promptTokenCount": 12,
"candidatesTokenCount": 778,
"totalTokenCount": 790
}
}
}]
Pesan output
Tindakan Analyze EML dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully analysed the following EML files using Vertex AI:
FILE_PATHS |
Tindakan berhasil. |
Error executing action "Analyze EML". Reason:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Analyze EML:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Menjelaskan Entity
Gunakan tindakan Describe Entity untuk meringkas informasi tentang entity menggunakan Vertex AI.
Tindakan ini berjalan di semua entity Google SecOps dan mengirimkan setiap entity satu per satu.
Input tindakan
Tindakan Describe Entity memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Model ID |
Opsional ID model yang akan digunakan, seperti
|
Temperature |
Opsional Nilai untuk mengontrol tingkat keacakan dalam
pemilihan token. Parameter ini menerima nilai jenis data Untuk mengetahui informasi selengkapnya tentang nilai suhu, lihat Bereksperimen dengan parameter value. |
Exclude Fields |
Opsional Daftar kolom metadata entity Google SecOps yang dipisahkan koma untuk dikecualikan selama pembuatan ringkasan entity. |
Force Refresh |
Opsional Jika dipilih, tindakan akan mengabaikan parameter Tidak dipilih secara default. |
Refresh After (Days) |
Wajib Jumlah hari yang harus ditunggu tindakan sebelum memperbarui ringkasan entitas. Tindakan ini menghasilkan nilai hash yang
didasarkan pada semua input yang dikirim ke Vertex AI, tidak termasuk nilai
dari parameter Tindakan ini memvalidasi nilai hash dari ringkasan terbaru yang dihasilkan dan mengabaikan nilai hash yang di-cache. Nilai defaultnya adalah |
Max Output Tokens |
Opsional Jumlah maksimum token output yang akan dihasilkan dalam setiap respons. Token terdiri atas sekitar empat karakter. 100 token setara dengan sekitar 60-80 kata. Batas ini berlaku untuk setiap entitas individual. Untuk mengetahui informasi selengkapnya, lihat Bereksperimen dengan parameter value. |
Output tindakan
Tindakan Describe Entity 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 menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Describe Entity:
[
{
"Entity": "1B16D64CE18772B8F77C74C3D4DC24AA066BB117",
"EntityResult": {
"summary": "This is a suspicious, enriched, internal file hash (SHA1: 1B16D64CE18772B8F77C74C3D4DC24AA066BB117) identified as a Microsoft Excel 2007+ file (\"FC090000\") located on a user's desktop. VirusTotal analysis shows 3 malicious flags out of 65 total engines. The file contains macros, is potentially obfuscated, and exhibits behaviors like writing to files, running DLLs, and downloading content. It was last modified on 2024-11-13 and created on 2021-07-07. The file is linked to a single case (\"potential_apt_doc_files\") which was closed. The file is flagged as an artifact but not vulnerable or a pivot point.\n",
"usageMetadata": {
"promptTokenCount": 12,
"candidatesTokenCount": 778,
"totalTokenCount": 790
}
}
}
]
Pesan output
Tindakan Describe Entity dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully summarized the entity based on the available
information using Vertex AI. |
Tindakan berhasil. |
Error executing action "Describe Entity". Reason:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Describe Entity:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Jalankan Perintah
Gunakan tindakan Execute Prompt untuk menjalankan perintah teks individual menggunakan Vertex AI.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Execute Prompt memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Model ID |
Opsional ID model yang akan digunakan, seperti
|
Text Prompt |
Wajib Petunjuk teks yang akan disertakan dalam perintah. |
Temperature |
Opsional Nilai untuk mengontrol tingkat keacakan dalam
pemilihan token. Parameter ini menerima nilai jenis data Untuk mengetahui informasi selengkapnya tentang nilai suhu, lihat Bereksperimen dengan parameter value. |
Candidate Count |
Opsional Jumlah variasi respons yang akan ditampilkan dalam setiap eksekusi tindakan. Untuk setiap permintaan, penagihan berlaku untuk token input sekali dan setiap token output dari semua kandidat yang dihasilkan. |
Response MIME Type |
Opsional Jenis media (MIME) dari respons output untuk teks kandidat yang dihasilkan. Jenis media respons (MIME) tersedia
untuk model berikut: Kemungkinan nilainya adalah sebagai berikut:
text/plain. |
Response Schema |
Opsional Skema yang harus diikuti oleh teks kandidat yang dihasilkan. Untuk menggunakan parameter ini, konfigurasikan parameter Skema respons tersedia untuk model berikut: |
Max Input Tokens |
Opsional Jumlah maksimum token input yang akan dikirimkan. Satu token terdiri dari maksimal empat karakter. 100 token dapat setara dengan 60-80 kata. Jika Anda tidak menetapkan nilai, tindakan akan mengeksekusi perintah apa pun. Jika jumlah token melebihi jumlah maksimum yang dikonfigurasi, tindakan akan gagal. |
Max Output Tokens |
Opsional Jumlah maksimum token output yang akan dihasilkan dalam setiap respons. Token terdiri atas sekitar empat karakter. 100 token setara dengan sekitar 60-80 kata. Batas ini berlaku untuk setiap entitas individual. Untuk mengetahui informasi selengkapnya, lihat Bereksperimen dengan parameter value. |
Output tindakan
Tindakan Execute Prompt 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 menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Execute Prompt:
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Responding to a malicious email requires a layered approach. Here's a breakdown of remediation steps, prioritizing actions based on urgency:\n\n**Immediate Actions (within minutes):**\n\n1. **Do NOT click any links or open any attachments.** This is paramount. Malicious links can download malware, and attachments can contain viruses or exploits.\n\n2. **Disconnect from the internet (if possible).** This limits the damage the malware can do if it's already on your system. Unplug your ethernet cable or turn off Wi-Fi.\n\n3. **Close the email immediately.** Don't even hover over links or attachments; the preview might be enough to trigger some malware.\n\n**Investigative Actions (within hours):**\n\n4. **Check your email account for unauthorized access.** Look for unfamiliar sent emails, changed settings (like forwarding rules), or new accounts added.\n\n5. **Run a full system scan with your antivirus software.** Ensure your antivirus definitions are up-to-date before running the scan. Consider a second opinion scan with a different reputable antivirus program.\n\n6. **Review your computer's processes (Task Manager on Windows, Activity Monitor on macOS).** Look for unfamiliar processes consuming significant resources. This could indicate malware activity.\n\n7. **Check your network connections.** See if any unauthorized connections exist.\n\n8. **Change your email password immediately.** Use a strong, unique password. Consider using a password manager.\n\n9. **If you clicked a link or opened an attachment, consider the potential impact.** Did you enter credentials? Did you download a file? The severity of action needed depends on this.\n\n**Remediation Actions (within days):**\n\n10. **Contact your IT department or security professional.** They can provide expert guidance and assist with more advanced remediation steps.\n\n11. **Consider more advanced malware scanning tools.** There are specialized tools that can detect malware missed by standard antivirus.\n\n12. **Review your operating system's security settings.** Ensure firewalls are enabled and that other security features are adequately configured.\n\n13. **Report the malicious email to your email provider.** This helps them remove the email and prevent others from being affected. You can often do this by forwarding the email to an abuse reporting address provided by your provider. Report it to the appropriate authorities if you suspect the email involves a crime.\n\n14. **Monitor your accounts and financial records for suspicious activity.** Phishing emails often aim to steal credentials and financial information.\n\n**Preventive Actions (ongoing):**\n\n15. **Implement strong email filtering.** Use spam filters and configure your email provider's security settings to block suspicious emails.\n\n16. **Train yourself and others to identify phishing emails.** Be wary of emails with unusual addresses, grammatical errors, urgent requests, or suspicious attachments.\n\n17. **Keep your software up to date.** Regularly update your operating system, applications, and antivirus software.\n\n18. **Use strong, unique passwords for all accounts.** A password manager can assist with this.\n\n19. **Enable two-factor authentication (2FA) wherever possible.** This adds an extra layer of security to your accounts.\n\n\n**If you suspect your personal data or financial information has been compromised:**\n\n* **Contact your bank and credit card companies immediately.** Report any suspicious transactions and consider placing a fraud alert on your accounts.\n* **Consider credit monitoring services.** This can help you detect and respond to identity theft.\n\n\nThe severity of the remediation steps depends on the nature of the malicious email and what actions you took in response to it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
}
]
},
"finishReason": "STOP",
"avgLogprobs": -0.4171245741660307
}
],
"usageMetadata": {
"promptTokenCount": 12,
"candidatesTokenCount": 778,
"totalTokenCount": 790
},
"modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}
Pesan output
Tindakan Execute Prompt dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully executed a prompt. |
Tindakan berhasil. |
Error executing action "Execute Prompt". Reason:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Execute Prompt:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Ping
Gunakan tindakan Ping untuk menguji konektivitas ke Vertex AI.
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 | Tidak tersedia |
| Pesan output | Tersedia |
| Hasil skrip | Tersedia |
Pesan output
Tindakan Ping dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully connected to Vertex AI with the provided connection
parameters! |
Tindakan berhasil. |
|
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Mentransformasi Data
Gunakan tindakan Transform Data untuk melakukan transformasi data menggunakan Vertex AI.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Transform Data memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Model ID |
Opsional ID model yang akan digunakan, seperti
|
Text Prompt |
Wajib Petunjuk teks yang akan disertakan dalam perintah. |
Temperature |
Opsional Nilai untuk mengontrol tingkat keacakan dalam
pemilihan token. Parameter ini menerima nilai jenis data Untuk mengetahui informasi selengkapnya tentang nilai suhu, lihat Bereksperimen dengan parameter value. |
JSON Object |
Wajib Objek JSON yang akan digunakan sebagai input tindakan. |
Max Output Tokens |
Wajib Jumlah maksimum token output yang akan dihasilkan dalam setiap respons. Token terdiri atas sekitar empat karakter. 100 token setara dengan sekitar 60-80 kata. Batas ini berlaku untuk setiap entitas individual. Untuk mengetahui informasi selengkapnya, lihat Bereksperimen dengan parameter value. Nilai defaultnya adalah |
Output tindakan
Tindakan Transform Data 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 menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Transform Data:
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Respondo it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
}
]
},
"finishReason": "STOP",
"avgLogprobs": -0.4171245741660307
}
],
"usageMetadata": {
"promptTokenCount": 12,
"candidatesTokenCount": 778,
"totalTokenCount": 790
},
"modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}
Pesan output
Tindakan Transform Data dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
Successfully transformed provided data. |
Tindakan berhasil. |
Error executing action "Transform Data". Reason:
ERROR_REASON |
Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial. |
Hasil skrip
Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Transform Data:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.