Mengintegrasikan Pusat Notifikasi Google dengan Google SecOps
Dokumen ini menjelaskan cara mengintegrasikan Pusat Notifikasi Google Workspace dengan Google Security Operations.
Kasus penggunaan
Integrasi Pusat Notifikasi Google menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:
Respons kampanye phishing: Serap notifikasi Pusat Notifikasi terkait potensi phishing yang menargetkan organisasi Anda. Memicu alur kerja otomatis untuk menyelidiki email, memblokir URL berbahaya, dan mengarantina akun yang terpengaruh.
Pembatasan pemindahan data yang tidak sah: Memicu respons insiden otomatis saat pergerakan data yang mencurigakan terdeteksi. Mengisolasi sistem yang terpengaruh dan memulai analisis forensik.
Perbaikan malware otomatis: Karantina perangkat terinfeksi yang diidentifikasi oleh notifikasi Google Workspace dan mulai pemindaian malware wajib atau deployment patch.
Manajemen kerentanan: Memproses pemberitahuan secara otomatis tentang kerentanan yang baru ditemukan yang memengaruhi lingkungan Google Workspace Anda untuk memprioritaskan penerapan patch dan menginformasikan tim yang relevan.
Sebelum memulai
Sebelum mengonfigurasi integrasi Pusat Notifikasi Google di Google SecOps, selesaikan langkah-langkah prasyarat berikut:
Mengaktifkan Google Workspace Alert Center API
Mengaktifkan API memungkinkan Google SecOps berkomunikasi dengan data keamanan Google Workspace Anda.
Di konsol Google Cloud , buka halaman Library.
Klik Enable.
Membuat akun layanan
Akun layanan berfungsi sebagai identitas yang aman untuk integrasi guna mengakses data Google Workspace Anda.
Di konsol Google Cloud , buka IAM & Admin > Service Accounts.
Klik addCreate service account.
Berikan nama (seperti "Integrasi Pusat Notifikasi SecOps") dan deskripsi.
Klik Create and continue.
Lewati langkah-langkah penetapan peran IAM opsional dan klik Done. Izin Pusat Notifikasi diberikan kepada pengguna Google Workspace yang ditiru identitasnya di konsol Google Admin domain Anda, bukan kepada akun layanan di Google Cloud IAM.
Temukan akun layanan dalam daftar, lalu salin Client ID (ID Unik) dan Alamat email-nya.
Mengonfigurasi kunci JSON
Integrasi ini menggunakan file kunci JSON statis untuk autentikasi.
Pilih akun layanan Anda di konsol Google Cloud dan buka tab Keys.
Klik Add key > Create new key.
Pilih JSON dan klik Create. File kunci akan otomatis didownload ke komputer Anda.
Salin konten lengkap file ini dan tempelkan ke
Service Account JSON Secretselama konfigurasi integrasi.
Mendelegasikan otoritas tingkat domain
Memberikan otoritas di seluruh domain memungkinkan akun layanan mengakses notifikasi pengguna Anda dengan meniru identitas administrator.
Dari konsol Google Admin domain Anda, buka Menu utama > Keamanan > Kontrol data dan akses > Kontrol API.
Di panel Domain wide delegation, pilih Manage Domain Wide Delegation.
Klik Tambahkan baru.
Di kolom Client ID, masukkan ID unik (client ID) yang Anda salin dari akun layanan.
Di kolom OAuth Scopes, masukkan cakupan berikut:
https://www.googleapis.com/auth/apps.alertsKlik Otorisasi.
Memberikan akses Pusat Notifikasi kepada pengguna yang ditiru identitasnya
Pengguna Google Workspace yang Anda tentukan dalam
parameter Impersonation Email Address harus memiliki hak istimewa administrator
Pusat Notifikasi di konsol Google Admin domain Anda.
Untuk memberikan akses Pusat Notifikasi di konsol Google Admin, tetapkan salah satu peran berikut kepada pengguna yang ditiru identitasnya:
Peran administrator standar: Tetapkan peran Admin Super atau Admin Layanan, yang mencakup akses penuh ke Pusat Notifikasi secara default.
Peran administrator khusus: Buat peran administrator khusus di Akun > Peran admin dengan hak istimewa Pusat Notifikasi > Akses penuh (diperlukan untuk menjalankan tindakan Hapus Notifikasi) atau hak istimewa Pusat Notifikasi > Akses lihat (cukup untuk penyerapan notifikasi hanya baca), dan tetapkan peran tersebut kepada pengguna yang ditiru identitasnya.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi hak istimewa administrator dan peran khusus Pusat Notifikasi, lihat Memberikan akses ke pusat notifikasi.
Parameter integrasi
Integrasi Pusat Notifikasi Google memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Service Account JSON Secret |
Wajib. Konten lengkap file JSON kunci akun layanan yang Anda download. |
Impersonation Email Address |
Wajib. Alamat email pengguna Google Workspace dengan hak istimewa administrator Pusat Notifikasi (seperti peran Admin Super atau Admin Layanan, atau peran administrator khusus dengan hak istimewa Pusat Notifikasi) di domain Google Workspace Anda. Integrasi ini menggunakan delegasi tingkat domain untuk meniru identitas pengguna ini dan mengambil atau mengelola pemberitahuan. |
Verify SSL |
Opsional. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Pusat Notifikasi Google. 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.
Notifikasi Dihapus
Gunakan tindakan Hapus Notifikasi untuk menghapus notifikasi di pusat notifikasi.
Setelah menghapus pemberitahuan, Anda dapat memulihkannya selama 30 hari berikutnya. Anda tidak dapat memulihkan notifikasi yang Anda hapus lebih dari 30 hari yang lalu.
Tindakan ini tidak berjalan di entity Google SecOps.
Input tindakan
Tindakan Hapus Pemberitahuan memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Alert ID |
Wajib
ID pemberitahuan yang akan dihapus. |
Output tindakan
Tindakan Delete Alert 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 Delete Alert dapat menampilkan pesan output berikut:
| Pesan output | Deskripsi pesan |
|---|---|
|
Tindakan berhasil. |
Error executing action "Delete Alert". 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 Delete Alert:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Ping
Gunakan tindakan Ping untuk menguji konektivitas ke pusat notifikasi.
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 the alert center server with the
provided connection parameters! |
Tindakan berhasil. |
Failed to connect to the alert center server! Error is
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 Ping:
| Nama hasil skrip | Nilai |
|---|---|
is_success |
True atau False |
Konektor
Untuk mempelajari lebih lanjut cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data (konektor).
Google Alert Center – Alerts Connector
Gunakan Google Alert Center – Alerts Connector untuk mengambil informasi tentang notifikasi dari pusat notifikasi.
Filter daftar dinamis berfungsi dengan parameter type.
Input konektor
Google Alert Center – Alerts Connector memerlukan parameter berikut:
| Parameter | Deskripsi |
|---|---|
Product Field Name |
Wajib Nama kolom tempat nama produk disimpan. Nilai defaultnya adalah |
Event Field Name |
Wajib Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah |
Environment Field Name |
Opsional
Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan akan ditetapkan ke lingkungan default. Nilai defaultnya adalah |
Environment Regex Pattern |
Opsional
Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom Gunakan nilai default Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah lingkungan default. |
PythonProcessTimeout |
Wajib
Batas waktu tunggu dalam detik untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah |
Service Account JSON Secret |
Wajib
Konten JSON lengkap dari file akun layanan yang Anda gunakan untuk autentikasi ke pusat notifikasi. |
Impersonation Email Address |
Wajib
Alamat email pengguna Google Workspace dengan hak istimewa administrator Pusat Notifikasi (seperti peran Admin Super atau Admin Layanan, atau peran administrator khusus dengan hak istimewa Pusat Notifikasi). |
Verify SSL |
Opsional Jika dipilih, integrasi akan memverifikasi bahwa sertifikat SSL untuk terhubung ke pusat notifikasi valid. Dipilih secara default. |
Max Hours Backwards |
Opsional Jumlah jam sebelum iterasi konektor pertama untuk mengambil respons. Parameter ini berlaku untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya atau nilai pengganti untuk stempel waktu konektor yang sudah tidak berlaku. Nilai defaultnya adalah 1 jam. |
Max Alerts To Fetch |
Opsional
Jumlah maksimum pemberitahuan yang akan diambil untuk setiap iterasi konektor. Jumlah maksimumnya adalah 100. |
Lowest Severity To Fetch |
Opsional
Tingkat keparahan pemberitahuan terendah yang akan diambil. |
Use whitelist as a blacklist |
Opsional
Jika dipilih, konektor akan menggunakan daftar dinamis sebagai daftar yang tidak diizinkan. Tidak dipilih secara default. |
Proxy Server Address |
Opsional Alamat server proxy yang akan digunakan. |
Proxy Username |
Opsional Nama pengguna proxy untuk melakukan autentikasi. |
Proxy Password |
Opsional Sandi proxy untuk melakukan autentikasi. |
Aturan Konektor
Aturan berikut menentukan logika operasional, perilaku pemrosesan data, dan mekanisme keamanan konektor.
Proxy: Konektor mendukung proxy.
Pembuatan peristiwa: Jika pemberitahuan berisi kunci
data/messages(daftar objek JSON), konektor akan membuat peristiwa terpisah untuk setiap objek dalam daftar.Waktu tunggu keamanan: Jika konektor mencapai 90% dari waktu tunggu eksekusinya (berdasarkan
PythonProcessTimeout), konektor akan berhenti dan tidak membuat pemberitahuan baru untuk iterasi tersebut guna mencegah penyerapan data parsial.Pengelolaan watermark: Konektor melacak pemberitahuan yang diproses menggunakan
alertId. ID ini menyimpan hingga 1.000 ID diids.json. Jika batas terlampaui, ID akan menghapus 100 ID terlama.
Contoh JSON peristiwa
Contoh JSON berikut menunjukkan struktur respons umum dari Google Alert Center API, yang mengilustrasikan kolom data tertentu yang tersedia untuk penyerapan.
{
"customerId": "038judqw",
"alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
"createTime": "2020-07-22T11:50:08.353Z",
"startTime": "2020-07-22T10:54:54.059475Z",
"endTime": "2020-07-22T11:46:51.020063Z",
"type": "User reported phishing",
"source": "Gmail phishing",
"data": {
"@type": "[type.googleapis.com/google.apps.alertcenter.type.MailPhishing](https://type.googleapis.com/google.apps.alertcenter.type.MailPhishing)",
"domainId": {
"customerPrimaryDomain": "smplylab.com"
},
"maliciousEntity": {
"fromHeader": "crazywiz7@abv.bg"
},
"messages": [
{
"messageId": "1753474999.350456.1595412914645@nm22.abv.bg",
"messageBodySnippet": " eicar com http malware wicar org data ms14_064_ole_not_xp html",
"md5HashSubject": "c93d4454877e844fdfcb4401472204f2",
"subjectText": "Re: App Store - Support. 17/07/2020 12:50:36",
"attachmentsSha256Hash": [
"77c2aed70c3b20c50dbf071f8688580e02463c213e7a65ccab1acc2f8a9769a3",
"f5e1b1bf12b71c54f68a719e0c45df5806a8b8d57bf3967d9bd4a071cfc5abbe"
],
"recipient": "lab3@smplylab.com",
"date": "2020-07-22T10:54:54.059475Z"
}
]
},
"securityInvestigationToolLink": "[admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE](https://admin.google.com/ac/ac/investigate?alert=CiRlMzc0MTVmMS03YzM5LTQ0YTUtYjQzYy00ZjgxNTk2MzhhMmE)",
"metadata": {
"customerId": "038judqw",
"alertId": "e37415f1-7c39-44a5-b43c-4f8159638a2a",
"status": "NOT_STARTED",
"updateTime": "2020-07-22T11:50:08.353Z",
"severity": "HIGH",
"etag": "rrXycg7VpUA="
},
"updateTime": "2020-07-22T11:50:08.353Z",
"etag": "rrXycg7VpUA="
}
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.