Applying Initiatives to your SDLC

You can use Scribe to apply policies at different points along your SDLC. For example, at the end of a build or at the admission control point to the production cluster. Use cases include:

Images must be signed, and they must have a matching CycloneDX SBOM.
Images must be built by a CircleCI workflow and produce signed SLSA provenance.
Tagged sources must be signed and verified by a set of individuals or processes.

For a detailed initiative description, see the initiatives section.

Quickstart

Creating an SBOM

Install valint:

curl -sSfL https://get.scribesecurity.com/install.sh  | sh -s -- -t valint

Create an SBOM of the type you want to verify. For a Docker image, the command would be:

valint bom busybox:latest -o attest \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

See Getting started with valint for more information on the bom command.

Alternatively, you can use GitHub actions, as described in detail in Setting up an integration in GitHub.

Verifying an initiative

Create an image SBOM as described in Creating an SBOM.

Verify the SBOM against an initiative. Let's take the SSDF initiative provided in the Scribe Sample Catalog:

valint verify busybox:latest --initiative ssdf@v2 \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

As a result, you will see the output table of the initiative verification. A detailed description of the fields is provided in the corresponding section of the Policy Results page.

Initiative results

INFO PS/PS.2/PS.2.1: Control "Make software integrity verification information available to software acquirers" Evaluation Summary: 
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.2/PS.2.1] Control "Make software integrity verification information available to software acquirers" Evaluati │
│ on Summary                                                                                                           │
├────────────────┬──────────────────┬───────┬──────────┬────────┬─────────────────────────────┬────────────────────────┤
│ RULE ID        │ RULE NAME        │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                     │ TARGET                 │
├────────────────┼──────────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ sbom-is-signed │ Image-verifiable │ none  │ true     │ pass   │ Evidence signature verified │ busybox:1.36.1 (image) │
├────────────────┼──────────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ CONTROL RESULT │                  │       │          │ PASS   │                             │                        │
└────────────────┴──────────────────┴───────┴──────────┴────────┴─────────────────────────────┴────────────────────────┘
INFO PS/PS.3/PS.3.1: Control "Securely archive the necessary files and supporting data to be retained for each software release" Evaluation Summary: 
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.3/PS.3.1] Control "Securely archive the necessary files and supporting data to be retained for each software  │
│ release" Evaluation Summary                                                                                          │
├───────────────────┬───────────────────┬───────┬──────────┬────────┬─────────────────────────┬────────────────────────┤
│ RULE ID           │ RULE NAME         │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                 │ TARGET                 │
├───────────────────┼───────────────────┼───────┼──────────┼────────┼─────────────────────────┼────────────────────────┤
│ provenance-exists │ Provenance exists │ error │ false    │ fail   │ SLSA Provenance missing │ busybox:1.36.1 (image) │
├───────────────────┼───────────────────┼───────┼──────────┼────────┼─────────────────────────┼────────────────────────┤
│ CONTROL RESULT    │                   │       │          │ FAIL   │                         │                        │
└───────────────────┴───────────────────┴───────┴──────────┴────────┴─────────────────────────┴────────────────────────┘
INFO PS/PS.3/PS.3.2: Control "Collect, safeguard, maintain, and share provenance data for all components of each software release" Evaluation Summary: 
┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.3/PS.3.2] Control "Collect, safeguard, maintain, and share provenance data for all components of each soft │
│ ware release" Evaluation Summary                                                                                  │
├────────────────┬───────────────┬───────┬──────────┬────────┬─────────────────────────────┬────────────────────────┤
│ RULE ID        │ RULE NAME     │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                     │ TARGET                 │
├────────────────┼───────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ sbom-is-signed │ SBOM archived │ none  │ true     │ pass   │ Evidence signature verified │ busybox:1.36.1 (image) │
├────────────────┼───────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ CONTROL RESULT │               │       │          │ PASS   │                             │                        │
└────────────────┴───────────────┴───────┴──────────┴────────┴─────────────────────────────┴────────────────────────┘
INFO SSDF: Initiative "SSDF Client Initiative" Evaluation Summary: 
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [SSDF] Initiative "SSDF Client Initiative" Evaluation Summary                                                              │
├───────────────────┬──────────────────────────────────────────────────────────────────┬────────────────────────────┬────────┤
│ CONTROL ID        │ CONTROL NAME                                                     │ RULE LIST                  │ RESULT │
├───────────────────┼──────────────────────────────────────────────────────────────────┼────────────────────────────┼────────┤
│ PS/PS.2/PS.2.1    │ Make software integrity verification information available to so │ - Image-verifiable (pass)  │ pass   │
│                   │ ftware acquirers                                                 │                            │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼────────────────────────────┼────────┤
│ PS/PS.3/PS.3.1    │ Securely archive the necessary files and supporting data to be r │ - Provenance exists (fail) │ fail   │
│                   │ etained for each software release                                │                            │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼────────────────────────────┼────────┤
│ PS/PS.3/PS.3.2    │ Collect, safeguard, maintain, and share provenance data for all  │ - SBOM archived (pass)     │ pass   │
│                   │ components of each software release                              │                            │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼────────────────────────────┼────────┤
│ INITIATIVE RESULT │                                                                  │                            │ FAIL   │
└───────────────────┴──────────────────────────────────────────────────────────────────┴────────────────────────────┴────────┘
Evaluation Target Name 'index.docker.io/library/busybox:latest'

info

Only the rules that are applicable to the target (the busybox:latest docker image) were verified. Other rules were disabled automatically, and no result was generated for them.

info

To verify the whole SSDF initiative, you need to run SCM platform discovery. See platforms discovery.

Running a single rule verification

Similar to initiatives, you can verify a single rule. Let's take as an example the sbom-require-complete-license-set rule from the Scribe Sample Catalog:

Create an image SBOM as described in Creating an SBOM.

Verify the SBOM against an existing rule from the bundle. The Scribe Sample Rule Catalog will be used as the default rule bundle for valint.

valint verify busybox:latest --rule sbom/complete-licenses@v2 \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

As a result, you will see the output table of the rule verification. A detailed description of the fields is provided in the corresponding section of the Policy Results page.

Rule evaluation results

┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [default] Control "Default" Evaluation Summary                                                                                                          │
├───────────────────────────────────┬───────────────────────────────────┬───────┬──────────┬────────┬────────────────────────────┬────────────────────────┤
│ RULE ID                           │ RULE NAME                         │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                    │ TARGET                 │
├───────────────────────────────────┼───────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────┼────────────────────────┤
│ sbom-require-complete-license-set │ Enforce SBOM License Completeness │ error │ false    │ pass   │ All packages have licenses │ busybox:1.36.1 (image) │
├───────────────────────────────────┼───────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────┼────────────────────────┤
│ CONTROL RESULT                    │                                   │       │          │ PASS   │                            │                        │
└───────────────────────────────────┴───────────────────────────────────┴───────┴──────────┴────────┴────────────────────────────┴────────────────────────┘

You will also see the results table of the initiative evaluation:

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│ [client-initiative] Initiative "client-initiative" Evaluation Summary                       │
├───────────────────┬───────────────┬────────────────────────────────────────────────┬────────┤
│ CONTROL ID        │ CONTROL NAME  │ RULE LIST                                      │ RESULT │
├───────────────────┼───────────────┼────────────────────────────────────────────────┼────────┤
│ default           │ Default       │ sbom-require-complete-license-set(pass)        │ pass   │
├───────────────────┼───────────────┼────────────────────────────────────────────────┼────────┤
│ INITIATIVE RESULT │               │                                                │ PASS   │
└───────────────────┴───────────────┴────────────────────────────────────────────────┴────────┘

