Skip to main content

Configuring the integration

The integration relies on GravityZone's Partners Public API to establish communication between GravityZone and ConnectWise Asio. This is done through the GravityZone API key and the GravityZone access URL, which are available in GravityZone Control Center . Then you do the rest of configuration in the ConnectWise Asio portal.

Getting the API key and the access URL the API key in GravityZone

To obtain the GravityZone API key and the GravityZone access URL, follow these steps:

  1. Log in to GravityZone Control Center using your Partner account credentials.

  2. Click the control_center_user_menu_icon.png user icon in the upper-right corner of the console and select My Account.

  3. Go to the API keys section and select an existing key or click Add to create a new one.

  4. Enter a name and enable the APIs that you want.

    cw-rmm_api_key_p_166799_en.png

    Note

    The integration works with the least possible number of APIs as follows:

    • Companies API

    • Licensing API

    • Packages API

    • Network API

    • Policies API

    • Quarantine API

    • Event Push Service API

  5. Click Save.

    The API key is generated. To prevent the leaking of sensitive information, do not share or distribute your own generated API keys.

In addition to the API key, the access URL also necessary to configure the integration is available in the Control Center API section.

Configuration steps in ConnectWise Asio

Once you have the GravityZone API key and the access URL, the rest of the configuration takes place in the ConnectWise Asio portal.

To set up the integration, follow these steps:

  1. Log in to the ConnectWise Asio portal: https://auplatform.connectwise.com

  2. In the left-side menu, go to the Integrations > All Integrations section.

    connectWiseAsio_all_integrations_p_166799_en.png

  3. Click the BitdefenderGravityZone Cloud Security for MSP product, then Integrate.

    ConnectWiseAsio_integrate_p_166799_en.png

    A configuration window will open.

  4. In the Connection Setup step:

    1. Under Connection 1, add the API key in the GravityZone API key field and the GravityZone access URL in the GZ server field.

      cw_asio_integration_setup_connection_not_tested_p_166799_en.png

      Note

      If you experience issues with the API key, one of the following errors might occur:

      • TC_0003: Required GravityZone APIs are disabled.

      • TC_0005: The provided API key does not belong to your GravityZone company configured for the ConnectWise Asio integration. Please provide a valid API key.

      Ensure that you configured the GravityZone API key as described earlier on this page, and that you are using an API key generated specifically for this integration.

    2. Optionally, to use the Bitdefender ticketing capabilities, select the Enable Ticketing checkbox to activate it. 

    3. Click the Test Connection button to validate the key.

      Wait for the test to finish.

      cw_asio_integration_setup_test_connection_p_166799_en.png

    4. Click Save and Proceed.

      This button becomes active after the connection is tested successfully.

      cw_asio_integration_setup_save_proceed_p_166799_en.png

    Note

    Although you can create more connections by clicking Add Connection, corresponding to multiple pairs of API keys and access URLs, we recommend configuring a single one for optimal operation.

  5. In the Platform API Credentials step:

    1. Select the option Grant API Access to Bitdefender Cloud Security for MSP. Bitdefender Cloud Security for MSP will be able to access your data that is relevant for Integration.

      cw_asio_integration_setup_platform_api_credentials_p_166799_en.png

    2. Click Generate.

    3. Click Save and Proceed.

      cw_asio_integration_setup_platform_api_credentials_regenerate_p_166799_en.png

  6. In the Site Mapping step, you can map GravityZone companies to ConnectWise companies manually or automatically.

    1. For manual mapping, in the Bitdefender Cloud Security for MSP column, select the existing GravityZone company you want to map to each ConnectWise company.

      If you want to map a ConnectWise company to a new GravityZone company:

      1. In the drop-down list, click Add New Site +.

        cw_asio_integration_setup_site_mapping_new_site_p_166799_en_copy.png

      2. Enter a name for the new GravityZone company.

        cw_asio_integration_setup_site_mapping_site_name_p_166799_en.png

      3. Click Create.

    2. For automatic mapping, click Find Match. ConnectWise companies are automatically matched to GravityZone companies by name.

      cw_asio_integration_setup_site_mapping_find_match_p_166799_en.png

      To remove all automatic mappings, click Actions > Remove Suggested Mapping.

    3. Once you have completed the mapping, click Proceed.

      If you want to configure the mapping later, click Skip.

    cw_asio_integration_setup_site_mapping_p_166799_en.png

  7. In the last step, click Save and Proceed.

    The integration is complete. Close the window.

    cw_asio_integration_setup_complete_p_166799_en.png

GravityZone installation package for ConnectWise Asio integration

When ConnectWise Asio Sites are mapped to new or existing GravityZone companies, the integration automatically generates a GravityZone installation package named CWSE_Connector_Default. This package is available only for GravityZone companies mapped through the ConnectWise Asio integration.

The CWSE_Connector_Default installation package includes the following Bitdefender modules by default:

  • Antimalware

  • Advanced Threat Control

  • Advanced Anti-Exploit

  • Network Protection

    • Content Control

    • Antiphishing

    • Web Traffic Scan

    • Network Attack Defense

Important

  • The CWSE_Connector_Default package is created only after the ConnectWise Asio Site-to-GravityZone company mapping is successfully completed.

  • You can create the CWSE_Connector_Default package in advance and customize the Bitdefender modules before deployment.

  • The CWSE_Connector_Default name is mandatory. If this package is missing, a new one with the exact same name will be automatically created and used for Bitdefender agent deployment.

    You may modify the package as needed, provided you maintain the same name.

  • Removing a GravityZone company from the ConnectWise Asio integration does not delete existing installation packages in GravityZone.

In this section: