Illusive Networks
Dokumen ini memberikan panduan tentang cara mengintegrasikan Illusive Networks dengan Google SecOps.
Kasus Penggunaan Produk
- Melakukan tindakan aktif - menjalankan pemindaian forensik, memperkaya entity, menambahkan/menghapus pengguna/server penipuan.
- Menyerap Insiden ke Siemplify.
Mengonfigurasi integrasi Illusive Networks di Google Security Operations
Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.
Parameter integrasi
Gunakan parameter berikut untuk mengonfigurasi integrasi:
| Parameter Display Name | Jenis | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|---|
| Root API | String | http://x.x.x.x | Ya | Root API instance Illusive Networks. |
| Kunci API | Sandi | T/A | Ya | Kunci API Illusive Networks. |
| File Sertifikat CA | String | Salah | File sertifikat CA berenkode Base 64. | |
| Verifikasi SSL | Kotak centang | Dicentang | Ya | Jika diaktifkan, verifikasi bahwa sertifikat SSL untuk koneksi ke server Illusive Networks valid. |
Cara membuat Kunci API
- Buka bagian "Settings" di Illusive Networks Console
- Di bagian "General", scroll ke bawah ke bagian "kunci API".
- Tekan tombol "Add Key".
- Sebaiknya tambahkan semua izin ke Kunci API.
- Dari string yang diberikan, Anda perlu menyalin semuanya kecuali string "Basic".
- Masukkan nilai tersebut ke dalam parameter "API Key" integrasi Google SecOps.
Cara memperbarui pembatasan kapasitas
Ada batas kapasitas untuk endpoint tertentu di Illusive Networks. Untuk
konektor, batasnya harus cukup tinggi, sehingga semua
insiden dapat diserap. Untuk memperbarui pembatasan kapasitas, Anda harus login
ke server pengelolaan dan membuka: C:\Program
Files\illusive-Management-Server-3.1.XXX.XXXX\conf\general.properties.txt
Dalam file, cari properti berikut:
- api.incident.rate.limit.maximum.num.requests
- api.rate.limit.windows.duration.minutes
Sebaiknya penyiapan dilakukan sebagai berikut:
- api.incident.rate.limit.maximum.num.requests=100
- api.rate.limit.windows.duration.minutes=1
- api.monitoring.rate.limit.maximum.num.requests = 100
- api.forensics.rate.limit.maximum.num.requests = 100
Tindakan
Ping
Deskripsi
Uji konektivitas ke Illusive Networks dengan parameter yang disediakan di halaman konfigurasi integrasi di halaman Google SecOps Content Hub.
Parameter
T/A
Dijalankan Pada
Tindakan ini tidak berjalan di entity.
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | jika berhasil: "Successfully connected to the Illusive Networks server with the provided connection parameters!" Tidak berhasil: (gagal) - Failed to connect to the Illusive Networks server! Error is {0}".format(exception.stacktrace) |
Umum |
Memperkaya Entity
Deskripsi
Memperkaya entity menggunakan informasi dari Illusive Networks. Entity yang didukung: Nama host.
Parameter
| Parameter Display Name | Jenis | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|---|
| T/A |
Dijalankan Pada
Tindakan ini berjalan di entity Host.
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Hasil JSON
{
"machineId": "00428a29-0343-4e13-aa97-3b624739c509",
"machineName": "HELLO",
"isHealthy": false,
"lastDeploymentMethodType": "WMI",
"distinguishedName": "CN=HELLO,CN=Computers,dc=iln,dc=local",
"groupName": null,
"sourceDiscoveryName": "iln.local",
"collectData": true,
"policyName": null,
"assignmentStatus": "ANALYSIS",
"operatingSystemType": "Windows",
"operatingSystemName": "Windows Server 2016 Standard Evaluation",
"operatingSystemVersion": "10.0 (14393)",
"agentVersion": null,
"bitness": null,
"loggedInUserName": null,
"lastLogonTime": 1613078764501,
"succeededDeceptionFamilies": 0,
"shouldBeUninstalledDeceptionFamilies": 0,
"desiredDeceptionFamilies": 0,
"deceptionFamiliesPercentages": null,
"lastExecutionType": "AGENT",
"machineLastExecutionPhaseType": "CONNECTION",
"machineLastExecutionPhaseStatus": "FAILURE",
"machineLastExecutionPhaseErrorMessage": "Unreachable - no ping",
"mitigationStatusType": null,
"machineExecutionUnifiedStatus": "FAILURE_CONNECTION",
"machineLastExecutionPhaseFinishDate": "2021-02-12T10:17:30.623Z",
"endpointTrapHealthCheckHostStatus": "NotTested",
"endpointTrapHealthCheckHostStatusLastUpdated": null,
"failedDeceptionFamilies": 0,
"inProgressDeceptionFamilies": 0,
"notDeployedDeceptionFamilies": 0,
"policyId": null,
"ghost": false
}
Pengayaan Entity
| Nama Kolom Pengayaan | Logika - Kapan harus diterapkan |
|---|---|
| ILLNET_machineName | Jika tersedia di JSON (Info Host) |
| ILLNET_isHealthy | Jika tersedia di JSON (Info Host) |
| ILLNET_host | Jika tersedia di JSON (Info Host) |
| ILLNET_distinguishedName | Jika tersedia di JSON (Info Host) |
| ILLNET_sourceDiscoveryName | Jika tersedia di JSON (Info Host) |
| ILLNET_policyName | Jika tersedia di JSON (Info Host) |
| ILLNET_operatingSystemName | Jika tersedia di JSON (Info Host) |
| ILLNET_agentVersion | Jika tersedia di JSON (Info Host) |
| ILLNET_loggedInUserName | Jika tersedia di JSON (Info Host) |
| ILLNET_machineExecutionUnifiedStatus | Jika tersedia di JSON (Info Host) |
| ILLNET_bitness | Jika tersedia di JSON (Info Host) |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika data tidak tersedia untuk setidaknya satu entitas (is_success = true): "Action wasn't able to enrich the following entities using Illusive Networks: \n {entity.identifier}". if data not available for all (is_success = false): "No entities were enriched". Tindakan akan gagal dan menghentikan eksekusi playbook: Jika kode status 429: "Error executing action "Enrich Entities". Alasan: Error pembatasan kapasitas. Lihat dokumentasi tentang cara meningkatkan batas kapasitas". |
Umum |
| Tabel Repositori Kasus | Name: {entity.identifier} Hanya akan ada 2 kolom: Kunci dan Nilai. |
Entity |
Menjalankan Pemindaian Forensik
Deskripsi
Menjalankan pemindaian forensik pada endpoint di Illusive Networks. Berfungsi dengan entity IP dan Nama Host.
Parameter
| Parameter Display Name | Jenis | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|---|
| Sertakan Informasi Sistem | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi sistem. |
| Menyertakan Informasi File Prefetch | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang file pengambilan data. |
| Sertakan Informasi Tambah-Hapus Program | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang program tambah-hapus. |
| Sertakan Informasi Proses Startup | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang proses startup. |
| Sertakan Informasi Proses yang Berjalan | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang proses yang berjalan. |
| Sertakan Informasi Program Bantuan Pengguna | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang program bantuan pengguna. |
| Menyertakan Informasi Histori Powershell | Kotak centang | Dicentang | Ya | Jika diaktifkan, tindakan akan menampilkan informasi tentang histori PowerShell. |
Jumlah Maksimum Item yang Akan Ditampilkan |
Bilangan bulat | 50 | Tidak | Tentukan jumlah item yang akan ditampilkan. Jika tidak ada yang diberikan, tindakan akan menampilkan semuanya. |
Dijalankan Pada
Tindakan ini berjalan di entity berikut:
- Alamat IP
- Host
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Hasil JSON
{
"Entity.identifier": {
"host_info": "{Host_info part}",
"prefetch_info": "{prefetch_info}",
"installed_programs_info": "{installed_programs_info}",
"startup_processes": "{startup_processes}",
"running_processes": "{running_processes}",
"user_assist_info": "{user_assist_info}",
"powershell_history": "{powershell history}"
}
}
Pengayaan Entity
| Nama Kolom Pengayaan | Logika - Kapan harus diterapkan |
|---|---|
| ILLNET_osName | Jika tersedia di JSON (Info Host) |
| ILLNET_machineType | Jika tersedia di JSON (Info Host) |
| ILLNET_host | Jika tersedia di JSON (Info Host) |
| ILLNET_loggedInUser | Jika tersedia di JSON (Info Host) |
| ILLNET_userProfiles | Jika tersedia di JSON (Info Host) |
| ILLNET_operatingSystemType | Jika tersedia di JSON (Info Host) |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika tidak berhasil untuk setidaknya satu: "Action wasn't able to get any information from forensic scan on the following endpoints: {entity.identifier}" Jika tidak ada keberhasilan untuk semua: "No forensic information was found on the provided endpoints." Pesan asinkron: "Memulai pemindaian forensik di endpoint berikut: {entity identifier}. \n Selesai melakukan pemindaian forensik di endpoint berikut." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika tidak ada parameter "include ..." yang diaktifkan: "Error executing action "Run Forensic Scan". Alasan: Anda harus mengaktifkan setidaknya salah satu parameter "Sertakan ..."" |
Umum |
| Info Host Tabel Repositori Kasus | Name: {entity.identifier} Hanya akan ada 2 kolom: Kunci dan Nilai. |
Entity |
| Prefetch_Info Tabel Repositori Kasus | Name: "{entity.identifier}: Prefetch Files Information" Kolom: Nama File Waktu Eksekusi Terakhir Waktu Modifikasi File Nama File Pengambilan Data di Awal |
Umum |
Tabel Repositori Kasus INSTALLED_PROGRAMS_INFO |
Nama: "{entity.identifier}: Add-Remove Programs Information" Kolom: Nama Tampilan Nama File |
Umum |
Tabel Repositori Kasus STARTUP_PROCESSES |
Name: "{entity.identifier}: Startup Processes" Kolom: Nama Perintah Lokasi Pengguna |
Umum |
Tabel Repositori Kasus RUNNING_PROCESSES |
Name: "{entity.identifier}: Running Processes" Kolom: Pengguna Hak Istimewa Admin Perintah ID proses Nama Proses Waktu Mulai |
Umum |
Tabel Repositori Kasus USER_ASSIST_INFO |
Nama: "{entity.identifier}: Informasi Program Bantuan Pengguna" Kolom: Nama File Nama pengguna Tanggal Terakhir Digunakan |
**** |
Tabel Repositori Kasus POWER_SHELL_HISTORY |
Name: "{entity.identifier}: Powershell History" Kolom: Nama pengguna Perintah |
Mencantumkan Item Penipuan
Deskripsi
Mencantumkan item penipuan yang tersedia di Illusive Networks.
Parameter
| Parameter Display Name | Jenis | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|---|
| Jenis Penipuan | DDL | Semua Nilai yang Mungkin Muncul: Semua Khusus Pengguna Hanya Server |
Ya | Tentukan jenis item yang menipu yang harus ditampilkan. |
| Status Menipu | DDL | Semua Nilai yang Mungkin Muncul: Semua Hanya Disetujui, Hanya Disarankan |
Ya | Tentukan jenis item yang menipu yang harus ditampilkan berdasarkan status. |
| Jumlah Item Maksimum yang Akan Ditampilkan | Bilangan bulat | 50 | Tidak | Tentukan jumlah item yang akan ditampilkan. Default: 50. Jika tidak ada yang ditentukan, tindakan akan menampilkan semua item. |
Dijalankan Pada
Tindakan ini tidak berjalan di entity.
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Hasil JSON
{
"users": [
{
"username": "backupad",
"password": "5437niwY",
"domainName": "intw-lab.local",
"policyNames": [
"Full Protection"
],
"adUser": false,
"activeUser": false,
"deceptiveState": "APPROVED"
},
{
"username": "jvillar",
"password": "ritA1102",
"domainName": "intw-lab.local",
"policyNames": [],
"adUser": true,
"activeUser": false,
"deceptiveState": "SUGGESTED"
},
{
"username": "gaccess.user",
"password": "psUiS01",
"domainName": "intw-lab.local",
"policyNames": [],
"adUser": true,
"activeUser": false,
"deceptiveState": "SUGGESTED"
},
{
"username": "service.user",
"password": "mAkaYe4",
"domainName": "intw-lab.local",
"policyNames": [],
"adUser": true,
"activeUser": false,
"deceptiveState": "SUGGESTED"
}
],
"servers": [
{
"host": "10.0.0.2",
"serviceTypes": [
"DB"
],
"policyNames": [
"Full Protection"
],
"adHost": false,
"deceptiveState": "APPROVED"
},
{
"host": "10.0.0.1",
"serviceTypes": [
"DB"
],
"policyNames": [
"Full Protection"
],
"adHost": false,
"deceptiveState": "APPROVED"
}
]
}
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika 200 dan tidak ada data yang tersedia (is_success=false) "No data was found regarding deceptive items based on the provided criteria in Illusive Networks." Tindakan akan gagal dan menghentikan eksekusi playbook: |
Umum |
| Tabel Repositori Kasus | Nama: "Pengguna Penipu" Kolom: Nama pengguna Sandi Domain Kebijakan Pengguna AD Aktif Negara bagian/Provinsi |
Umum |
| Tabel Repositori Kasus | Nama: "Server Penipu" Kolom: Host Layanan Kebijakan Server AD Negara bagian/Provinsi |
Umum |
Menambahkan Pengguna Penipu
Deskripsi
Tambahkan pengguna penipu di Illusive Networks.
Parameter
| Nama | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|
| Nama pengguna | T/A | Ya | Tentukan nama pengguna untuk pengguna penipu baru. |
| Sandi | T/A | Ya | Tentukan sandi untuk pengguna penipu baru. |
| Domain DNS | T/A | Tidak | Tentukan nama domain untuk pengguna penipu baru. |
| Nama Kebijakan | T/A | Tidak | Tentukan daftar kebijakan yang dipisahkan koma yang perlu diterapkan ke pengguna penipu baru. Jika tidak ada yang diberikan, tindakan akan menggunakan semua kebijakan secara default. |
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Success (is_success=true) → Successfully added deceptive user in Illusive networks. Kasus 1. Pengguna Sudah Ada (gagal) - Error saat menjalankan tindakan "{action name}". Alasan: Pengguna yang menipu "{username}" sudah ada. Kasus 2. Kode status 400 (gagal) - Error saat menjalankan tindakan "{action name}". Alasan: {error message}. Kasus 3. Error Umum (gagal) - Terjadi error saat menjalankan tindakan "{action name}". Alasan: {error traceback}. |
Umum |
Menghapus Pengguna Penipu
Deskripsi
Menghapus pengguna yang menipu dari Illusive Networks.
Parameter
| Nama | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|
| Nama pengguna | T/A | Ya | Tentukan nama pengguna dari pengguna yang menipu yang perlu dihapus. |
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Berhasil → Berhasil menghapus pengguna penipu di jaringan Illusive. Kasus 1. Pengguna tidak ada (is_success=false) - Tindakan tidak dapat menghapus pengguna yang menipu "{username}". Alasan: Pengguna yang menipu "{username}" tidak ada. Kasus 2. Error Umum (gagal) - Terjadi error saat menjalankan tindakan "{action name}". Alasan: {error traceback}. |
Umum |
Menambahkan Server Penipuan
Deskripsi
Tambahkan server penipu di Illusive Networks.
Parameter
| Nama | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|
| Nama Server | T/A | Ya | Tentukan nama untuk server penipuan baru. |
| Jenis Layanan | DB | Ya | Tentukan daftar jenis layanan yang dipisahkan koma untuk server penipu baru. |
| Nama Kebijakan | Tidak | Tentukan daftar kebijakan yang dipisahkan koma yang perlu diterapkan ke server penipu baru. Jika tidak ada yang diberikan, tindakan akan menggunakan semua kebijakan secara default. |
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Berhasil (is_success=true) → Successfully added deceptive server in Illusive networks. Kasus 1. Server Sudah Ada (gagal) - Terjadi error saat menjalankan tindakan "{action name}". Alasan: Server penipu "{server name}" sudah ada. Kasus 2. Status 400 (gagal) - Terjadi error saat menjalankan tindakan "{action name}". Alasan: {error message}. Kasus 3. Error Umum - Terjadi error saat menjalankan tindakan "{action name}". Alasan: {error traceback}. |
Umum |
Menghapus Server Penipuan
Deskripsi
Menghapus server penipu dari Illusive Networks.
Parameter
| Nama | Nilai Default | Is Mandatory | Deskripsi |
|---|---|---|---|
| Nama Server | T/A | Ya | Tentukan nama server penipu yang perlu dihapus. |
Hasil Tindakan
Hasil Skrip
| Nama Hasil Skrip | Opsi Nilai |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Repositori Kasus
| Jenis Hasil | Nilai / Deskripsi | Jenis |
|---|---|---|
| Pesan output* | Berhasil → Berhasil menghapus server penipuan di jaringan Illusive. Kasus 1. Server tidak ada (is_success=false) - Tindakan tidak dapat menghapus server penipuan "{server name}". Alasan: Server penipu "{server name}" tidak ada. Kasus 2. Error Umum - Terjadi error saat menjalankan tindakan "{action name}". Alasan: {error traceback}. |
Umum |
Konektor
Illusive Networks - Incidents Connector
Deskripsi
Tarik insiden dengan linimasa forensik terkait dari Illusive Networks.
Mengonfigurasi Illusive Networks - Incidents Connector 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 | Type> | Nilai Default | Wajib Diisi | Deskripsi |
|---|---|---|---|---|
| Nama Kolom Produk | String | Nama Produk | Ya | Masukkan nama kolom sumber untuk mengambil nama Kolom Produk. |
| Nama Kolom Peristiwa | String | details_serviceType | 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. |
| Waktu Tunggu Skrip (Detik) | Bilangan bulat | 180 | Ya | Batas waktu tunggu untuk proses python yang menjalankan skrip saat ini. |
| Root API | String | http://x.x.x.x | Ya | Root API instance Illusive Networks. |
| Kunci API | String | T/A | Ya | Kunci API Illusive Networks. Catatan: string "Basic" tidak boleh menjadi bagian dari nilai. |
| Tingkat Keparahan Pemberitahuan | String | Sedang | Ya | Tingkat keparahan pemberitahuan Google SecOps yang akan dibuat berdasarkan insiden dari Illusive Networks. Nilai yang memungkinkan: Informatif Rendah Sedang Tinggi Kritis |
| Jam Maksimum Mundur | Bilangan bulat | 1 | Tidak | Jumlah jam dari tempat pengambilan insiden. |
| Insiden Maksimum yang Akan Diambil | Bilangan bulat | 10 | Tidak | Jumlah insiden yang akan diproses per satu iterasi konektor. Jumlah maksimum adalah 1000. |
| Menggunakan daftar yang diizinkan sebagai daftar yang tidak diizinkan | Kotak centang | Dicentang | Ya | Jika diaktifkan, daftar yang diizinkan akan digunakan sebagai daftar yang tidak diizinkan. |
| Verifikasi SSL | Kotak centang | Tidak dicentang | Ya | Jika diaktifkan, pastikan sertifikat SSL untuk koneksi ke server Illusive Networks valid. |
| File Sertifikat CA | String | T/A | Tidak | File sertifikat CA berenkode Base 64. |
| Alamat Server Proxy | String | T/A | Tidak | Alamat server proxy yang akan digunakan. |
| Nama Pengguna Proxy | String | T/A | Tidak | Nama pengguna proxy untuk melakukan autentikasi. |
| Sandi Proxy | Sandi | T/A | Tidak | Sandi proxy untuk autentikasi. |
Aturan Konektor
Dukungan Proxy
Konektor mendukung proxy.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.