Cisco Orbital

Dokumen ini menjelaskan cara mengintegrasikan Cisco Orbital dengan Google Security Operations.

Kasus Penggunaan

Melakukan tindakan aktif - menjalankan kueri SQL untuk mendapatkan informasi selengkapnya tentang endpoint.

Mengonfigurasi Integrasi Cisco Orbital agar berfungsi dengan Google Security Operations

Izin Produk

Untuk melakukan autentikasi, Anda perlu membuat token dan menggunakan token ini dalam permintaan API.

Cara membuat Client ID dan Client Secret

Untuk membuat Client ID dan Rahasia Klien, Anda harus melakukan langkah-langkah berikut:

  1. Login ke Cisco Orbital.
  2. Buka setelan akun, lalu klik Create API Credentials.
  3. Isi kolom.
  4. Salin Client ID dan Rahasia Klien.

Mengonfigurasi integrasi Cisco Orbital 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
Nama Instance String T/A Tidak Nama Instance yang ingin Anda konfigurasi integrasinya.
Deskripsi String T/A Tidak Deskripsi Instance.
Client ID String T/A Ya Client ID akun Cisco Orbital.
Rahasia Klien Sandi T/A Ya Rahasia Klien akun Cisco Orbital.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, setelan ini akan memverifikasi bahwa sertifikat SSL untuk koneksi ke server Cisco Orbital valid.
Menjalankan dari Jarak Jauh Kotak centang Tidak dicentang Tidak Centang kolom untuk menjalankan integrasi yang dikonfigurasi dari jarak jauh. Setelah dicentang, opsi akan muncul untuk memilih pengguna jarak jauh (agen).

Tindakan

Ping

Deskripsi

Uji konektivitas ke Cisco Orbital 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, dan tidak memiliki parameter input wajib.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil: "Successfully connected to the Cisco Orbital server with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

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

Umum

Menjalankan Kueri

Deskripsi

Menjalankan kueri di endpoint berdasarkan entitas IP dan Nama Host di Cisco Orbital.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Kueri String T/A Ya Tentukan kueri yang perlu dijalankan.
Nama String T/A Tidak Tentukan nama untuk tugas kueri. Jika tidak ada yang ditentukan, tindakan akan menggunakan nama dalam format berikut: PRODUCT_NAME-GUID
Kolom Konteks Kustom String T/A Tidak Tentukan kolom konteks kustom tambahan yang harus ditambahkan ke tugas. Format: key_1:value_1,key_2:value_1.
Jumlah Hasil Maksimum yang Akan Ditampilkan Bilangan bulat 100 Tidak Tentukan jumlah hasil yang harus ditampilkan.
Sembunyikan Tabel Repositori Kasus Kotak centang T/A Tidak Jika diaktifkan, tindakan tidak akan menyiapkan tabel repositori kasus.
Waktu habis Bilangan bulat 1 Tidak Tentukan berapa menit untuk menunggu hasil sebelum menyelesaikan eksekusi tindakan. Maksimum: 5 menit. Default: 1 menit.

Dijalankan Pada

