Managing integrations

This section describes how to edit or delete an existing integration and how to create a new integration.

Creating a new integration

When you use Kaspersky Security Plug-in for ConnectWise Automate for the first time, you must create an integration between Kaspersky Endpoint Security Cloud and ConnectWise Automate.

Later, you can edit an existing integration, as described in Editing an integration, or create another integration. You may have to create several integrations for load balancing purposes by selecting different workspaces in different integrations, and then assigning the "bridge" role to several computers and connecting each of these computers to different integrations. As a result, the load of interacting with Kaspersky Endpoint Security Cloud is distributed between several computers.

To create an integration:

1. Open ConnectWise Automate Control Center.
2. Select Dashboard on the toolbar (if you use ConnectWise Automate 10.5 or 11) or select System → Configuration → Dashboard (if you use ConnectWise Automate 12).
3. In the System Dashboard window that opens, click the following sequence of tabs: Config → Integration → Kaspersky.
4. On the Kaspersky tab, specify the user name and password that you use to connect to Kaspersky Endpoint Security Cloud:

   

   Connecting to Kaspersky Endpoint Security Cloud

   • User name—Email address used for your Kaspersky Endpoint Security Cloud account. This field cannot be blank.
   • Password—Password to connect to Kaspersky Endpoint Security Cloud. This field cannot be blank.
5. Click the Sign in button.

   After you connect to Kaspersky Endpoint Security Cloud, the Integration settings section appears.

   

   Specifying integration settings

6. Click the Create new link.
7. Provide the integration name in the dialog box that opens. The Integration name field cannot be blank. By default, the integration name is Integration with ConnectWise Automate.

   For an integration with Kaspersky Endpoint Security Cloud, click the View integration ID link under the integration name to view the identifier of the integration. You may have to provide this ID to Kaspersky Lab Technical Support for diagnostics and troubleshooting.

8. Specify the following integration settings:
   • Workspaces. Select workspaces for your integration. For details, refer to Editing the list of integration workspaces.
   • Administrators. Select administrators for your integration. For details, refer to Editing the list of integration administrators.
9. To save changes, close the System Dashboard window when you have finished specifying the integration settings.

Kaspersky Endpoint Security Cloud is now integrated with ConnectWise Automate.

Editing an integration

Editing an integration means renaming it or editing the list of workspaces and administrators that are related to the integration, that is, adding or removing workspaces and administrators to / from the integration.

To edit an integration:

1. On the Kaspersky tab of ConnectWise Automate Control Center, go to the Integration settings section. For details, refer to Creating a new integration, steps 1–5.
2. In the Select integration drop-down list, select the integration that you want to edit.
3. If you want to rename the integration, click the Rename link and provide the new integration name in the dialog box that opens. The Integration name field cannot be blank.

   For an integration with Kaspersky Endpoint Security Cloud, click the View integration ID link under the integration name to view the identifier of the integration. You may have to provide this ID to Kaspersky Lab Technical Support for diagnostics and troubleshooting.

4. If you want to edit the list of workspaces for your integration, refer to Editing the list of integration workspaces.
5. If you want to edit the list of administrators for your integration, refer to Editing the list of integration administrators.
6. To save changes, close the System Dashboard window when you have finished editing the integration settings.

Kaspersky Endpoint Security Cloud integration with ConnectWise Automate is now updated.

Editing the list of integration workspaces

When you create or edit an integration with ConnectWise Automate, edit the list of Kaspersky Endpoint Security Cloud workspaces associated with your integration.

When you add workspaces to the integration, information from these workspaces is synchronized between Kaspersky Endpoint Security Cloud and ConnectWise Automate, and ConnectWise Automate gains access to these workspaces. You may also have to remove a client’s workspace from the integration, for example, if your company no longer provides services to this client. After you remove a workspace, information from this workspace is no longer synchronized with ConnectWise Automate, but all integration administrators are able to continue administering this workspace in Kaspersky Endpoint Security Cloud.

