Skip to main content

Configured Host Groups API

The information required to read the each Host Smart Group is organized into the following tabs:

Requirement TypesDetails
APIhttps://csi7.secunia.com/csi/api/?uid=<xyz>&action=<xyz>&which=<xyz>&smartGroupTextType=<xyz>&smartGroupId=<xyz>&_dc=1563355275960&sort=host_name&dir=ASC&sorters=%5B%7B%22field%22%3A%22host_name%22%2C%22direction%22%3A%22ASC%22%7D%5D&host_name=&start=0&limit=21
Note: The value for <xyz> in the above API is defined in the Parameters section.
MethodsGET
Parameters
  • uid = UID Value taken from successful login. See How to Obtain the Token.
  • action = smart_groups
  • which = getSmartGroupContents
  • smartGroupTextType = host
  • smartGroupId = "id":"n" value from the JSON response of Host Smart Groups API.
Note: The above parameters have to be entered in the <xyz> of above API respectively.
Response{"success":true,"error_code":0,"data":{"rows":[{"nsi_device_id":"1","host_name":"BLR-LT-101247","score":"88","num_insecure":"22","num_eol":"4","num_patched":"193","num_installations":"219","group_name":"FLEXERA","software_inspector_id":"21","updated":"2019-07-12 07:07:26","software_inspector_version":"7.6.1.2"}],"total":"1"},"compiledTime":"2019-07-17 00:28:04"}
Received InformationThe following information will be received in the API response:
  • "nsi_device_id"—Device Id
  • "host_name"—Name of Host
  • "score"—System score of host
  • "num_insecure"—Number of insecure installations
  • "num_eol"—Number of end-of-life installations
  • "num_patched"—Number of secure installations
  • "num_installations"—Total number of installations
  • "group_name"—Custom group or LAN group name
  • "software_inspector_id"—Agent types:
    0: Agent imports but not scanned
    11: Mac
    21: Windows
    31: SCCM
    41: RHEL
    100: AD imports but not scanned
  • "updated"—Last Scanned date
  • "software_inspector_version"—Agent Version