snyk-threadfix 0.0.3

No project description provided

snyk-threadfix

This tool allows you to generate .threadfix file data from Snyk project data. It outputs JSON data in the ThreadFix file format - both printing to standard out and also allowing you to specify an output filename.

It does not upload directly to ThreadFix at this time. However:

1. We will likely do that in the future given sufficient demand
2. There is a ThreadFix API endpoint that you can use for this: ThreadFix Upload Scan API

Installation

pip install snyk-threadfix

Configuration

You must first obtain a Snyk API token from your Snyk account. Once you have a token you must either install the Snyk CLI and run snyk auth <your-token> or simply run:

export SNYK_TOKEN=<your-token> 

Usage

You must first identify your Snyk org ID. This is easy - simply log into your Snyk account, click on Settings, and find your Organization ID there. If you have multiple orgs in your Snyk account, make sure to first choose the one you want.

You must also identify the Snyk project ID's for which you would like to generate ThreadFix data. You can do this using the Snyk API, for example, using the List all projects endpoint. See also the pysnyk SDK. Another way of identifying the project IDs you want to use is simply by browsing to the desired project(s) with the Snyk UI and grabbing the UUID from the address bar of your browser.

Once you have a project ID or list of project IDs that you would like to generate a threadfix file for, run the following:

For a single project ID:

snyk-threadfix --orgId=<your-snyk-org-id> --projectIds=<snyk-project-id>

For multiple IDs:

snyk-threadfix --orgId=<your-snyk-org-id> --projectIds=<snyk-project-id-0>,<snyk-project-id-1>,<snyk-project-id-2>,...

ThreadFix JSON data will be output to standard out. If you would like to save the JSON to a file you can either pipe it to a file or use the --output parameter, for example:

snyk-threadfix --output=<your-desired-output-filename>.threadfix --orgId=<your-snyk-org-id> --projectIds=<snyk-project-id>

Additional input parameters are available:

snyk-threadfix main.py --help