Referensi API Integrasi untuk konsol manajemen lokal (Pratinjau publik)

Artikel ini mencantumkan API yang didukung untuk mengintegrasikan Microsoft Defender untuk IoT dengan layanan mitra.

Misalnya, API ini saat ini diimplementasikan dengan Tutorial: Mengintegrasikan ServiceNow dengan Microsoft Defender untuk IoT, melalui Konektor ServiceNow Service Graph untuk Defender untuk IoT.

Catatan

API integrasi dimaksudkan untuk berjalan terus menerus dan membuat aliran data yang terus berjalan, seperti untuk mengkueri data baru dari lima menit terakhir. API integrasi mengembalikan data dengan tanda waktu.

Untuk hanya mengkueri data, gunakan API reguler non-integrasi sebagai gantinya, untuk konsol manajemen lokal untuk mengkueri semua perangkat, atau untuk sensor tertentu untuk mengkueri perangkat dari sensor tersebut saja. Untuk informasi selengkapnya, lihat Referensi Defender for IoT API.

URI: /external/v3/integration/

perangkat (Membuat dan memperbarui perangkat)

API ini mengembalikan data tentang semua perangkat yang diperbarui setelah stempel waktu yang diberikan.

URI: /external/v3/integration/devices/<timestamp>

Parameter URI:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
timestamp	Waktu mulai dari mana hasil dikembalikan, dalam milidetik dari waktu Epoch dan dalam zona waktu UTC.	/external/v3/integration/devices/1664781014000	Diperlukan

GET

Minta

Parameter kueri:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
idSensor	Mengembalikan hanya perangkat yang dilihat oleh sensor tertentu. Gunakan nilai ID dari hasil API sensor (Dapatkan sensor ).	1	Opsional
notificationType	Menentukan jenis perangkat yang akan dikembalikan. Nilai yang didukung mencakup: - 0: Perangkat yang diperbarui dan baru (default). - 1: Hanya perangkat baru. - 2: Hanya perangkat yang diperbarui.	2	Opsional
halaman	Menentukan angka di mana penomoran halaman hasil dimulai. Misalnya, 0= halaman pertama adalah 0. Default = 0	0	Opsional
ukuran	Menentukan ukuran halaman. Default = 50	75	Opsional

Respons

Jenis: JSON

Bidang respons:

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_count	Bilangan bulat	Tidak dapat diubah ke null	Jumlah objek dalam tataan hasil lengkap, termasuk semua halaman.
u_devices	Array JSON objek perangkat	Tidak dapat diubah ke null	Array objek perangkat, seperti yang ditentukan oleh API perangkat (Dapatkan detail untuk perangkat ).

Contoh respons

{
    "u_devices": [{
        "u_operating_system": "",
        "u_ip_address_objects": [{
            "u_ip_address": "10.10.50.5",
            "u_guessed_mac_addresses": [{
                "u_mac_address": "00:02:a2:1f:1c:59"
            }]
        }],
        "u_zone": "asd",
        "u_name": "10.10.50.5",
        "u_mac_address_objects": [{
            "u_mac_address": "00:02:a2:1f:1c:59"
        }],
        "u_last_update": 1664782919000,
        "u_vendor": "HILSCHER GMBH",
        "u_cm_device_url": "https://<IP address>/#/sites/1/zones/1/devices-maps?devices=1",
        "u_sensor_ids": [{
            "u_sensor_id": 1
        }],
        "u_appliance": "Management console (CM)",
        "u_site": "asd",
        "u_device_type": {
            "u_category": "ICS",
            "u_purdue_layer": "Process Control",
            "u_name": "PLC"
        },
        "u_firmwares": [],
        "u_last_activity": 1664782791000,
        "u_purdue_layer": "N/A",
        "u_device_urls": [{
            "u_device_url": "https://<IP address>9/#/assets/highlight/1"
        }],
        "u_vlans": [{
            "u_vlan": "1"
        }],
        "u_groups": ["asd"],
        "u_first_discovered": 1664781051000,
        "u_id": 1,
        "u_protocol_objects": [{
            "u_protocol": "MODBUS"
        }]
    }, {
        "u_operating_system": "",
        "u_ip_address_objects": [{
            "u_ip_address": "10.10.20.10",
            "u_guessed_mac_addresses": [{
                "u_mac_address": "00:02:a2:1f:02:ba"
            }]
        }],
        "u_zone": "asd",
        "u_name": "10.10.20.10",
        "u_mac_address_objects": [{
            "u_mac_address": "00:02:a2:1f:02:ba"
        }],
        "u_last_update": 1664782859000,
        "u_vendor": "HILSCHER GMBH",
        "u_cm_device_url": "https://<IP address>/#/sites/1/zones/1/devices-maps?devices=50",
        "u_sensor_ids": [{
            "u_sensor_id": 1
        }],
        "u_appliance": "Management console (CM)",
        "u_site": "asd",
        "u_device_type": {
            "u_category": "ICS",
            "u_purdue_layer": "Process Control",
            "u_name": "PLC"
        },
        "u_firmwares": [],
        "u_last_activity": 1664782786000,
        "u_purdue_layer": "N/A",
        "u_device_urls": [{
            "u_device_url": "https://<IP address>9/#/assets/highlight/50"
        }],
        "u_vlans": [{
            "u_vlan": "1"
        }],
        "u_groups": ["asd"],
        "u_first_discovered": 1664781052000,
        "u_id": 50,
        "u_protocol_objects": [{
            "u_protocol": "MODBUS"
        }]
    }],
    "u_count": 204
}

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/devices/<Timestamp>"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/devices/<Timestamp>"