info

The rule was put in the client-initiative initiative. To change that, you can use the --initiative-name and --initiative-id flags. It was also put in the default control. This cannot be changed unless you provide a full initiative config with custom names and IDs for your controls.

Targetless Run

Some of the rules in this catalog can also be run in "targetless" mode, meaning that the evidence will be looked up based only on the product name, version, and options specified in the rule config. No target for preliminary analysis is needed. This is usually helpful for third-party reports, such as security scans and platform discoveries.

As an example, let's run trivy to create a SARIF report:

trivy image --format sarif --output results.sarif ubuntu:latest

Then, create evidence from this report:

valint evidence results.sarif \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

Finally, verify the evidence against the rule. Note that we don't need to provide valint with the target report:

valint verify --rule sarif/trivy/verify-trivy-report@v2 \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

valint will use the latest evidence for the specified product name and version that meets the other rule requirements. In our example, the rule needs an evidence created by the "Trivy Vulnerability Scanner" tool, so valint was able to find it just by this partial context.

Initiative results

┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [default] Control "Default" Evaluation Summary                                                                                     │
├────────────────┬──────────────────────────────────────┬───────┬──────────┬────────┬────────────────────────────────┬───────────────┤
│ RULE ID        │ RULE NAME                            │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                        │ TARGET        │
├────────────────┼──────────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────┼───────────────┤
│ trivy-report   │ Verify Trivy SARIF Report Compliance │ error │ false    │ fail   │ 113 violations | 0 max allowed │ results.sarif │
├────────────────┼──────────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────┼───────────────┤
│ CONTROL RESULT │                                      │       │          │ FAIL   │                                │               │
└────────────────┴──────────────────────────────────────┴───────┴──────────┴────────┴────────────────────────────────┴───────────────┘

┌────────────────────────────────────────────────────────────────────────┐
│ [client-initiative] Initiative "client-initiative" Evaluation Summary  │
├───────────────────┬───────────────┬───────────────────────────┬────────┤
│ CONTROL ID        │ CONTROL NAME  │ RULE LIST                 │ RESULT │
├───────────────────┼───────────────┼───────────────────────────┼────────┤
│ default           │ Default       │ trivy-report(fail)        │ fail   │
├───────────────────┼───────────────┼───────────────────────────┼────────┤
│ INITIATIVE RESULT │               │                           │ FAIL   │
└───────────────────┴───────────────┴───────────────────────────┴────────┘

Whole initiative verification

If you want to verify an initiative on all existing attestations, provide valint with the --all-evidence flag. It disables using of target for evidence filtering and verifies all matching attestations for each rule.

valint verify --initiative ssdf@v2 --all-evidence \
   --product-key <PRODUCT_KEY> -- product-version <PRODUCT_VERSION> \
   --scribe.client-secret <SCRIBE_TOKEN>

Initiative results

INFO PS/PS.3/PS.3.1: Control "Securely archive the necessary files and supporting data to be retained for each software release" Evaluation Summary: 
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.3/PS.3.1] Control "Securely archive the necessary files and supporting data to be retained for each software  │
│ release" Evaluation Summary                                                                                          │
├───────────────────┬───────────────────┬───────┬──────────┬────────┬─────────────────────────┬────────────────────────┤
│ RULE ID           │ RULE NAME         │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                 │ TARGET                 │
├───────────────────┼───────────────────┼───────┼──────────┼────────┼─────────────────────────┼────────────────────────┤
│ provenance-exists │ Provenance exists │ error │ false    │ fail   │ SLSA Provenance missing │ busybox:1.36.1 (image) │
├───────────────────┼───────────────────┼───────┼──────────┼────────┼─────────────────────────┼────────────────────────┤
│ CONTROL RESULT    │                   │       │          │ FAIL   │                         │                        │
└───────────────────┴───────────────────┴───────┴──────────┴────────┴─────────────────────────┴────────────────────────┘
INFO PS/PS.3/PS.3.2: Control "Collect, safeguard, maintain, and share provenance data for all components of each software release" Evaluation Summary: 
┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.3/PS.3.2] Control "Collect, safeguard, maintain, and share provenance data for all components of each soft │
│ ware release" Evaluation Summary                                                                                  │
├────────────────┬───────────────┬───────┬──────────┬────────┬─────────────────────────────┬────────────────────────┤
│ RULE ID        │ RULE NAME     │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                     │ TARGET                 │
├────────────────┼───────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ sbom-is-signed │ SBOM archived │ none  │ true     │ pass   │ Evidence signature verified │ busybox:1.36.1 (image) │
├────────────────┼───────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ CONTROL RESULT │               │       │          │ PASS   │                             │                        │
└────────────────┴───────────────┴───────┴──────────┴────────┴─────────────────────────────┴────────────────────────┘
INFO PS/PS.1/PS.1.1: Control "Store all forms of code based on the principle of least privilege" Evaluation Summary: 
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.1/PS.1.1] Control "Store all forms of code based on the principle of least privilege" Evaluation Summary                                                  │
├────────────────────┬────────────────────────────────┬───────┬──────────┬────────┬────────────────────────────────────────┬───────────────────────────────────────┤
│ RULE ID            │ RULE NAME                      │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                                │ TARGET                                │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ 2fa                │ Enforce 2FA                    │ error │ true     │ fail   │ 2FA authentication is NOT enabled      │ my-org (github organization)          │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ branch-protection  │ Branch protected               │ error │ true     │ fail   │ 1 unprotected branches | 0 max allowed │ my-repo (github repo)                 │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ max-admins         │ Limit admins                   │ error │ true     │ fail   │ 6 admins | 3 max allowed               │ my-org (github organization)          │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ repo-is-private    │ Repo private                   │ none  │ true     │ pass   │ The repository is private              │ my-repo (github repo)                 │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ web-commit-signoff │ Require signoff on web commits │ error │ true     │ fail   │ web_commit_signoff_required is NOT set │ my-org (github organization)          │
├────────────────────┼────────────────────────────────┼───────┼──────────┼────────┼────────────────────────────────────────┼───────────────────────────────────────┤
│ CONTROL RESULT     │                                │       │          │ FAIL   │                                        │                                       │
└────────────────────┴────────────────────────────────┴───────┴──────────┴────────┴────────────────────────────────────────┴───────────────────────────────────────┘
INFO PS/PS.2/PS.2.1: Control "Make software integrity verification information available to software acquirers" Evaluation Summary: 
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [PS/PS.2/PS.2.1] Control "Make software integrity verification information available to software acquirers" Evaluati │
│ on Summary                                                                                                           │
├────────────────┬──────────────────┬───────┬──────────┬────────┬─────────────────────────────┬────────────────────────┤
│ RULE ID        │ RULE NAME        │ LEVEL │ VERIFIED │ RESULT │ SUMMARY                     │ TARGET                 │
├────────────────┼──────────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ sbom-is-signed │ Image-verifiable │ none  │ true     │ pass   │ Evidence signature verified │ busybox:1.36.1 (image) │
├────────────────┼──────────────────┼───────┼──────────┼────────┼─────────────────────────────┼────────────────────────┤
│ CONTROL RESULT │                  │       │          │ PASS   │                             │                        │
└────────────────┴──────────────────┴───────┴──────────┴────────┴─────────────────────────────┴────────────────────────┘
INFO SSDF: Initiative "SSDF Client Initiative" Evaluation Summary: 
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [SSDF] Initiative "SSDF Client Initiative" Evaluation Summary                                                                           │
├───────────────────┬──────────────────────────────────────────────────────────────────┬─────────────────────────────────────────┬────────┤
│ CONTROL ID        │ CONTROL NAME                                                     │ RULE LIST                               │ RESULT │
├───────────────────┼──────────────────────────────────────────────────────────────────┼─────────────────────────────────────────┼────────┤
│ PS/PS.1/PS.1.1    │ Store all forms of code based on the principle of least privileg │ - Branch protected (fail),              │ fail   │
│                   │ e                                                                │ - Repo private (pass),                  │        │
│                   │                                                                  │ - Enforce 2FA (fail),                   │        │
│                   │                                                                  │ - Limit admins (fail),                  │        │
│                   │                                                                  │ - Require signoff on web commits (fail) │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼─────────────────────────────────────────┼────────┤
│ PS/PS.2/PS.2.1    │ Make software integrity verification information available to so │ - Image-verifiable (pass)               │ pass   │
│                   │ ftware acquirers                                                 │                                         │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼─────────────────────────────────────────┼────────┤
│ PS/PS.3/PS.3.1    │ Securely archive the necessary files and supporting data to be r │ - Provenance exists (fail)              │ fail   │
│                   │ etained for each software release                                │                                         │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼─────────────────────────────────────────┼────────┤
│ PS/PS.3/PS.3.2    │ Collect, safeguard, maintain, and share provenance data for all  │ - SBOM archived (pass)                  │ pass   │
│                   │ components of each software release                              │                                         │        │
├───────────────────┼──────────────────────────────────────────────────────────────────┼─────────────────────────────────────────┼────────┤
│ INITIATIVE RESULT │                                                                  │                                         │ FAIL   │
└───────────────────┴──────────────────────────────────────────────────────────────────┴─────────────────────────────────────────┴────────┘

