Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image Added

For general information & instructions on the use of Remote Providers within ThreadFix, please refer to

...

the Remote Providers parent page

...

.

...

For information on REST API functionality for Remote Providers, please refer to the following: Remote Providers API

Introduction

ThreadFix uses Dependency Track API Client to authenticate and pull both application and scan information.

Fetching Applications

ThreadFix uses this endpoint to pull applications from the Dependency Track instance

...

. ThreadFix does paginate this request.

Code Block
/api/v1/project

...

Fetching Scans

ThreadFix uses this endpoint to get vulnerability information from Dependency Track Client API:

Code Block
/api/v1/vulnerability/project/{projectNativeId}
  • From the returned data ThreadFix extracts severity, status, datecreated, location, and issuetype dependency values of each finding from all new, open, and reopened issues for the specified application

...

  • Because the results set does not provide a scan date, ThreadFix will report the date the scan was imported as the scan date

...

  • ThreadFix does paginate this request

...

  • Users need to have the Vulnerability_Analysis permission to import scans, as seen below:

Image Modified

Parsing Vulnerabilities

The JSON returned by Dependency Track vulnerabilities endpoint maps directly to these ThreadFix Finding Mappings:

  • Native Id - vulnerability.uuid

  • Vulnerability code - vulnerability.cwe.name (if cwe.name is null it will map to Configuration)

  • Severity code - vulnerability.severity

  • Path - “Dependencies”

  • Dependency.reference - vulnerability.vulnId

  • dependency.componentName - component.name

  • dependency.componentFilePath - component.fileName

  • dependency.description - vulnerability.description

  • CVE - vulnerability.vulnId