Mengumpulkan data CMDB ServiceNow

Didukung di:

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

Menambahkan rentang IP ke ServiceNow

  1. Login ke instance ServiceNow Anda sebagai administrator.
  2. Buka All > System Security > IP Address Access Control.
  3. Klik New.
  4. 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.
  5. Klik Kirim.
  6. 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.

  1. Login ke ServiceNow Admin Console.
  2. Buka All > User Administration > Users.
  3. Klik New.
  4. 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).
  5. Klik Kirim.

Menetapkan izin yang diperlukan

  1. Setelah membuat pengguna, buka data pengguna.
  2. Buka bagian Roles.
  3. Klik Edit.
  4. Dalam daftar Collection, telusuri dan tambahkan peran berikut:
    • cmdb_read: Memberikan akses baca ke tabel CMDB.
  5. 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.
  • 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)

  1. Login ke instance ServiceNow Anda sebagai pengguna integrasi.
  2. Buka All > System Web Services > REST > REST API Explorer.
  3. Pilih Table API dari drop-down namespace.
  4. Pilih Retrieve records from a table (GET).
  5. Di Parameter Jalur, masukkan nama tabel (misalnya, cmdb_ci).
  6. Klik Kirim.
  7. 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 Anda
      • your-username: Nama pengguna integrasi Anda
      • your-password: Sandi pengguna integrasi Anda

Respons yang berhasil akan menampilkan data JSON dengan item konfigurasi.

Menyiapkan feed

Untuk mengonfigurasi feed, ikuti langkah-langkah berikut:

  1. Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
  2. Klik Tambahkan Feed Berita Baru.
  3. Di halaman berikutnya, klik Konfigurasi satu feed.
  4. Di kolom Nama feed, masukkan nama untuk feed (misalnya, ServiceNow CMDB - All CIs atau ServiceNow CMDB - Servers).
  5. Pilih API pihak ketiga sebagai Jenis sumber.
  6. Pilih ServiceNow CMDB sebagai Log type.
  7. Klik Berikutnya.
  8. 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
    • 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
    • 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.
    • Namespace aset: Namespace aset.
    • Label penyerapan: Label yang akan diterapkan ke peristiwa dari feed ini.
  9. Klik Berikutnya.

  10. 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:

  1. Buat feed pertama menggunakan langkah-langkah di atas (misalnya, untuk cmdb_ci_server).
  2. Klik Tambahkan Feed Berita Baru untuk membuat feed berita tambahan.
  3. 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.