Devo

Dokumen ini menjelaskan cara mengintegrasikan Devo dengan Google Security Operations.

Izin Produk

Devo menyediakan beberapa metode autentikasi yang dijelaskan dalam dokumen Kredensial keamanan yang tersedia dalam dokumentasi Devo.

Integrasi Google Security Operations mendukung token autentikasi atau kunci akses untuk autentikasi.

Sebaiknya konfigurasikan autentikasi berbasis token:

  1. Buka dokumen Token autentikasi yang tersedia dalam dokumentasi Devo.
  2. Ikuti langkah-langkah tentang cara membuat token, pada langkah 3 pilih Query data using REST API.
  3. Pada langkah 4, untuk tabel target, tentukan "siem.logtrust.alert.info".

Selesaikan proses pembuatan sesuai dengan dokumentasi untuk mendapatkan token.

API

Untuk mengetahui informasi selengkapnya tentang API, lihat dokumen referensi API yang tersedia dalam dokumentasi Devo.

Mengonfigurasi integrasi Devo di Google SecOps

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
URL API String https://apiv2-us.devo.com Ya Tentukan root API untuk instance Devo target.
Token API Sandi T/A Tidak

Jika autentikasi berbasis token digunakan, tentukan token API untuk instance Devo target.

Jika Token dan Kunci Akses diberikan, integrasi akan berfungsi pada token API dan mengabaikan Kunci Akses.

Kunci API Sandi T/A Tidak Jika autentikasi kunci akses digunakan, tentukan kunci API untuk instance Devo target.
Rahasia API Sandi T/A Tidak Jika autentikasi kunci akses digunakan, tentukan rahasia API untuk instance Devo target.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, server Google SecOps akan memeriksa sertifikat yang dikonfigurasi untuk root API.

Kasus Penggunaan

  1. Devo dapat digunakan sebagai sumber pemberitahuan untuk diproses oleh Google SecOps.
  2. Devo dapat dikueri dari Google SecOps untuk memperkaya konteks pemberitahuan Google SecOps.

Tindakan

Ping

Deskripsi

Uji konektivitas ke instance Devo dengan parameter yang disediakan di halaman konfigurasi integrasi di halaman Google SecOps Content Hub.

Jika "siem.logtrust.alert.info" tidak diberikan untuk token akses yang dihasilkan, tindakan Ping akan gagal meskipun tokennya valid. Untuk informasi selengkapnya, lihat bagian Izin Produk.

Parameter

T/A

Kasus Penggunaan

Tindakan ini digunakan untuk menguji konektivitas di halaman konfigurasi integrasi di halaman Google SecOps Content Hub, dan dapat dijalankan sebagai tindakan manual, bukan digunakan dalam playbook.

Dijalankan Pada

Tindakan ini tidak berjalan di entity, dan tidak memiliki parameter input wajib.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success True/False is_success=False
Hasil JSON
N/A
Pengayaan Entity

T/A

Insight

T/A

Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil: "Successfully connected to the Devo instance with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika tidak berhasil: "Failed to connect to the LogRhythm server! Error is {0}".format(exception.stacktrace)

Umum

Kueri Lanjutan

Deskripsi

Menjalankan kueri lanjutan berdasarkan parameter yang diberikan. Perhatikan bahwa tindakan tidak berfungsi pada entity Google SecOps. Untuk mengkueri tabel selain siem.logtrust.alert.info, buat token tambahan untuk tabel tersebut dengan mengikuti dokumen Authentication tokens yang tersedia dalam dokumentasi Devo dan tentukan di halaman konfigurasi integrasi.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Kueri String T/A Ya

Tentukan kueri yang akan dijalankan terhadap instance Devo.

Contoh: "from siem.logtrust.alert.info".

Jangka Waktu DDL

Sejam Terakhir

Nilai yang Mungkin Muncul:

  • Sejam Terakhir
  • 6 Jam Terakhir
  • 24 Jam Terakhir
  • Seminggu Terakhir
  • Sebulan Terakhir
  • Kustom
Tidak

Tentukan jangka waktu untuk hasil.

Jika "Kustom" dipilih, Anda juga harus memberikan parameter "Waktu Mulai".

Waktu Mulai String T/A Tidak

Tentukan waktu mulai untuk kueri.

Parameter ini wajib diisi jika "Kustom" dipilih untuk parameter "Rentang Waktu".

Format: ISO 8601

Contoh: 2021-08-05T05:18:42Z

Waktu Berakhir String T/A Tidak

Tentukan waktu akhir untuk kueri.

Jika tidak ada yang diberikan dan "Kustom" dipilih untuk parameter "Rentang Waktu", parameter ini akan menggunakan waktu saat ini.