In this case, no rule was disabled, and all of them were verified.

Migration from an older version

Before initiatives were introduced in valint v2.0.0, a slightly different format of configs was used for the policy engine. Essentially, there were only rule and policy configs, so if you're using one of those, here's how you can migrate to the new format.

Rule configs migration

In general, older rule configs can be used in valint v2.0.0 and newer with some minor changes. The main difference is that, from now on, valint requires each config to state its format. The only change needed is to add this line to your rule config:

config-type: rule

After that, you can pass the rule config to valint using the same --rule flag as before.

Policy configs migration

Policy configs were deprecated in valint v2.0.0. Policies themselves were renamed to controls and are now consumed as part of the initiative config. The migration process is slightly more complex but still quite straightforward.

If you use a single policy config, you can copy it entirely under the controls key in the new initiative config. For example, if you have a policy config like this:

name: "MyPolicy"
rules:
  - uses: images/blocklist-build-scripts@v1
    level: error
    with:
      blocklist:
      - "wget"
      - "curl"

then the new initiative config will look like this:

config-type: "initiative"
name: "MyInitiative"
controls:
  - name: "MyControl"
    rules:
      - uses: images/blocklist-build-scripts@v1
        level: error
        with:
          blocklist:
          - "wget"
          - "curl"

If you use multiple policies at once, you can copy all of them under the controls key in the new initiative config.

The next important step is to ensure that the referenced rules work with the new valint version. If you use rules from the Scribe Sample Catalog, you only need to change the referenced rule version from @v1 to @v2. If your rule is not listed in the updated catalog, please check whether it was renamed or moved to a different folder. As a result, the initiative configuration will look like this:

config-type: "initiative"
name: "MyInitiative"
controls:
  - name: "MyControl"
    rules:
      - uses: images/blocklist-build-scripts@v2
        level: error
        with:
          blocklist:
          - "wget"
          - "curl"

This configuration can be passed to valint using the --initiative flag.

If you're using custom rules, update them as shown in the section above.

tip

Note that initiatives provide more flexibility and control over rules and controls than policies, including smart filtering as shown in the Rule Filtering section. Depending on the scenario, it might be useful to place all controls in a single initiative and filter them by gate or target.

note

Starting with valint v2.0.0, some initiatives are shipped as part of the Scribe Catalog. See this section and this section for more details.

Example

Let's take SLSA L2 as an example. Prior to valint v2.0.0, one could verify a single SLSA L2 rule using the following command:

valint verify alpine:latest --rule slsa/l2-provenance-authenticated@v1 --product-key <PRODUCT_KEY> --product-version <PRODUCT_VERSION>

This command would verify the alpine:latest image against the slsa/l2-provenance-authenticated rule.

To run v2 of the same rule, you could simply replace @v1 with @v2 in the command shown above. However, with the initiatives available, it is recommended to run the following command:

valint verify alpine:latest --initiative slsa.l2@v2 --product-key <PRODUCT_KEY> --product-version <PRODUCT_VERSION>

This command will verify the alpine:latest image against all rules in the SLSA L2 initiative, including slsa/l2-provenance-authenticated.

We recommend using the initiative configuration also for SLSA L1, as it provides better result descriptions and integration with the Scribe service. In that case, the command will look like this:

valint verify alpine:latest --initiative slsa.l1@v2 --product-key <PRODUCT_KEY> --product-version <PRODUCT_VERSION>

To get more information about initiatives provided in the Scribe Policy Catalog, see the Sample Policy Catalog section.

Sample Policy Catalog

We provide a set of sample initiatives and rules that can be used to verify the compliance of your software supply chain. This catalog is used by valint by default. To use a different version of this catalog, use the --bundle-tag valint flag.

To use a custom initiatives rule catalog, you can specify the path to the catalog in the --bundle flag (it may be a local path or a git repo). Additionally, --bundle-branch and --bundle-tag flags can be used to specify the branch or tag of the catalog git repo.

Name	Description
NIST Application Container Security Initiative	This initiative enforces container security controls as outlined in NIST SP 800-190. It ensures that containerized applications follow security best practices, including vulnerability scanning, trusted image sources, registry security, and proper configuration to minimize risk. The initiative enables policy-driven enforcement of security controls throughout the software development lifecycle (SDLC), providing real-time feedback to developers and enforcement in CI/CD pipelines.
NIST Supply Chain Integrity Initiative	This initiative enforces key supply chain requirements from NIST SP 800-53. It mandates that container builds include: - A Software Bill of Materials (SBOM) to ensure component inventory and traceability, addressing requirements from SR-4 and CM-8. - Provenance data to support architectural traceability, as outlined in SA-8. Both the SBOM and the provenance artifacts must be cryptographically signed to meet integrity requirements specified in SA-12.
OWASP Top 10 CI/CD Security Controls	OWASP Top 10 CI/CD Security Controls - GitHub
SLSA L1 Framework	Evaluate SLSA Level 1
SLSA L2 Framework	Evaluate SLSA Level 2
SSDF Client Initiative	Evaluate PS rules from the SSDF initiative
Secure Software Pipeline Blueprint	Blueprint for secure pipelines - Gitlab
Secure Software Pipeline Blueprint	Blueprint for secure pipelines - GitHub

Rules

SBOM

Evidence Type: SBOM

Rule Name	Description
Apply Scribe Template Policy	Verify XX using the Scribe API template rule.
Scribe Published Policy	Verify image Scribe Publish flag is set for container image.
Verify No Critical or High Vulnerabilities	Verify via Scribe API that there are no critical or high severity vulnerabilities in the target artifact (container image, folder, etc.).
NTIA SBOM Compliance Check	Validates that SBOM metadata meets basic NTIA requirements for authors and supplier.
Enforce SBOM Freshness	Verify the SBOM is not older than the specified duration.
Require SBOM Existence	Verify the SBOM exists as evidence.
Require SBOM Signature	Verify the SBOM is signed.
Require SBOM Existence	Verify the SBOM exists as evidence.

Image SBOM

Evidence Type: Image SBOM

Rule Name	Description
Verify Image Labels	Verify specified labels key-value pairs exist in the image.
Forbid Large Images	Verify the image size is below the specified threshold.
Disallow Container Shell Entrypoint	Verify the container image disallows shell entrypoint.
Fresh Base Image	Verifies that each base image is not older than the specified threshold (max_days) from its creation date.
Banned Ports	Ensures that the container image does not expose ports that are disallowed by organizational policy. The rule examines properties in the SBOM metadata and checks each value (expected in the format "port/protocol") against a provided banned ports list. It fails if any banned port is exposed or if no banned ports list is provided.
Disallow Specific Users in SBOM	Verify specific users are not allowed in an SBOM.
Restrict Build Scripts	Verify no build scripts commands appear in block list.
Registry Connection HTTPS	Checks if the container's registry scheme is HTTPS
Verify NPM Packages Origin	Verify that the artifact contains only components from allowed NPM registries.
Require Image Labels	Verify the image has the specified labels.
Require Healthcheck	Checks that the container image includes at least one healthcheck property.
Allowed Base Image	Verifies that every base image is from an approved source. The rule returns a summary including the component names and versions of valid base images, or lists the invalid ones. This rule requires Dockerfile context; for example, run it with: `valint my_image --base-image Dockerfile`.
Fresh Image	Verify the image is not older than the specified threshold.
Allowed Main Image Source	Ensures the main container image referenced in the SBOM is from an approved source.
Require Signed Container Image	Enforces that container images (target_type=container) are cryptographically signed.
Disallow Specific Users in SBOM	Verify specific users are not allowed in an SBOM.
Enforce SBOM Dependencies	Verify the artifact includes all required dependencies.
Enforce SBOM License Completeness	Verify all dependencies in the artifact have a license.
Restrict Disallowed SBOM Licenses	Verify the number of disallowed licenses in SBOM dependencies remains below the specified threshold.
Enforce Allowed SBOM Components	Verify the artifact contains only allowed components.
Require Specified SBOM Licenses	Verify the artifact includes all specified licenses.
Restrict Disallowed Dependencies	Verify the number of disallowed dependencies remains below the specified threshold.

Git SBOM

Evidence Type: Git SBOM

Rule Name	Description
Restrict Coding Permissions	Verify only allowed users committed to the repository.
Required Git Evidence Exists	Verify required Git evidence exists.
Git Artifact Signed	Verify the Git artifact is signed.
Disallow Commits to Main Branch	Verify commits made directly to the main branch are disallowed.
Disallow Unsigned Commits	Verify all commits are signed.

SLSA Provenance

Evidence Type: SLSA Provenance

Rule Name	Description
SLSA External Parameters Match in Provenance Document	Verify the specified external parameters value match in the provenance document.
Verify that provenance is authenticated	Verify the artifact is signed.
SLSA Field Exists in Provenance Document	Verify the specified field exists in the provenance document.
Verify Provenance Document Exists	Verify that the Provenance document evidence exists.
Disallow dependencies in SLSA Provenance Document	Verify that dependencies in the block list do not appear in the SLSA Proveance document.
Verify build time	Verify the artifact was created within the specified time window.
Verify that artifact was created by the specified builder	Verify the artifact was created by the specified builder.
Verify that artifact has no disallowed builder dependencies	Verify the artifact has no disallowed builder dependencies.
SLSA Field Value Matches in Provenance Document	Verify the specified field value matches in the provenance document.

SARIF Evidence

Evidence Type: SARIF Evidence

Rule Name	Description
Verify Attack Vector Exists in SARIF	Verify required evidence validates attack vectors in the SARIF report.
Verify IaC Misconfiguration Threshold in SARIF	Verify the number of infrastructure-as-code (IaC) errors in the SARIF report remains below the specified threshold.
Verify Required Evidence in SARIF	Verify all required evidence exists as defined by the SARIF policy.
Verify Artifact Signature in SARIF	Verify the artifact referenced in the SARIF report is signed to confirm its integrity.
Verify Rule Compliance in SARIF	Verify the SARIF report complies with defined generic rules for compliance and security. vulnerability profiles.
Verify Tool Evidence in SARIF	Verify required tools were used to generate the SARIF report.
Verify Semgrep Rule in SARIF	Verify the Semgrep SARIF report complies with predefined rules to ensure compliance and detect issues.
Verify Trivy SARIF Report Compliance	Verify the Trivy SARIF report complies with predefined rules to ensure compliance and detect issues.
Verify IaC Misconfiguration Threshold in Trivy SARIF	Verify the number of infrastructure-as-code (IaC) errors in the Trivy SARIF report remains below the specified threshold.
Trivy Blocklist CVE Check	Verify a CVE Blocklist against a SARIF report
Trivy Vulnerability Findings Check	Verifies that vulnerability findings in the SARIF evidence from Trivy do not exceed the defined severity threshold.
Verify Attack Vector Threshold in Trivy SARIF	Verify no attack vector in the Trivy SARIF report exceeds the specified threshold.
SARIF Update Needed	Verify no security packages require updates.
K8s Jailbreak	Verify no misconfigurations from the prohibited ids list in the Kuberentes scan is below specified threshold

Generic Statement

Evidence Type: Generic Statement

Rule Name	Description
3rd Party Scanner Violations	Limit allowed violations in 3rd party scanner reports
Required Trivy Evidence Exists	Verify required Trivy evidence exists
Required Generic Evidence Exists	Verify required evidence exists.
Generic Artifact Signed	Verify required evidence is signed.

Github Organization Discovery Evidence

Evidence Type: Github Organization Discovery Evidence

Rule Name	Description
Verify members_can_create_repositories setting	Verify only allowed users can create repositories in the GitHub organization.
Verify `secret_scanning_push_protection` Setting	Verify secret scanning push protection is configured in the GitHub repository.
Verify `secret_scanning_validity_checks_enabled` Setting	Verify validity checks for secrets are configured for the GitHub repository.
Verify dependabot_security_updates_enabled_for_new_repositories setting	Verify Dependabot security updates for new repositories are configured in the GitHub organization.
Verify `secret_scanning` Setting in `security_and_analysis`	Verify secret scanning is configured in the GitHub repository.
Limit Admin Number in GitHub Organization	Verify the maximum number of GitHub organization admins is restricted.
Verify `advanced_security_enabled_for_new_repositories` setting	Verify Advanced Security is enabled for new repositories in the GitHub organization.
Require GitHub Organization Discovery Evidence	Verify the GitHub Organization exists as evidence.
Verify dependency_graph_enabled_for_new_repositories setting	Verify dependency graph is enabled for new repositories in the GitHub organization.
Verify GitHub Organization Requires Signoff on Web Commits	Verify contributors sign commits through the GitHub web interface.
Verify Two-Factor Authentication (2FA) Requirement Enabled	Verify Two-factor Authentication is required in the GitHub organization.
Verify GitHub Organization Secrets Are Not Too Old	Verify secrets in the GitHub organization are not older than the specified threshold.
Allowed GitHub Organization Admins	Verify only users in the Allowed List have admin privileges in the GitHub organization.
Verify secret_scanning_enabled_for_new_repositories setting	Verify secret scanning is configured for new repositories in the GitHub organization.
Allowed GitHub Organization Users	Verify only users in the Allowed List have user access to the GitHub organization.
Verify `secret_scanning_push_protection_custom_link_enabled` Setting	Verify secret scanning push protection custom link is enabled in the GitHub organization.
Verify dependabot_security_updates setting in security_and_analysis	Verify Dependabot security updates are configured in the GitHub organization.
Verify that members can create private repositories setting is configured	Verify only allowed users can create private repositories in the GitHub organization.
Verify Repo Visibility Setting	Verify only repositories in the Allowed List are public in the GitHub organization.
Verify `secret_scanning_validity_checks` Setting in `security_and_analysis`	Verify validity checks for secrets are configured for the GitHub organization.
Verify `secret_scanning_push_protection_enabled_for_new_repositories` Setting	Verify secret scanning push protection is enabled for new repositories in the GitHub organization.
Verify dependabot_alerts_enabled_for_new_repositories setting	Verify Dependabot alerts for new repositories are enabled in the GitHub organization.

