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:

  1. Aktifkan Google Workspace Alert Center API.

  2. Membuat akun layanan:

  3. Konfigurasikan kunci JSON.

  4. Mendelegasikan otoritas tingkat domain.

  5. Berikan akses Pusat Notifikasi kepada pengguna yang ditiru identitasnya.

Mengaktifkan Google Workspace Alert Center API

Mengaktifkan API memungkinkan Google SecOps berkomunikasi dengan data keamanan Google Workspace Anda.

  1. Di konsol Google Cloud , buka halaman Library.

    Buka Koleksi

  2. Klik Enable.

Membuat akun layanan

Akun layanan berfungsi sebagai identitas yang aman untuk integrasi guna mengakses data Google Workspace Anda.

  1. Di konsol Google Cloud , buka IAM & Admin > Service Accounts.

    Buka Akun Layanan

  2. Klik addCreate service account.

  3. Berikan nama (seperti "Integrasi Pusat Notifikasi SecOps") dan deskripsi.

  4. Klik Create and continue.

  5. 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.

  6. 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.

  1. Pilih akun layanan Anda di konsol Google Cloud dan buka tab Keys.

  2. Klik Add key > Create new key.

  3. Pilih JSON dan klik Create. File kunci akan otomatis didownload ke komputer Anda.

  4. Salin konten lengkap file ini dan tempelkan ke Service Account JSON Secret selama konfigurasi integrasi.

Mendelegasikan otoritas tingkat domain

Memberikan otoritas di seluruh domain memungkinkan akun layanan mengakses notifikasi pengguna Anda dengan meniru identitas administrator.

  1. Dari konsol Google Admin domain Anda, buka Menu utama > Keamanan > Kontrol data dan akses > Kontrol API.

  2. Di panel Domain wide delegation, pilih Manage Domain Wide Delegation.

  3. Klik Tambahkan baru.

  4. Di kolom Client ID, masukkan ID unik (client ID) yang Anda salin dari akun layanan.

  5. Di kolom OAuth Scopes, masukkan cakupan berikut:

    https://www.googleapis.com/auth/apps.alerts
    
  6. Klik 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

Successfully deleted alert with ID RECORD_ID in the alert center.

Alert with ID RECORD_ID doesn't exist in the alert center.

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 source.

Event Field Name Wajib

Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis).

Nilai defaultnya adalah type.

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 Environment Field Name. Parameter ini memungkinkan Anda memanipulasi kolom lingkungan menggunakan logika ekspresi reguler.

Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan.

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 180.

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 di ids.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.