Format: ISO 8601

Contoh: 2021-08-05T05:18:42Z

Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 50 Tidak Tentukan jumlah maksimum baris yang harus ditampilkan oleh tindakan.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success True/False is_success=False
Hasil JSON
{
   "msg": "",
   "timestamp": 1630483519438,
   "cid": "01a5d92a25ba",
   "status": 0,
   "object": [
       {
           "eventdate": 1619452643049,
           "alertHost": "backoffice",
           "domain": "siemplify",
           "priority": 7.0,
           "context": "my.alert.siemplify.500",
           "category": "my.context",
           "status": 0,
           "alertId": "22797077",
           "srcIp": null,
           "srcPort": null,
           "srcHost": "",
           "dstIp": null,
           "dstPort": null,
           "dstHost": "",
           "protocol": "",
           "username": "user@siemplify.co",
           "application": "",
           "engine": "pil01-pro-custom-us-aws",
           "extraData": "{\"count\":\"13\",\"eventdate\":\"2021-04-26+15%3A56%3A30.0\"}"
       }
   ]
}
Pengayaan Entity

T/A

Insight

T/A

Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika setidaknya beberapa data ditemukan (is_success=true): "Successfully retrieved results for the provided query in Devo."

Jika tidak ada hasil yang ditemukan (is_success=false): "No results found for the provided query in Devo."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error dilaporkan dalam kueri: "Error executing action "Penelusuran Lanjutan". Reason: {message}''.format(error.Stacktrace)

Jika parameter "waktu mulai" kosong dan parameter "Time Frame" ditetapkan ke "Custom" (gagal): "Error executing action "". Reason: "Start Time" should be provided, when "Custom" is selected in the "Time Frame" parameter."

Jika nilai parameter "Waktu Mulai" lebih besar dari nilai parameter "Waktu Selesai" (gagal): "Error saat menjalankan tindakan "". Alasan: "Waktu Selesai" harus lebih lambat dari "Waktu Mulai".

Jika nilai negatif atau 0 ditetapkan untuk parameter "Max Rows to Return": "Error executing action "". Reason: "Max Rows to Return" should be positive, non-zero number."

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Advanced Query". Reason: {0}''.format(error.Stacktrace)

Umum
Tabel

Nama Tabel: Advanced Query Results

Kolom Tabel:

Semua kolom yang ditampilkan dari respons.

Umum

Kueri Sederhana

Deskripsi

Menjalankan kueri sederhana berdasarkan parameter yang diberikan. Perhatikan bahwa tindakan tidak berfungsi pada entity Google SecOps. Untuk mengkueri tabel selain siem.logtrust.alert.info, buat token tambahan untuk tabel tersebut dengan mengikuti dokumen Authentication tokens yang tersedia dalam dokumentasi Devo dan tentukan di halaman konfigurasi integrasi.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Nama Tabel String siem.logtrust.alert.info Ya Tentukan tabel yang harus dikueri.
Kolom yang akan Ditampilkan CSV T/A Tidak

Tentukan kolom yang akan ditampilkan.

Jika tidak ada yang diberikan, tindakan akan menampilkan semua kolom.

Filter Where String T/A Tidak Tentukan filter Where untuk kueri yang perlu dijalankan.
Jangka Waktu DDL

Sejam Terakhir

Nilai yang Mungkin Muncul:

Sejam Terakhir

6 Jam Terakhir

24 Jam Terakhir

Seminggu Terakhir

Sebulan Terakhir

Kustom

Tidak

Tentukan jangka waktu untuk hasil.

Jika "Kustom" dipilih, Anda juga harus memberikan parameter "Waktu Mulai".

Waktu Mulai String T/A Tidak

Tentukan waktu mulai untuk kueri.

Parameter ini wajib diisi jika "Kustom" dipilih untuk parameter "Rentang Waktu".

Format: ISO 8601

Contoh: 2021-08-05T05:18:42Z

Waktu Berakhir String T/A Tidak

Tentukan waktu akhir untuk kueri.

Jika tidak ada yang diberikan dan "Kustom" dipilih untuk parameter "Rentang Waktu", parameter ini akan menggunakan waktu saat ini.