Github Repository Discovery Evidence

Evidence Type: Github Repository Discovery Evidence

Rule Name	Description
Pull request approval policy check for GitHub repository	Verify the repository's pull request approval policy
Verify secret scanning.	Verify both `secret_scanning_validity_checks` and `security_and_analysis` are set in GitHub organization and all the repositories.
Verify Dependabot security updates setting	Verify Dependabot security updates are configured in the GitHub repository.
Verify Repository Is Private	Verify the GitHub repository is private.
Require GitHub Repository Discovery Evidence	Verify the GitHub Repository exists as evidence.
Verify Repository Requires Commit Signoff	Verify contributors sign off on commits to the GitHub repository through the GitHub web interface.
Verify Default Branch Protection	Verify the default branch protection is configured in the GitHub repository.
Verify No Old Secrets Exist in Repository	Verify secrets in the GitHub repository are not older than the specified threshold.
Verify No Organization Secrets Exist in Repository	Verify no organization secrets exist in the GitHub repository.
Verify Branch Verification Setting	Verify branch verification in the GitHub repository matches the value defined in the configuration file.
Verify Branch Protection Setting	Verify branch protection is configured in the GitHub repository.
Verify All Commits Are Signed in Repository	Verify all commits are signed in a repository attestation.
Verify secret_scanning setting	Verify `secret_scanning` is configured in the GitHub repository.
Verify No Cache Usage Exists in Repository	Verify the GitHub repository has no cache usage.
Verify All Commits Are Signed in Repository	Verify all commits in the GitHub repository are signed.
Repo Workflows and Pipelines Discovered	Ensure that repository pipelines discovery was not skipped.
Verify Only Ephemeral Runners Exist in Repository	Verify self-hosted runners are disallowed in the GitHub repository.
Allowed Public Repositories	Verify only GitHub repositories in the Allowed List are public.
Verify Push Protection Setting	Verify `secret_scanning_push_protection` is configured in the GitHub repository.

Gitlab Organization Discovery Evidence

Evidence Type: Gitlab Organization Discovery Evidence

Rule Name	Description
Limit Admins in GitLab Organization	Verify the maximum number of admins for the GitLab project is restricted.
Require Gitlab Organization Discovery Evidence	Verify the Gitlab Organization exists as evidence.
Ensure Active Projects in GitLab Organization	Verify no GitLab organization projects are inactive.
Restrict Public Visibility in GitLab Organization	Verify only allowed projects in the GitLab organization have public visibility.
Allowed Admins in GitLab Organization	Verify only users in the Allowed List have admin privileges in the GitLab organization.
Forbid Long-Lived Tokens in GitLab Organization	Verify no GitLab organization tokens have an excessively long lifespan.
Forbid Unused Tokens in GitLab Organization	Verify there are no unused GitLab organization tokens.
Allowed Users in GitLab Organization	Verify only users in the Allowed List have access to the GitLab organization.
Restrict Token Scopes in GitLab	Verify all tokens in the GitLab organization are restricted to allowed scopes to prevent excessive permission.
Block Users in GitLab Organization	Verify no users in the GitLab organization are on the block list.
Prevent Token Expiration in GitLab Organization	Verify no GitLab organization tokens are about to expire.
Forbid Token Scopes in GitLab Organization	Verify no GitLab organization tokens have disallowed scopes.

Gitlab Project Discovery Evidence

Evidence Type: Gitlab Project Discovery Evidence

Rule Name	Description
Merge approval policy check for GitLab project	Verify the project's merge approval policy complies with requirements.
Set Push Rules for GitLab Project	Verify push rules are set for the GitLab project.
Disable Committers' Approval for Merge Requests in GitLab	Verify `merge_requests_disable_committers_approval` is set for the GitLab project.
Restrict Commit Authors in GitLab Project	Verify only GitLab project users in the Allowed List have commit author permissions.
Require Minimal Approvers in GitLab Project	Verify the required number of approvers for the GitLab project is met.
Enforce Medium Severity Limit	Verify the maximum allowed medium severity alerts for the GitLab project.
Enforce Merge Access Level Policy for GitLab Project	Verify the GitLab project's merge access level complies with requirements.
Set Author Email Regex in GitLab Project	Verify the `author_email_regex` for the GitLab project is set to the specified value.
Check CWE Compliance	Verify that specified CWEs were not detected in the GitLab project.
Enforce Critical Severity Limit	Verify the maximum allowed critical severity alerts for the GitLab project.
Verify Commit Message Format	Verify that commit messages in the GitLab project adhere to the specified format template.
Enable Member Check for GitLab Project	Verify `member_check` is enabled for the GitLab project.
Restrict Selective Code Owner Removals in GitLab	Verify `selective_code_owner_removals` is set for the GitLab project.
Run Secrets Scanning in GitLab Project	Verify secrets scanning is performed for the GitLab project.
Reset Approvals on Push in GitLab Project	Verify `reset_approvals_on_push` is set for the GitLab project.
Require Gitlab Project Discovery Evidence	Verify the Gitlab Project exists as evidence.
Reject Unsigned Commits in GitLab Project	Verify `reject_unsigned_commits` is enabled for the GitLab project.
Enable Commit Committer Check in GitLab Project	Verify `commit_committer_check` is enabled for the GitLab project.
Protect CI Secrets in GitLab Project	Verify secrets in the GitLab project are not shared.
Validate All Commits in GitLab Project	Verify all commits in the GitLab project are validated.
Disallow Banned Approvers	Verify approvers in the GitLab project are not on the banned list.
Allowed Committer Emails in GitLab Project	Verify only users in the Allowed List use committer email addresses in the GitLab project.
Set Push Access Level in GitLab Project	Verify the GitLab project's push access level policy complies with requirements.
Disallow Force Push in GitLab Project	Verify force pushes in the GitLab project are disallowed to maintain repository integrity.
Set Visibility Level in GitLab Project	Verify the GitLab project's visibility matches the required level.
Restrict Approvers Per Merge Request	Verify the binary field `disable_overriding_approvers_per_merge_request` is set for the GitLab project.
Allowed Commit Authors in GitLab Project	Verify only users in the Allowed List author commits in the GitLab project.
Disable Author Approval for Merge Requests in GitLab	Verify the binary field `merge_requests_author_approval` is set for the GitLab project.
Enable Secrets Prevention in GitLab Project	Verify `prevent_secrets` is enabled for the GitLab project.
Ensure All Commits Are Signed in GitLab Project	Verify all commits in the GitLab project are signed.
Check Description Substring	Verify a specific substring is not found in the description attribute of vulnerabilities for the GitLab project.
Verify Project Activity	Verify the GitLab project is active for a specified duration.
Allowed Committer Names in GitLab Project	Verify only users in the Allowed List commit by name in the GitLab project.
Check Message Substring	Verify a specific substring is not found in the message attribute of vulnerabilities for the GitLab project.
Run SAST Scanning in GitLab Project	Verify SAST scanning is performed for the GitLab project.
Require Code Owner Approval in GitLab Project	Verify code owner approval is required for specific branches in the GitLab project.
Ensure SAST Scanning Passes	Verify SAST scanning is successful for the GitLab project.
Ensure Secrets Scanning Passes	Verify secrets scanning is successful for the GitLab project.
Require Password for Approvals in GitLab Project	Verify the binary field `require_password_to_approve` is set for the GitLab project.