Adding workspaces to the integration is required when you create a new integration.

To edit the list of integration workspaces:

1. In the Integration settings window that opens after you connect to Kaspersky Endpoint Security Cloud, click the Edit link next to Workspaces.
2. In the Select workspaces dialog box, the list of workspaces is displayed. Do one of the following:
   • Select the check boxes next to the workspaces that you want to add to the integration.
   • Clear the check boxes next to the workspaces that you want to remove from the integration.
3. Click OK when you have selected the required workspaces.

The list of workspaces associated with the selected integration is now saved.

Page top

Editing the list of integration administrators

When you create or edit an integration with ConnectWise Automate, edit the list of administrators of your integration. You can add integration administrators as well.

When you add administrators to the integration, they have the same rights as existing administrators: they can administer all Kaspersky Endpoint Security Cloud workspaces bound to this integration and manage the integration settings.

When you remove administrators from the integration, they can no longer manage this integration and cannot administer its workspaces. You may have to remove administrators, for example, if they stop working for your company or move to new positions within the company and are no longer allowed to manage integrations.

Adding administrators to the integration is required when you create a new integration.

To add integration administrators:

1. In the Integration settings window that opens after you connect to Kaspersky Endpoint Security Cloud, click the Add new link next to Administrators.
2. In the Add administrators dialog box that opens, specify the email addresses and aliases associated with the Kaspersky Lab accounts of the users that you want to add as new administrators. You can add several administrators at a time.
   • Use a semicolon to separate the email address and alias of an administrator.
   • Type the data for each administrator in a new line.

     Only users registered in Kaspersky Endpoint Security Cloud can be added to the integration.

3. Click Next and check the data that you provided. If everything is correct, click Finish to add the administrators to the integration. If you want to change the information you provided, click Back.
4. After you perform all the actions with administrators' accounts, click OK.
5. The new administrators are added to the list of administrators of the selected integration.

To remove integration administrators:

1. In the Integration settings window that opens after you connect to Kaspersky Endpoint Security Cloud, click the Edit link next to Administrators.

   The Select administrators dialog box opens, and names of all the administrators of the selected integration are displayed. The check boxes are selected next to all administrators of the integration.

2. To remove one or more administrators from the integration, clear the check boxes next to these administrator names.
3. Click OK.

The list of administrators associated with the selected integration is now saved. The removed administrators can no longer administer the workspaces of this integration.

Page top

Deleting an existing integration

You can delete an existing integration in the Integration settings section.

When you delete an integration, all workspaces linked to the integration are unbound from the integration and continue to exist in Kaspersky Endpoint Security Cloud. All administrators of the deleted integration receive notifications that the integration was deleted, but they can continue to administer workspaces that were linked to this integration. All workspaces that are unbound from the deleted integration can be added to other integrations.

To delete an integration:

1. On the Kaspersky tab of ConnectWise Automate Control Center, go to the Integration settings section. For details, refer to Creating a new integration, steps 1–5.
2. In the Select integration drop-down list, select the integration that you want to delete.
3. Click Delete.
4. Confirm integration deletion in the dialog box.

The integration is deleted.

Supplementary parameter

The parameter that indicates the type of Kaspersky Endpoint Security Cloud server to which Kaspersky Security Plug-in for ConnectWise Automate connects may be included in the .config file of ConnectWise Automate.

The parameter name is KESCloudServer; its possible values are:

• production—Kaspersky Security Plug-in for ConnectWise Automate works with the Production server.
• beta—Kaspersky Security Plug-in for ConnectWise Automate works with the Beta server.
• test—Kaspersky Security Plug-in for ConnectWise Automate works with the Test server.

You are strongly urged not to modify the KESCloudServer parameter unless you receive clear instructions from Kaspersky Lab.

By default, the KESCloudServer parameter is not displayed in the .config file of ConnectWise Automate.

The KESCloudServer parameter can be specified as follows:

Page top