Skip to main content

Installing and Setting up the Checkmarx One Eclipse Plugin

The plugin can be installed from the Eclipse marketplace. There is an alternative method for installing the plugin from a zip archive.

Figure 1. 
Eclipse_initial_setup.gif

GIF - How to install and set up the plugin



Installing the Plugin from Marketplace

To install the plugin from marketplace:

  1. In the Eclipse console, click on Help > Eclipse Marketplace…

  2. In the Find box, enter “checkmarx one” and click Go.

    Installing_Eclipse_1.png
  3. Click Install for the Checkmarx One Plugin.

    Installing_Eclipse_2.png
  4. In the Review Licenses window, after reviewing the license information, select the I accept... radio button and click Finish.

    Installing_Eclipse_3.png
  5. In the Trust Authorities and Trust Artifacts windows, select the trusted content and click Trust Selected.

    Installing_Eclipse_4.png
    Installing_Eclipse_5.png
  6. If a security warning is shown, click Install anyway to complete the plugin installation.

    When the installation is finished, you will be prompted to restart the Eclipse IDE to apply the plugin update.

To install the plugin manually from a zip archive:

  1. Download the “com.checkmarx…” zip file here.

  2. In the Eclipse console, click on Help > Install New Software > Add > Archive.

    6140723401.png
  3. In the window that opens, navigate to the downloaded zip file and click Open.

  4. In the Add Repository window, optionally enter a Name for the plugin (e.g., Checkmarx One Plugin) then click Add.

  5. In the Available Software window, select the Checkmarx One Eclipse Plugin checkbox, and click Next.

    6141149410.png
  6. Review the information in the Install Details window, and click Next.

  7. In the Review Licenses window, after reviewing the license information, select the I accept… radio button and click Finish.

    6140657821.png
  8. If a security warning is shown, click Install anyway to complete the plugin installation.

    When the installation is finished, you will be prompted to restart the Eclipse IDE to apply the plugin update.

Setting up the Plugin

After installing the plugin, you need to configure access to the Checkmarx One server before you can start importing results in your Eclipse IDE.

To set up the plugin:

  1. In the top menu, click Window > Preferences. (For Mac OS, click Eclipse > Preferences.)

    Installing_Eclipse_6.png

    The Preferences configuration window is shown.

  2. In the Preferences window, click Checkmarx AST (or search for Checkmarx AST in the search box).

    The Checkmarx One Eclipse plugin configuration settings are shown.

    Installing_Eclipse_7.png
  3. In the API Key field, enter your Checkmarx One API key.

    Notice

    If you need to create an API key, see Generating an API Key.

  4. In the Additional Params field, you can submit additional CLI params. This can be used to manually submit the base url and tenant name if there is a problem extracting them from the API Key. It can also be used to add global params such as --debug or --proxy. To learn more about CLI global params, see Global Flags.

  5. Click on Test Connection, to test that the connection works.

    Notice

    If the connection fails, you can view detailed error logs by entering --debug in the Additional Options section and retrying the connection.

  6. Click Apply and Close at the bottom of the screen to save your settings.