koneksi (Dapatkan koneksi perangkat)

API ini mengembalikan data tentang semua koneksi perangkat yang diperbarui setelah stempel waktu yang diberikan.

URI: /external/v3/integration/connections/<timestamp>

Parameter URI:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
timestamp	Waktu mulai dari mana hasil dikembalikan, dalam milidetik dari waktu Epoch dan dalam zona waktu UTC.	/external/v3/integration/devices/1664781014000	Diperlukan

GET

Minta

Parameter kueri:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
halaman	Menentukan angka di mana penomoran halaman hasil dimulai. Misalnya, 0= halaman pertama adalah 0. Default = 0	0	Opsional
ukuran	Menentukan ukuran halaman. Default = 50	75	Opsional

Respons

Jenis: JSON

Bidang respons:

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_count	Bilangan bulat	Tidak dapat diubah ke null	Jumlah objek dalam tataan hasil lengkap, termasuk semua halaman.
u_connections	Array JSON objek koneksi	Tidak dapat diubah ke null	Array objek koneksi

bidang koneksi

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_appliance	Untai	Tidak dapat diubah ke null	Nama sensor yang menemukan koneksi.
u_src_device_id	Bilangan bulat	Tidak dapat diubah ke null	ID perangkat sumber koneksi.
u_src_device_name	Untai	Tidak dapat diubah ke null	Nama perangkat sumber koneksi.
u_dest_device_id	Bilangan bulat	Tidak dapat diubah ke null	ID perangkat tujuan koneksi.
u_dest_device_name	Untai	Tidak dapat diubah ke null	Nama perangkat tujuan koneksi.
u_connection_type	Untai	Tidak dapat diubah ke null	Salah satu dari berikut ini: One Way, Two Way, Multicast

Contoh respons

