Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Desktop Software Finding Details

Avatar
Ingrid
Follow
Publication Date – September 26, 2023

⇤ Findings

https://api.bitsighttech.com/ratings/v1/companies/company_guid/findings?risk_vector=desktop_software

Get an organization’s Desktop Software finding details.

Parameters

For details specific to Desktop Software, use the ?risk_vector=desktop_software parameter. Other query parameters are listed in GET: Finding Details.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/findings?risk_vector=desktop_software -u api_token:

Example Response

{
  "links":{
    "next":"https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/findings?limit=100&offset=100&risk_vector=desktop_software",
    "previous":null
  },
  "count":266,
  "results":[
    {
      "temporary_id":"A9Jq47BBje16e6e8d144bd8121cb4b4b2c941579f5",
      "affects_rating":true,
      "assets":[
        {
          "asset":"24.6.16.69",
          "identifier":null,
          "category":"low",
          "importance":0.0,
          "is_ip":true
        }
      ],
      "details":{
        "cvss":{
          "base":[ ]
        },
        "check_pass":"",
        "estimation_of_users":"1",
        "diligence_annotations":{
          "count_ips":1,
          "operating_system_rule":{
            "version":"10.15.7",
            "eol":"9999-01-01",
            "launch":"2020-09-24",
            "is":"match"
          },
          "user_agent_rule":{
            "version":"113",
            "eol":"2023-06-06",
            "launch":"2023-05-02",
            "is":"match"
          },
          "sample_ips":[
            "24.6.16.69"
          ],
          "sample_user_agent_strings":[
            "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.0.0 Safari/537.36"
          ],
          "sample_domains":[
            "avgle.com"
          ]
        },
        "geo_ip_location":"US",
        "country":"United States",
        "grade":"GOOD",
        "operating_system_family":"Mac OS X",
        "operating_system_grade":"GOOD",
        "operating_system_name":"macOS",
        "operating_system_support_status":"SUPPORTED",
        "operating_system_version":"10.15.7",
        "remediations":[
          {
            "message":"Supported Operating System and Browser",
            "help_text":"The operating system and browser are both supported.",
            "remediation_tip":""
          }
        ],
        "sample_timestamp":"2023-06-09T23:59:59Z",
        "user_agent_family":"Chrome",
        "user_agent_grade":"GOOD",
        "user_agent_support_status":"SUPPORTED",
        "user_agent_version":"113",
        "vulnerabilities":[ ],
        "rollup_end_date":"2023-06-09",
        "rollup_start_date":"2023-05-19",
        "searchable_details":"Supported Operating System and Browser"
      },
      "evidence_key":"Mac OS X 10.15.7 / Chrome 113.0.0",
      "first_seen":"2023-05-19",
      "last_seen":"2023-06-09",
      "related_findings":[ ],
      "risk_category":"Diligence",
      "risk_vector":"desktop_software",
      "risk_vector_label":"Desktop Software",
      "rolledup_observation_id":"kkMa1MuYiptCdylSJzGDoA==",
      "severity":1.0,
      "severity_category":"minor",
      "tags":[
        "Widget Division"
      ],
      "remediation_history":{
        "last_requested_refresh_date":null,
        "last_refresh_status_date":null,
        "last_refresh_status_label":null,
        "last_refresh_reason_code":null
      },
      "asset_overrides":[ ],
      "duration":null,
      "comments":null,
      "remaining_decay":62,
      "remediated":null
    },
    […]
  ]
}

Response Attributes

Field Description 
links
Object 		Navigation for multiple pages of results. See pagination.
  
next
String 		The URL for navigating to the next page of results. 
previous
String 		The URL for navigating to the previous page of results. 
count
Integer 		The number of findings. 
results
Array 		Findings and their details.
  Object A finding.
  
temporary_id
String 		A temporary identifier for this finding. 
affects_rating
Boolean 		true = This finding impacts the risk vector letter grade. 
assets
Array 		Asset (IP address or domain) details.
  Object An asset.
  
asset
String 		The asset associated with this finding. 
identifier
Null 		For internal Bitsight use. 
category
String 		The Bitsight-calculated asset importance. 
importance
Decimal 		The Bitsight-calculated asset importance. 
is_ip
Boolean 		true = This asset is an IP address. 
details
Object 		Finding details.
  
