GitLab Advanced SAST analyzer
- Introduced in GitLab 17.1 as an experiment for Python.
- Support for Go and Java added in 17.2.
- Changed to beta in GitLab 17.2.
- Support for JavaScript, TypeScript and C# added in 17.3.
- Changed to GA in GitLab 17.3.
- Support for Java Server Pages (JSP) added in GitLab 17.4.
GitLab Advanced SAST is a Static Application Security Testing (SAST) analyzer designed to discover vulnerabilities by performing cross-function and cross-file taint analysis.
GitLab Advanced SAST is an opt-in feature. When it is enabled, the GitLab Advanced SAST analyzer scans all the files of the supported languages, using the GitLab Advanced SAST predefined ruleset. The Semgrep analyzer will not scan these files.
All vulnerabilities identified by the GitLab Advanced SAST analyzer will be reported, including vulnerabilities previously reported by the Semgrep analyzer. An automated transition process is proposed for the future, in which the Vulnerability Management system will automatically de-duplicate findings that were identified by both the GitLab Advanced SAST analyzer and the Semgrep analyzer. It’s proposed that the capability will be based on the advanced tracking algorithm and will keep the original record of the vulnerability (if it was first identified by Semgrep, then the Semgrep finding).
By following the paths user inputs take, the analyzer identifies potential points where untrusted data can influence the execution of your application in unsafe ways, ensuring that injection vulnerabilities, such as SQL injection and cross-site scripting (XSS), are detected even when they span multiple functions and files.
GitLab Advanced SAST includes the following features:
- Source detection: Usually user input that can be tweaked by a malicious entity.
- Sink detection: Sensitive function calls, whose arguments should not be controlled by the user.
- Cross-function analysis: Tracks data flow through different functions to detect vulnerabilities that span multiple functions.
- Cross-file analysis: Tracks data flow across different files, discovering vulnerabilities at a deeper level.
- Sanitizer detection: Avoid false positive results in case the user input is properly sanitized.
Supported languages
GitLab Advanced SAST supports the following languages with cross-function and cross-file taint analysis:
- Python
- Go
- Java (JSP files are also supported)
- JavaScript
- TypeScript
- C#
Configuration
Enable the Advanced SAST analyzer to discover vulnerabilities in your application by performing cross-function and cross-file taint analysis. You can then adjust its behavior by using CI/CD variables.
Enabling the analyzer
Prerequisites:
- GitLab version 17.1 or later, if you are running a self-managed instance. (GitLab.com is ready to use.)
- The
.gitlab-ci.yml
file must include:- The
test
stage.
- The
To enable the Advanced SAST analyzer:
- On the left sidebar, select Search or go to and find your project.
- Select Build > Pipeline editor.
- If no
.gitlab-ci.yml
file exists, select Configure pipeline, then delete the example content. - Include a SAST template (if not already done), either
Jobs/SAST.gitlab-ci.yml
orJobs/SAST.latest.gitlab-ci.yml
. Note: Thelatest
templates can receive breaking changes in any release. - Set the CI/CD variable
GITLAB_ADVANCED_SAST_ENABLED
totrue
.
Here is a minimal YAML file for enabling GitLab Advanced SAST:
include:
- template: Jobs/SAST.gitlab-ci.yml
variables:
GITLAB_ADVANCED_SAST_ENABLED: 'true'
-
Select the Validate tab, then select Validate pipeline.
The message Simulation completed successfully confirms the file is valid.
- Select the Edit tab.
- Complete the fields. Do not use the default branch for the Branch field.
- Select the Start a new merge request with these changes checkbox, then select Commit changes.
- Complete the fields according to your standard workflow, then select Create merge request.
- Review and edit the merge request according to your standard workflow, then select Merge.
Pipelines now include an advanced SAST job.
Troubleshooting
If you encounter issues while using GitLab Advanced SAST, refer to the troubleshooting guide.
Feedback
Feel free to add your feedback in the dedicated issue 466322.