Skip to main content

Setting up Datto integration

For Datto integration, you need to create a GravityZone company, configure the installation package, get the API key and the Access URL in GravityZoneControl Center, and then fill this information as variable values in site settings.

Creating companies in GravityZone

GravityZone groups devices together as companies, similarly to Datto’s sites. Prepare the deployment environment by creating companies in Control Center and matching sites in Web Portal.

To create a company in Control Center:

  1. Log in to GravityZoneControl Center using your Partner credentials (see Requirements).

  2. Go to the Companies page from the left side menu.

  3. Configure company details and, in the Type field, select Customer.

  4. In the Licensing tab, select Trial or Monthly Subscription.

  5. Click Save and add company.

    A company is created and added to the Companies list.

Creating a security installation package

The security agent deployment requires an installation package for each company created in GravityZoneControl Center. The installation package uses a small-sized file to download and run the security agent installation files on your devices.

To create an installation package:

  1. In GravityZoneControl Center, navigate to the Network > Packages.

  2. Click Add at the top, to open the package configuration window.

  3. Enter a name for your installation package.

    Note

    Use unique names for newly created packages to ensure the correct security agent installation.

  4. Under Company, select the company where you are going to install the security agent on.

  5. Select the protection modules you want to install.

    For more information, refer to the this section in the GravityZone documentation.

  6. Configure Scan mode settings.

  7. Configure package settings.

    For more information, refer to the Creating installation packages section in the GravityZone documentation.

  8. Under Deployer, ensure the package connects to the Bitdefender Cloud to download the installation files.

  9. Click Save.

Generating API Key and getting Access URL

Get the GravityZone API key and Access URL to add them as variable values to the site settings. The Bitdefender component will need to call the Packages API to deploy the security agent.

You can generate API keys for each user account.

To generate an API key and get the Access URL in Control Center:

  1. In Control Center, click the username at the top and choose My Account.

  2. Go to the API keys section and click Add to open the APIs list.

  3. Enable Packages API and click Save to confirm.

    A key is generated and added to the table.

    img-03-api-key.png
  4. Click the key to open API details.

  5. Copy the key and keep it safe.

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

  6. Close the API details window.

  7. Under the Control Center API section, copy the Access URL and keep it safe.

Defining site variables

Define variables used by the Bitdefender component at the site level. By defining site variables, you can deploy the security agent to your targets through the Web Portal.

To define site variables in the old UI:

  1. Log into Web Portal.

  2. Click Sites to open the drop-down list.

  3. Go to the Settings tab of your selected site.

  4. Under Variables, click Add Variable to add the following entries, individually:

    Variable name

    Value

    GravityZoneAccessUrl

    Enter the Access URL to provide access to Control Center.

    GravityZoneApiKey

    Enter the API key to identify the APIs called by the component.

    GravityZonePackageName

    Enter the installation package name created in Control Center. This should match the Control Center company with the site where you want to deploy the security agent.

    The values are case-sensitive, so you must enter the variables exactly as they appear in the table.

  5. Select Mask value for each variable to hide its value.

To define site variables in the new UI:

  1. Log in to Web Portal.

  2. In the left-side menu, click Sites, select your site and go to Settings.

  3. Scroll down to Variables and click Add Variable to add the following entries, individually:

    Variable name

    Value

    GravityZoneAccessUrl

    Enter the Access URL to provide access to Control Center.

    GravityZoneApiKey

    Enter the API key to identify the APIs called by the component.

    GravityZonePackageName

    Enter the installation package name created in Control Center. This should match the Control Center company with the site where you want to deploy the security agent.

Note

You need to define the variables only once and change the default package value when you want to deploy a different installation package.

img-04-datto-variables.png

To manage security for your devices in Datto, you execute Bitdefender components through monitoring policies and jobs.