Getting started
Main concepts used
In Hermine a “product” is a piece of software that you develop internally.
A “release” is a version of a product.
A “component” is a third party FOSS component used by you
A “version” is a version of a component
A “scope” is a scenario in which a 3rd party dependency is used. Typically, in a nodeJS project there is two scopes:
dependencies
anddevDependencies
. The precise meaning depends on each package manager (see for instance Maven’s documentation for Dependency Scopes)
Manual workflow
You can use Hermine through the GUI for one shot analysis:
Create a release
From the Product list page (Your products –> All products), create a new product (button in the top left corner)
Create a release for this product (button in the top left corner)
Express your exploitation choices
The exploitation of a third party component is to describe what will be done with it.
It can be :
Distribution under a source and/or non source form
Exposing is functionalities through the network
Internal usage only
You can define general exploitation rules for each scope of your release.
http://127.0.0.1:8080/release/1/exploitation
Import your raw SBOM
There is currently two formats supported to import raw SBOMS: [OSS Review Toolkit]’s native format and SPDX.
OSS Review Toolkit’s EvaluatedModel
To generate an
EvaluatedModel
report with ORT from the Analyzer results:
ort analyze -i /path/to/sourcecode -o /folder/for/analyzer/ -f JSON
then
ort report -f EvaluatedModel -i /folder/for/analyzer/analyzer-result.json -o /folder/for/reporter
SPDX
SPDX support is still basic at the moment. Exports from Artyfactory or Fossology seem to work, but further testing is still needed.
Importing
To actually import the raw SBOM, go to the “Import components” tab, and select:
your format (cf. supra) and the location of the file
If you want to delete the current content of the release or not
And the type of linking, between the dependencies listed in this import and the code base of your product.
Validate your import
Go to the “Validation steps” tab to validate the components you have just imported.
Validation Step 1
Checks that all the packages have a proper SPDX expression. Some package may miss licence information or carry information that doesn’t follow the SPDX standard.
You can create “curation” rules. That will be stored and reused when the same component is used in another release/product.
Validation Step 2
Confirm ANDs operators in SPDX expressions are not poorly registered ORs. In some situations multiple licences are just expressed as a list, which is automatically converted as a cumulative expression (“A AND B”), while the reality of the licencing is actually alternative (“A OR B”), causing often false alarms.
Validation Step 3
This will list every scope used in you release and check that every one of them has an exploitation mode defined.
Validation Step 4
When a component is proposed under different licences, you must express under which you want to exploit them. You can create choice rules that will apply to different component / versions.
Validation Step 5
Check that the licenses are compatible with your policy. You can add derogations in order to handle specific cases.
Read your validated SBOM
Once you have passed all the validation steps, you can read the resulting SBOM in the “Bill of Materials” tab. You can tweak each usage, for instance to change the exploitation on individual components.
Read your obligations
The “Obligations” tab lists the resulting obligations.