Format: ISO 8601 Contoh: 2021-08-05T05:18:42Z

Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 50 Tidak Tentukan jumlah maksimum baris yang harus ditampilkan oleh tindakan.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success True/False is_success=False
Hasil JSON
{
   "msg": "",
   "timestamp": 1630483519438,
   "cid": "01a5d92a25ba",
   "status": 0,
   "object": [
       {
           "eventdate": 1619452643049,
           "alertHost": "backoffice",
           "domain": "siemplify",
           "priority": 7.0,
           "context": "my.alert.siemplify.500",
           "category": "my.context",
           "status": 0,
           "alertId": "22797077",
           "srcIp": null,
           "srcPort": null,
           "srcHost": "",
           "dstIp": null,
           "dstPort": null,
           "dstHost": "",
           "protocol": "",
           "username": "user@siemplify.co",
           "application": "",
           "engine": "pil01-pro-custom-us-aws",
           "extraData": "{\"count\":\"13\",\"eventdate\":\"2021-04-26+15%3A56%3A30.0\"}"
       }
   ]
}
Pengayaan Entity

T/A

Insight

T/A

Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika setidaknya beberapa data ditemukan (is_success=true): "Successfully retrieved results for the query: "{constructed query}" in Devo."

Jika tidak ada hasil yang ditemukan (is_success=false): "No results found for the query {constructed query} in Devo".

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error dilaporkan dalam kueri: "Error executing action "Simple Search". Reason: {message}''.format(error.Stacktrace)

Jika parameter "waktu mulai" kosong dan parameter "Time Frame" ditetapkan ke "Custom" (gagal): "Error executing action "". Reason: "waktu mulai" should be provided, when "Custom" is selected in the "Time Frame" parameter."

Jika nilai parameter "Waktu Mulai" lebih besar dari nilai parameter "Waktu Berakhir" (gagal): "Error saat menjalankan tindakan "". Alasan: "Waktu Berakhir" harus lebih lambat dari "Waktu Mulai".

Jika nilai negatif atau 0 ditetapkan untuk parameter "Max Rows to Return": "Error executing action "". Reason: "Max Rows to Return" should be positive, non-zero number."

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Simple Query". Reason: {0}''.format(error.Stacktrace)

Umum
Tabel

Nama Tabel: Hasil Kueri Sederhana

Kolom Tabel: Semua kolom yang ditampilkan dari respons

Umum

Konektor

Devo Alerts Connector

Deskripsi

Konektor dapat digunakan untuk mengambil data pemberitahuan dari tabel siem.logtrust.alert.info dari Devo. Daftar yang diizinkan konektor dapat digunakan untuk menyerap hanya jenis pemberitahuan tertentu berdasarkan nilai konteks pemberitahuan.

Mengonfigurasi Konektor Pemberitahuan Devo di Google SecOps

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi konektor di Google SecOps, lihat Mengonfigurasi konektor.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Nama Kolom Produk String Devo Ya Masukkan nama kolom sumber untuk mengambil nama Kolom Produk.
Nama Kolom Peristiwa String "context" Ya Masukkan nama kolom sumber untuk mengambil nama Kolom Peristiwa.
Nama Kolom Lingkungan String "" Tidak

Menjelaskan nama kolom tempat nama lingkungan disimpan.

Jika kolom lingkungan tidak ditemukan, lingkungan tersebut adalah lingkungan default.

Pola Regex Lingkungan String .* Tidak

Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom "Nama Kolom Lingkungan".

Defaultnya adalah .* untuk menangkap semua dan menampilkan nilai yang tidak berubah.

Digunakan untuk mengizinkan pengguna memanipulasi kolom lingkungan melalui logika ekspresi reguler.

Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah lingkungan default.

URL API String https://apiv2-us.devo.com Ya Tentukan URL API untuk instance Devo target.
Token API Sandi T/A Tidak Jika autentikasi berbasis token digunakan, tentukan token API untuk instance Devo target.
Kunci API Sandi T/A Tidak Jika autentikasi kunci akses digunakan, tentukan kunci API untuk instance Devo target.
Rahasia API Sandi T/A Tidak Jika autentikasi kunci akses digunakan, tentukan rahasia API untuk instance Devo target.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, server Google SecOps akan memeriksa sertifikat yang dikonfigurasi untuk root API.
Waktu offset dalam jam Bilangan bulat 24 Ya Mengambil pemberitahuan dari X jam ke belakang.
Pemberitahuan Maksimum Per Siklus Bilangan bulat 30 Ya Jumlah pemberitahuan yang harus diproses selama satu operasi konektor.
Prioritas Minimum untuk Diambil String Normal Ya

Prioritas minimum pemberitahuan yang akan diserap ke Google SecOps, misalnya, Rendah atau Sedang.

Nilai yang Mungkin: Sangat Rendah, Rendah, Normal, Tinggi, Sangat Tinggi

Menggunakan daftar yang diizinkan sebagai daftar yang tidak diizinkan Kotak centang Tidak dicentang Ya Jika diaktifkan, daftar yang diizinkan akan digunakan sebagai daftar yang tidak diizinkan.

Aturan Konektor

Dukungan Proxy

Konektor mendukung Proxy.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.