You can easily integrate Helm into your CI/CD process to streamline and automate the process of creating product versions and uploading SBOMs to Helm. You can either use our GitHub action independently or integrate it into your existing GitHub action workflow, enabling you to maintain comprehensive and up-to-date documentation of your product's components, dependencies, and vulnerabilities with minimal effort.
Once configured, Helm will automatically add or update SBOMs for the appropriate product versions based on your event trigger when new or updated SBOMs are added to your connected GitHub repository.
Efficiency: Automates the labor-intensive process of maintaining SBOMs, freeing up your team to focus on development.
Accuracy and consistency: Ensures that every change in your codebase is reflected in your SBOMs.
Integration: Fits naturally into your existing GitHub workflows, enhancing your DevOps practices without disrupting them.
Compliance and transparency: Facilitates compliance with regulatory requirements and enhances transparency with stakeholders by providing detailed and up-to-date SBOMs.
What formats are supported? Currently, we only support CycloneDX JSON. If you need SPDX support, let us know.
Our GitHub Action simplifies the management of SBOMs by automating the creation and uploading of product versions and their corresponding SBOM files from your GitHub repository.
To get started, you'll need Helm API access and the API credentials, as well as our Helm API URL (api-base-url).
In your GitHub repository, create a /workflows directory: .github/workflows
Create a new workflow .yml file under .github/workflows/ if you don’t already have one. If you already have one, just incorporate our step under jobs: > steps.
Create a step to upload your SBOM in the jobs section.
In the step, you can refer to the parameters in the table below or to the Readme for each of the parameters you'll need to add.
Provide the product-name and product-version-name.
If the product and version don't exist and you want us to create it for you, set create-product-and-version-if-missing to true.
Pass in your client-id and client-secret. These are your Helm API credentials. client-id is your email address (for the user that generated the API key) and client-secret is that user's API key.
Provide your sbom-file-path.
In our action, we currently set on to workflow_dispatch, which enables you to run it manually from the GitHub UI, but you can set it to whatever trigger you want, such as push, pull_request, or to run on a schedule.
Using Visual Studio Code editor?
You can install their GitHub actions plug-in, which will enable you to hover over the parameters to get the information in the table below or in the Readme file.
In the uses: parameter, this is set to /medcrypt/action-helm-sbom-upload@your_version_branch
In the with: parameter, specify the following information:
repository
'https://helm.environment.medcrypt.co/sub-path/'
This is the Root URL of the Helm API, and is provided to you by Medcrypt.
product-name
'your product name'
This is your product name. Quotes are optional.
product-version-name
'1.0'
This is your product version. It must be enclosed in quotes to prevent truncation of numeric values.
create-product-and-version-if-missing
'false'
This indicates if a product or product version should be created if the product or version does not exist in Helm. This is set to false by default. Use this with caution.
client-id
${{ secrets.CLIENT_ID }}
This is the email address of the user that has Helm API access.
client-secret
${{ secrets.CLIENT_SECRET }}
This is the API key of the Helm API.
sbom-file-path
./api_test_sbom.json
This is the path to your SBOM file. This should be the location of the file within your current GitHub workspace, such as after checking out source code, downloading an artifact, etc.
Wrap our action up in your own workflow file, then write a reusable workflow using on: workflow_call to call your workflow.
Just copy and paste the step into that repo's yml file. If desired, you can create your own reusable action to store client-id and client-secret, anything that will be the same across your organization.
If there is an error, you can check the action to see where errors occurred.
You can remove the product from the UI or delete the version. Removing the product will archive it, so that you can readd it, but if you delete the version, you will no longer be able to access that version's SBOM, and will need to readd it.
You can stop using this or modify your action settings at any time, including changing or disconnecting repositories, changing event triggers, and more.