Skip to main content

Importing SAST to Checkmarx One

Prerequisites

Before you can import an existing SAST environment into Checkmarx One, ensure you have the following:

  • Exported SAST environment archive: A .zip file containing the exported SAST environment.

  • Checkmarx One Tenant name

  • Checkmarx One Admin username and password

  • Symmetric key: A .txt file containing the symmetric key. This file is automatically generated with the exported SAST archive.

To retrieve the symmetric key:

  1. Open the .txt file in any text editor.

  2. Copy the key string to use during the import process.

Import Procedure

To import the SAST exported environment to Checkmarx One, proceed as follows:

  1. Log in to Checkmarx One using the Tenant name and Admin credentials.

  2. Click on the Settings icon in the left Navigation pane. The Account Settings page is displayed.

  3. Open the Imports tab and click Import.

    6247580328.png

    The screen for importing a a SAST Environment into Checkmarx One is displayed:

    sast-export-zips.png
  4. Upload the exported SAST archive by doing one of the following:

    • Drag and drop the file into the Exported zip area.

    • Click Select File and browse to the .zip file on your system.

    Enter the Symmetric key (Encryption key)

    Note

    A notification that the file is successfully uploaded will appear at the top

  5. Upload the project-to-application mapping file in JSON format by doing one of the following:

    • Drag and drop the file into the Project to application mapping area.

    • Click Select File to browse and upload the file manually.

  6. Click Import Data. The import process starts and its status is displayed.

  7. 6247580319.png
  8. When the import process is completed, the status will be updated accordingly.

    6247580316.png

Import Statuses & History

There are 4 import statuses: Running, Pending, Completed, Failed.

The Import screen contains the history of all the Imports timestamps.

For example:

6247580313.png

Import Panel

Click on the relevant Import line in the main Import screen.

6247580310.png

The import panel is opened on the right screen side, containing the following Import details:

  • Import ID

  • Import timestamp

  • Status

  • Download logs button

Import Logs

Click on Download migration logs button 6247580307.png.

The migration logs will be downloaded to the browser’s default download folder.

Note

Error logs will be printed to the screen for a quick analysis (they will be also included in the downloaded logs)

For example:

6247580304.png