Static Application Security Testing (SAST) checks your source code for known vulnerabilities.
Find a file
2023-06-27 19:08:38 +02:00
src/ruby_gem Add .gitlab-ci.yml and test Ruby app 2023-05-03 17:02:09 +01:00
.gitlab-ci.yml Fix ensure-brakeman-job-added job 2023-06-12 11:07:26 +02:00
README.md Update README.md on how to disable sast jobs 2023-06-27 19:08:38 +02:00
template.yml Update image_tag default value to match corresponding CI template 2023-06-13 12:35:32 +02:00

SAST (Static Application Security Testing)

Read more about this feature here: https://docs.gitlab.com/ee/user/application_security/sast/

Configure SAST with CI/CD variables (https://docs.gitlab.com/ee/ci/variables/index.html). List of available variables: https://docs.gitlab.com/ee/user/application_security/sast/index.html#available-cicd-variables

Usage

You should add this component to an existing .gitlab-ci.yml file by using the include: keyword.

include:
  - component: gitlab.com/gitlab-components/sast@<VERSION>

where <VERSION> is the latest released tag or main.

If you want to leverage the $SAST_DISABLED variable to run the jobs conditionally use include:rules with when: never. Otherwise all SAST jobs will always run when applicable:

include:
  - component: gitlab.com/gitlab-components/sast@main
    rules:
      - if: $SAST_DISABLED == "true" || $SAST_DISABLED == "1"

This assumes SAST_DISABLED variable is already defined in .gitlab-ci.yml with either 'true' or '1' as the value:

variables:
  SAST_DISABLED: 'true'

Inputs

Input Default value Description
stage test The stage where you want the job to be added
image_prefix $CI_TEMPLATE_REGISTRY_HOST/security-products Define where all Docker image are pulled from
image_tag 4 Tag of the Docker image to use
image_suffix "" Suffix added to image. If set to -fips, FIPS-enabled images are used for scan. Only used by semgrep analyzer
excluded_analyzers "" Comma separated list of analyzers that should not run
excluded_paths "spec, test, tests, tmp" Comma separated list of paths to exclude
search_max_depth 4 Defines how many directory levels the search for programming languages should span
run_kubesec_sast "false" Set it to "true" to run kubesec-sast job
include_experimental "false" Set it to "true" to enable experimental analyzers