Breadcrumbs

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"

  4.  This will show by default all libraries without a license, but you can select other options to filter as needed

  5. Click the "Export" button located on the top right

  6. Send the output file to Mend Support for review:  support@whitesourcesoftware.com

image2017-11-12_11-17-50.png

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"

image2017-11-12_11-20-4.png

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