K8s Namespace Discovery Evidence

Evidence Type: K8s Namespace Discovery Evidence

Rule Name	Description
Allowed Container Images	Verify only container images specified in the Allowed List run within the Kubernetes namespace.
Verify Namespace Termination	Verify Kubernetes namespaces are properly terminated to prevent lingering resources and maintain cluster hygiene.
Require K8s Namespace Discovery Evidence	Verify the K8s Namespace exists as evidence.
Allowed Namespaces	Verify only namespaces specified in the Allowed List are allowed within the cluster.
Verify Namespace Runtime Duration	Verify Kubernetes namespaces adhere to a specified runtime duration to enforce lifecycle limits.
Allowed Namespace Registries	Verify container images in Kubernetes namespaces originate from registries in the Allowed List.
Allowed Pods in Namespace	Verify only pods explicitly listed in the Allowed List run within a Kubernetes namespace.

K8s Pod Discovery Evidence

Evidence Type: K8s Pod Discovery Evidence

Rule Name	Description
Verify Pod Runtime Duration	Verify Kubernetes pods adhere to a specified runtime duration to enforce lifecycle limits.
Require K8s Pod Discovery Evidence	Verify the K8s Pod exists as evidence.
Verify Pod Termination	Verify Kubernetes pods are properly terminated to prevent lingering resources and maintain cluster hygiene.
Allowed Pods	Verify only pods explicitly listed in the Allowed List are allowed to run.

Bitbucket Project Discovery Evidence

Evidence Type: Bitbucket Project Discovery Evidence

Rule Name	Description
Prevent Long-Lived Tokens	Verify Bitbucket API tokens expire before the maximum time to live.
Require Bitbucket Project Discovery Evidence	Verify the Bitbucket Project exists as evidence.
Allowed Project Admins	Verify only users specified in the Allowed List have admin privileges in the Bitbucket project.
Allowed Project Users	Verify only users specified in the Allowed List have user access to the Bitbucket project.
Prevent Credential Exposure	Verify access to the Bitbucket project is blocked if exposed credentials are detected.

Bitbucket Repository Discovery Evidence

Evidence Type: Bitbucket Repository Discovery Evidence

Rule Name	Description
Require Bitbucket Repository Discovery Evidence	Verify the Bitbucket Repository exists as evidence.
Allowed Repository Admins	Verify only users specified in the Allowed List have admin privileges in the Bitbucket repository.
Verify Default Branch Protection Setting Is Configured	Verify the default branch protection is enabled in the Bitbucket repository.
Allowed Repository Users	Verify only users specified in the Allowed List have user access to the Bitbucket repository.

Bitbucket Workspace Discovery Evidence

Evidence Type: Bitbucket Workspace Discovery Evidence

Rule Name	Description
Require Bitbucket Workspace Discovery Evidence	Verify the Bitbucket Workspace exists as evidence.
Allowed Workspace Admins	Verify only users specified in the Allowed List have admin privileges in the Bitbucket workspace.
Allowed Workspace Users	Verify only users specified in the Allowed List have user access to the Bitbucket workspace.

Dockerhub Project Discovery Evidence

Evidence Type: Dockerhub Project Discovery Evidence

Rule Name	Description
Verify DockerHub Tokens are Active	Verify that all discovered Dockerhub tokens are set to Active in Dockerhub.
Verify no unused Dockerhub	Verify that there are no unused Dockerhub.

Jenkins Folder Discovery Evidence

Evidence Type: Jenkins Folder Discovery Evidence

Rule Name	Description
Require Jenkins Folder Discovery Evidence	Verify the Jenkins Folder exists as evidence.
Verify Exposed Credentials	Verify there are no exposed credentials.

Jenkins Instance Discovery Evidence

Evidence Type: Jenkins Instance Discovery Evidence

Rule Name	Description
Require Jenkins Instance Discovery Evidence	Verify the Jenkins Instance exists as evidence.
Disallow Unused Users	Verify there are no users with zero activity.
Verify Inactive Users	Verify there are no inactive users.

Statement

Evidence Type: Statement

Rule Name	Description
Verify Selected Commits Are Signed API	Verify selected commits are signed in the GitHub organization.
Branch protection enabled in GitHub repository	Verify GitHub branch protection rules
Disallow Unsigned Commits In Time Range	Verify commits in the specified time range are signed.
Sign Selected Commits in GitLab	Verify the selected commits are signed in the GitLab organization.
Set Push Rules in GitLab	Verify GitLab push rules are configured via the API.
Sign Selected Commit Range in GitLab	Verify the selected range of commits is signed via the GitLab API.
Verify No 3rd Party Findings via Scribe API	Verify via Scribe API that there are no findings reported by 3rd party tools in the target product.
Verify No Critical or High Vulnerabilities in Product	Verify via Scribe API that there are no critical or high severity vulnerabilities in any deliverable component of the product.

General Information

Most of the policy rules in this bundle consist of two files: a .yaml and a .rego.

The first is a rule configuration file that should be referenced by on runtime or merged to the actual valint.yaml. The second is a rego script that contains the actual verifyer code. It can be used as is or merged to the .yaml using script option.

Modifying rules in the Catalog

Each rule in this catalog consists of a rego script and yaml configuration file. In order to run a rule, its script file should be referred by a rule config. Each .yaml represents such a config and is ready for use.

SBOM

An example of creating an SBOM evidence:

valint bom ubuntu:latest -o statement

To verify the evidence against the rule, run:

valint verify ubuntu:latest -i statement-cyclonedx-json --rule sbom/rule_config@v2

Require SBOM Signature

This rule (artifact-signed.yaml) verifies that the SBOM is signed and the signer identity equals to a given value.

If you have not created an SBOM yet, create an sbom attestation, for example:

In artifact-signed.yaml file, edit policy parameters attest.cocosign.policies.rules.input identity to reflect the expected signers identity.

You can also edit target_type to refelct the artifact type.

info

Optional target types are git,directory, image, file, generic.

evidence:
   target_type: container
with:
   identity:
      emails:
         - example@company.com

Restrict Disallowed Dependencies

This rule (blocklist-packages.yaml, blocklist-packages.rego) verifies an SBOM does not include packages in the list of risky packages.

rego code for This rule can be found in the blocklist-packages.rego file.

Edit the list of the risky licenses in the input.rego.args parameter in file blocklist-packages.yaml:

with:
   blocklist:
      - "pkg:deb/ubuntu/tar@1.34+dfsg-1ubuntu0.1.22.04.1?arch=arm64&distro=ubuntu-22.04"
      - "log4j"
   blocklisted_limit: 0

Enforce SBOM Dependencies

This rule (required-packages.yaml, required-packages.rego) verifies that the SBOM includes packages from the list of required packages.

Edit the list of the required packages in the input.rego.args parameter in file required-packages.yaml:

with:
   required_pkgs:
      - "pkg:deb/ubuntu/bash@5.1-6ubuntu1?arch=amd64\u0026distro=ubuntu-22.04"
   violations_limit: 1

The rule checks if there is a package listed in SBOM whose name contains the name of a required package as a substring. For example, if the package name is pkg:deb/ubuntu/bash@5.1-6ubuntu1?arch=amd64\u0026distro=ubuntu-22.04, it will match any substring, like just bash or bash@5.1-6ubuntu1.

