Configure Mend for GitHub Enterprise for SAST

enableScan

Boolean

Optional. Default Value: false. The available parameter values are:

• true - Enable Mend for GitHub Enterprise’s SAST scan.

• false - Disable Mend for GitHub Enterprise’s SAST scan.

baseBranches

Array

Optional. Default Value: Your GitHub Enterprise "default" branch. Trigger a SAST scan for each commit to the specified branch.

Example usage:

"baseBranches": ["integration"]

This will set the integration branch as the base branch.

Note: Currently, only one branch is allowed to be listed in the baseBranches parameter. Allowing more than one branch name, for example ["master", "integration"], is planned for future release.

scanPullRequests

Boolean

Optional. Default Value: false. The available parameter values are:

• true - Enable scanning feature branches if they have a pull request to the configured base branch.

• false - Disable scanning feature branches.

Note: If you run SAST scans on a feature branch, the scans are not visible in the scans table of the Mend SAST web application. The results are also not added to trend information or any dashboards with the Mend SAST web application.

The results of the feature branch scan are only for you as a developer to help you to get confidence in your code before you merge it.

incrementalScan

Boolean

Optional. Default Value: true. Enable a faster scan by outputting results which are relative to the previous scan. The scan is compared against the latest scan on the base branch.

Notes:

• To perform incremental scans on feature branches, it’s required to set scanPullRequests to true.

• When incrementalScan is set to true, feature branch scans will always be incremental.

• Base branch scans will be incremental as long as there are no changes in the scan engine that are relevant to the scanned project (e.g., Java for Java projects).

snippetSize

Integer

Optional. Default Value: 10. Adjust the amount of lines that are displayed in the snippets that appear in the MendSAST application under the findings' Details section. In case snippetSize is set to 0, no snippets will be included in the Details section.

configExternalURL

String

Optional. Default Value: N/A. The URL where the external .mendsastcli-config.json file is hosted. The .mendsastcli-config.json file content needs to be in the same format as the SAST CLI configuration file.

The following protocols are supported: 'ftp://', 'http://', 'https://'.

For example: 'https://mydomain.com/mend-sast-settings/.mendsastcli-config.json'.

Note:

• If configExternalURL is left empty or does not exist, the integration will look for a .mendsastcli-config.json file at the root of the repository in your base branch.

• If configExternalURL is left empty or does not exist AND a .mendsastcli-config.json file does not exist, the integration will use our default configuration.

checkRunConclusionLevel

String

Optional. Default Value: failure. Determine when the commit should return a failure or success on “New findings” introduced in the commit. The available parameter values are:

• failure - Commit will fail when the SAST scan returns “New findings” which are more severe than the severityThreshold.

• success - Commit will succeed despite any “New findings” returned by the SAST scan.

severityThreshold

String

Optional. Default Value: High. Set the threshold of “New findings” introduced in the commit which would trigger checkRunConclusionLevel to return a failed build. The available parameter values are:

• high - Trigger the threshold when the scan outputs a new finding of severity high or above.

• medium - Trigger the threshold when the scan outputs a new finding of severity medium or above.

• low - Trigger the threshold when the scan outputs a new finding of severity low or above.

issueType

String

Optional. Default Value: repo. The SAST scan produces a single scan report issue for the whole repo, by default, to minimize noise levels. However, the issueType parameter allows to control that. Setting it to “finding” will change the behavior, so an issue will be created for each finding. The available parameter values are:

• repo - Generate one scan report issue for the entire repo (default).

• finding - Generate an issue per finding.

minSeverityLevel

String

Optional. Default Value: High. When issueType is set to finding, this parameter specifies the minimum severity of a finding that should be reported as an issue. No issues will be created for findings with a lower severity. This allows you to minimize noise levels.

• high - Issues are created only for findings with ‘high’ severity.

• medium - Issues are created only for findings with ‘medium’ severity or above.

• low - Issues are created for all findings.

useMendCheckNames

Boolean

Optional. Default Value: false. The available parameter values are:

• true - Names of all Checks will be named after Mend. For example: Mend Code Security Check.

• false - Names of all Checks will be named after WhiteSource. For example: WhiteSource Code Security Check.

Note: When a .whitesource file is created, the value of useMendCheckNames is true.

engines

Optional. Default Value: Auto-detects language. A comma-separated list of SAST engine/language IDs to be used in the analysis (e.g. 1,2). The available Engine IDs can be found in our CLI Parameters documentation.

javaEngineGeneration

Optional. Default Value: 1. Specifies which generation of Java detection engine is used to perform the scan. The available parameters are:

• 1 - Use Java engine generation 1

• 2 - Use Java engine generation 2

jsEngineGeneration

Optional. Default Value: 1. Specifies which generation of JavaScript detection engine is used to perform the scan. The available parameters are:

• 1 - Use JavaScript engine generation 1

• 2 - Use JavaScript engine generation 2

csharpEngineGeneration

Optional. Default Value: 1. Specifies which generation of C# detection engine is used to perform the scan. The available parameters are:

• 1 - Use C# engine generation 1

• 2 - Use C# engine generation 2

pythonEngineGeneration

Optional. Default Value: 1. Specifies which generation of Python detection engine is used to perform the scan. The available parameters are:

• 1 - Use Python engine generation 1

• 2 - Use Python engine generation 2

pathExclusions

Optional. Default Value: Empty List. Specifies a comma separated list of paths that are excluded from the analysis, typically test code or library paths. These paths will be added to the list of default exclusions configured for this project.

noDefaultExclusions

Optional. Default Value: false. The available parameter values are:

• true - Override the excluded default paths predefined by Mend, allowing them to be included in the scan.

• false - Excludes the default paths predefined by Mend. These paths will not be included in the scan.

maxFileSize

Optional. Default Value: 1024 KB. Set the maximum file size above which a file will be ignored during the scan.

timeouts: perScan

Optional. Default Value: 480 minutes per scan. Scan time in minutes for the whole scan, after which the analysis will stop and mark the scan as partially successful.

timeouts: perLanguage

Optional. Default Value: 480 minutes per language. Scan time in minutes per language, after which the analysis will be stop and continue to the next language, if applicable.

timeouts: perFile

Optional. Default Value: 60 seconds per file. Scan time in seconds per individual file, after which the analysis will stop and continue to the next file, if applicable.