Import/Export for License Inventory Review in On-Premises Environment

Export Instructions:

  1. Go to https://<domain>.whitesourcesoftware.com/Wss/WSS.html#!assignLicenses
  2. Select "Domain (by name)" or "Domain (by id)"
  3. Enter the organization you want to export in the text box, and click "Search"
    1. This will show by default all libraries without license, but you can select other options to filter as needed
  4. Click the "Export" button located on the top right
  5. Send the output file to WhiteSource Support for review:  support@whitesourcesoftware.com


Import Instructions:

  1. Go to https://<domain>.whitesourcesoftware.com/Wss/WSS.html#!assignLicenses
  2. Scroll to the bottom of the screen
  3. Click "Choose File"
  4. Select a CSV file to upload (see below for CSV format requirements).
  5. Click "Submit"

CSV Format Requirements:

Currently the license importer works via CSV file format.  The number of fields must be between 4-6 and in the following order:

Field 1:  Managed Resource Id

Field 2:  License Name

Field 3:  License Reference Type (see list above in background section)

Field 4:  License Reference URL (or license text file for SOURCE_LIBRARY)

Field 5:  Project Host Type (required for:  ARTIFACT_DESCRIPTOR, PROJECT_HOST_SITE) or Custom Disclaimer (optional)

Field 6:  Custom Disclaimer (optional)

Notes:

  • Project Host Type for ARTIFACT_DESCRIPTOR can be any of the following values:  repo, site, manual, null
  • Project Host Type for PROJECT_HOST_SITE can be any of the following values:  SOURCEFORGE, GOOGLE_CODE, GITHUB, GITORIOUS_TI

Supported Reference Types:

ARTIFACT_DESCRIPTOR
PROJECT_SITE
NUGET_PACKAGE
PYPI_PACKAGE
NODE_PACKAGED_MODULE
BOWER_PACKAGE
RUBY_GEM
SOURCE_LIBRARY
PROJECT_HOST_SITE
DOT_NET
NUGET_PACKAGE_MODULE
CDNJS
OTHER

Example CSV File:

20569402,MIT,PYPI_PACKAGE,https://github.com/erezsh/plyplus,custom disclaimer
7050084,MIT,RUBY_GEM,https://github.com/yrgoldteeth/bootstrap-will_paginate/blob/master/MIT-LICENSE
17516611,OpenSSL,SOURCE_LIBRARY,LICENSE
123456,GPL 2.0,PROJECT_SITE,https://github.com/yrgoldteeth/bootstrap-will_paginate/blob/master/MIT-LICENSE