Governance Policies

8min

SOOS allows you to create policies or rules around the packages, licenses and CWEs identified through SOOS scans. Once a policy is created, a policy violation warning will be generated any time a scan detects a something which violates the policy.

Policy Types

License Name

License Name policies provide the ability to allow or disallow one or more licenses by SPDX identifier.

License Attribute

License Attribute policies provide the ability to disallow licenses by specifying attributes of your software, such as Commercial with Patents.

Missing License

Missing/Unknown license policies provide the ability to identify packages which do not have a license or where the license is not a known SPDX license.

Package

Package policies provide the ability to disallow specific packages using the package identifier and optional version syntax.

Package Installs

Package Install policies provide the ability to set a minimum threshold for number of package downloads, to ensure that only well known/used packages are referenced.

CWEs / OWASP Top 10 / MITRE Top 25

CWE policies allow specific CWEs to be disallowed across SCA, SBOM, Container, SAST and DAST scans.

Viewing Policies

SOOS Governance Policies can be applied globally (to all projects) or to project/group of projects. The Projects option can be used to filter to view all policies, global policies or a specific projects policies. Select the Policy type tabs to view specific policies that have been created or to create new policies.

Governance policies


Creating Policies

All policies contain the following common properties:

  • Policy Name - The name appears in the Violation Issues detail, so it's important to use meaningful names.
  • Policy Scope - Defines if the policy applies to all projects or only specific projects.
  • Policy Severity - The severity to use when for Violation Issues created by this policy.
  • Policy Behavior - Optional value to indicate if this policy should be triggered when the required data is missing.

Policy Definition

The Policy Definition varies based on the type of policy, in this case providing a package id and optional version will ensure that a violation is created for any matching packages.

License Name policies only

Select either 'allow' or 'disallow' to create either an allow list or disallow list of license names.

  • Allow - Any license detected that is not in this list will generate a violation.
  • Disallow - Any license detected that is is in a disallow list will generate a violation.
Governance policy creation