{
    "u_count": 106,
    "u_connections": [{
        "u_src_device_id": 103,
        "u_dest_device_name": "10.10.10.16",
        "u_src_device_name": "10.10.10.18",
        "u_appliance": "Management console (CM)",
        "u_connection_type": "Two Way",
        "u_dest_device_id": 95
    }, {
        "u_src_device_id": 115,
        "u_dest_device_name": "10.10.10.64",
        "u_src_device_name": "10.10.10.30",
        "u_appliance": "Management console (CM)",
        "u_connection_type": "Two Way",
        "u_dest_device_id": 19
    }, {
        "u_src_device_id": 176,
        "u_dest_device_name": "10.10.45.7",
        "u_src_device_name": "10.10.45.100",
        "u_appliance": "Management console (CM)",
        "u_connection_type": "Two Way",
        "u_dest_device_id": 134
    },

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/connections/1664781014000"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/connections/1664781014000"

perangkat (Dapatkan detail untuk perangkat)

API ini mengembalikan data tentang perangkat tertentu per ID perangkat tertentu.

URI: /external/v3/integration/device/{deviceId}

GET

Minta

Parameter kueri:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
deviceId	ID perangkat yang diminta di konsol manajemen lokal	1	Diperlukan

Respons

Jenis: JSON

Bidang respons:

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_id	Bilangan bulat panjang	Tidak dapat diubah ke null	ID perangkat di konsol manajemen lokal.
u_vendor	Untai	Dapat diubah ke null	Nama vendor perangkat.
u_appliance	Untai	Tidak dapat diubah ke null	Nama sensor yang mendeteksi perangkat.
u_mac_address_objects	String array JSON	Tidak dapat diubah ke null	Array nilai u_mac_address , mencantumkan alamat MAC perangkat.
u_groups	String array JSON	Tidak dapat diubah ke null	Array grup yang berisi perangkat.
u_site	Untai	Tidak dapat diubah ke null	Nama situs perangkat.
u_zone	Untai	Tidak dapat diubah ke null	Nama situs perangkat.
u_last_activity	DateTime	Tidak dapat diubah ke null	Tanda waktu terakhir kali perangkat aktif.
u_first_discovered	DateTime	Tidak dapat diubah ke null	Tanda waktu waktu penemuan perangkat.
u_device_type	Untai	Tidak dapat diubah ke null	Jenis perangkat
u_name	Untai	Tidak dapat diubah ke null	Menentukan nama perangkat.
u_ip_address_objects	Array JSON alamat IP	Tidak dapat diubah ke null	Array objek alamat IP
u_mac_address_objects	Array JSON alamat MAC	Tidak dapat diubah ke null	Array objek alamat MAC
u_protocol_objects	Array protokol JSON	Tidak dapat diubah ke null	Array objek protokol
u_vlans	Array JSON objek VLAN	Tidak dapat diubah ke null	Array objek VLAN
u_purdue_layer	Untai	Tidak dapat diubah ke null	Menentukan lapisan Purdue default untuk jenis perangkat ini.
u_sensor_ids	Array JSON objek ID sensor	Tidak dapat diubah ke null	Array objek ID sensor
u_cm_device_url	Untai	Tidak dapat diubah ke null	URL yang digunakan untuk mengakses perangkat di konsol manajemen lokal.
u_device_urls	Array JSON objek URL	Tidak dapat diubah ke null	Array objek URL perangkat
u_last_update	Bilangan bulat panjang	Tidak dapat diubah ke null	Menentukan tanda waktu waktu pembaruan terakhir perangkat.
u_firmwares	Array JSON objek firmware	Tidak dapat diubah ke null	Array objek firmware

bidang ip_address_object

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_ip_address	Untai	Tidak dapat diubah ke null	Salah satu alamat IP perangkat
u_guessed_mac_address	Untai	Tidak dapat diubah ke null	Alamat MAC yang ditebak yang terkait dengan alamat IP

mac_address_object bidang

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_mac_address	Untai	Tidak dapat diubah ke null	Salah satu alamat MAC perangkat.

bidang protocol_object

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_protocol	Untai	Tidak dapat diubah ke null	Salah satu protokol yang digunakan oleh perangkat.

bidang vlan_object

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_vlan	Untai	Tidak dapat diubah ke null	Salah satu VLAN tempat perangkat ditemukan.

bidang sensor_id_object

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_sensor_id	Untai	Tidak dapat diubah ke null	ID sensor yang mendeteksi perangkat.

device_url_object bidang

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_device_url	Untai	Tidak dapat diubah ke null	URL yang digunakan untuk melihat perangkat di konsol manajemen lokal.

bidang firmware_object

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_appliance	Untai	Tidak dapat diubah ke null	Nama konsol manajemen lokal yang mengelola perangkat.
u_id	Bilangan bulat panjang	Tidak dapat diubah ke null	ID perangkat di konsol manajemen lokal
u_asset	Untai	Tidak dapat diubah ke null	Nama perangkat
u_address	Untai	Tidak dapat diubah ke null	Alamat firmware perangkat
u_module_address	Untai	Dapat diubah ke null	Alamat modul firmware perangkat
u_serial	Untai	Dapat diubah ke null	Nomor seri firmware perangkat
u_model	Untai	Dapat diubah ke null	Model firmware perangkat
u_version	Untai	Dapat diubah ke null	Versi firmware perangkat
u_additional_data	Untai	Dapat diubah ke null	Data tambahan khusus vendor firmware perangkat

Contoh respons

[{
    "u_operating_system": "",
    "u_ip_address_objects": [{
        "u_ip_address": "10.10.50.5",
        "u_guessed_mac_addresses": [{
            "u_mac_address": "00:02:a2:1f:1c:59"
        }]
    }],
    "u_zone": "asd",
    "u_name": "10.10.50.5",
    "u_mac_address_objects": [{
        "u_mac_address": "00:02:a2:1f:1c:59"
    }],
    "u_last_update": 1664782919000,
    "u_vendor": "HILSCHER GMBH",
    "u_cm_device_url": "https://<IP address>/#/sites/1/zones/1/devices-maps?devices=1",
    "u_sensor_ids": [{
        "u_sensor_id": 1
    }],
    "u_appliance": "Management console (CM)",
    "u_site": "asd",
    "u_device_type": {
        "u_category": "ICS",
        "u_purdue_layer": "Process Control",
        "u_name": "PLC"
    },
    "u_firmwares": [],
    "u_last_activity": 1664782791000,
    "u_purdue_layer": "N/A",
    "u_device_urls": [{
        "u_device_url": "https://<IP address>9/#/assets/highlight/1"
    }],
    "u_vlans": [{
        "u_vlan": "1"
    }],
    "u_groups": ["asd"],
    "u_first_discovered": 1664781051000,
    "u_id": 1,
    "u_protocol_objects": [{
        "u_protocol": "MODBUS"
    }]
}]

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/device/<device ID>"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/device/1"

deleteddevices (Dapatkan perangkat yang dihapus)

API ini mengembalikan daftar ID perangkat yang baru dihapus, dari tanda waktu yang disediakan.

URI: /external/v3/integration/deleteddevices/

GET

Minta

Parameter URI:

Nama	Deskripsi	Contoh	Diperlukan/Opsional
timestamp	Waktu mulai dari mana hasil dikembalikan, dalam milidetik dari waktu Epoch dan dalam zona waktu UTC.	/external/v3/integration/deleteddevices/1664781014000	Diperlukan

Respons

Jenis: Array JSON dari perangkat yang dihapus

Bidang perangkat yang dihapus:

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_id	Bilangan bulat panjang	Tidak dapat diubah ke null	ID perangkat yang dihapus

Contoh respons

[{
    "u_id": 192
}, {
    "u_id": 66
}, {
    "u_id": 4
}, {
    "u_id": 22
}, {
    "u_id": 24
}]

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP address>/external/v3/integration/deleteddevices/<timestamp>"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/deleteddevices/1664781014000"

sensor (Dapatkan sensor)

API ini mengembalikan daftar objek sensor untuk sensor jaringan OT yang terhubung.

URI: /external/v3/integration/sensors/

GET

Minta

URI: /sensors

Tidak ada parameter kueri

Respons

Jenis: JSON

Bidang respons:

Array bidang berikut:

Nama	Jenis	Nullable / Tidak dapat diubah ke null	Daftar nilai
u_id	Bilangan bulat panjang	Tidak dapat diubah ke null	Menentukan ID sensor internal, yang akan digunakan dalam API perangkat (Buat dan perbarui perangkat).
u_name	Untai	Tidak dapat diubah ke null	Menentukan nama appliance sensor.
u_interface_address	Untai	Tidak dapat diubah ke null	Menentukan alamat jaringan appliance sensor.
u_connection_state	Untai	Tidak dapat diubah ke null	Menentukan status koneksi perangkat dengan konsol manajemen lokal, menggunakan salah satu nilai berikut: - DISINKRONKAN: Koneksi berhasil. - OUT_OF_SYNC: Konsol manajemen lokal tidak dapat memproses data yang diterima dari sensor. - TIME_DIFF_OFFSET: Penyimpangan waktu terdeteksi. Konsol manajemen lokal telah terputus dari sensor. DISCONNECTED: Sensor tidak berkomunikasi dengan konsol manajemen. Periksa konektivitas jaringan.
u_version	Untai	Tidak dapat diubah ke null	Representasi string dari versi perangkat lunak sensor.
u_alert_count	Bilangan bulat panjang	Tidak dapat diubah ke null	Jumlah pemberitahuan saat ini yang dipicu oleh sensor.
u_device_count	Bilangan bulat panjang	Tidak dapat diubah ke null	Jumlah perangkat saat ini yang terdeteksi oleh sensor.
u_unhandled_alert_count	Bilangan bulat panjang	Tidak dapat diubah ke null	Jumlah peringatan yang saat ini tidak tertangani pada sensor.
u_is_activated	Boolean	Tidak dapat diubah ke null	Menentukan apakah sensor diaktifkan.
u_data_intelligence_version	Untai	Tidak dapat diubah ke null	Representasi string dari versi inteligensi ancaman yang diinstal pada sensor.
u_uid	Untai	Tidak dapat diubah ke null	Menentukan pengidentifikasi unik sensor secara global.
u_zone_id	Bilangan bulat panjang	Dapat diubah ke null	Tentukan zona perangkat.
u_is_in_learning_mode	Boolean	Tidak dapat diubah ke null	Menentukan apakah sensor dalam mode pembelajaran.
u_remote_upgrade_stage	Untai	Dapat diubah ke null	Menentukan tahap saat ini dalam proses pembaruan versi sebagai salah satu hal berikut ini: - UPLOADING - PREPARE_TO_INSTALL - STOPPING_PROCESSES - BACKING_UP_DATA - TAKING_SNAPSHOT - UPDATING_CONFIGURATION - UPDATING_DEPENDENCIES - UPDATING_LIBRARIES - PATCHING_DATABASES - STARTING_PROCESSES - VALIDATING_SYSTEM_SANITY - VALIDATION_SUCCEEDED_REBOOTING - SUCCESS - FAILURE - UPGRADE_STARTED - STARTING_INSTALLATION - INSTALLING_OPERATING_SYSTEM

Contoh respons

[
  {
    u_connection_state: "SYNCED",
    u_uid: "fab58081-1fde-4d3f-8eea-9aa723abbd55",
    u_name: "Microsoft Defender for IoT",
    u_is_activated: true,
    u_alert_count: 6,
    u_device_count: 202,
    u_interface_address: "https://<IP address>9",
    u_zone_id: 1,
    u_data_intelligence_version: "May 26, 2022",
    u_is_in_learning_mode: false,
    u_unhandled_alert_count: 6,
    u_remote_upgrade_stage: "",
    u_id: 1,
    u_version: "22.2.5.7-r-2121448",
  },
];

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP Address>/external/v3/integration/sensors"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/sensors"

devicecves (Dapatkan CVE perangkat)

API ini mengembalikan daftar CVE aktif untuk semua perangkat yang diperbarui sejak tanda waktu yang disediakan.

URI: /external/v3/integration/devicecves/

GET

Minta

URI: /external/v3/integration/devicecves/<timestamp>

Parameter URI

Nama	Deskripsi	Contoh	Diperlukan/Opsional
timestamp	Waktu mulai dari mana hasil dikembalikan, dalam milidetik dari waktu Epoch dan dalam zona waktu UTC.	/external/v3/integration/devicecves/1664781014000	Diperlukan

Parameter kueri

Nama	Deskripsi	Contoh	Diperlukan/Opsional
halaman	Menentukan angka di mana penomoran halaman hasil dimulai.	0= halaman pertama adalah 0. Default = 0	Opsional
ukuran	Menentukan ukuran halaman.	Default = 50	Opsional
idSensor	Menampilkan hasil dari sensor tertentu, seperti yang ditentukan oleh ID sensor yang diberikan.	1	Opsional
skor	Menentukan skor CVE minimum yang akan diambil. Semua hasil akan memiliki skor CVE yang sama dengan atau lebih besar dari nilai yang diberikan.	Default = 0.	Opsional
deviceIds	Daftar ID perangkat yang dipisahkan koma tempat Anda ingin menampilkan hasil.	Misalnya: 1232,34,2,456	Opsional

Respons

Jenis: Hitungan dan array JSON CVE perangkat

Bidang respons

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_count	Bilangan bulat	Tidak dapat diubah ke null	Jumlah objek dalam tataan hasil lengkap, termasuk semua halaman.
u_device_cves	Array JSON objek CVE perangkat	Tidak dapat diubah ke null	Array objek CVE perangkat

Bidang CVE perangkat

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_id	Bilangan bulat	Tidak dapat diubah ke null	ID perangkat di konsol manajemen lokal.
u_name	Untai	Tidak dapat diubah ke null	Nama perangkat.
u_ip_address_objects	Array JSON objek alamat IP	Tidak dapat diubah ke null	Array nilai u_ip_address , menentukan alamat IP perangkat.
u_mac_address_objects	Array JSON objek alamat MAC	Tidak dapat diubah ke null	Array nilai u_mac_address , mencantumkan alamat MAC perangkat.
u_last_activity	Bilangan bulat	Tidak dapat diubah ke null	Tanda waktu terakhir kali lalu lintas terlihat dari atau ke perangkat.
u_last_update	Bilangan bulat	Tidak dapat diubah ke null	Tanda waktu terakhir kali properti diubah pada perangkat, termasuk perubahan pengguna dan perubahan sistem otomatis.
u_cves	Array JSON CVE	Tidak dapat diubah ke null	Array objek detail CVE

Catatan

Jika Defender untuk IoT dapat dengan yakin mengidentifikasi alamat MAC salah satu alamat IP-nya, alamat MAC dikembalikan di u_mac_address_objects bidang secara langsung.

Jika Defender untuk IoT tidak sepenuhnya yakin tentang alamat MAC, seperti jika lalu lintas telah dirutekan melalui router, alamat MAC dikembalikan di u_guessed_mac_address bidang sebagai gantinya, sebagai bagian dari array JSON alamat IP.

u_ip_address_objects bidang

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_ip_address	Untai	Tidak dapat diubah ke null	Salah satu alamat IP perangkat
u_guessed_mac_address	Array JSON objek alamat MAC	Tidak dapat diubah ke null	Array JSON alamat MAC

u_mac_address_objects bidang

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_mac_address	Untai	Tidak dapat diubah ke null	Salah satu alamat MAC perangkat

u_cves bidang

Nama	Jenis	Dapat diubah ke null / Tidak dapat diubah ke null	Daftar nilai
u_address	Untai	Tidak dapat diubah ke null	Alamat antarmuka tertentu, dengan firmware tertentu tempat CVE terdeteksi.
u_cve_id	Untai	Tidak dapat diubah ke null	Menentukan ID CVE
u_score	Untai	Tidak dapat diubah ke null	Menentukan skor risiko CVE
u_attack_vector	Untai	Tidak dapat diubah ke null	Mendefinisikan vektor serangan sebagai salah satu dari berikut: ADJACENT_NETWORK, , LOCALNETWORK
u_description	Untai	Tidak dapat diubah ke null	Menentukan deskripsi CVE

Contoh respons

{
    "u_count": 2,
    "u_device_cves": [{
        "u_ip_address_objects": [{
            "u_ip_address": "192.168.1.127",
            "u_guessed_mac_addresses": [{
                "u_mac_address": "00:0f:38:67:4f:1c"
            }]
        }],
        "u_name": "192.168.1.127",
        "u_mac_address_objects": [{
            "u_mac_address": "00:0f:38:67:4f:1c"
        }],
        "u_last_update": 1664787209000,
        "u_last_activity": 1664782792000,
        "u_id": 135,
        "u_cves": [{
            "u_cve_id": "CVE-2015-2373",
            "u_score": "10.0",
            "u_ip_address": "192.168.1.127",
            "u_description": "The Remote Desktop Protocol (RDP) server service in Microsoft Windows 7 SP1, Windows 8, and Windows Server 2012 allows remote attackers to execute arbitrary code via a series of crafted packets, aka \"Remote Desktop Protocol (RDP) Remote Code Execution Vulnerability.\"",
            "u_attack_vector": "NETWORK"
        }, {
            "u_cve_id": "CVE-2015-1635",
            "u_score": "10.0",
            "u_ip_address": "192.168.1.127",
            "u_description": "HTTP.sys in Microsoft Windows 7 SP1, Windows Server 2008 R2 SP1, Windows 8, Windows 8.1, and Windows Server 2012 Gold and R2 allows remote attackers to execute arbitrary code via crafted HTTP requests, aka \"HTTP.sys Remote Code Execution Vulnerability.\"",
            "u_attack_vector": "NETWORK"
        }, {
            "u_cve_id": "CVE-2015-0014",
            "u_score": "10.0",
            "u_ip_address": "192.168.1.127",
            "u_description": "Buffer overflow in the Telnet service in Microsoft Windows Server 2003 SP2, Windows Vista SP2, Windows Server 2008 SP2 and R2 SP1, Windows 7 SP1, Windows 8, Windows 8.1, and Windows Server 2012 Gold and R2 allows remote attackers to execute arbitrary code via crafted packets, aka \"Windows Telnet Service Buffer Overflow Vulnerability.\"",
            "u_attack_vector": "NETWORK"
        }]
    }, {
        "u_ip_address_objects": [{
            "u_ip_address": "10.13.10.5",
            "u_guessed_mac_addresses": [{
                "u_mac_address": "00:05:f0:00:0f:cd"
            }]
        }],
        "u_name": "10.13.10.5",
        "u_mac_address_objects": [{
            "u_mac_address": "00:05:f0:00:0f:cd"
        }],
        "u_last_update": 1664787149000,
        "u_last_activity": 1664782792000,
        "u_id": 181,
        "u_cves": [{
            "u_cve_id": "CVE-2016-7182",
            "u_score": "10.0",
            "u_ip_address": "10.13.10.5",
            "u_description": "The Graphics component in Microsoft Windows Vista SP2; Windows Server 2008 SP2 and R2 SP1; Windows 7 SP1; Windows 8.1; Windows Server 2012 Gold and R2; Windows RT 8.1; Windows 10 Gold, 1511, and 1607; Office 2007 SP3; Office 2010 SP2; Word Viewer; Skype for Business 2016; Lync 2013 SP1; Lync 2010; Lync 2010 Attendee; and Live Meeting 2007 Console allows attackers to execute arbitrary code via a crafted True Type font, aka \"True Type Font Parsing Elevation of Privilege Vulnerability.\"",
            "u_attack_vector": "NETWORK"
        }, {
            "u_cve_id": "CVE-2016-3270",
            "u_score": "10.0",
            "u_ip_address": "10.13.10.5",
            "u_description": "The Graphics component in the kernel in Microsoft Windows Vista SP2; Windows Server 2008 SP2 and R2 SP1; Windows 7 SP1; Windows 8.1; Windows Server 2012 Gold and R2; Windows RT 8.1; and Windows 10 Gold, 1511, and 1607 allows local users to gain privileges via a crafted application, aka \"Win32k Elevation of Privilege Vulnerability.\"",
            "u_attack_vector": "NETWORK"
        }, {
            "u_cve_id": "CVE-2016-3266",
            "u_score": "10.0",
            "u_ip_address": "10.13.10.5",
            "u_description": "The kernel-mode drivers in Microsoft Windows Vista SP2, Windows Server 2008 SP2 and R2 SP1, Windows 7 SP1, Windows 8.1, Windows Server 2012 Gold and R2, Windows RT 8.1, and Windows 10 Gold, 1511, and 1607 allow local users to gain privileges via a crafted application, aka \"Win32k Elevation of Privilege Vulnerability,\" a different vulnerability than CVE-2016-3376, CVE-2016-7185, and CVE-2016-7211.",
            "u_attack_vector": "NETWORK"
        }]
    }]
}

perintah cURL

Jenis: GET

API:

curl -k -H "Authorization: <Authorization token>" "https://<IP Address>/external/v3/integration/devicecves/<timestamp>"

Contoh:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" "https://127.0.0.1/external/v3/integration/devicecves/1664781014000"

Langkah berikutnya

Untuk informasi selengkapnya, lihat:

• Ringkasan referensi Defender for IoT API
• Tutorial: Mengintegrasikan ServiceNow dengan Pertahanan Microsoft untuk IoT