Mengumpulkan data CMDB ServiceNow
Dokumen ini menjelaskan cara mengumpulkan data CMDB ServiceNow dengan menyiapkan feed Google Security Operations menggunakan API pihak ketiga.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Akses istimewa ke instance ServiceNow dengan akses konsol admin
- Akun pengguna ServiceNow dengan peran
cmdb_read(persyaratan minimum untuk akses baca) - REST API diaktifkan di instance ServiceNow Anda (diaktifkan secara default)
Mengonfigurasi daftar IP yang diizinkan
Sebelum membuat feed, Anda harus mengizinkan rentang IP Google SecOps di setelan jaringan atau firewall ServiceNow.
Mendapatkan rentang IP Google SecOps
- Ambil rentang IP dari file JSON rentang alamat IP Google.
Menambahkan rentang IP ke ServiceNow
- Login ke instance ServiceNow Anda sebagai administrator.
- Buka All > System Security > IP Address Access Control.
- Klik New.
- Berikan detail konfigurasi berikut:
- Type: Pilih Allow.
- Alamat IP: Masukkan satu rentang IP Google SecOps dalam notasi CIDR (misalnya,
192.0.2.0/24). - Name: Masukkan nama deskriptif (misalnya,
GGoogle SecOps IP Range 1). - Active: Centang kotak untuk mengaktifkan aturan.
- Klik Kirim.
- Ulangi langkah 3-5 untuk setiap rentang IP Google SecOps tambahan.
Mengonfigurasi akses API ServiceNow
Agar Google SecOps dapat mengambil data CMDB, Anda perlu membuat pengguna ServiceNow dengan izin yang sesuai.
Membuat pengguna integrasi khusus (direkomendasikan)
- Login ke ServiceNow Admin Console.
- Buka All > User Administration > Users.
- Klik New.
- Berikan detail konfigurasi berikut:
- User ID: Masukkan nama pengguna deskriptif (misalnya,
google_secops_integration). - Nama depan: Masukkan
Google. - Nama belakang: Masukkan
SecOps Integration. - Email: Masukkan alamat email yang valid untuk notifikasi.
- Sandi: Klik Setel Sandi dan buat sandi yang kuat.
- Active: Centang kotak.
- Web service access only: Centang kotak (direkomendasikan untuk akses khusus API).
- User ID: Masukkan nama pengguna deskriptif (misalnya,
- Klik Kirim.
Menetapkan izin yang diperlukan
- Setelah membuat pengguna, buka data pengguna.
- Buka bagian Roles.
- Klik Edit.
- Dalam daftar Collection, telusuri dan tambahkan peran berikut:
- cmdb_read: Memberikan akses baca ke tabel CMDB.
- Klik Simpan.
Mencatat kredensial API
Setelah membuat pengguna, catat kredensial berikut:
- Nama pengguna: ID Pengguna yang Anda buat (misalnya,
google_secops_integration) - Sandi: Sandi yang Anda tetapkan untuk pengguna
- Nama Host API: FQDN instance ServiceNow Anda (misalnya,
myinstance.servicenow.com)- Jangan sertakan
https://atau jalur apa pun. - Jangan sertakan garis miring di akhir.
- Jangan sertakan
- Nama Tabel: Tabel CMDB yang akan dikueri (misalnya,
cmdb_ci,cmdb_ci_server,cmdb_ci_computer)
Memahami tabel CMDB ServiceNow
CMDB ServiceNow diatur dalam struktur tabel hierarkis. Tabel yang paling umum untuk penyerapan data aset meliputi:
| Nama Tabel | Deskripsi | Kasus Penggunaan |
|---|---|---|
cmdb_ci |
Tabel Base Configuration Item (induk dari semua tabel CI) | Semua item konfigurasi |
cmdb_ci_server |
Item konfigurasi server | Server fisik dan virtual |
cmdb_ci_computer |
Item konfigurasi komputer | Workstation, laptop, desktop |
cmdb_ci_linux_server |
Item konfigurasi server Linux | Server Linux secara khusus |
cmdb_ci_win_server |
Item konfigurasi server Windows | Server Windows secara khusus |
cmdb_ci_vm_instance |
Instance virtual machine | Virtual machine |
cmdb_ci_network_adapter |
Adaptor jaringan | Kartu antarmuka jaringan |
cmdb_ci_ip_address |
Alamat IP | Data alamat IP |
cmdb_ci_service |
Layanan bisnis | Item katalog layanan |
cmdb_ci_appl |
Aplikasi | Item konfigurasi aplikasi |
Memverifikasi akses REST API
Sebelum membuat feed, pastikan kredensial ServiceNow API Anda berfungsi dengan benar.
Menguji menggunakan REST API Explorer (opsional)
- Login ke instance ServiceNow Anda sebagai pengguna integrasi.
- Buka All > System Web Services > REST > REST API Explorer.
- Pilih Table API dari drop-down namespace.
- Pilih Retrieve records from a table (GET).
- Di Parameter Jalur, masukkan nama tabel (misalnya,
cmdb_ci). - Klik Kirim.
- Pastikan status responsnya adalah 200 OK dan data ditampilkan.
Menguji menggunakan curl (opsional)
Atau, uji API menggunakan curl:
curl "https://your-instance.service-now.com/api/now/table/cmdb_ci?sysparm_limit=10" \ --request GET \ --header "Accept: application/json" \ --user 'your-username':'your-password'- Ganti:
your-instance.service-now.com: Nama host instance ServiceNow Andayour-username: Nama pengguna integrasi Andayour-password: Sandi pengguna integrasi Anda
- Ganti:
Respons yang berhasil akan menampilkan data JSON dengan item konfigurasi.
Menyiapkan feed
Untuk mengonfigurasi feed, ikuti langkah-langkah berikut:
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik Tambahkan Feed Berita Baru.
- Di halaman berikutnya, klik Konfigurasi satu feed.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
ServiceNow CMDB - All CIsatauServiceNow CMDB - Servers). - Pilih API pihak ketiga sebagai Jenis sumber.
- Pilih ServiceNow CMDB sebagai Log type.
- Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
- Username: Masukkan ID pengguna ServiceNow (misalnya,
google_secops_integration). - Secret: Masukkan sandi pengguna ServiceNow. Penting: Kolom ini bersifat sensitif. Sandi dienkripsi dan tidak dapat dilihat setelah disimpan.
- Nama Host API: Masukkan nama domain yang sepenuhnya memenuhi syarat untuk instance ServiceNow Anda.
- Contoh:
myinstance.servicenow.com - Jangan sertakan:
- Protokol (
https://) - Jalur (
/api/now/table/) - Garis miring di akhir
- Protokol (
- Contoh:
- Instance regional: Jika instance ServiceNow Anda berada di region tertentu, gunakan format nama host yang benar:
- Standar:
instance.service-now.com - Uni Eropa:
instance.service-now.eu - Region lain: Verifikasi dengan administrator ServiceNow Anda
- Standar:
- Table Name: Masukkan tabel CMDB ServiceNow yang akan dikueri.
- Contoh:
cmdb_ci(semua item konfigurasi)cmdb_ci_server(semua server)cmdb_ci_computer(workstation dan komputer)cmdb_ci_linux_server(Khusus server Linux)cmdb_ci_win_server(Khusus server Windows) Catatan: Nama tabel peka huruf besar/kecil dan harus sama persis. Anda hanya dapat mengkueri satu tabel per feed. Untuk menyerap beberapa tabel, buat feed terpisah untuk setiap tabel.
- Contoh:
- Namespace aset: Namespace aset.
- Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini.
- Username: Masukkan ID pengguna ServiceNow (misalnya,
Klik Berikutnya.
Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Setelah penyiapan, feed akan mulai mengambil data CMDB dari instance ServiceNow. Sinkronisasi awal mungkin memerlukan waktu beberapa menit, bergantung pada jumlah data dalam tabel.
Menyerap beberapa tabel CMDB
Untuk menyerap data dari beberapa tabel CMDB, buat feed terpisah untuk setiap tabel:
- Buat feed pertama menggunakan langkah-langkah di atas (misalnya, untuk
cmdb_ci_server). - Klik Tambahkan Feed Berita Baru untuk membuat feed berita tambahan.
- Gunakan kredensial ServiceNow yang sama, tetapi tentukan nama tabel yang berbeda.
Contoh konfigurasi:
| Nama Feed | Nama Tabel | Tujuan |
|---|---|---|
| ServiceNow CMDB - Server | cmdb_ci_server |
Semua CI server |
| ServiceNow CMDB - Computers | cmdb_ci_computer |
CI Workstation |
| ServiceNow CMDB - Network Adapters | cmdb_ci_network_adapter |
CI antarmuka jaringan |
| ServiceNow CMDB - Applications | cmdb_ci_appl |
CI Aplikasi |
Izin API yang diperlukan
Pengguna integrasi memerlukan izin ServiceNow berikut:
| Izin/Peran | Tingkat Akses | Tujuan |
|---|---|---|
| cmdb_read | Baca | Mengambil data item konfigurasi CMDB |
Peran tambahan (opsional):
- itil: Diperlukan jika Anda memerlukan akses tulis untuk membuat atau memperbarui CI (tidak diperlukan untuk penyerapan Google SecOps)
- rest_api_explorer: Berguna untuk menguji akses API selama penyiapan
Tabel pemetaan UDM
| Kolom ServiceNow | Pemetaan UDM | Logika |
|---|---|---|
name |
entity.asset.hostname |
Nama host utama aset |
ip_address |
entity.asset.ip |
Alamat IP utama aset |
mac_address |
entity.asset.mac |
Alamat MAC aset |
serial_number |
entity.asset.hardware.serial_number |
Nomor seri hardware |
asset_tag |
entity.asset.asset_id |
Tag atau ID aset |
sys_class_name |
entity.asset.asset_type |
Class CI (server, komputer, dll.) |
os |
entity.asset.platform_software.platform |
Sistem operasi |
sys_created_on |
entity.asset.first_seen_time |
Stempel waktu pembuatan aset |
sys_updated_on |
entity.asset.last_seen_time |
Stempel waktu pembaruan terakhir |
location |
entity.asset.location.name |
Lokasi fisik |
company |
entity.asset.attribute.labels.value |
Perusahaan/organisasi pemilik |
event.idm.entity.entity.metadata.entity_type |
USER |
Dipetakan dari log perubahan |
calendar_integration", "u_ldap_source", "u_show_popup", "source", "building", "web_service_access_only", "notification", "enable_multifactor_authn", "sso_source", "sys_domain.display_value", "sys_domain.link", "u_itil_license_type", and "u_assets_validated |
entity.entity.asset.attribute.labels |
Dipetakan dari log perubahan |
last_login_time |
entity.relation.entity.user.last_login_time |
Dipetakan dari log perubahan |
x_bmgr_support_ent_bomgar_username", "vip", "zip", "time_format", "active", "gender", "failed_attempts", "federated_id", "internal_integration_user", "u_business_line", "department.link", "introduction", "preferred_language", "manager.link", "photo", "avatar", "time_zone", "schedule", and "correlation_id |
entity.relation.entity.user.attribute.labels |
Dipetakan dari log perubahan |
street |
entity.relation.entity.user.personal_address.name |
Dipetakan dari log perubahan |
department.display_value |
entity.relation.entity.user.department |
Dipetakan dari log perubahan |
u_office |
entity.relation.entity.user.company_name |
Dipetakan dari log perubahan |
title |
entity.relation.entity.user.title |
Dipetakan dari log perubahan |
first_name |
entity.relation.entity.user.first_name |
Dipetakan dari log perubahan |
last_name |
entity.relation.entity.user.last_name |
Dipetakan dari log perubahan |
middle_name |
entity.relation.entity.user.middle_name |
Dipetakan dari log perubahan |
manager.display_value |
entity.relation.entity.user.managers.user_display_name |
Dipetakan dari log perubahan |
sys_domain_path", "transaction_log", "cost_center", "sys_mod_count", and "sys_tags |
entity.entity.labels |
Dipetakan dari log perubahan |
employee_number", "phone", "home_phone", and "mobile_phone |
entity.relation.entity.user.phone_numbers |
Dipetakan dari log perubahan |
city |
entity.relation.entity.user.personal_address.city |
Dipetakan dari log perubahan |
state |
entity.relation.entity.user.personal_address.state |
Dipetakan dari log perubahan |
country |
entity.location.country_or_region |
Dipetakan dari log perubahan |
u_site_code |
entity.location.city |
Dipetakan dari log perubahan |
u_region |
entity_labels |
Dipetakan dari log perubahan |
location.display_value |
entity.labels |
Dipetakan dari log perubahan |
location.link |
entity.labels |
Dipetakan dari log perubahan |
email |
_relation.entity.user.email_addresses |
Dipetakan dari log perubahan |
sys_id |
entity.asset.product_object_id |
Dipetakan dari log perubahan |
u_sima_bs_activation_date", "attestation_status", "u_oracle_asm_lun_size", "u_app_resource_jndi_name", "is_encrypted", "monitor", "operational_status", "u_updated_ci", "u_cluster_node", "firewall_status", "skip_sync", "u_excluded", "u_data_classification", "u_sla_report", "u_restriction", "u_rack_slot", "u_account_aztech_oe.link", "u_account_aztech_oedisplay_value", "u_organisational_entity.link", "u_organisational_entity.display_value", "assignment_group.link", "assignment_group.display_value", "cost_center.link", "cost_center.display_value", "u_service_instance", "u_local_oe_cost_center", "managed_by", "u_mode_of_operation", "install_status", and "u_provider_tag |
entity.labels |
Dipetakan dari log perubahan |
u_build_user |
entity.user.email_addresses |
Dipetakan dari log perubahan |
metadata.entity_type |
ASSET |
Dipetakan dari log perubahan |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.