Illusive Networks

Dokumen ini memberikan panduan tentang cara mengintegrasikan Illusive Networks dengan Google SecOps.

Kasus Penggunaan Produk

  1. Melakukan tindakan aktif - menjalankan pemindaian forensik, memperkaya entity, menambahkan/menghapus pengguna/server penipuan.
  2. 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.
Catatan: string "Basic" tidak boleh menjadi bagian dari nilai.

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

  1. Buka bagian "Settings" di Illusive Networks Console
  2. Di bagian "General", scroll ke bawah ke bagian "kunci API".
  3. Tekan tombol "Add Key".
  4. Sebaiknya tambahkan semua izin ke Kunci API.
  5. Dari string yang diberikan, Anda perlu menyalin semuanya kecuali string "Basic".
  6. 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 tersedia untuk setidaknya satu (is_success = true): "Successfully enriched the following entities using Illusive Networks: \n {entity.identifier}".

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 terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)

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 berhasil dijalankan untuk setidaknya satu (is_success = true): "Successfully ran forensic scan on the following endpoints in Illusive Networks: {entity.identifier}"

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 terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Run Forensic Scan". Reason: {0}''.format(error.Stacktrace)

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 data tersedia (is_success = true): "Successfully returned available deceptive items from Illusive Networks".

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:
jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "List Deceptive Items". Reason: {0}''.format(error.Stacktrace)

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.