@soos-io/soos-sbom
v1.0.6
Published
SOOS wrapper script to upload SBOMs.
Downloads
503
Maintainers
Readme
SOOS SBOM
SOOS is an independent software security company, located in Winooski, VT USA, building security software for your team. SOOS, Software security, simplified.
Use SOOS to scan your software for vulnerabilities and open source license issues with SOOS Core SCA. Generate and ingest SBOMs. Export reports to industry standards. Govern your open source dependencies. Run the SOOS DAST vulnerability scanner against your web apps or APIs. Scan your Docker containers for vulnerabilities. Check your source code for issues with SAST Analysis.
Demo SOOS or Register for a Free Trial.
If you maintain an Open Source project, sign up for the Free as in Beer SOOS Community Edition.
Requirements
Installation
Globally
run npm i -g @soos-io/soos-sbom@latest
Then Run soos-sbom
from any terminal and add the parameters you want.
Locally
run npm install --prefix ./soos @soos-io/soos-sbom
Then run from the same terminal node ./soos/node_modules/@soos-io/soos-sbom/bin/index.js
Client Parameters
| Argument | Default | Description |
| ----------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| --apiKey
| | SOOS API Key - get yours from SOOS Integration. Uses SOOS_API_KEY
env value if present. |
| --branchName
| | The name of the branch from the SCM System. |
| --branchURI
| | The URI to the branch from the SCM System. |
| --buildURI
| | URI to CI build info. |
| --buildVersion
| | Version of application build artifacts. |
| --clientId
| | SOOS Client ID - get yours from SOOS Integration. Uses SOOS_API_CLIENT
env value if present. |
| --commitHash
| | The commit hash value from the SCM System. |
| --logLevel
| INFO
| Minimum level to show logs: PASS, IGNORE, INFO, WARN, or FAIL. |
| --onFailure
| continue_on_failure
| Action to perform when the scan fails. Options: fail_the_build, continue_on_failure. |
| --operatingEnvironment
| | Set Operating environment for information purposes only. |
| --otherOptions
| | Other Options to pass to syft. |
| --projectName
| | Project Name - this is what will be displayed in the SOOS app. |
| --directoriesToExclude
| **/node_modules/**, "**/bin/**", "**/obj/**", "**/lib/**
| Listing of directories or patterns to exclude from the search for SBOM files. eg: bin/start/, /start/ |
| --filesToExclude
| | Listing of files or patterns patterns to exclude from the search for SBOM files. eg: /int.cdx.json/, **/internal.cdx.json |
| sbomPath
| | The SBOM file or folder to scan. When a folder is specified all SBOMs found in the folder and sub-folders will be scanned. |