cvss
Object 		If the finding has an associated vulnerability, this contains the CVSS score.
  
base
Array 		CVSS scores of vulnerabilities associated with this finding. 
check_pass
String 		For internal Bitsight use. 
estimation_of_users
String 		The estimated number of affected users, which is based on the number of distinct cookies with a unique pair of browser and operating system (OS) versions. 
diligence_annotations
Object 		Diligence finding details.
  
count_ips
Integer 		The number of IP addresses attributed to this finding. 
operating_system_rule
Object 		Details of the logic for determining the supported status of the operating system.
  
version
String 		The OS version. 
eol
String [YYYY-MM-DD]		 The OS end-of-life date. 
launch
String [YYYY-MM-DD]		 The OS launch date. 
is
String 		  
user_agent_rule
Object 		Details of the logic for determining the supported status of the user’s operating system.
  
version
String 		The OS version. 
eol
String [YYYY-MM-DD]		 The OS end-of-life date. 
launch
String [YYYY-MM-DD]		 The OS launch date. 
is
String 		  
sample_ips
Array 		A sampled list of attributed IP addresses. 
sample_user_agent_strings
Array 		Sample user-agent strings, as sent by the browser. 
sample_domains
Array 		Sample domains. 
geo_ip_location
String 		A 2-letter ISO country code indicating this finding’s country of origin. 
country
String 		This finding’s country of origin. 
grade
String 		The finding grade. 
operating_system_family
String 		The OS type. 
operating_system_grade
String 		An assessment of this OS. See graded OS. 
operating_system_name
String 		The OS name. 
operating_system_support_status
String 		The operating system’s support status. 
operating_system_version
String 		The OS version. 
remediations
Array 		Information about the finding and instructions to remediate it, if any.
  Object The information.
  
message
String 		Details of this finding. 
help_text
String 		An overview of this finding. 
remediation_tip
String 		The recommended remediation instructions. 
sample_timestamp
String [YYYY-MM-DDTHH:MM:SSZ]		 The date and time when this finding was observed. 
user_agent_family
String 		The user’s browser type. 
user_agent_grade
String 		An assessment of this browser. See graded browsers. 
user_agent_support_status
String 		The browser’s support status. 
user_agent_version
String 		The current version of this browser. 
vulnerabilities
Array 		Not applicable to Desktop Software findings. 
rollup_end_date
String [YYYY-MM-DD]		 The date when this finding was last observed. 
rollup_start_date
String [YYYY-MM-DD]		 The date when this finding was first observed. 
searchable_details
String 		Details that can be searched in the Bitsight platform. 
evidence_key
String 		The asset attributed to the finding. 
first_seen
String [YYYY-MM-DD]		 The date when an observation was first seen. 
last_seen
String [YYYY-MM-DD]		 The date when an observation was last seen. 
related_findings
Array 		Related findings and their details. 
risk_category
String 		The risk category of this finding. 
risk_vector
String 		The slug name of this risk vector. 
risk_vector_label
String 		The display name of this risk vector. 
rolledup_observation_id
String 		The rolled up ID for identifying the finding. 
severity
Decimal 		The finding severity, which is the measured risk that this finding introduces. 
severity_category
String 		The finding severity slug name. 
tags
Array 		Infrastructure tags that identify this asset. 
remediation_history
Object 		The finding’s remediation and refresh history.
  
last_requested_refresh_date
String [YYYY-MM-DD]		 The date when a finding refresh that included this finding was last requested. 
last_refresh_status_date
String [YYYY-MM-DD]		 The date when this finding’s remediation status was last refreshed. 
last_refresh_status_label
String [YYYY-MM-DD]		 The current refresh status of this finding. 
last_refresh_reason_code
String [YYYY-MM-DD]		 The current remediation status of this finding. 
asset_overrides
Array 		User-assigned asset importance details. 
duration
Integer 		For internal Bitsight use. 
comments
String 		A thread of finding comments. 
remaining_decay
Integer [Calendar Days]		 The remaining finding lifetime. 
remediated
Boolean 		true = The finding is remediated.

Related articles