Device Audit


This API is for listing all the device activities that have occurred in your network.

 

  • Functionality
  • To retrieve all the device activities in your network.
  • HTTP Method 
  • GET
  • API URI
  • api/1.4/reports/dcm/deviceaudit
  • Filters
  • os_platform={Numeric}
    This is to filter based on OS Platform
    1 - Windows
    2 - Mac


    isblocked={Numeric}
    This is to filter devices based on allowed/blocked status
    0 - Allowed
    1 - Blocked


    devicetype={Numeric}
    This is to filter based on device type
    Code equivalent for each device type:
    2 - Biometric
    3 - Bluetooth
    4 - CDROM
    5 - DiskDrive
    9 - FloppyDisk
    19 - Image
    20 - Infrared
    21 - Keyboard
    24 - Modem
    26 - Mouse
    37 - Printer
    42 - SmartCardReader
    46 - TapeDrive
    49 - WPD
    100 - WPD_AppleDevices
    102 - SerialPorts(COM)
    103 - ParallelPorts(LPT)
    104 - WirelessNetworkAdapters


    dipId={String}
    This is to filter records based on device instance path.


    period={Numeric}
    This is to filter based on time period.
    0 - This week
    1 - This month
    2 - This year
    3 - Last week
    4 - Last month
    5 - Last two month
    6 - Last three month
    7 - Last six month
    8 - Last nine month
    9 - Last year

    domain={String}
    This is to filter the records based on domain names.

    computer={Numeric}
    This is to filter devices connected to a particular computer. The resource IDs of all the computers can be obtained from :
    Key: "resource_id"
    /api/1.0/som/computers

    gid={Numeric}

    This is to filter devices connected to a particular group of computers. The IDs of of all the custom computer groups can be obtained from:
    api/1.0/admin/customgroups
  • Paging
  • page={Numeric}
    This is for navigating to specific pages.This field denotes the current page.

    pagelimit={Numeric}
    This is to specify the number of records to be displayed per page.
  • Response Parameters
  • isblocked
    This denotes the last access status.
    0 - Allowed
    1 - Blocked
    usage_duration
    This denotes the duration of the last connection in milliseconds.

    All times are in epoch long format.

Response Data

 { 	"message_type": "dcm", 	"message_response": { 		"total": 7603, 		"limit": 25, 		"page": 1, 		"dcm": [ 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 9283, 				"device_removed_time": 1744202399456, 				"managedcomputer.friendly_name": "1493600z7Jl3  K5QUPKY", 				"vendor_hex_id": "1a2c", 				"os_platform": 1, 				"vendor_name": "China Resource Semico Co., Ltd", 				"device_type": "smp.dcm.keyboard", 				"serial_number": "340bcb0a", 				"domain_netbios_name": "WORKGROUP", 				"userresource.name": "1493600z7Jl3-User", 				"product_name": "HID Keyboard Device", 				"deviceauditevents.target_device_name": "HID Keyboard Device", 				"is_blocked": 1, 				"product_hex_id": "2124", 				"device_inserted_time": 1744116003726, 				"resource_name": "1493600z7Jl3", 				"customer_id": 1, 				"class_guid": "{4d36e96b-e325-11ce-bfc1-08002be10318}", 				"usage_duration": 86395730, 				"computer_resource_id": 113550, 				"db_updated_time": 1744202428351, 				"deviceauditevents.target_manufacturer_name": "Microsoft" 			}, 			{ 				"custom_device_name": "--", 				"deviceaudit_id": 6011, 				"device_removed_time": 1744202383484, 				"managedcomputer.friendly_name": "74927000gsRq  D8LTMFI", 				"vendor_hex_id": "13fe", 				"os_platform": 1, 				"vendor_name": "Kingston Technology Company Inc.", 				"device_type": "smp.dcm.removablestoragedevice", 				"serial_number": "0", 				"domain_netbios_name": "WORKGROUP", 				"userresource.name": "74927000gsRq-User", 				"product_name": "DataTraveler 2.0 1GB/4GB Flash Drive / Patriot Xporter 4GB Flash Drive", 				"deviceauditevents.target_device_name": "DataTraveler 2.0 1GB/4GB Flash Drive / Patriot Xporter 4GB Flash Drive", 				"is_blocked": 1, 				"product_hex_id": "1d00", 				"device_inserted_time": 1744116003460, 				"resource_name": "74927000gsRq", 				"customer_id": 1, 				"class_guid": "{4d36e967-e325-11ce-bfc1-08002be10318}", 				"usage_duration": 86380024, 				"computer_resource_id": 113543, 				"db_updated_time": 1744202411818, 				"deviceauditevents.target_manufacturer_name": "DataTraveler" 			} 		] 	}, 	"message_version": "1.4", 	"status": "success", 	"response_code": 200 }