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:
- Buka dokumen Token autentikasi yang tersedia dalam dokumentasi Devo.
- Ikuti langkah-langkah tentang cara membuat token, pada langkah 3 pilih Query data using REST API.
- 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
- Devo dapat digunakan sebagai sumber pemberitahuan untuk diproses oleh Google SecOps.
- 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:
|
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.