Restrict Disallowed SBOM Licenses

This rule (banned-licenses.yaml, banned-licenses.rego) verifies that the SBOM does not include licenses from the list of risky licenses.

Edit the list of the risky licenses in the input.rego.args parameter in file banned-licenses.yaml:

rgs:
   blocklist:
      - GPL
      - MPL
   blocklisted_limit : 10

Enforce SBOM License Completeness

This rule (complete-licenses.yaml, complete-licenses.rego) verifies that every package in the SBOM has a license.

It doesn't have any additional parameters.

Enforce SBOM Freshness

This rule (fresh-sbom.yaml, fresh-sbom.rego) verifies that the SBOM is not older than a given number of days.

Edit the config input.rego.args parameter in file fresh-sbom.yaml:

with:
   max_days : 30

Images

An example of creating an evidence:

valint bom ubuntu:latest -o statement

To verify the evidence against the rule:

valint verify ubuntu:latest -i statement --rule images/rule_config@v2

Disallow Container Shell Entrypoint

This rule (restrict-shell-entrypoint.yaml, restrict-shell-entrypoint.rego) verifies that the image entrypoint does not provide shell access by default. It does so by verifying that both Entrypoint and Cmd don't contain sh (there's an exclusion for .sh though).

This rule is not configurable.

Restrict Build Scripts

This rule (blocklist-build-scripts.yaml, blocklist-build-scripts.rego) verifies that the image did not run blocklisted scripts on build.

Edit the list of the blocklisted scripts in the input.rego.args parameter in file blocklist-build-scripts.yaml:

with:
   blocklist:
      - curl

Verify Image Labels

This rule (verify-labels.yaml, verify-labels.rego) verifies that image has labels with required values.

Edit the list of the required labels in the config object in file verify-labels.yaml:

with:
   labels:
      - label: "org.opencontainers.image.version"
        value: "22.04"

Fresh Image

This rule (fresh-image.yaml, fresh-image.rego) verifies that the image is not older than a given number of days.

Edit the config input.rego.args parameter in file fresh-image.yaml:

with:
   max_days: 183

Forbid Large Images

This rule (forbid-large-images.yaml, forbid-large-images.rego) verifies that the image is not larger than a given size.

Set max size in bytes in the input.rego.args parameter in file forbid-large-images.yaml:

with:
   max_size: 77808811

Git

An example of creating a Git evidence:

valint bom git:https://github.com/golang/go -o statement

To verify the evidence against the rule:

valint verify git:https://github.com/golang/go -i statement --rule git/rule_config@v2

Restrict Coding Permissions

This rule (coding-permissions.yaml, coding-permissions.rego) verifies that files from the specified list were modified by authorized users only.

For This rule be able to run, the evidence must include a reference to the files that were modified in the commit. This can be done by adding parameter --components commits,files to the valint bom command.

For specifying the list of files and identities, edit the input.rego.args parameter in file coding-permissions.yaml. This example for repository Golang Build verifies that files build.go and internal/https/README.md were modified only by identities containing @golang.com and @golang.org:

with:
   ids:
      - "@golang.com"
      - "@golang.org"
   files:
      - "a.txt"
      - "somedir/b.txt"

Disallow Unsigned Commits

This rule (no-unsigned-commits.yaml, no-unsigned-commits.rego) verifies that evidence has no unsigned commits. It does not verify the signatures though.

Disallow Commits to Main Branch

This rule (no-commit-to-main.yaml, no-commit-to-main.rego) verifies that evidence has no commits made to main branch.

SLSA

Example of creating a SLSA statement:

valint slsa ubuntu:latest -o statement

Example of verifying a SLSA statement:

valint verify ubuntu:latest -i statement-slsa --rule slsa/rule_config@v2

Verify that artifact was created by the specified builder

This rule (verify-builder.yaml, verify-builder.rego) verifies that the builder name of the SLSA statement equals to a given value.

Edit config input.rego.args parameter in file verify-builder.yaml:

with:
   id: "local"

Disallow dependencies in SLSA Provenance Document

This rule (banned-builder-deps.yaml, banned-builder-deps.rego) verifies that the builder used to build an artifact does not have banned dependencies (such as an old openSSL version).

Edit config input.rego.args parameter in file banned-builder-deps.yaml:

with:
   blocklist:
      - name: "valint"
         version: "0.0.0"

Verify Build Time

This rule (build-time.yaml, build-time.rego) verifies that the build time of the SLSA statement is within a given time window The timezone is derived from the timestamp in the statement.

Edit config input.rego.args parameter in file build-time.yaml:

with:
   start_hour: 8
   end_hour: 20
   workdays:
      - "Sunday"
      - "Monday"
      - "Tuesday"
      - "Wednesday"
      - "Thursday"

Verify that artifact has no disallowed builder dependencies

This rule (verify-byproducts.yaml, verify-byproducts.rego) verifies that the SLSA statement contains all the required byproducts. According to the SLSA Provenance documentation, there are no mandatory fields in the description of a byproduct, but at least one of uri, digest, content should be specified. So, the rule checks if each byproduct specified in the configuration is present in one of those fields of any byproduct in the SLSA statement. It does so by calling the contains function, so the match is not exact.

Before running the rule, specify desired byproducts in the input.rego.args parameter in file verify-byproducts.yaml:

with:
   byproducts:
      - 4693057ce2364720d39e57e85a5b8e0bd9ac3573716237736d6470ec5b7b7230

SLSA Field Exists in Provenance Document

This rule (field-exists.yaml, field-exists.rego) verifies that the SLSA statement contains a field with the given path.

Before running the rule, specify desired paths in the input.rego.args parameter in file field-exists.yaml:

with:
   paths:
      - "predicate/runDetails/builder/builderDependencies"
   violations_threshold: 0

Sarif Reports

Generic SARIF Rule

This rule (verify-sarif.yaml, verify-sarif.rego) allows to verify any SARIF report against a given rule. The rule has several parameters to check against:

ruleLevel: the level of the rule, can be "error", "warning", "note", "none"
ruleIds: the list of the rule IDs to check against
precision: the precision of the check, can be "exact", "substring", "regex"
ignore: the list of the rule IDs to ignore
maxAllowed: the maximum number of violations allowed

These values can be changed in the input.rego.args section in the verify-sarif.yaml file.

Creating a BOM out of a SARIF report

Create a trivy sarif report of the vulnerabilities of an image:

trivy image ubuntu:latest -f sarif -o ubuntu-cve.json

Create an evidence from this report:

valint evidence ubuntu-cve.json  -o statement

Verify the attestation against the rule:

valint verify ubuntu-cve.json -i statement-generic --rule sarif/verify-sarif@v2

Running Trivy On Docker Container Rootfs

As an alternative, one can run trivy against an existing Docker container rootfs:

docker run --rm -it alpine:3.11

Then, inside docker run:

curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh -s -- -b /usr/local/bin
trivy rootfs / -f sarif -o rootfs.json

Then, outside docker run this to copy the report from the container:

docker cp $(docker ps -lq):/rootfs.json .

After that create the evidence and verify it as described above.

Verify Rule Compliance in SARIF

To verify that the SARIF report complies with defined generic rules for compliance and security, set the following parameters in the rego.args section in theverify-sarif.yaml file:

with:
   rule_level: []
   precision: []
   rule_ids: []
   ignore: []
   max_allowed: 0

For example, to alarm on specific rule levels & rule IDs, modify config as follows:

