Skip to main content

Installing and Setting up the Checkmarx One JetBrains Plugin

Installing the Plugin

The Checkmarx One JetBrains Plugin is available on the JetBrains marketplace, and can be installed directly from your JetBrains IDE console.

Figure 1. 
JetBrains_-_Installation_and_Setup.gif

GIF - How to install and set up the plugin



To install the plugin from the marketplace:

  1. Open your JetBrains IDE console (e.g., IntelliJ IDEA).

  2. In the main menu click on Plugins.

    Image_319.png
  3. Search for the Checkmarx AST plugin, then click Install for that plugin.

    Image_320.png
  4. Follow the prompts to run the installation.

    The plugin is installed.

Setting up the Plugin

If you would like to use a proxy server, you can set up a proxy variable in one of two ways. See below.

To set up the plugin:

  1. In the main navigation, click Customize > All settings.

    Image_321.png

    The Settings window is shown.

  2. In the Settings window, click Tools > Checkmarx One (or search for Checkmarx One in the search box).

    Image_348.png

    The Checkmarx One JetBrains plugin configuration settings are shown.

  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 Parameters 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 Validate connection, to test that the connection works.

    Notice

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

  6. Click OK at the bottom of the screen.

Setting up a Proxy Variable (Optional)

There are two ways to set up a proxy variable in JetBrains: using additional parameters in JetBrains or using your system’s environment variables.

Setting up a Proxy Variable using Additional Parameters

  1. In the main navigation, click Customize > All settings.

    The Settings window is shown.

  2. In the Settings window, click Tools > Checkmarx One (or search for Checkmarx One in the search box).

    The Checkmarx One JetBrains plugin configuration settings are shown.

  3. In the Additional parameters section, configure your proxy variable using the following format --proxy http://username:[email protected]:8080/.

    Notice

    It is not recommended to pass the username and password in clear text.

  4. Click OK at the bottom of the screen.

Setting up a Proxy Variable using your OS System Environment Variables

  • In your operating system (e.g., Windows, iOS, Linux, etc.), set up a system environment variable with the following configuration:

    • In the Name field, enter HTTP_PROXY.

    • In the Value field, enter the value of your proxy address using the following format: http://username:[email protected]:8080/.