Checkmarx
Depending on the SAST tool used, we support different methods of consuming the SAST result for Mobb to generate automated remediations. In this example, we will see how Mobb works with Checkmarx.
With Checkmarx, we support 3 different methods:
Option 1 - Upload Vulnerability Report
Select "Upload Vulnerability Report"
Next, you must upload a Checkmarx SAST report in .json
or .xml
format. Once the report is uploaded, click “Continue”.
If you need help generating a .json report in CxOne, refer to Checkmarx documentation here
The next screen prompts you to connect to your code repository. Mobb currently supports GitHub, GitLab, Azure DevOps and Bitbucket as SCM tools.
You can either use the “Pick a repository from your list” where Mobb will prompt you to connect to your repository, or use the second option - “Add a specific code repository” to supply the URL.
Pick a repository from your list - This option provides you the ability to look up your connected GitHub, GitLab, Azure Repo or Bitbucket Cloud accounts to pick a repository
Add a specific code repository - This option allows you to specify a public or private repository URL
Public repository - Mobb will instantly connect to the repository to extract the content required to generate the fix data
Private repository
Accessible repository: If GitHub or GitLab is already connected and the private repository is in these accounts, Mobb will instantly connect to the repository to extract the content required to generate the fix data
Inaccessible repository: If GitHub or GitLab are not connected OR the repository is not in already connected accounts, Mobb will allow you to connect another GitHub or GitLab account OR upload the source code in a zip file
Once you have connected your repository, you are ready to run the analysis. To do so, click on “Continue”.
Note that if you are getting a warning that says "The code provided has been updated after the vulnerabilities were detected. Some vulnerabilities might be missing." You may want to provide a more recent SAST report or adjust your Git branch to an earlier one.
After the analysis, you can review the available fixes on the project page. To access the fix page, click the “Link to fix” button next to the issue you wish to review.
Mobb provides an intuitive UI that allows you to influence the fix's direction through simple questions. Once you are satisfied with the fix recommendation, you can either commit the changes back to your source code repository, download the .diff
file, or save fix data:
Commit Changes - This allows you to commit the fixes directly to your source code repository through a Pull Request. This requires you to have the repository connected.
Download the
.diff
file - This option allows you to download the.diff
file and apply the fix manually to your branch.Save fix data - This option allows you to save the fix data so you can work on other fixes in the project. After you're satisfied, you can commit the fixes back to the repository all at once.
This tutorial will use the “Commit Changes” button to initiate the commit immediately.
After using the “Commit Changes” button, you will be prompted with the name of the branch. In this example, the branch we will commit to is called “feature1”.
Once you are satisfied with the rest of the inputs, click “Commit Changes”. This will initiate a Pull Request in your GitHub or GitLab repository.
Option 2 - Scan via Mobb CLI
This option provides you with a CLI command that you can run on your workstation to perform both a SAST scan followed by the Mobb analysis.
Please note that this option will require you to have access to your own Checkmarx (CxOne) account and is not supported with the on-prem CxSAST version
To use this option, select “Scan via Mobb CLI”.
Next, we will need to pick a repository. Same as the previous option, you can either use the “Pick a repository from your list” to establish a connection to your GitHub or GitLab account or alternatively, you can use the second option - “Add a specific code repository” to supply the URL to your repository.
Once we have specified the source code repository, we will be presented with the command to run in our own desktop environment.
Please note that for this step, you must have the latest nodeJS version installed. To install Node.js, visit the URL:
https://nodejs.org/en/download
Pick the latest version of Node.js supported for your platform and install it.
Note that if you are running this command in a Windows command prompt, make sure you edit the multi-line character from \
to^
.
Example for windows command prompt:
During the command prompt, Mobb CLI will ask for a few Checkmarx-related inputs that you will need to provide to complete the SAST scan.
Once the analysis is complete, press any key to open the link to the analysis. If the page to the Mobb analysis doesn’t open, you can copy the URL and paste it into your browser.
Like before, you will see the analysis page and the available fixes. From there, you can review the fixes and commit them back to your source code repository.
Option 3 - Browse Checkmarx Projects
This option allows you to connect to your own Checkmarx (CxOne) account directly and access the scan results from the Checkmarx Projects.
Please note that this option will require you to have access to your own Checkmarx (CxOne) account and is not available for CxSAST (on-prem)
To use this option, select the “Browse Checkmarx projects” option.
In the next screen, you will be required to provide your tenant information as well as the Checkmarx API key. Once ready, click on “Continue”.
On the next screen, you can browse through your Checkmarx projects to select which ones you wish to perform analysis against SAST findings. Once you have selected the projects, click on “Continue”.
This will take you to the analysis page of the first Checkmarx project you selected, along with the available fixes. From there, you can review the fixes and commit them back to your source code repository, or use the side menu to move to other projects.
Last updated