with:
   rule_level:
      - "error"
      - "warning"
      - "note"
      - "none"
   precision: []
   rule_ids:
      - "CVE-2021-1234"
      - "CVE-2021-5678"
   ignore: []
   max_allowed: 0

Do Not Allow Vulnerabilities Based On Specific Attack Vector

Trivy/grype reports usually contain descriptions for some CVEs, like impact and attack vector. This rule (verify-attack-vector.yaml, verify-attack-vector.rego) is meant to restrict number of vulnerabilities with specific attack vectors. For example, to restrict vulnerabilities with attack vector "stack buffer overflow", set the following parameters in the rego.args section in the verify-attack-vector.yaml file:

with:
   attack_vectors:
      - "stack buffer overflow"
   violations_threshold: 0

Then run the rule against the SARIF report as described above.

Verify IaC Misconfiguration Threshold in SARIF

This rule (report-iac-errors.yaml, report-iac-errors.rego) allows to verify a Trivy IaC report and check if there are any errors in the configuration.

First, create a trivy report of the misconfigurations of a Dockerfile:

trivy config <dir_containing_dockerfile> -f sarif -o my-image-dockerfile.json

Create an evidence from this report:

valint evidence my-image-dockerfile.json -o statement

Verify the attestation against the rule:

valint verify my-image-dockerfile.json -i statement-generic --rule sarif/report-iac-errors@v2

The only configurable parameter in report-iac-errors.yaml is violations_threshold, which is the maximum number of errors allowed in the report:

with:
   violations_threshold: 0

Verify Semgrep Rule in SARIF

semgrep, a code analysis tool, can produce SARIF reports, which later can be verified by valint against a given rule.

This rule (verify-semgrep-report.yaml, verify-semgrep-report.rego) allows to verify that given SARIF report does not contain specific rules violations.

First, one needs to create a semgrep report (say, for the openvpn repo):

cd openvpn/
semgrep scan --config auto -o semgrep-report.sarif --sarif

Then, create an evidence from this report:

valint evidence semgrep-report.sarif -o statement

Configuration of This rule is done in the file verify-semgrep-report.yaml. In this example we forbid any violations of the use-after-free rule:

with:
   rule_ids:
      - "use-after-free"
   violations_threshold: 0

Then, run valint verify as usual:

valint verify semgrep-report.sarif -i statement-generic --rule sarif/verify-semgrep-report@v2

If any violations found, the output will contain their description, including the violated rule and the file where the violation was found.

Verify Tool Evidence in SARIF

This rule (verify-tool-evidence.yaml) allows to verify the existence of an evidence of SARIF report created by a specified tool. By default, the rule checks for an evidence created out of any SARIF report. To specify a tool, use the tool parameter in the evidence section of the rule configuration. For example, to verify that there is an evidence of a SARIF report created by trivy, use the following configuration:

uses: sarif/verify-tool-evidence@v2
evidence:
   tool: "Trivy Vulnerability Scanner"

K8s Jailbreak

Trivy k8s analysis can highlight some misconfigurations which allow container to access host filesystem or network. The goal of This rule is to detect such misconfigurations.

To run this rule one has to create a Trivy k8s report and create a generic statement with valint from it. Then, simply verify the statement against this rule. No additional configuration required.

Writing Rule Files

Rego policy rules can be written either as snippets in the yaml file, or as separate rego files.

An example of such a rego script is given in the verify-sarif.rego file, that is consumed by the verify-sarif.yaml configuraion. To evaluate the rule, run

valint verify ubuntu-cve.json -i statement-generic --rule sarif/verify-sarif@v2

Quickstart​

Creating an SBOM​

Verifying an initiative​

Running a single rule verification​

Targetless Run​

Whole initiative verification​

Migration from an older version​

Rule configs migration​

Policy configs migration​

Example​

Sample Policy Catalog​

Rules​

SBOM​

Image SBOM​

Git SBOM​

SLSA Provenance​

SARIF Evidence​

Generic Statement​

Github Organization Discovery Evidence​

Github Repository Discovery Evidence​

Gitlab Organization Discovery Evidence​

Gitlab Project Discovery Evidence​

K8s Namespace Discovery Evidence​

K8s Pod Discovery Evidence​

Bitbucket Project Discovery Evidence​

Bitbucket Repository Discovery Evidence​

Bitbucket Workspace Discovery Evidence​

Dockerhub Project Discovery Evidence​

Jenkins Folder Discovery Evidence​

Jenkins Instance Discovery Evidence​

Statement​

General Information​

Modifying rules in the Catalog​

SBOM​

Require SBOM Signature​

Restrict Disallowed Dependencies​

Enforce SBOM Dependencies​

Restrict Disallowed SBOM Licenses​

Enforce SBOM License Completeness​

Enforce SBOM Freshness​

Images​

Disallow Container Shell Entrypoint​

Restrict Build Scripts​

Verify Image Labels​

Fresh Image​

Forbid Large Images​

Git​

Restrict Coding Permissions​

Disallow Unsigned Commits​

Disallow Commits to Main Branch​

SLSA​

Verify that artifact was created by the specified builder​

Disallow dependencies in SLSA Provenance Document​

Verify Build Time​

Verify that artifact has no disallowed builder dependencies​

SLSA Field Exists in Provenance Document​

Sarif Reports​

Generic SARIF Rule​

Creating a BOM out of a SARIF report​

Running Trivy On Docker Container Rootfs​

Verify Rule Compliance in SARIF​

Do Not Allow Vulnerabilities Based On Specific Attack Vector​

Verify IaC Misconfiguration Threshold in SARIF​

Verify Semgrep Rule in SARIF​

Verify Tool Evidence in SARIF​

K8s Jailbreak​

Writing Rule Files​

Quickstart

Creating an SBOM

Verifying an initiative

Running a single rule verification

Targetless Run

Whole initiative verification

Migration from an older version

Rule configs migration

Policy configs migration

Example

Sample Policy Catalog

Rules

SBOM

Image SBOM

Git SBOM

SLSA Provenance

SARIF Evidence

Generic Statement

Github Organization Discovery Evidence

Github Repository Discovery Evidence

Gitlab Organization Discovery Evidence

Gitlab Project Discovery Evidence

K8s Namespace Discovery Evidence

K8s Pod Discovery Evidence

Bitbucket Project Discovery Evidence

Bitbucket Repository Discovery Evidence

Bitbucket Workspace Discovery Evidence

Dockerhub Project Discovery Evidence

Jenkins Folder Discovery Evidence

Jenkins Instance Discovery Evidence

Statement

General Information

Modifying rules in the Catalog

SBOM

Require SBOM Signature

Restrict Disallowed Dependencies

Enforce SBOM Dependencies

Restrict Disallowed SBOM Licenses

Enforce SBOM License Completeness

Enforce SBOM Freshness

Images

Disallow Container Shell Entrypoint

Restrict Build Scripts

Verify Image Labels

Fresh Image

Forbid Large Images

Git

Restrict Coding Permissions

Disallow Unsigned Commits

Disallow Commits to Main Branch

SLSA

Verify that artifact was created by the specified builder

Disallow dependencies in SLSA Provenance Document

Verify Build Time

Verify that artifact has no disallowed builder dependencies

SLSA Field Exists in Provenance Document

Sarif Reports

Generic SARIF Rule

Creating a BOM out of a SARIF report

Running Trivy On Docker Container Rootfs

Verify Rule Compliance in SARIF

Do Not Allow Vulnerabilities Based On Specific Attack Vector

Verify IaC Misconfiguration Threshold in SARIF

Verify Semgrep Rule in SARIF

Verify Tool Evidence in SARIF

K8s Jailbreak

Writing Rule Files