Tindakan ini berjalan di entity berikut:

  • Alamat IP
  • Host

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "results": [
        {
            "node": "eXHZw6pLMxepKQtf9B8VTQ",
            "osQuery": [
                {
                    "sql": "SELECT name,pid FROM processes;"
                }
            ],
            "osQueryResult": [
                {
                    "types": [
                        "",
                        ""
                    ],
                    "columns": [
                        "name",
                        "pid"
                    ],
                    "values": [
                        "[System Process]",
                        "0",
                        "System",
                        "4",
                        "Registry",
                        "88",
                        "smss.exe",
                        "516",
                        "csrss.exe",
                        "596",
                        "wininit.exe",
                        "672",
                        "csrss.exe",
                        "680",
                        "winlogon.exe",
                        "724",
                        "services.exe",
                        "796",
                        "lsass.exe",
                        "804",
                        "svchost.exe",
                        "916",
                        "fontdrvhost.exe",
                        "936",
                        "svchost.exe",
                        "944",
                        "svchost.exe",
                        "1020",
                        "svchost.exe",
                        "296",
                        "fontdrvhost.exe",
                        "560",
                        "dwm.exe",
                        "1048",
                        "svchost.exe",
                        "1136",
                        "svchost.exe",
                        "1144",
                        "svchost.exe",
                        "1192",
                        "svchost.exe",
                        "1256",
                        "svchost.exe",
                        "1280",
                        "svchost.exe",
                        "1372",
                        "svchost.exe",
                        "1392",
                        "svchost.exe",
                        "1488",
                        "svchost.exe",
                        "1504",
                        "svchost.exe",
                        "1552",
                        "svchost.exe",
                        "1604",
                        "svchost.exe",
                        "1716",
                        "svchost.exe",
                        "1724",
                        "svchost.exe",
                        "1804",
                        "svchost.exe",
                        "1812",
                        "svchost.exe",
                        "1964"
                    ],
                    "error": "",
                    "secs": 0.06800670176744461,
                    "label": "",
                    "name": ""
                }
            ],
            "error": {
                "en": ""
            },
            "hostinfo": {
                "osinfo": {
                    "os": "windows",
                    "osname": "Windows 10 Enterprise Evaluation",
                    "release": "6.3",
                    "version": "10.0.18363",
                    "arch": "amd64"
                },
                "hostname": "TIP-HW-HOST-034",
                "interfaces": {
                    "Ethernet0": {
                        "name": "Ethernet0",
                        "mac": "00:50:56:a2:05:8b",
                        "ipv4": "172.30.202.128/24",
                        "ipv6": "fe80::983:e8ed:c392:3e3e/64",
                        "active": true
                    }
                },
                "external": {
                    "name": "",
                    "mac": "",
                    "ipv4": "185.180.102.139",
                    "active": true
                },
                "updated": "2020-10-12T12:03:30.1329732Z",
                "version": "v1.7.6"
            },
            "rowcount": 149,
            "context": {
                "description": "front desk",
                "lol": "kek",
                "value": "anything\"}"
            }
        },
        {
            "node": "oHNPQUeWwK1ql3R2J13GSw",
            "osQuery": [
                {
                    "sql": "SELECT name,pid FROM processes;"
                }
            ],
            "osQueryResult": [
                {
                    "types": [
                        "",
                        ""
                    ],
                    "columns": [
                        "name",
                        "pid"
                    ],
                    "values": [
                        "[System Process]",
                        "0",
                        "System",
                        "4",
                        "Registry",
                        "88",
                        "smss.exe",
                        "360",
                        "csrss.exe",
                        "440",
                        "wininit.exe",
                        "520",
                        "csrss.exe",
                        "536",
                        "winlogon.exe",
                        "616",
                        "services.exe",
                        "656",
                        "lsass.exe",
                        "664",
                        "svchost.exe",
                        "772",
                        "fontdrvhost.exe",
                        "784",
                        "fontdrvhost.exe",
                        "792",
                        "svchost.exe",
                        "864",
                        "svchost.exe",
                        "6852",
                        "SystemSettings.exe",
                        "7864",
                        "YourPhone.exe",
                        "5160",
                        "RuntimeBroker.exe",
                        "516",
                        "dllhost.exe",
                        "1496"
                    ],
                    "error": "",
                    "secs": 0.025061199441552162,
                    "label": "",
                    "name": ""
                }
            ],
            "error": {
                "en": ""
            },
            "hostinfo": {
                "osinfo": {
                    "os": "windows",
                    "osname": "Windows 10 Enterprise Evaluation",
                    "release": "6.3",
                    "version": "10.0.18363",
                    "arch": "amd64"
                },
                "hostname": "TIP-HW-HOST-033",
                "fqdn": {
                    "127.0.0.1": "www.virustotal.com"
                },
                "interfaces": {
                    "Ethernet0": {
                        "name": "Ethernet0",
                        "mac": "00:50:56:a2:66:8a",
                        "ipv4": "172.30.202.127/24",
                        "ipv6": "fe80::84:5a0f:7973:63/64",
                        "active": true
                    }
                },
                "external": {
                    "name": "",
                    "mac": "",
                    "ipv4": "185.180.102.139",
                    "active": true
                },
                "updated": "2020-10-07T00:11:31.0951018Z",
                "version": "v1.7.6"
            },
            "rowcount": 132,
            "context": {
                "description": "front desk",
                "lol": "kek",
                "value": "anything\"}"
            }
        }
    ],
    "error": {
        "en": ""
    },
    "next": ""
}
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output\*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kueri SQL dijalankan tanpa error di salah satu entitas (is_success=true): "Successfully executed query and retrieved results from Cisco Orbital on the following entities:\n".format(entity.identifier)

Jika kueri SQL tidak dijalankan di beberapa entitas (is_success=true): "Action wasn't able to successfully execute query and retrieve results from Cisco Orbital on the following entities:\n".format(entity.identifier)

Jika kode status 400 dilaporkan dalam respons pertama (is_success=false): "Action wasn't able to execute queries in Cisco Orbital. Reason: {0}".format(comma-separated list of errors)

Jika semua hasil mengalami error: "Action wasn't able to execute queries on all provided entities in Cisco Orbital. Alasan: error dalam kueri."

Pesan Asinkron: "Kueri Dikirim. Menunggu hasil hingga waktu tunggu habis."

Tindakan akan gagal dan menghentikan eksekusi playbook:

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

Jika parameter "Waktu tunggu" tidak berada dalam rentang 1-5: "Nilai waktu tunggu harus berada dalam rentang dari 1 hingga 5".

Umum

Tabel Repositori Kasus

Untuk setiap hasil yang tidak memiliki error

Jika jenis entitas adalah nama host:

Nama Tabel: "Results for {0}".format(entity.identifier)

Jika jenis entitas lainnya:

Nama Tabel: "Results for {0} ({1})".format(entity.identifier, hostinfo/hostname)

Semua kolom dari respons akan digunakan sebagai kolom tabel.

Umum

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