[Topic 145893]

Kaspersky Security Integrations for MSP

Kaspersky Security Plug-in for ConnectWise Automate

Kaspersky Security Integration with ConnectWise Manage

Kaspersky Security Integration with Autotask

Kaspersky Security Integration with Tigerpaw

Kaspersky Security Integration with SolarWinds N-central

[Topic 178951]

What's new

The following new features are implemented in Kaspersky Security Integrations for MSP.

Version 1 Maintenance Release 5:

• Integration of Kaspersky Lab security applications with SolarWinds N-central. In particular:
  • Deploying Kaspersky Lab security applications from SolarWinds N-central.
  • Viewing the anti-virus protection status of devices.
  • Running a virus scan on devices.
  • Performing an anti-virus database update on devices.
  • Adding dashboards for viewing Kaspersky Lab-related information about the devices in your network.

Version 1 Maintenance Release 4:

• Integration of Kaspersky Security for Microsoft Office 365 with professional services automation (PSA) systems ConnectWise Manage, Autotask, and Tigerpaw. In particular:
  • Creating a ticket or a service order in the PSA system when Kaspersky Security for Microsoft Office 365 notifies that a certain issue occurs in its operation.
  • Closing a ticket or a service order in the PSA system when Kaspersky Security for Microsoft Office 365 notifies that a previously occurred issue is resolved.
  • Providing the PSA system with the information about the number of mailboxes that Kaspersky Security for Microsoft Office 365 protects for each customer workspace. This data is required for automatic generation of invoices for your customers.

Version 1 Maintenance Release 3:

• Integration with Tigerpaw.
• Improved ConnectWise Automate dashboards:
  • The new Licensing dashboard is implemented.
  • Drill-down capability for the Protection dashboards is implemented.
• Capability to generate reports on Kaspersky Security Center virtual servers / Kaspersky Endpoint Security Cloud workspaces and license reports directly from ConnectWise Automate and Autotask.
• Improved billing functionality: capability to separate the usage of licenses for Kaspersky Lab products by servers and workstations managed by Kaspersky Security Center / Kaspersky Endpoint Security Cloud (the number of computers that use a certain license).
• Additional interface and usability improvements.

Version 1 Maintenance Release 2:

• Integration with Autotask.

Page top

[Topic 145889]

Kaspersky Security Plug-in for ConnectWise Automate

This section describes Kaspersky Security Plug-in for ConnectWise Automate. It contains a general description of the software and provides instructions for working with it.

[Topic 133515]

Kaspersky Security Plug-in for ConnectWise Automate

This section describes the purpose, functions, and distribution kit of Kaspersky Security Plug-in for ConnectWise Automate, and provides hardware and software requirements for Kaspersky Security Plug-in for ConnectWise Automate.

[Topic 133516]

About Kaspersky Security Plug-in for ConnectWise Automate

Kaspersky Security Plug-in for ConnectWise Automate is used to integrate Kaspersky Lab security applications into your ConnectWise Automate Control Center to provide a combination of monitoring and management tools, and protection technologies. The Plug-in allows you to monitor and manage the state of all Kaspersky Lab security applications installed at your clients’ locations, by means of one tool—so multiple software products are not needed.

Kaspersky Endpoint Security applications provide enterprise-class protection services and, when integrated with ConnectWise Automate Control Center by means of Kaspersky Security Plug-in for ConnectWise Automate, help to boost the efficiency of your protection monitoring and management.

ConnectWise Automate administrators can use Kaspersky Security Plug-in for ConnectWise Automate to install Kaspersky Endpoint Security and Kaspersky Security Center Network Agent remotely, monitor and manage different security aspects of computers in the client's corporate network, and initiate virus scan and anti-virus database update tasks on client computers. Security incident data is received and can be used to generate tickets and alerts or perform specific actions.

[Topic 162501]

About data provision

Kaspersky Security Plug-in for ConnectWise Automate is designed for the integration of Kaspersky Lab solutions for administration of security applications with ConnectWise Automate within the framework of the functionality described in this Help document.

To use Kaspersky Security Plug-in for ConnectWise Automate, you must install the integration components and connect them to the Kaspersky Lab solution you use, create an integration with ConnectWise Automate, specify connection parameters and integration settings and select your customers’ virtual servers / workspaces for the integration.

By using the product, you agree that said product may receive data from ConnectWise Automate and the connected virtual servers / workspaces, as well as store, process, and display information that is intended for ensuring the product functionality.

By creating an integration and connecting ConnectWise Automate and virtual servers / workspaces to the product, you thus confirm that you are the sole owner of any data you provide or that you are entitled to provide any data.

Any information provided is protected and processed in accordance with the Kaspersky Lab Privacy Policy.

For the purpose of integration of Kaspersky Security Center / Kaspersky Endpoint Security Cloud and ConnectWise Automate, Kaspersky Security Plug-in for ConnectWise Automate may receive, store, and process the following types of data:

• Data required to connect to the integrated software:
  • Parameters for connecting to Kaspersky Security Center Administration Server, including an account.
  • Account for connecting to Kaspersky Endpoint Security Cloud.
• Data about Kaspersky Security Center / Kaspersky Endpoint Security Cloud events and about assigning the Critical and Warning statuses to computers managed by Kaspersky Security Center / Kaspersky Endpoint Security Cloud. This data is required for automatic creation of tickets or similar entities.
• Data about licenses used at Kaspersky Security Center virtual servers / Kaspersky Endpoint Security Cloud workspaces and about attributes of these licenses. This data is displayed in reports and on dashboards in ConnectWise Automate.
• Data about the protection status of computers managed by Kaspersky Security Center / Kaspersky Endpoint Security Cloud (the computer name, the protection status, the detailed description of the status, the number of viruses found, the last scan date and time, and the last anti-virus database update date and time) and data about events. This data is displayed on dashboards in ConnectWise Automate.
• Integration settings:
  • Type of integrated platform (ConnectWise Automate).
  • Integration name.
  • Integration ID (for integrations with Kaspersky Endpoint Security Cloud).
  • Date and time of integration creation.
  • Set of integrated virtual servers / workspaces.
  • List of Kaspersky Endpoint Security Cloud administrators (their aliases and email addresses) who are also granted administrative privileges in the integration.

For integrations with Kaspersky Endpoint Security Cloud, the received data may be stored and processed within the Kaspersky Endpoint Security Cloud infrastructure according to the Kaspersky Endpoint Security Cloud data provision. For details, refer to section "About data provision" in Kaspersky Endpoint Security Cloud Online Help.

All received data is used by the MSP administrators and technicians. Kaspersky Lab Technical Support specialists may also use the above data when an MSP administrator contacts Technical Support.

[Topic 135789]

Features of Kaspersky Security Plug-in for ConnectWise Automate

Kaspersky Security Plug-in for ConnectWise Automate provides the following features.

Protection monitoring

Kaspersky Lab monitors for ConnectWise Automate are designed specifically to react to any security issues that may occur on protected computers. The monitors perform appropriate actions depending on the issue type: raise alerts, create tickets, and automatically run virus scans and update commands for the anti-virus database. The monitoring feature of Kaspersky Security Plug-in for ConnectWise Automate automates most routine tasks, allowing you to focus on activities that are most critical and valuable for your business.

Ticketing

With the help of Kaspersky Security Plug-in for ConnectWise Automate, Kaspersky Lab solutions can be integrated directly into the ConnectWise Automate ticketing system to create tickets on the basis of the security issues.

Simplified protection management

Integration with Kaspersky Lab solutions allows you to manage everyday tasks through a single, easy-to-use dashboard embedded in ConnectWise Automate. Management features include on-demand endpoint scans and virus signature database updates.

Remote deployment

Integration with Kaspersky Lab solutions includes a script that easily enables silent and remote installation of Kaspersky Security Center Network Agents and Kaspersky Endpoint Security directly from ConnectWise Automate.

Centralized dashboard

Kaspersky Lab's powerful and easy-to-use dashboard, integrated into ConnectWise Automate, gives managed service providers (MSPs) an overview of all aspects of their clients’ security. You can briefly view the protection status in high-level diagrams, where important issues are highlighted, and then proceed to more detailed views of events and full information about protected computers. Thus, you can start solving problems immediately. Also, the dashboard provides the information about all keys added to Kaspersky Security Center Administration Servers or Kaspersky Endpoint Security Cloud workspaces.

Compatibility

Kaspersky Lab solutions can be integrated with both installed and cloud versions of ConnectWise Automate. Kaspersky Security Plug-in for ConnectWise Automate also supports Multivendor Antivirus Dashboard, so that you are able to use this convenient tool to monitor and manage the state of Kaspersky Lab security applications installed on your client companies’ workstations or Windows servers.

Page top

[Topic 133517]

Distribution kit

Kaspersky Security Plug-in for ConnectWise Automate is delivered as a free plug-in, which you can unpack and install on the computer that has ConnectWise Automate Control Center installed.

You can download the plug-in from the Kaspersky Lab website or from ConnectWise Automate Solution Center.

[Topic 133514]

Hardware and software requirements

Recommended hardware:

• The recommended minimum screen resolution for work with Kaspersky Security Plug-in for ConnectWise Automate is 1280x1024 or 1366x768, as the minimum window size is 1240x700.

Software requirements:

• Kaspersky Security Center Administration Server 10 Service Pack 2 Maintenance Release 1 and later or Kaspersky Endpoint Security Cloud
• ConnectWise Automate 10.5, 11, and 12.

  Kaspersky Security Plug-in for ConnectWise Automate Maintenance Release 2.1 (build 1.0.2.227) or later is required for successful integration with ConnectWise Automate 12. Earlier versions of Kaspersky Security Plug-in are not compatible with ConnectWise Automate 12.

• Supported operating systems are the same as those supported by ConnectWise Automate Agent. Refer to ConnectWise Automate documentation for details.

Page top

[Topic 153188]

Deployment schemas of Kaspersky Security Plug-in for ConnectWise Automate

Kaspersky Security Plug-in for ConnectWise Automate is used to integrate Kaspersky Lab solutions with ConnectWise Automate Control Center. The Plug-in allows you to monitor and manage the state of all Kaspersky Lab security applications installed at your clients’ locations by means of one convenient tool—so multiple software products are not needed.

The deployment schema that suits your integration depends on the Kaspersky Lab solution you use and on your integration model. There are three deployment schemas:

• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center.
• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center with slave Administration Servers.
• For a cloud-based version of a Kaspersky Lab solution—Kaspersky Endpoint Security Cloud.

This section describes the deployment schemas in detail.

[Topic 153189]

Deployment schema for on-premises solution

Deploy Kaspersky Security Plug-in for ConnectWise Automate based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you do not have slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Plug-in for ConnectWise Automate are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution

The following list describes deployment sequence and data flow:

• First, Kaspersky Security Plug-in for ConnectWise Automate is installed on the computer where ConnectWise Automate Server is installed.
• Then the computers managed by ConnectWise Automate, and with Kaspersky Security Center Administration Server installed, are detected and Kaspersky Security Plug-in for ConnectWise Automate is installed on those computers.
• ConnectWise Automate Server exchanges data with the computers that have ConnectWise Automate Agents installed.
• Kaspersky Security Center Administration Server exchanges data with client computers that have Kaspersky Lab programs installed. These computers are considered managed if they have only Network Agent installed, or protected if they have Kaspersky Endpoint Security installed.

Page top

[Topic 153190]

Deployment schema for on-premises solution and slave servers

Deploy Kaspersky Security Plug-in for ConnectWise Automate based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you use slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Plug-in for ConnectWise Automate are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution and slave servers

The following list describes deployment prerequisites, deployment sequence, and data flow:

• One or more Administration Servers are used in the client's infrastructure. These Administration Servers are slave Administration Servers relative to the Administration Server that is installed in the MSP infrastructure. The Administration Server that is installed in the MSP infrastructure is the master Administration Server. You can use this type of deployment to decrease load on your master Administration Server.
• First, Kaspersky Security Plug-in for ConnectWise Automate is installed on the computer where ConnectWise Automate Server is installed.
• Then the computers managed by ConnectWise Automate, and with Kaspersky Security Center Administration Server installed, are detected and Kaspersky Security Plug-in for ConnectWise Automate is installed on those computers.
• ConnectWise Automate Server exchanges data with the computers that have ConnectWise Automate Agents installed.
• Kaspersky Security Center Administration Server exchanges data with client computers that have Kaspersky Lab programs installed. These computers are considered managed if they have only Network Agent installed, or protected if they have Kaspersky Endpoint Security installed.

Page top

[Topic 153191]

Deployment schema for cloud-based solution

Deploy Kaspersky Security Plug-in for ConnectWise Automate based on this schema if you use the cloud-based version of a Kaspersky Lab solution—Kaspersky Endpoint Security Cloud.

The components of Kaspersky Security Plug-in for ConnectWise Automate are shown as orange rectangles in the following figure.

Deployment schema for cloud-based solution

The following list describes deployment prerequisites, deployment sequence, and data flow:

• First, Kaspersky Security Plug-in for ConnectWise Automate is installed on the computer, where ConnectWise Automate Server is installed.
• Kaspersky Security Plug-in for ConnectWise Automate is installed on a computer that has ConnectWise Automate Server installed and the "Cloud Bridge" role assigned. The "Cloud Bridge" role indicates that this computer interacts with Kaspersky Endpoint Security Cloud and connects ConnectWise Automate and Kaspersky Endpoint Security Cloud like a bridge.
• ConnectWise Automate Server exchanges data with the computers that have ConnectWise Automate Agents installed.
• Data from Kaspersky Endpoint Security Cloud workspaces is transferred to Kaspersky Security Plug-in for ConnectWise Automate and ConnectWise Automate through the "Cloud Bridge" computer.

Page top

[Topic 133480]

Installing and removing Kaspersky Security Plug-in for ConnectWise Automate

Kaspersky Security Plug-in for ConnectWise Automate is delivered as a plug-in, which you unpack and install on the computer that has ConnectWise Automate Control Center installed.

This section contains step-by-step instructions for Kaspersky Security Plug-in for ConnectWise Automate installation, update, and removal.

[Topic 133555]

Installing Kaspersky Security Plug-in for ConnectWise Automate

To successfully install Kaspersky Security Plug-in for ConnectWise Automate, download and save the latest version of Kaspersky Security Plug-in for ConnectWise Automate from the Kaspersky Lab website.

Before you install Kaspersky Security Plug-in for ConnectWise Automate, it is strongly recommended to check its digital signature, to make sure that the Plug-in is issued by Kaspersky Lab.

To check the Kaspersky Security Plug-in for ConnectWise Automate digital signature:

1. Locate the KasperskyPlugin.dll file, which you downloaded from the Kaspersky Lab website.
2. Right-click the KasperskyPlugin.dll file and select Properties.
3. In the properties window that opens, click the Digital Signatures tab and check that the KasperskyPlugin.dll file has Kaspersky Lab signatures.
4. Close the properties window.

After you download and check the digital signature of Kaspersky Security Plug-in for ConnectWise Automate, use ConnectWise Automate Plugin Manager to install Kaspersky Security Plug-in for ConnectWise Automate.

To install Kaspersky Security Plug-in for ConnectWise Automate:

1. Open ConnectWise Automate Control Center.
2. On the main menu, do either of the following:
   • Select Help → Plugin Manager (if you use ConnectWise Automate 10.5 or 11).
   • Select System → Solutions → Plugin Manager (if you use ConnectWise Automate 12).
3. In the Plugin Manager window that opens, select Advanced → Manage Plugins → Add Plugin.
4. In the window that opens, locate the Plug-in file and click Open.
5. In the Add a Plugin dialog box, do the following:
   1. Specify the Plug-in settings.
   2. Make sure that the Remote Agent check box is cleared.

      If the Remote Agent check box is selected, the Plug-in is installed on all the computers on the network, including those on which Kaspersky Lab security applications are not installed. This causes an additional load on ConnectWise Automate.

   3. Click the Save and Close button.

      The Plug-in is added to the Disabled Plugins list in ConnectWise Automate Plugin Manager.

6. In the Plugin Manager window, click the Refresh button.

   The list of installed plug-ins is updated and now contains Kaspersky Security Plug-in for ConnectWise Automate.

7. Enable Kaspersky Security Plug-in for ConnectWise Automate:
   1. In the list of plug-ins, right-click Kaspersky Security Plug-in for ConnectWise Automate and select Enable.
   2. From the Advanced drop-down list, select Reload Plugins → Reload DBAgent Plugins.
8. Close the Plugin Manager window. If you are prompted, click OK.
9. Restart ConnectWise Automate Control Center. The new Plug-in is downloaded.

The Kaspersky icon is displayed on the ConnectWise Automate Control Center toolbar. Click this icon to open the Kaspersky Security Plug-in for ConnectWise Automate dashboard.

Page top

[Topic 133579]

Updating Kaspersky Security Plug-in for ConnectWise Automate

If an earlier version of Kaspersky Security Plug-in for ConnectWise Automate is already installed, you can upgrade it to the latest version. For this purpose, download and save the latest version of Kaspersky Security Plug-in for ConnectWise Automate from the Kaspersky Lab website, and then use ConnectWise Automate Plugin Manager to update to the latest version.

Before you use the new version of Kaspersky Security Plug-in for ConnectWise Automate, it is strongly recommended to check its digital signature, to make sure that the Plug-in is issued by Kaspersky Lab.

To check the Kaspersky Security Plug-in for ConnectWise Automate digital signature:

1. Locate the KasperskyPlugin.dll file, which you downloaded from the Kaspersky Lab website.
2. Right-click the KasperskyPlugin.dll file and select Properties.
3. In the properties window that opens, click the Digital Signatures tab and check that the KasperskyPlugin.dll file has Kaspersky Lab signatures.
4. Close the properties window.

After you download and check the digital signature of Kaspersky Security Plug-in for ConnectWise Automate, use ConnectWise Automate Plugin Manager to update Kaspersky Security Plug-in for ConnectWise Automate.

To update Kaspersky Security Plug-in for ConnectWise Automate:

1. Open ConnectWise Automate Control Center.
2. On the main menu, do either of the following:
   • Select Help → Plugin Manager (if you use ConnectWise Automate 10.5 or 11).
   • Select System → Solutions → Plugin Manager (if you use ConnectWise Automate 12).
3. In the Plugin Manager window that opens, in the list of plug-ins select Kaspersky Security Plug-in for ConnectWise Automate.
4. In the Plugin Manager window, on the menu bar select Advanced → Manage Plugins → Update Plugin.
5. In the window that opens, locate the Plug-in file and click Open.

The Plug-in update starts automatically. After the Plug-in is updated, you are notified that the process is complete.

[Topic 133582]

Removing Kaspersky Security Plug-in for ConnectWise Automate

You can remove Kaspersky Security Plug-in for ConnectWise Automate by means of ConnectWise Automate Plugin Manager.

To remove Kaspersky Security Plug-in for ConnectWise Automate:

1. Open ConnectWise Automate Control Center.
2. On the main menu, do either of the following:
   • Select Help → Plugin Manager (if you use ConnectWise Automate 10.5 or 11).
   • Select System → Solutions → Plugin Manager (if you use ConnectWise Automate 12).
3. In the Plugin Manager window that opens, in the list of plug-ins select Kaspersky Security Plug-in for ConnectWise Automate.
4. In the Plugin Manager window, on the menu bar select Advanced → Manage Plugins → Remove Plugin.
5. A message appears, confirming removal of the Plug-in.

Kaspersky Security Plug-in for ConnectWise Automate is removed.

After Kaspersky Security Plug-in for ConnectWise Automate is removed, all modifications that the Plug-in made to the initial ConnectWise Automate configuration remain in the system. That is, all the scripts, roles, monitors, and other items are still available, as well as any database tables added by the Plug-in. The process of complete removal of the Plug-in and all its items is described in the Knowledge Base. The SQL scripts for removing all Plug-in components are provided as well.

If tracing is enabled, the trace files are not removed from the temporary folders on the ConnectWise Automate server, computers that have ConnectWise Automate Control Center installed, or Automate Agents. You can manually remove them later from the following folder: %windir%\temp\KasperskyPluginLogs\.

Page top

[Topic 133520]

Getting started with Kaspersky Security Plug-in for ConnectWise Automate

After you install Kaspersky Security Plug-in for ConnectWise Automate, you must perform additional configuration in ConnectWise Automate Control Center to be able to use the Plug-in with your Kaspersky Lab solution.

This section describes the actions that you must perform when getting started with Kaspersky Security Plug-in for ConnectWise Automate. The actions depend on the Kaspersky Lab solution you use. Refer to one of the following sections to get started with Kaspersky Security Plug-in for ConnectWise Automate.

[Topic 165648]

Prerequisites

When configuring integration, you must specify the parameters of the Kaspersky Lab solution you integrate with (Kaspersky Security Center / Kaspersky Endpoint Security Cloud). It is recommended that you check these parameters in advance in order to prepare for setting up integration.

Kaspersky Security Center parameters

Check the following parameters:

• Address of the computer on which Kaspersky Security Center Administration Server is installed.
• Credentials: user name and password for the computer on which Administration Server is installed.
• If you establish connection to the Administration Server through a proxy server, check the proxy server parameters: network address or domain name and credentials for the proxy server.

Kaspersky Endpoint Security Cloud parameters

Check the credentials of your Kaspersky Business Hub account: email address and password.

Additional prerequisites

During the integration process, it is required to add Kaspersky Endpoint Security Cloud workspaces to your integration. Prior to integration, you must create workspaces and distribute computers of client companies between these workspaces.

If you use Kaspersky Security Center, creation of virtual servers is optional.

[Topic 141684]

Getting started if Kaspersky Security Center Administration Server is used

After you install Kaspersky Security Plug-in for ConnectWise Automate, deploy it on the computers where Kaspersky Security Center Administration Server is installed.

Kaspersky Security Plug-in for ConnectWise Automate adds new role detection rules to the ConnectWise Automate database. The new roles are Kaspersky Security Administration Server and Kaspersky Security Network Agent. These roles are used by the Plug-in to automatically detect the Administration Server computers, and the client computers, managed by the Administration Server. The Plug-in is then deployed on computers that have Administration Server installed. However, role detection and Plug-in deployment occur not immediately but instead during the scheduled synchronization procedure. You can force the process of role detection and Plug-in deployment manually using the tools provided by ConnectWise Automate.

You can perform the Plug-in deployment procedure at any level: for a client, a location, or an individual computer. When you deploy the Plug-in for a higher level, it is deployed for all sublevels as well. For example, when you deploy the Plug-in for a location, it is deployed for all the computers at this location that have Kaspersky Security Center installed.

To get started using the Plug-in:

1. In the ConnectWise Automate navigation tree, use the context menu to execute the Commands → Inventory → Update Config command for all Kaspersky Security Center Administration Servers and computers, managed by the Administration Servers, or for the computers' parent client or location.

   When you execute the command for a client or location, the command is applied to all the computers under this client or location. As a result, the configuration of the selected computers is updated and includes new Plug-in role definitions.

2. Also in the ConnectWise Automate navigation tree, use the context menu to execute the Commands → Inventory → Resend System Info command for all Administration Servers and computers, managed by the Administration Servers, or for the computers' parent client or location.

   As a result, the Automate Agents on the selected computers send the updated system information, including information on the detected roles, to the ConnectWise Automate server.

Page top

[Topic 141686]

Getting started if Kaspersky Endpoint Security Cloud is used

After you install Kaspersky Security Plug-in for ConnectWise Automate, it must be integrated with Kaspersky Endpoint Security Cloud.

The integration process consists of the following phases:

1. Creating a new integration or editing an existing one. At this phase, you create an integration and add workspaces and administrators to this integration, or edit the list of workspaces and administrators of an existing integration. Adding workspaces to an integration is required to get information on computers and events from these workspaces. Adding administrators is required to allow these administrators to manage the workspaces and integration itself.
2. Assigning the "bridge" role to the computer. This role indicates that this computer interacts with Kaspersky Endpoint Security Cloud and connects ConnectWise Automate and Kaspersky Endpoint Security Cloud like a bridge.
3. Providing the connection settings for the bridge. At this step, you specify the credentials to be used by the bridge to connect to Kaspersky Endpoint Security Cloud.

[Topic 141436]

Managing integrations

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

[Topic 165499]

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.

[Topic 165745]

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.

[Topic 141634]

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

[Topic 141658]

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

[Topic 155631]

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.

[Topic 150901]

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

[Topic 141462]

Managing the "bridge" role of a computer

When you install Kaspersky Security Plug-in for ConnectWise Automate, a new role definition is added to the ConnectWise Automate configuration. This role definition is Kaspersky Endpoint Security Cloud Bridge. This role shows that a computer with such a role interacts with Kaspersky Endpoint Security Cloud, connecting it to ConnectWise Automate like a bridge.

The computer to be assigned the "bridge" role must meet the following requirements:

• Stable access to the Internet.
• ConnectWise Automate Agent installed.
• Kaspersky Security Center Administration Console installed.

The "bridge" role is assigned to a computer manually. When you assign the "bridge" role to a computer, the computer is authorized to perform requests to Kaspersky Endpoint Security Cloud and return the results to ConnectWise Automate.

You can also remove the "bridge" role from a computer, for example, if you want to assign this role to another computer.

The exact steps required to assign and remove the "bridge" role depend on the ConnectWise Automate version that you use.

If you use ConnectWise Automate 10.5 or 11

To assign the "bridge" role to a computer:

1. In the ConnectWise Automate navigation tree, select the computer to which you want to assign the "bridge" role.
2. Right-click the selected computer, point to Commands → LabTech, and then click Kaspersky - Assign Kaspersky Endpoint Security Cloud Bridge Role.

   Configuration of the selected computer is updated and the "bridge" role is assigned to the computer.

3. Double-click the selected computer. The computer management screen opens.
4. Click the Detected Roles tab (if you use ConnectWise Automate 10.5), or on the Automation () tab click the Detected Roles tile (if you use ConnectWise Automate 11), and check that the "bridge" role is present in the list of roles for the selected computer.

To remove the "bridge" role from a computer:

1. In the ConnectWise Automate navigation tree, select the computer from which you want to remove the "bridge" role.
2. Right-click the selected computer, point to Commands → LabTech, and then click Kaspersky - Remove Kaspersky Endpoint Security Cloud Bridge Role.

   Configuration of the selected computer is updated and the "bridge" role is removed from the computer.

3. Double-click the selected computer. The computer management screen opens.
4. Click the Detected Roles tab (if you use ConnectWise Automate 10.5), or on the Automation () tab click the Detected Roles tile (if you use ConnectWise Automate 11), and check that the "bridge" role is absent in the list of roles for the selected computer.

If you use ConnectWise Automate 12

To assign the "bridge" role to a computer:

1. In the ConnectWise Automate 12 browser, select the computer to which you want to assign the "bridge" role.
2. Double-click the selected computer. The computer management screen opens.
3. On the Automation () tab, click the Detected Roles tile. Click the Add button.
4. In the Role Template list, select Kaspersky Endpoint Security Cloud Bridge. Click OK to save the changes.
5. In the ConnectWise Automate navigation tree, right-click the computer, point to Commands → Remote Agent, and then click Update Plug-ins.
6. On the Automation () tab of the computer management screen, click the Detected Roles tile and check that the "bridge" role is present in the list of roles for the selected computer.

To remove the "bridge" role from a computer:

1. In the ConnectWise Automate 12 browser, select the computer from which you want to remove the "bridge" role.
2. Double-click the selected computer. The computer management screen opens.
3. On the Automation () tab, click the Detected Roles tile.
4. Right-click the Kaspersky Endpoint Security Cloud Bridge role, and then click Delete Role. Confirm the action.
5. In the ConnectWise Automate navigation tree, right-click the computer, point to Commands → Remote Agent, and then click Update Plug-ins.
6. On the Automation () tab of the computer management screen, click the Detected Roles tile and check that the "bridge" role is absent in the list of roles for the selected computer.

[Topic 165784]

Connecting to Kaspersky Lab solutions

This section describes the Kaspersky tab of the Computer Management screen in ConnectWise Automate Control Center. This section also explains how to use this tab to configure connection between Kaspersky Security Plug-in for ConnectWise Automate and the Kaspersky Lab solution you use (Kaspersky Security Center or Kaspersky Endpoint Security Cloud) and how to view information about computers and events.

[Topic 141437]

About the Kaspersky tab

Kaspersky Security Plug-in for ConnectWise Automate adds the Kaspersky tab to the Computer Management screen for computers that have the Kaspersky Security Center Administration Server role or Kaspersky Endpoint Security Cloud Bridge role in ConnectWise Automate. On this tab, you can view and edit connection settings for Kaspersky Security Center Administration Servers or Kaspersky Endpoint Security Cloud integrations. The Kaspersky tab also provides information about the computers managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge and about the events that occurred on those computers.

Click the Kaspersky tab to specify connection settings for the Kaspersky Lab solution you use:

• Kaspersky Security Center Administration Server, if you use an on-premises version of a Kaspersky Lab solution.
• Kaspersky Endpoint Security Cloud integration, if you use the Cloud version of a Kaspersky Lab solution.

The channel of data exchange between ConnectWise Automate Agent and ConnectWise Automate Server must be secure, since it is used for transferring data from Kaspersky Security Center. You may use VPN to ensure that you connection is protected.

The Kaspersky tab is displayed only for computers that have the Kaspersky Security Center Administration Server role or the Kaspersky Endpoint Security Cloud Bridge role in ConnectWise Automate.

The Kaspersky tab of the Computer Management screen has three second-level tabs. In the left vertical pane of the Kaspersky tab, you can shift between these three tabs. By default, the Settings tab is displayed.

• Settings—Click this tab to view and configure the connection settings for the Kaspersky Lab solution you use. The appearance of the Settings tab depends on the Kaspersky Lab solution that is being used.
• Computers—Click this tab to view information about computers managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.
• Events—Click this tab to view information about events registered on the computers managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.

Page top

[Topic 133836]

Connecting to Kaspersky Security Center Administration Server

After Kaspersky Security Plug-in for ConnectWise Automate is installed, specify the connection settings for all Kaspersky Security Center Administration Servers. Connection settings can be specified in ConnectWise Automate, on the Kaspersky tab of the Computer Management screen for each of the Administration Server computers. Kaspersky Security Plug-in for ConnectWise Automate uses the specified settings to connect to the Administration Servers and receive security information from them. This security information is then displayed on the Kaspersky dashboard.

Use the Settings tab to view and specify the connection settings for Kaspersky Security Center Administration Server.

Connecting to Kaspersky Security Center Administration Server

Specify the following settings to connect to Kaspersky Security Center Administration Server:

• User name—User name to connect to Administration Server. This field cannot be blank.
• Password—Password to connect to Administration Server. This field cannot be blank.

If you changed any of the connection settings, click Save for your changes to take effect. The newly specified connection settings are then checked and saved. Usually, establishing a new connection takes several minutes.

The Administration Server connection settings you provided are stored in the ConnectWise Automate server database. The password is stored in encrypted form by Kaspersky Security Plug-in for ConnectWise Automate.

[Topic 141456]

Connecting to Kaspersky Endpoint Security Cloud

After you assign the "bridge" role to the computer (see section Managing the "bridge" role of a computer for details), open the Computer Management screen of this computer and proceed to the Kaspersky tab. On the Kaspersky tab, specify your credentials to be used by the bridge to connect to Kaspersky Endpoint Security Cloud.

To connect to Kaspersky Endpoint Security Cloud:

1. Click the Kaspersky tab of the Computer Management screen.

   

   Connecting to Kaspersky Endpoint Security Cloud

2. On the Settings tab, specify the following connection settings:
   • 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
3. Click Proceed to connect to Kaspersky Endpoint Security Cloud using the specified settings.

   

   Selecting integration and specifying integration settings

4. In the Provide integration settings section that is displayed, select the previously configured integration in the Select Integration drop-down list.

   You can view the identifier of your integration by clicking the Integration ID link.

5. If you cannot find the required integration in the drop-down list, make sure that the user account provided in step 2 has access to this integration. To change the user specified in step 2 and connect to the integration using other credentials, click Switch user and in the Set up connection to Kaspersky Endpoint Security Cloud section specify the user name and password as instructed in step 2.
6. If you want the Kaspersky Endpoint Security Cloud Bridge computer to establish connection through the proxy server, in the Provide integration settings section select the Use proxy server check box and provide the following proxy server settings:
   • Address—Network address of the proxy server. Provide the address in the following format: host:port.
   • User name—User name to connect to the proxy server
   • Password—Password to connect to the proxy server.
7. Click Save to save the connection settings you provided.

The system validates the settings. If the settings you provided are correct, connection with Kaspersky Endpoint Security Cloud is established.

[Topic 134079]

Viewing computer information

The Computers tab displays a list of computers managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.

Viewing computer information

Click the Computers tab to view information, provided by the Kaspersky Lab solution, about protection of the computers in your network. You can use the left navigation tree and the set of filters to quickly find required computers, for example, those installed in a specific location or with a specific protection status.

Filters in the top pane allow convenient searching of computers. You can filter the computers by protection states, name, and status. To restrict your computer selection and to view only the computers with selected properties, apply several filters at the same time. Every time you open the Computers tab, the previously used filter settings are restored—there is no need to set up filters again.

Use the navigation tree to display the computers of a specific client or location. Do one of the following:

• Click the Clients node to display all the computers managed by the selected Administration Server or received from Kaspersky Endpoint Security Cloud workspaces by the selected "bridge".
• Click the name of a specific client to view the computers of this client that are managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.
• Click the name of a specific location to view the computers at this location that are managed by the selected Administration Server or retrieved from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.

Information about the computers is displayed as a table. You can sort information in the table by any of the table columns by clicking the column header. For each computer you can find the following information:

• Computer—Name of the computer. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed above and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud is displayed below. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.

  

  Computer names

• Status—Current protection status of the managed computer. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Status description—Detailed description of the problems detected on the selected computer, if the computer status differs from OK. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Agent installed—Yes, if Kaspersky Security Center Network Agent is installed on the selected computer; otherwise, No.
• Viruses found—Number of viruses found on the selected computer. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Last scan—Date and time when a scan of the selected computer was last performed. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Database issued—Date and time when anti-virus databases on the selected computer were issued. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Last information update—Date and time when information on a computer was last updated in Kaspersky Security Center or Kaspersky Endpoint Security Cloud. If more than five days passed since the date when information on a computer was last updated, this computer is deleted from the ConnectWise Automate database and is no longer displayed in the computer list.

When you select a computer or a group of computers in the table, its properties are displayed in the Statistics and commands pane on the right side of the screen. You can run a virus scan and anti-virus database update task in the Statistics and commands pane for the selected computer or group.

In addition to the properties in the table, the following computer properties and actions are displayed in the Statistics and commands pane:

• Commands—Click one of the links in this group to scan the computer for viruses or update the anti-virus databases on the computer.
• Client—Name of the ConnectWise Automate client that the computer belongs to.
• Location—Name of the ConnectWise Automate location that the computer belongs to.

You can view which problems on the computers require your attention. For this purpose, select the computers you are interested in. The problems detected on these computers are displayed in the Detected problems field in the Statistics and commands pane, accompanied by the total number of computers selected.

Page top

[Topic 134091]

Viewing event information

On the Events tab, a list of events is displayed that occurred on the computers managed by the selected Administration Server or received from Kaspersky Endpoint Security Cloud workspaces by the selected bridge.

Viewing event information

Click the Events tab to view additional information, obtained from the Kaspersky Lab solution, about the security issues detected on a particular computer or group of computers.

In the top pane, you can configure filters to view only the events with selected properties. You can filter events by severity level, client, computer, or time of occurrence. To restrict your event selection and view only those events with selected properties, apply several filters at the same time. Every time you open the Events tab, the previously used filter settings are restored—there is no need to set up filters again.

Information on the events is displayed as a table. You can sort information in the table by any of the table columns by clicking the column header. For each event, you can view the following information:

• Client—Name of a ConnectWise Automate client company. The computer on which the event occurred belongs to this client. This field is applicable if you use Kaspersky Security Center; it is blank if you use Kaspersky Endpoint Security Cloud.
• Severity—Severity level of the event according to Kaspersky Security Center or Kaspersky Endpoint Security Cloud.
• Time occurred—Time when the event occurred.
• Computer—Name of the computer on which the event occurred. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed on the first line of the entry and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud on the second line. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.
• Event—Name and description of the event.

When you select an event in the table, its properties are displayed in the pane on the right side of the screen. In addition to those in the table, the following event properties are displayed:

• Location—Name of the ConnectWise Automate location. The computer on which the event occurred belongs to this location. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Virtual Server—Name of the Kaspersky Security Center virtual server. The computer on which the event occurred is located on this server. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Kaspersky Security Center group—Name of a Kaspersky Security Center group. The computer on which the event occurred belongs to this group. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Application—Name of the application that the event is related to.
• Version—Version the application that the event is related to.
• Task—Name of the task that the event is related to. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.

[Topic 133521]

Viewing information on Kaspersky dashboard

Kaspersky Security Plug-in for ConnectWise Automate adds the Kaspersky icon to the ConnectWise Automate Control Center toolbar. When you click this icon, the Kaspersky Security Plug-in for ConnectWise Automate window opens. This window contains a set of dashboards where you can view Kaspersky Lab-related information about the computers in your network.

When you open the Kaspersky Security Plug-in for ConnectWise Automate window, the Statistics tab is displayed, showing a set of charts with information about the protection status of the computers on the network.

In the left vertical pane of the Kaspersky Security Plug-in for ConnectWise Automate, window you can shift between the following tabs:

• Statistics—Click this tab to view high-level information about computer protection, deployment, and database status in graphical format.
• Computers—Click this tab to view detailed information about the computers.
• Events—Click this tab to view information about events registered by the Kaspersky Lab solution that is integrated with ConnectWise Automate.
• Licensing—Click this tab to view information about the Kaspersky Lab keys used by all managed devices on the network.

[Topic 165582]

Viewing protection information

This section describes the Statistics tab and explains how to use it to view aggregated protection information about the computers of all your client companies.

[Topic 133600]

About the Statistics tab

On the Statistics tab, you can view aggregated protection information, represented as a set of charts, about the computers of all your clients. The charts help you to manage the state of your network by allowing you to observe statistical information about the computers. You can monitor protection statuses of computers on the network by viewing information provided by Kaspersky Security Plug-in for ConnectWise Automate. For example, you can immediately detect how many computers on the network are in the critical state or have outdated anti-virus databases.

Viewing protection information

The following pie charts provide snapshots of several aspects of computer protection:

• Protection status
• Deployment status
• Database status

You can filter information displayed in the charts by client and location.

To filter information displayed,

In the Clients drop-down list, select a client or location you want to view.

In the Attention required section below the charts, you can also view statistics on clients that have computers requiring your attention. This section shows information on the number of computers on the network of client companies that require your attention. These are the computers with the following statuses:

• Critical protection status.
• Unmanaged and Unprotected deployment status.
• Anti-virus databases were issued more than a week ago database status.

Page top

[Topic 155652]

Deployment status chart

The Deployment status chart displays the total number of computers managed by ConnectWise Automate, which have the deployment statuses below.

Deployment status chart

• Unmanaged—Kaspersky Security Center Network Agent is not installed (computers are not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud).
• Unprotected—Kaspersky Security Center Network Agent is installed (computers are managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud) but no real-time protection solution by Kaspersky Lab is installed.
• Protected—Both Kaspersky Security Center Network Agent and a real-time protection solution by Kaspersky Lab are installed.

In the middle of the pie chart, the total number of computers is displayed. To the right of the chart, the legend shows details on how many computers, with each status, are on the network.

When you click any deployment status color icon in the chart legend or any chart sector, a window appears, showing details on the computers with the selected deployment status.

The following information is displayed for each computer:

• Computer—Name of the computer. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed above and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud is displayed below. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.

  

  Computer names

• Client / Location—Name of the ConnectWise Automate client and location that the computer belongs to.
• Workspace—If you use Kaspersky Endpoint Security Cloud, this field shows the name of the workspace to which the selected computer belongs. When you click the workspace name, the corresponding Kaspersky Endpoint Security Cloud workspace opens in your browser window.

Page top

[Topic 155651]

Protection status chart

Protection status chart displays the total number of computers, managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud (depending on the solution you use), which take the following protection statuses: Critical, Warning, or OK.

Protection status chart

In the middle of the chart, the total number of managed computers is displayed. To the right of the chart, the legend shows the number of computers with each status. This allows you to instantly know the number of critical or warning computers on the network.

When you click any computer status color icon in the chart legend, or any chart sector, a window appears, showing details on the computers with the selected status.

The following information is displayed for each computer:

• Computer—Name of the computer. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed above and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud is displayed below. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.

  

  Computer names

• Client / Location—Name of the ConnectWise Automate client and location that the computer belongs to.
• Status description—Detailed description of the problems detected on the computer, if the computer status differs from OK.
• Workspace—If you use Kaspersky Endpoint Security Cloud, this field shows the name of the workspace to which the selected computer belongs. When you click the workspace name, the corresponding Kaspersky Endpoint Security Cloud workspace opens in your browser window.

Page top

[Topic 155653]

Database status chart

The Database status chart displays the total number of computers (managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud) on which a real-time protection solution by Kaspersky Lab is installed, categorized according to the time since the anti-virus databases being used were issued.

Database status chart

In the middle of the pie chart, the total number of protected computers is displayed. To the right of the chart, the legend shows the number of computers in each group. This allows you to see the number of computers that use anti-virus databases issued a long time ago.

When you click any database status color icon in the chart legend or in any color sector of the pie chart, a window opens showing details about the computers with the selected database status.

The following information is displayed for each computer:

• Computer—Name of the computer. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed above and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud is displayed below. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.

  

  Computer names

• Client / Location—Name of the ConnectWise Automate client and location that the computer belongs to.
• Workspace—If you use Kaspersky Endpoint Security Cloud, this field shows the name of the workspace to which the selected computer belongs. When you click the workspace name, the corresponding Kaspersky Endpoint Security Cloud workspace opens in your browser window.

[Topic 165524]

Viewing computer information

This section describes the Computers tab and explains how to use it to view information about managed computers on your network.

[Topic 133601]

About the Computers tab

The Computers tab displays a list of all computers managed by ConnectWise Automate.

Viewing computer information

Click the Computers tab to view information, provided by the Kaspersky Lab solution, about protection of the computers in your network. You can use the left navigation tree and the set of filters to quickly find required computers, for example, those installed in a specific location or with a specific protection status.

Filters in the top pane allow convenient searching of computers. You can filter the computers by management and protection states, name, and status. To restrict your computer selection and to view only the computers with selected properties, apply several filters at the same time. Every time you open the Computers tab, the previously used filter settings are restored—there is no need to set up filters again.

Use the navigation tree to display the computers of a specific client or location. Do one of the following:

• Click the Clients node to display all the computers.
• Click the name of a specific client to display the computers of this client.
• Click the name of a specific location to display the computers in this location.

Information about the computers is displayed as a table. You can sort information in the table by any of the table columns by clicking the column header. For each computer you can find the following information:

• Computer—Name of the computer. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed above and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud is displayed below. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.

  

  Computer names

• Administration Server / Workspace—The content of this field depends on which Kaspersky Lab solution you use:
  • If you use Kaspersky Security Center, this field shows the computer name of the Administration Server that manages the selected computer. The Administration Server computer name can be different in ConnectWise Automate and in Kaspersky Security Center. The Administration Server computer name for ConnectWise Automate is displayed on the first line of the entry and the name for Kaspersky Security Center on the second line. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.
  • If you use Kaspersky Endpoint Security Cloud, this field shows the name of the Kaspersky Endpoint Security Cloud workspace to which the selected computer belongs.
• Status—Current protection status of the managed computer. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Status description—Detailed description of the problems detected on the selected computer, if the computer status differs from OK. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Agent installed—Yes, if Kaspersky Security Center Network Agent is installed on the selected computer; otherwise, No.
• Viruses found—Number of viruses found on the selected computer. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Last scan—Date and time when a scan of the selected computer was last performed. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Database issued—Date and time when anti-virus databases on the selected computer were issued. If the computer is not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, this field is blank.
• Last information update—Date and time when information on a computer was last updated in Kaspersky Security Center or Kaspersky Endpoint Security Cloud. If more than five days passed since the date when information on a computer was last updated, this computer is deleted from the ConnectWise Automate database and is no longer displayed in the computer list.

When you select a computer or a group of computers in the table, its properties are displayed in the Statistics and commands pane on the right side of the screen. You can run a virus scan and anti-virus database update task in the Statistics and commands pane for the selected computer or group.

In addition to the properties in the table, the following computer properties and actions are displayed in the Statistics and commands pane:

• Commands—Click one of the links in this group to scan the computer for viruses or update the anti-virus databases on the computer.
• Client—Name of the ConnectWise Automate client that the computer belongs to.
• Location—Name of the ConnectWise Automate location that the computer belongs to.

You can view which problems on the computers require your attention. For this purpose, select the computers you are interested in. The problems detected on these computers are displayed in the Detected problems field in the Statistics and commands pane, accompanied by the total number of computers selected.

Page top

[Topic 133664]

Sorting the list of computers

Sorting the list of computers is useful if you want, for example, to view computers with a specific status or computers with the most time since the last virus scan at the top of the list.

You can sort both filtered and unfiltered list of computers.

To sort the list of computers:

1. Click the Computers tab.
2. Click the name of the column you want to sort by. You can sort by any column of the list.

   The list of computers is sorted by the columns you select.

   When you click the column name for the first time, the values are sorted in ascending order. When you click the column name again, the values are sorted in descending order. The arrow next to the column name shows the sort direction.

Page top

[Topic 133655]

Filtering computers by management and protection status

Filtering the list of computers by management and protection status is useful if, for example, you want to view only computers that are not managed and then move them into Kaspersky Security Center or Kaspersky Endpoint Security Cloud management or if you want to view only computers that are not protected and then install Kaspersky Anti-Virus on them.

To filter the computers by management and protection status:

1. Click the Computers tab.
2. Click one of the following links in the Show computers section:

   Link	Action
   All	Displays all the computers managed by ConnectWise Automate.
   Managed	Displays the computers on which Network Agent is installed; these computers are managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud.
   Unmanaged	Displays the computers on which Network Agent is not installed; these computers are not managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud.
   Protected	Displays the managed computers on which Kaspersky Anti-Virus is installed.
   Unprotected	Displays the managed computers on which Kaspersky Anti-Virus is not installed.

   Only the selected computers are displayed.

3. Click Reset filter to display all the computers.

Page top

[Topic 133662]

Advanced filter of computers

Advanced filter enables you to filter the list of computers and to search for computers that match specific criteria. For example, you can view only computers with a specific name or part of a name, or with a specific protection status.

Advanced filter for computers

To apply advanced filter to the list of computers:

1. Click the Computers tab.
2. Click the value within the parentheses next to one of the field names in the Filter by section.
3. In the Filter window specify the following criteria:

   Field	How to set up a filter
   Computer	To filter the list of computers by name, type any part of the computer name in this field; either the ConnectWise Automate computer name or a computer name in Kaspersky Security Center or Kaspersky Endpoint Security Cloud can be used.
   Administration Server / Cloud Bridge	To filter the list of computers by Administration Server (if you use Kaspersky Security Center) or by Cloud Bridge (if you use Kaspersky Endpoint Security Cloud), select the check boxes next to the required Administration Servers or Cloud Bridges.
   Workspace	To filter the list of computers by workspace (if you use Kaspersky Endpoint Security Cloud), type any part of the workspace name in this field.
   Status	To filter the list of computers by protection status, click the required status. Click All to display the computers with all statuses.
   Description	To filter the list of computers by protection status description, select one or more of the standard protection status descriptions.

4. Click Apply.

   Only the selected computers are displayed.

5. On the Computers tab, click Reset filter to display all the computers.

Page top

[Topic 165526]

Viewing event information

This section describes the Events tab and explains how to use it to view information about events that occur on managed computers.

[Topic 133602]

About the Events tab

The Events tab displays a list of events that occurred on the managed computers.

Viewing event information

Click the Events tab to view additional information, obtained from the Kaspersky Lab solution, about the security issues detected on a particular computer or group of computers.

In the top pane, you can configure filters to view only the events with selected properties. You can filter events by severity level, client, computer, or time of occurrence. To restrict your event selection and view only those events with selected properties, apply several filters at the same time. Every time you open the Events tab, the previously used filter settings are restored—there is no need to set up filters again.

Information on the events is displayed as a table. You can sort information in the table by any of the table columns by clicking the column header. For each event, you can view the following information:

• Client—Name of a ConnectWise Automate client company. The computer on which the event occurred belongs to this client. This field is applicable if you use Kaspersky Security Center; it is blank if you use Kaspersky Endpoint Security Cloud.
• Severity—Severity level of the event according to Kaspersky Security Center or Kaspersky Endpoint Security Cloud.
• Time occurred—Time when the event occurred.
• Computer—Name of the computer on which the event occurred. The computer name can be different in ConnectWise Automate and in the Kaspersky Lab solution. The computer name for ConnectWise Automate is displayed on the first line of the entry and the name for Kaspersky Security Center / Kaspersky Endpoint Security Cloud on the second line. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.
• Event—Name and description of the event.
• Administration Server / Workspace—The content of this field depends on the Kaspersky Lab solution you use:
  • If you use Kaspersky Security Center, this field shows the computer name of the Administration Server that manages the computer on which the event occurred. The Administration Server computer name can be different in ConnectWise Automate and in Kaspersky Security Center. The Administration Server computer name for ConnectWise Automate is displayed on the first line of the entry and the name for Kaspersky Security Center on the second line. When you click the computer name, the Computer Management screen of ConnectWise Automate Control Center is displayed for this computer.
  • If you use Kaspersky Endpoint Security Cloud, this field shows the name of the workspace, to which the computer on which the event occurred belongs.

When you select an event in the table, its properties are displayed in the pane on the right side of the screen. In addition to those in the table, the following event properties are displayed:

• Location—Name of the ConnectWise Automate location. The computer on which the event occurred belongs to this location. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Virtual Server—Name of the Kaspersky Security Center virtual server. The computer on which the event occurred is located on this server. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Kaspersky Security Center group—Name of a Kaspersky Security Center group. The computer on which the event occurred belongs to this group. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.
• Application—Name of the application that the event is related to.
• Version—Version the application that the event is related to.
• Task—Name of the task that the event is related to. This field is displayed if you use Kaspersky Security Center; it is not displayed if you use Kaspersky Endpoint Security Cloud.

Page top

[Topic 133665]

Sorting the list of events

Sorting the list of events is useful if, for example, you want to view events that have a specific severity level or that most recently appeared at the top of the list.

You can sort both filtered and unfiltered list of events.

To sort the list of events:

1. Click the Events tab.
2. Click the name of the column that you want to sort by. You can sort by any column of the list.

   The list of events is sorted by the selected columns.

   When you click the column name the first time, the values are sorted in ascending order. When you click the column name again, the values are sorted in descending order. The arrow next to the column name shows the sort direction.

Page top

[Topic 133666]

Filtering events by severity level

Filtering the list of events by severity level is useful if, for example, you want to view only critical events in order to immediately respond to and solve a problem.

To filter the events by severity level:

1. Click the Events tab.
2. Click one of the following links in the Show events section:

   Link	Action
   Any	Displays all the events.
   Info	Displays the events with Info severity level.
   Warning	Displays the events with Warning severity level.
   Error	Displays the events with Error severity level.
   Critical	Displays the events with Critical severity level.

   Only the events with the selected severity level are displayed.

3. Click Reset filter to display all the events.

Page top

[Topic 133667]

Advanced filter of events

Advanced filter enables you to filter the list of events and to search for events that match specific criteria. For example, you can view only events that occurred during the last day, or events that occurred on a particular computer, or that occurred at a particular client company.

Advanced filter for events

To apply advanced filter to the list of events:

1. Click the Events tab.
2. Click the value within the parentheses next to one of the field names in the Filter by section.
3. In the Filter window specify the following criteria:

   Field	How to set up a filter
   Client	To filter the list of events by client, type any part of the client name in this field.
   Computer	To filter the list of events by computer name, type any part of the computer name in this field; either the ConnectWise Automate computer name or a computer name in Kaspersky Security Center or Kaspersky Endpoint Security Cloud can be used.
   Administration Server / Cloud Bridge	To filter the list of events by Administration Server (if you use Kaspersky Security Center), or by Cloud Bridge (if you use Kaspersky Endpoint Security Cloud), select the check boxes next to the required Administration Servers or Cloud Bridges.
   Virtual server / Workspace	To filter the list of events by virtual server (if you use Kaspersky Security Center), or the workspace (if you use Kaspersky Endpoint Security Cloud), type any part of the virtual server or workspace name in this field.
   Event name	To filter the list of events by name, type any part of the event name or description in this field.
   Occurred	To filter the list of events by occurrence time, click one of the occurrence intervals. Click Anytime to display all the events.

4. Click Apply.

   Only the selected events are displayed.

5. On the Events tab, click Reset filter to display all the events.

[Topic 165578]

Viewing licensing information

This section describes the Licenses tab and explains how to use it to view information about keys used on devices integrated with ConnectWise Automate.

[Topic 155550]

About the Licensing tab

The Licensing tab displays information on all the keys used on devices—managed by any Administration Server or connected to any Kaspersky Endpoint Security Cloud workspace—that are integrated with ConnectWise Automate.

Key usage statistics are aggregated and displayed on the chart. The chart helps you to find out which keys are used on the managed computers in your network. The chart also helps you to manage the state of licensing on your network by allowing you to check how many of the keys have exceeded limits or are used over 90%. A key exceeds limits if the number of computers that use the key divided by the number of computers to which the key can be assigned is greater than 1. A key is used over 90% if the number of computers that use the key divided by the number of computers to which the key can be assigned is greater than 0.9.

Viewing licensing information

The Key details section displays information, provided by Kaspersky Security Center or Kaspersky Endpoint Security Cloud, about the keys used on the devices in your network, or stored in the main or virtual Administration Server storage or at the workspace. You can use filters to quickly find information about the required keys, for example, those used on devices installed at a specific client company or in a specific location, or keys with a specific status. You can apply several filters at the same time. Every time you open the Licensing tab, the previously used filter settings are restored—there is no need to set up filters again.

Information about the keys is displayed as a table. You can sort information in the table by any of the table columns by clicking the column header. For each key you can find the following information:

• Key—Serial number of the key. Click the key number to view information on the devices, where this key is used as active.
• Product name—Name of the product that uses this key. This column also may show additional information on the key, such as product version and validity period.
• Key source—Source that the key was received from. Kaspersky Security Plug-in for ConnectWise Automate may receive the key from the Administration Server, from a virtual server, or from a Kaspersky Endpoint Security Cloud workspace. If several managed devises use the same key, each of them may receive this key from a different source. This column displays the first few key sources. To view all key sources for the selected key, click the Show details link.
• Active on non-mobile devices—Number of non-mobile devices on which this key is active.
• Active on mobile devices—Number of mobile devices on which this key is active.
• Active on devices (overall)—Total number of devices on which this key is active.
• Expiration date—Date when the key expires.

You can filter information displayed in the charts by client and location.

To filter information displayed,

In the All clients drop-down list, select a client or location to view only licenses that are used on the computers for this particular client or location.

Page top

[Topic 155595]

Viewing key details

One key can be used by multiple managed devices. This window shows detailed information on all the devices, where the selected key is active.

• Show only devices managed by ConnectWise Automate—Select this check box to view key usage information only for devices managed by ConnectWise Automate. If this check box is cleared, all the devices that use this key are displayed, including those not managed by ConnectWise Automate.
• Client—Name of the ConnectWise Automate client that the device belongs to.
• Device—Name of the device that uses this key. When you click a device name, the Computer Management screen of ConnectWise Automate Control Center is displayed for the device.
• Application name—Name of the application that uses this key.
• Application version—Version of the application that uses this key.

Page top

[Topic 155591]

Sorting the list of keys

Sorting the list of keys is useful if, for example, you want to view the keys for a specific application or keys with the nearest expiration date at the top of the list.

You can sort both filtered and unfiltered list of keys.

To sort the list of keys:

1. Click the Licensing tab.
2. Click the name of the column you want to sort by. You can sort by any column of the list.

   The list of keys is sorted by the columns you select.

   When you click a column name for the first time, the values are sorted in ascending order. When you click the column name again, the values are sorted in descending order. The arrow next to the column name shows the sort direction.

Page top

[Topic 155594]

Filtering keys by status

Filtering the list of keys by status is useful if, for example, you want to view only keys that have exceeded restrictions in order to respond immediately and solve a problem.

To filter the keys by status:

1. Click the Licensing tab.
2. Click one of the following links in the Show keys section:

   Link	Action
   All	Displays all the keys.
   Exceeded restrictions	Displays the keys with Exceeded restrictions status. A key exceeds restrictions if the number of computers that use the key divided by the number of computers to which the key can be assigned is greater than 1.
   More than 90% used	Displays the keys with More than 90% used status. A key is used over 90% if the number of computers that use the key divided by the number of computers to which the key can be assigned is greater than 0.9.
   OK	Displays the keys with OK status.

   Only keys with the selected status are displayed.

3. Click Reset filter to display all the keys.

Page top

[Topic 133799]

Running Kaspersky Lab management commands

To keep a network of your clients' computers secure, run the Kaspersky Lab management commands for all computers on the network. Kaspersky Security Plug-in for ConnectWise Automate provides two commands: scan computers for viruses and update anti-virus databases.

You can run the commands directly from the Kaspersky Security Plug-in for ConnectWise Automate dashboard. This method is useful as it allows you to respond to dashboard information immediately. For example, you can run the virus scan command on a computer that has not been scanned in a long time or you can run the update command on a computer with outdated anti-virus databases.

These security commands can be run for managed computers, that is, for computers that have Network Agent installed. You can also run the security commands on a group of computers. You save time by not running commands on individual computers.

[Topic 133802]

Running virus scan command

Run the virus scan command to check computers for viruses and other malware. In the Kaspersky dashboard, accessible from the ConnectWise Automate toolbar, you can view the time when the computer was last scanned for viruses. When an infected object is found during virus scan, the default actions are either to disinfect the object, or, if disinfection is impossible, to skip the object during the scan process.

The virus scan command can only be run on computers that have Kaspersky Endpoint Security or Kaspersky Security for Windows Server installed.

When you perform the virus scan command, all exclusions configured in the "Exclusions and trusted zone" section of the security policies are retained.

To scan computers:

1. In the Kaspersky dashboard, select the Computers tab.
2. In the list of computers displayed on the Computers tab, select one or more computers for which you want to run the virus scan command.

   To select several individual computers use the Ctrl key, to select a range of computers use the Shift key, or just drag the pointer. To select all the displayed computers, click Select → Select all on the top command bar.

3. Start the computer scanning process in one of the following ways:
   • On the top command bar, click Run scan.
   • In the right pane, in the Computer statistics and actions section, click Scan computers.

The scan command is run for the selected computers, which are protected by Kaspersky Endpoint Security for Windows or Kaspersky Security for Windows Server.

You can view the status and results of the scan command for each computer on the Computer Management screen of ConnectWise Automate.

To view the scan results:

1. Open the Computer Management screen for the required computer.
2. On the Computer Management screen, click the Commands tab and view the command status.

Page top

[Topic 133803]

Running anti-virus database update command

Run the update command to update the anti-virus database on computers. In the Kaspersky dashboard, you can view the time when the anti-virus databases were updated.

The update command can be run only for the computers that have Kaspersky Endpoint Security or Kaspersky Security for Windows Server installed.

To enable execution of the local update command on remote agents through ConnectWise Automate Control Center, perform the following setup in Kaspersky Security Center: open the policy and in the Policy properties window select Advanced Settings → Application settings, and then select the Allow local tasks to be displayed and managed (except custom scan) check box. By default, this check box is cleared, so any local commands except virus scan are denied by policy.

To update anti-virus databases on the computers:

1. In the Kaspersky dashboard, select the Computers tab.
2. In the list of computers displayed on the Computers tab, select one or more computers for which you want to run the anti-virus database update procedure.

   To select several individual computers use the Ctrl key, to select a range of computers use the Shift key, or just drag the pointer. To select all the displayed computers, click Select → Select all on the top command bar.

3. Start the anti-virus database updating process in one of the following ways:
   • On the top command bar, click Run update.
   • In the right pane, in the Computer statistics and actions section, click Update virus bases.

The update command is run for the selected computers, which are protected by Kaspersky Endpoint Security for Windows or Kaspersky Security for Windows Server. After the command is successfully completed, click Refresh to update the Database issued field on the Computers tab of the Kaspersky dashboard.

You can view the status and results of the update command for each computer in the Computer Management screen of ConnectWise Automate.

To view the anti-virus database update results:

1. Open the Computer Management screen for the desired computer.
2. In the Computer Management screen, click the Commands tab and view the command status.

Page top

[Topic 133839]

Monitoring and alerting

After you install and enable Kaspersky Security Plug-in for ConnectWise Automate, new internal monitors are created in ConnectWise Automate Control Center. Monitoring and alerting functionality is intended to manage different computer statuses in Kaspersky Security Center / Kaspersky Endpoint Security Cloud and to apply appropriate actions to draw your attention to a problem, automatically resolve an issue, or perform maintenance.

The monitors work and raise alerts only for the managed computers.

You can view the monitors by opening the Monitors tab on the ConnectWise Automate Control Center toolbar. The Kaspersky Security Center / Kaspersky Endpoint Security Cloud monitors are displayed in the list of monitors on the Internal Monitors tab.

Each monitor runs with the specified frequency. The monitors check for specific computer statuses or status descriptions and raise appropriate alerts or perform predefined actions. Depending on the computer status, a monitor can result in different actions: raising an alert, creating a ticket, or performing virus scan or anti-virus database updates. Automatic virus scan or anti-virus database updates, initiated by the monitors, help save you time.

The following Kaspersky Lab monitors are available in ConnectWise Automate Control Center:

Kaspersky Lab monitors available in ConnectWise Automate Control Center

Page top

[Topic 134012]

Deploying Kaspersky Lab security applications from the Control Center

With Kaspersky Security Plug-in for ConnectWise Automate, you can install Kaspersky Lab security applications on computers using a ConnectWise Automate script. The script enables you to install only Kaspersky Security Center Network Agent, or both Network Agent and Kaspersky Endpoint Security applications on the remote agents, depending on your needs. After installing these applications, the computers are considered protected and managed.

Before running the installation script, use Kaspersky Security Center or Kaspersky Endpoint Security Cloud tools to create and save a stand-alone installation package containing Kaspersky Security Center Network Agent, or both Kaspersky Security Center Network Agent and Kaspersky Endpoint Security. The script then deploys this package and installs the applications on the selected computers.

The script that installs Kaspersky Lab security applications can be run only for the Windows operating system.

The script can be run at different levels: for a client, a location or an individual computer.

This section explains how to install Kaspersky Lab security applications on computers from ConnectWise Automate Control Center.

[Topic 134046]

Creating a stand-alone installation package

A stand-alone installation package is an executable file that you can save on a computer, a removable drive, or a shared resource in order to enable the script to use for stand-alone installation. The Kaspersky Install script, included in Kaspersky Security Plug-in for ConnectWise Automate, then runs the created file locally on the client's computers to install Kaspersky Lab applications.

Creation of a stand-alone installation package differs depending on the Kaspersky Lab solution you use: Kaspersky Security Center or Kaspersky Endpoint Security Cloud. Refer to one of the following sections for instructions on creating a stand-alone installation package.

[Topic 135672]

Installation package in Kaspersky Security Center

Kaspersky Security Center allows you to create stand-alone installation packages for security applications. The Kaspersky Install script then runs the created file locally on the client computers to install an application, without involving Kaspersky Security Center.

To create a stand-alone installation package from Kaspersky Security Center:

1. Connect to Kaspersky Security Center Administration Server.
2. In the Kaspersky Security Center console tree, select Advanced → Remote installation → Installation packages.
3. In the workspace, select the installation package of the required application: Kaspersky Endpoint Security or Kaspersky Security Center Network Agent.
4. Start the process of creating a stand-alone installation package by using one of the following methods:
   • In the context menu of the installation package, select Create stand-alone installation package.
   • In the workspace of the installation package, click the Create stand-alone installation package link.

   This will start the Stand-alone Installation Package Creation Wizard. Follow the Wizard instructions.

5. At the final step of the Wizard, select the Open folder option to view the created stand-alone installation package in the folder.
6. If necessary, copy the package to a removable drive (such as a flash drive) for subsequent usage.
7. Proceed to the Running installation script procedure.

Page top

[Topic 133845]

Installation package in Kaspersky Endpoint Security Cloud

Kaspersky Endpoint Security Cloud allows you to download distribution packages of security applications. The Kaspersky Install script then runs the downloaded file locally on the client computers to install an application, without involving Kaspersky Endpoint Security Cloud.

To download a distribution package in Kaspersky Endpoint Security Cloud:

1. On a server or workstation, open a browser and go to Kaspersky Endpoint Security Cloud Management Console.
2. Select the Distribution packages section.

   The Distribution packages section contains distribution packages of security applications available for download.

3. Select a distribution package and click the Download link.

   If your company uses a proxy server, click Proxy server and define the proxy server settings (address, port, user name, and password). If you defined the proxy server settings when you connected the company to Kaspersky Endpoint Security Cloud at the stage of proceeding to the client company's workspace, those settings will affect the distribution package download.

   The distribution package starts downloading to the computer.

4. When the download is complete, open the folder containing the distribution package.
5. If necessary, copy the package to a removable drive (such as a flash drive) for subsequent usage.
6. Proceed to the Running installation script procedure.

Page top

[Topic 134018]

Running installation script

To deploy Kaspersky Lab security applications from ConnectWise Automate Control Center:

1. Locate the setup.exe file, created during the Creating stand-alone installation package procedure, in the folder where it was saved.
2. Create the Kaspersky subfolder of the LTShare\Transfer\Software folder, on the ConnectWise Automate server.
3. Place the generated stand-alone installation package (setup.exe file) to the LTShare\Transfer\Software\Kaspersky folder.
4. Confirm that the setup.exe file can be downloaded through the browser.

   Check the download link, for example, http://<yourFQDN.com>/labtech/transfer/software/kaspersky/setup.exe, where <yourFQDN.com> is the web address of your web server.

5. In the ConnectWise Automate navigation tree, right-click the client, location, or group for which you want to run the installation script, and then select Scripts → Anti-Virus → Kaspersky Lab → Kaspersky Install.

   The Run Script dialog box opens.

6. In the Run Script dialog box, specify the script target and then select Once in the Schedule section.
7. Click OK to start the script.

   The script is started. The script copies and executes the setup.exe file on the client's computers. Installation is run in silent mode.

8. To view the status and results of the installation script execution for an individual computer, open the Computer Management screen and proceed to the Scripts tab.

Page top

[Topic 134031]

Viewing and editing installation script

You can view and if necessary edit or change the settings of the script, which installs Kaspersky Lab security applications on the computers.

Although you can use the ConnectWise Automate Script window to inspect and modify the script, doing so is not recommended, because making incorrect changes can cause the script to damage the computer system.

To view or modify the installation script:

1. In the ConnectWise Automate navigation tree, click the Scripts node.
2. Select Scripts → Anti-Virus → Kaspersky Lab and double-click Kaspersky Install.

   The Script window opens, where you can view or edit the script.

3. After editing the script, click Save to save your changes, and then Close.

Page top

[Topic 134095]

Plug-in modifications to ConnectWise Automate configuration

After you install Kaspersky Security Plug-in for ConnectWise Automate, it adds its own items to the existing ConnectWise Automate entities.

The table below shows the items added by Kaspersky Security Plug-in for ConnectWise Automate.

Kaspersky Security Plug-in for ConnectWise Automate items added to ConnectWise Automate entities

Page top

[Topic 142996]

Enabling and disabling tracing

You may need to save traces of Kaspersky Security Plug-in for ConnectWise Automate, for example, if you contact Technical Support and are asked to provide the traces for diagnostics and troubleshooting. It is recommended to disable tracing when the issue is resolved, as tracing requires additional resources and additional memory to store trace files. It is also recommended to remove the trace files from your computer, when the issue, which required tracing, is resolved, because the trace files may contain personal and confidential data.

The trace files are saved to the %windir%\temp\KasperskyPluginLogs\ folder.

By default, tracing is disabled. You can enable and disable tracing by using the Microsoft Windows registry.

To enable or disable tracing:

Before editing the Microsoft Windows registry, it is recommended that you back up the registry.

1. Click the Start button.
2. In the Start menu, either in the Run box or the Search box, type regedit and press Enter.

   The Registry Editor window opens.

   If you have restricted access to the Windows computer you are logged in to, you might not be able to access the Windows registry.

3. In the Registry Editor window, navigate to the Kaspersky Security Plug-in for LabTech registry key. It is available by one of the following paths:
   • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Plug-in for Labtech
   • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Plug-in for Labtech
4. Edit the value of the EnableTraces parameter as follows:
   • 1—To enable tracing.
   • 0—To disable tracing.
5. Click OK in the Edit window to save your changes.
6. Close the Registry Editor window.

Page top

[Topic 95897]

Glossary

Administration Server

A component of Kaspersky Security Center that centrally stores information about all Kaspersky Lab applications that are installed within the corporate network. Administration Server can also be used to manage these applications.

Administration Server client (Client computer)

A computer, server, or workstation on which Network Agent and managed Kaspersky Lab applications are running.

Anti-virus databases

Databases that contain information about computer security threats known to Kaspersky Lab as of when the anti-virus databases are released. Entries in anti-virus databases allow malicious code to be detected in scanned objects. Anti-virus databases are created by Kaspersky Lab specialists and updated hourly.

Kaspersky Lab update servers

HTTP servers at Kaspersky Lab from which Kaspersky Lab applications download database and application module updates.

Managed computer

Computer with Network Agent installed; this computer is managed by Kaspersky Security Center.

Network Agent

A Kaspersky Security Center component that enables interaction between the Administration Server and Kaspersky Lab applications that are installed on a specific network node (workstation or server).

Notification

A message with information about an event (or events), which is sent by the application via other notification delivery systems (for example, via email) to the specified addresses.

Protection status

Current protection status, which reflects the level of computer security.

Protocol

A clearly defined and standardized set of rules governing the interaction between a client and a server. Well-known protocols and the services associated with them include HTTP, FTP, and NNTP.

Remote installation

Installation of Kaspersky Lab applications by using the services provided by Kaspersky Security Plug-in for ConnectWise Automate.

Update

A function performed by a Kaspersky Lab application that enables it to keep computer protection up-to-date. During the update, an application downloads updates for its databases and modules from Kaspersky Lab update servers and automatically installs and applies them.

Virus

A program that infects other ones, by adding its code to them in order to gain control when infected files are run. This simple definition allows identifying the main action performed by any virus: infection.

Workspace

Virtual Administration Server by Kaspersky Lab that is designed to manage a security software suite on devices connected to Kaspersky Endpoint Security Cloud, as well as store individual settings of Kaspersky Endpoint Security Cloud and the registration data of a company using this product.

Page top

[Topic 70331]

Contact Technical Support

This section describes how to get technical support and the terms on which it is available.

[Topic 124640]

How to get technical support

If you cannot find a solution to your issue in the Kaspersky Security Integrations for MSP documentation or in any of the sources of information about Kaspersky Security Integrations for MSP, contact Technical Support. Technical Support specialists will answer all your questions about configuring and using Kaspersky Security Integrations for MSP.

Before contacting Technical Support, please read the support rules.

You can contact Technical Support in one of the following ways:

• By visiting the Technical Support website
• By sending a request to Technical Support from the Kaspersky CompanyAccount portal

[Topic 68417]

Technical Support via Kaspersky CompanyAccount

Kaspersky CompanyAccount is a portal for companies that use Kaspersky Lab applications. The Kaspersky CompanyAccount portal is designed to facilitate interaction between users and Kaspersky Lab specialists through online requests. You can use Kaspersky CompanyAccount to track the status of your online requests and store a history of them as well.

You can register all of your organization's employees under a single account on Kaspersky CompanyAccount. A single account lets you centrally manage electronic requests from registered employees to Kaspersky Lab and also manage the privileges of these employees via Kaspersky CompanyAccount.

The Kaspersky CompanyAccount portal is available in the following languages:

• English
• Spanish
• Italian
• German
• Polish
• Portuguese
• Russian
• French
• Japanese

To learn more about Kaspersky CompanyAccount, visit the Technical Support website.

[Topic 34744]

AO Kaspersky Lab

Kaspersky Lab is a world-renowned vendor of systems protecting computers against digital threats, including viruses and other malware, unsolicited email (spam), and network and hacking attacks.

In 2008, Kaspersky Lab was rated among the world’s top four leading vendors of information security software solutions for end users (IDC Worldwide Endpoint Security Revenue by Vendor). Kaspersky Lab is the preferred vendor of computer protection systems for home users in Russia (IDC Endpoint Tracker 2014).

Kaspersky Lab was founded in Russia in 1997. It has since grown into an international group of companies with 38 offices in 33 countries. The company employs more than 3,000 skilled professionals.

Products. Kaspersky Lab products provide protection for all systems, from home computers to large corporate networks.

The personal product range includes security applications for desktop, laptop, and tablet computers, smartphones and other mobile devices.

The company offers protection and control solutions and technologies for workstations and mobile devices, virtual machines, file and web servers, mail gateways, and firewalls. The company's portfolio also features specialized products providing protection against DDoS attacks, protection for industrial control systems, and prevention of financial fraud. Used in conjunction with centralized management tools, these solutions ensure effective automated protection for companies and organizations of any size against computer threats. Kaspersky Lab products are certified by major test laboratories, compatible with software from diverse vendors, and optimized to run on many hardware platforms.

Kaspersky Lab virus analysts work around the clock. Every day they uncover hundreds of thousands of new computer threats, create tools to detect and disinfect them, and include their signatures in databases used by Kaspersky Lab applications.

Technologies. Many technologies that are now part and parcel of modern anti-virus tools were originally developed by Kaspersky Lab. It is no coincidence that many other developers use the Kaspersky Anti-Virus engine in their products, including: Alcatel-Lucent, Alt-N, Asus, BAE Systems, Blue Coat, Check Point, Cisco Meraki, Clearswift, D-Link, Facebook, General Dynamics, H3C, Juniper Networks, Lenovo, Microsoft, NETGEAR, Openwave Messaging, Parallels, Qualcomm, Samsung, Stormshield, Toshiba, Trustwave, Vertu, and ZyXEL. Many of the company’s innovative technologies are patented.

Achievements. Over the years, Kaspersky Lab has won hundreds of awards for its services in combating computer threats. Following tests and research conducted by the reputed Austrian test laboratory AV-Comparatives in 2014, Kaspersky Lab ranked among the top two vendors by the number of Advanced+ certificates earned and was ultimately awarded the Top Rated certificate. But Kaspersky Lab's main achievement is the loyalty of its users worldwide. The company’s products and technologies protect more than 400 million users, and its corporate clients number more than 270,000.

[Topic 137602]

Information about third-party code

Information about third-party code is contained in the file legal_notices.txt.

[Topic 135855]

Trademark notices

Registered trademarks and service marks are the property of their respective owners.

Microsoft, Windows, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries.

Page top

[Topic 145892]

Kaspersky Security Integration with ConnectWise Manage

This section describes Kaspersky Security Plug-in for ConnectWise Automate. It contains a general description of the software and provides instructions for working with it.

[Topic 139194]

Kaspersky Security Integration with ConnectWise Manage

This section describes the purpose, functions, and distribution kit of Kaspersky Security Integration with ConnectWise Manage, and provides hardware and software requirements for Kaspersky Security Integration with ConnectWise Manage.

[Topic 138159]

About Kaspersky Security Integration with ConnectWise Manage

Integration is the process of bringing together components into a single system. Kaspersky Security Integration with ConnectWise Manage integrates Kaspersky Lab solutions (Kaspersky Security Center or Kaspersky Business Hub) and ConnectWise Manage to provide a combination of monitoring and management tools, such as automated billing and ticket creation for client accounts. Kaspersky Security Integration with ConnectWise Manage integrates ConnectWise Manage with all cloud-based products managed by Kaspersky Business Hub: Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.

In terms of Kaspersky Security Integration with ConnectWise Manage, integration is a set of parameters and interaction rules that can be set up and configured. First, you create an integration between your Kaspersky Lab solution and ConnectWise Manage; then you can manage and configure your integrations, and view and edit integration parameters. When configuring an integration, you set up mapping between the entities of the Kaspersky Lab solution and ConnectWise Manage entities, and define rules that determine how your Kaspersky Lab solution interacts with ConnectWise Manage.

Kaspersky Security Integration with ConnectWise Manage consists of two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP (managed service providers).

• Kaspersky Security Integration Tool for MSP provides a graphical user interface (GUI) to configure integration. The tool is used to configure connection between the Kaspersky Lab solution that you use and ConnectWise Manage. The tool is also used to configure mapping between the Kaspersky Lab solution entities and ConnectWise Manage entities. Kaspersky Lab solution entities are virtual servers, if you use Kaspersky Security Center, or companies, if you use Kaspersky Business Hub. ConnectWise Manage entities are Companies and Products.
• Kaspersky Security Integration Service for MSP is a Microsoft Windows service application that is installed on the computer that has Kaspersky Security Center Administration Server installed. Kaspersky Security Integration Service for MSP synchronizes data in Kaspersky Security Center and ConnectWise Manage. It is a service application only, with no user interface.

Page top

[Topic 162484]

About data provision

Kaspersky Security Integration with ConnectWise Manage is designed for the integration of Kaspersky Lab solutions for administration of security applications with ConnectWise Manage within the framework of the functionality described in this Help document.

To use Kaspersky Security Integration with ConnectWise Manage, you must install the integration components and connect them to the Kaspersky Lab solution you use, create an integration with ConnectWise Manage, specify connection parameters and integration settings and select your customers’ virtual servers / companies for the integration.

By using the product, you agree that said product may receive data from ConnectWise Manage and the connected virtual servers / companies, as well as store, process, and display information that is intended for ensuring the product functionality.

By creating an integration and connecting ConnectWise Manage and virtual servers / companies to the product, you thus confirm that you are the sole owner of any data you provide or that you are entitled to provide any data.

Any information provided is protected and processed in accordance with the Kaspersky Lab Privacy Policy.

For the purpose of integration of Kaspersky Security Center / Kaspersky Business Hub and ConnectWise Manage, Kaspersky Security Integration with ConnectWise Manage may receive, store, and process the following types of data:

• Data required to connect to the integrated software:
  • Parameters for connecting to Kaspersky Security Center Administration Server, including account credentials.
  • Account credentials for connecting to Kaspersky Business Hub.
  • Connection parameters for accessing ConnectWise Manage.
• Data about events that occur in Kaspersky Security Center, Kaspersky Endpoint Security Cloud, or Kaspersky Security for Microsoft Office 365. This data is required for automatic creation of tickets or similar entities.
• Data about assigning the Critical and Warning statuses to computers managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud. This data is required for automatic creation of tickets or similar entities.
• Data about usage of licenses for Kaspersky Lab security applications by computers managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud (the number of computers that use a certain license). This data is required for automatic generation of invoices for your customers.
• Data about the number of protected Kaspersky Security for Microsoft Office 365 mailboxes. This data is required for automatic generation of invoices for your customers.
• Data about the state of a managed Kaspersky Security Center virtual server / Kaspersky Endpoint Security Cloud workspace (the number of managed computers, the number of protected computers, the number of created and closed tickets of various types, the number of threats and malicious objects detected on the computers, the number of problematic computers, and the number of infected computers). This data is required for report generation.
• Data about licenses used at Kaspersky Security Center virtual servers / Kaspersky Endpoint Security Cloud workspaces and about attributes of these licenses. This data is required for report generation.
• Integration settings:
  • Type of integrated platform (ConnectWise Manage).
  • Integration name.
  • Integration ID (for integrations with Kaspersky Business Hub).
  • Date and time of integration creation.
  • Set of integrated virtual servers / companies.
  • List of Kaspersky Business Hub administrators (their aliases and email addresses) who are also granted administrative privileges in the integration.
  • Rules for mapping objects of Kaspersky Security Center / Kaspersky Business Hub to those of ConnectWise Manage (virtual servers / companies to ConnectWise Manage companies and Kaspersky Lab security applications to ConnectWise Manage products).
  • Rules for creating objects in ConnectWise Manage, such as tickets, agreement additions, and configuration items.

If you integrate ConnectWise Manage with Kaspersky Business Hub, the above data (specifically, data required to connect to the integrated software and integration settings) is transferred from Kaspersky Security Integration Tool for MSP to Kaspersky Business Hub. This data is processed there and is stored according to the terms and conditions of the Privacy Policy of Kaspersky Business Hub.

If your integration includes a company for which a Kaspersky Endpoint Security Cloud workspace has been created, the data that Kaspersky Business Hub receives from Kaspersky Security Integration Tool for MSP is transferred to the Kaspersky Endpoint Security Cloud workspace. This data is processed there and is stored according to the terms and conditions of the agreements that were accepted during the workspace creation.

If your integration includes a company for which a Kaspersky Security for Microsoft Office 365 workspace has been created, the data that Kaspersky Business Hub receives from Kaspersky Security Integration Tool for MSP is transferred to the Kaspersky Security for Microsoft Office 365 workspace. This data is processed there and is stored according to the terms and conditions of the agreements that were accepted during the workspace creation.

All received data is used by the MSP administrators and technicians. Kaspersky Lab Technical Support specialists may also use the above data when an MSP administrator contacts Technical Support.

[Topic 138161]

Features of Kaspersky Security Integration with ConnectWise Manage

Kaspersky Security Integration with ConnectWise Manage helps you to integrate Kaspersky Lab solutions with ConnectWise Manage to provide ticketing, straightforward monitoring, issue tracking, automated billing, and reporting in the customer environment.

Kaspersky Security Integration with ConnectWise Manage provides the following features:

• Connection

With Kaspersky Security Integration with ConnectWise Manage, you can connect Kaspersky Lab solutions to ConnectWise Manage with a few clicks to enable automated billing, ticketing, and other processes. You do not need any additional tools or consoles: you can access everything from your ConnectWise Manage console.

• Automatic ticketing

Kaspersky Security Integration with ConnectWise Manage simplifies multi-tenancy management by enabling automation of ticket creation and workflow for each of your client companies. You can select an Agreement with your client and map it to the corresponding Kaspersky Lab solution.

The tickets are automatically created and assigned to a Service Board, which reduces the time you spend monitoring your managed companies and increases the number of clients that a single technician can manage. For additional resource efficiency, assign business impacts and severities to tickets to streamline their prioritization.

• Billing setup

Kaspersky Security Integration with ConnectWise Manage provides easy access to pricing of Kaspersky Lab security applications from ConnectWise Manage, which significantly simplifies and automates customer billing and reporting.

• Report generation

You can generate service reports on Kaspersky Security Center virtual servers or Kaspersky Business Hub companies and license reports directly from ConnectWise Manage. Service reports include statistics on protection services provided to the client over the last 30 days and the last 7 days. License reports provide information about keys, including their usage and availability.

• Compatibility

With Kaspersky Security Integration with ConnectWise Manage, it is easy to create solutions based on customer needs and requirements: ConnectWise Manage works with both on-premises and cloud-based Kaspersky Lab solutions. Use Kaspersky Lab cloud-based security to avoid additional overhead, or keep everything inside the perimeter and make the most of your existing hardware investment with an on-premises solution.

Page top

[Topic 138160]

Distribution kit

Kaspersky Security Integration with ConnectWise Manage is delivered free of charge as a distribution package that contains installation files for Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

You can download the distribution kit from the Kaspersky Lab website.

No license is required for Kaspersky Security Integration with ConnectWise Manage.

Page top

[Topic 138162]

Software requirements

Basic software requirements for integration setup:

• ConnectWise Manage 2016.1–2016.6, 2017.1–2017.6, and 2018.1–2018.3.
• Kaspersky Security Center Administration Server 10 Service Pack 2 Maintenance Release 1 and later, Kaspersky Endpoint Security Cloud, or Kaspersky Security for Microsoft Office 365.

Software requirements for Kaspersky Security Integration Tool for MSP:

• Microsoft Windows 7 and later.
• Microsoft .NET Framework 4.5.2.
• Kaspersky Security Center Administration Server 10 Service Pack 2 Maintenance Release 1 and later, or Kaspersky Security Center Administration Console 10 Service Pack 2 Maintenance Release 1 and later—for an on-premises solution only.

Software requirements for Kaspersky Security Integration Service for MSP:

• Supported operating systems are the same as those supported by Kaspersky Security Center 10 Service Pack 2 Maintenance Release 1 and later. Refer to Kaspersky Security Center documentation for details.
• Administration Server component of Kaspersky Security Center 10 Service Pack 2 Maintenance Release 1 and later.
• Microsoft .NET Framework 4.5.2.

Page top

[Topic 153146]

Deployment schemas of Kaspersky Security Integration with ConnectWise Manage

This section describes the deployment schemas of Kaspersky Security Integration with ConnectWise Manage. The schemas include the two components of Kaspersky Security Integration with ConnectWise Manage:

• Kaspersky Security Integration Tool for MSP—Used to configure connection between the Kaspersky Lab solution you use and Autotask and to configure mapping between the Kaspersky Lab solution entities and Autotask entities.
• Kaspersky Security Integration Service for MSP—Synchronizes data in Kaspersky Security Center and Autotask. It is a service application only, with no user interface.

The deployment schema that suits your integration depends on the Kaspersky Lab solution you use and on your integration model. There are three deployment schemas:

• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center.
• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center with slave Administration Servers.
• For a cloud-based version of a Kaspersky Lab solution—Kaspersky Business Hub.

This section describes the deployment schemas in detail.

[Topic 153145]

Deployment schema for on-premises solution

Deploy Kaspersky Security Integration with ConnectWise Manage based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you do not have slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Integration with ConnectWise Manage are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution

The following list describes deployment prerequisites and data flow:

• Kaspersky Security Integration Service for MSP must be installed on the computer on which Kaspersky Security Center Administration Server is installed.
• Kaspersky Security Integration Tool for MSP must be installed on the computer on which either Administration Console or Administration Server is installed and deployed.
• In Kaspersky Security Center, virtual servers must be created for each of the ConnectWise Manage companies. These virtual servers are then mapped to the companies, allowing you to integrate Kaspersky Security Center and ConnectWise Manage.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with ConnectWise Manage for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Security Center are received by Kaspersky Security Integration Service for MSP and tickets are created based on them.

Page top

[Topic 153143]

Deployment schema for on-premises solution and slave servers

Deploy Kaspersky Security Integration with ConnectWise Manage based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you use slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Integration with ConnectWise Manage are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution and slave servers

The following list describes deployment prerequisites and data flow:

• One or more Administration Servers are used in the client's infrastructure. These Administration Servers are slave Administration Servers relative to the Administration Server that is installed in the MSP infrastructure. The Administration Server installed in the MSP infrastructure is the master Administration Server. You can use this type of deployment to decrease load on your master Administration Server.
• Kaspersky Security Integration Service for MSP must be installed on the computer on which the slave Administration Server is installed in the client's infrastructure.
• Kaspersky Security Integration Tool for MSP must be installed on the computer on which either Administration Console or the master Administration Server is installed and deployed.
• In your slave Administration Server, virtual servers must be created for each of the managed accounts. These virtual servers are then mapped to ConnectWise Manage companies, allowing you to integrate Kaspersky Security Center and ConnectWise Manage.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with ConnectWise Manage for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Security Center are received by Kaspersky Security Integration Service for MSP and tickets are created based on them.

Page top

[Topic 153142]

Deployment schema for cloud-based solution

Deploy Kaspersky Security Integration with ConnectWise Manage based on this schema if you use the cloud-based version of a Kaspersky Lab solution—Kaspersky Business Hub.

The components of Kaspersky Security Integration with ConnectWise Manage are shown as orange rectangles in the following figure.

Deployment schema for cloud-based solution

The following list describes deployment prerequisites and data flow:

• In this deployment schema, only Kaspersky Security Integration Tool for MSP is used. Kaspersky Security Integration Service for MSP is not used.
• Kaspersky Security Integration Tool for MSP must be installed in your infrastructure, and not in the client infrastructure.
• In your Kaspersky Business Hub solution, companies must be created for each of the ConnectWise Manage companies. These companies are then mapped to the companies, allowing you to integrate Kaspersky Business Hub and ConnectWise Manage.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with ConnectWise Manage for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Business Hub are received and tickets are created based on them.

Page top

[Topic 153171]

Integration scenario

This section describes the overall sequence of actions that you perform to integrate your Kaspersky Lab solution (Kaspersky Security Center or Kaspersky Business Hub) with ConnectWise Manage by means of Kaspersky Security Integration with ConnectWise Manage.

1. Installing Kaspersky Security Integration with ConnectWise Manage.

   Download Kaspersky Security Integration with ConnectWise Manage from the Kaspersky Lab web site and install it by using a standard Windows installation procedure.

2. Preparing information for setting up integration.

   Check the connection settings and additional prerequisites to successfully integrate your Kaspersky Lab solution with ConnectWise Manage. You will have to provide these parameters in the next steps of this scenario.

3. Connecting Kaspersky Security Integration with ConnectWise Manage to your Kaspersky Lab solution.

   Provide the parameters to connect Kaspersky Security Integration with ConnectWise Manage to your Kaspersky Lab solution:

   • For Kaspersky Security Center, provide user credentials and server parameters.
   • For Kaspersky Business Hub, provide the account credentials.
4. Creating integration with ConnectWise Manage.

   Provide the parameters for the new integration with ConnectWise Manage that is created during initial configuration. The integration parameters are the same for Kaspersky Security Center and for Kaspersky Business Hub.

5. Adding virtual servers or companies to your integration.

   Select virtual servers or companies to be integrated with ConnectWise Manage:

   • For Kaspersky Security Center, select virtual servers to be mapped to ConnectWise Manage companies.
   • For Kaspersky Business Hub, select companies to be mapped to ConnectWise Manage companies.
6. Checking integration.

   After you perform step 1 through step 5, Kaspersky Security Integration with ConnectWise Manage will be installed and set up. To verify the installation, open the Companies tab and make sure that your virtual servers / companies are displayed in the first column and that your ConnectWise Manage companies are available for selection in the second column.

   

   Kaspersky Security Integration Tool for MSP main window

[Topic 138216]

Installing and removing Kaspersky Security Integration with ConnectWise Manage

Kaspersky Security Integration with ConnectWise Manage is delivered as a distribution package that contains two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

This section contains step-by-step instructions for installing and removing Kaspersky Security Integration with ConnectWise Manage.

[Topic 138164]

Installing Kaspersky Security Integration with ConnectWise Manage

After you download the distribution package for Kaspersky Security Integration with ConnectWise Manage, install the components of Kaspersky Security Integration with ConnectWise Manage by using a standard Windows installation procedure.

Kaspersky Security Integration Service must be installed if you use Kaspersky Security Center. If you use Kaspersky Business Hub, you do not have to install Kaspersky Security Integration Service.

Install Kaspersky Security Integration Service for MSP on the computer on which Kaspersky Security Center Administration Server is installed. Install Kaspersky Security Integration Tool for MSP on the computer on which either Administration Console or Administration Server is installed and deployed.

Install both components of Kaspersky Security Integration with ConnectWise Manage—Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP—in the same manner. The steps below describe the installation process for each component.

Before you install the components of Kaspersky Security Integration with ConnectWise Manage, it is strongly recommended to check their digital signatures to make sure that they are issued by Kaspersky Lab.

To check the digital signature for a component of Kaspersky Security Integration with ConnectWise Manage:

1. Locate the installation application (msp_setup.exe file) for the Kaspersky Security Integration with ConnectWise Manage component.
2. Right-click the installation application and select Properties.
3. In the properties window that opens, click the Digital Signatures tab and check that the installation application has Kaspersky Lab signatures.
4. Close the properties window.

After you check the digital signatures of the Kaspersky Security Integration with ConnectWise Manage components, install each of the components.

You can install Kaspersky Security Integration with ConnectWise Manage either in interactive mode or in silent mode.

Installation in interactive mode

To install a component of Kaspersky Security Integration with ConnectWise Manage in interactive mode:

1. On the machine where you want to install Kaspersky Security Integration with ConnectWise Manage, double-click the installation application (msp_setup.exe file) for the component.
2. Follow the wizard steps to install the component.
   • Accept the terms of the license agreement to continue installation.
   • When installing Kaspersky Security Integration Tool for MSP, accept the terms of the privacy policy to continue installation.
   • If required, change the installation folder for the component. The folder you select must have about 25 MB of free space to install both components of Kaspersky Security Integration with ConnectWise Manage.
3. Click Finish on the last page of the wizard.

Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP are installed. Kaspersky Security Integration Tool for MSP is added to the Start menu.

Installation in silent mode

To install Kaspersky Security Integration Tool for MSP in silent mode:

1. Read the license agreement and the privacy policy stored in license.txt file next to the installation application (msp_setup.exe file). Proceed only if you accept the terms of the license agreement and the privacy policy.
2. At the command prompt, type

   msp_setup.exe /s /v"EULA=1 PRIVACYPOLICY=1 INSTALLDIR=\"<installation path>\""

   Here,

   • EULA=1 means that you accept the terms of the license agreement.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Tool for MSP will not be installed.

   • PRIVACYPOLICY=1 means that you accept the terms of the privacy policy.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Tool for MSP will not be installed.

   • INSTALLDIR=\"<installation path>\" is the path to the Kaspersky Security Integration Tool for MSP installation folder.

     If you do not specify this parameter, Kaspersky Security Integration Tool for MSP will be installed to %PROGRAMFILES%\Kaspersky Lab\Kaspersky Security Integration Tool for MSP (in 32-bit versions of Windows) or %PROGRAMFILES(x86)%\Kaspersky Lab\Kaspersky Security Integration Tool for MSP (in 64-bit versions of Windows).

Kaspersky Security Integration Tool for MSP is installed and is added to the Start menu.

To install Kaspersky Security Integration Service for MSP in silent mode:

1. Read the license agreement stored in license.txt file next to the installation application (msp_setup.exe file). Proceed only if you accept the terms of the license agreement.
2. At the command prompt, type

   msp_setup.exe /s /v"EULA=1 INSTALLDIR=\"<installation path>\""

   Here,

   • EULA=1 means that you accept the terms of the license agreement.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Service for MSP will not be installed.

   • INSTALLDIR=\"<installation path>\" is the path to the Kaspersky Security Integration Service for MSP installation folder.

     If you do not specify this parameter, Kaspersky Security Integration Service for MSP will be installed to %PROGRAMFILES%\Kaspersky Lab\Kaspersky Security Integration Service for MSP (in 32-bit versions of Windows) or to %PROGRAMFILES(x86)%\Kaspersky Lab\Kaspersky Security Integration Service for MSP (in 64-bit versions of Windows).

Kaspersky Security Integration Service for MSP is installed.

Known issue

Kaspersky Security Integration Service for MSP cannot connect to ConnectWise Manage if Kaspersky Security Center and Kaspersky Security Integration Service for MSP are deployed in the client's network instead of the managed service provider's network, and there is an authentication proxy server between Kaspersky Security Integration Service for MSP and ConnectWise Manage.

To enable Kaspersky Security Integration Service for MSP to connect to ConnectWise Manage over the Internet through the proxy with authentication:

1. Launch the Services Microsoft Management Console snap-in by selecting Start → Control panel → Administrative Tools → Services.
2. Right-click Kaspersky Security Integration Service for MSP and select Properties.
3. In the service properties window that opens, click the Log On tab and specify the following settings:
   • In the Log on as section, select the This account option.
   • Specify the account credentials for connection to the Internet by Kaspersky Security Integration Service for MSP.
4. Click OK in the service properties window to save your changes.

Page top

[Topic 138165]

Removing Kaspersky Security Integration with ConnectWise Manage

You can remove the components of Kaspersky Security Integration with ConnectWise Manage by using a standard Windows installation / uninstallation procedure.

To remove a component of Kaspersky Security Integration with ConnectWise Manage:

1. On the Start menu, select Control Panel and then click Programs and Features.
2. In the list of installed programs, select Kaspersky Security Integration Tool for MSP or Kaspersky Security Integration Service for MSP.
3. Right-click the selected application and select Uninstall.

The selected application is removed. Repeat these steps for the other component of Kaspersky Security Integration with ConnectWise Manage.

As an alternative, you can remove the components of Kaspersky Security Integration with ConnectWise Manage in silent mode.

To remove Kaspersky Security Integration Tool for MSP in silent mode:

Run Command Prompt as an administrator and type

msiexec.exe /x {E58E13CA-6745-4C60-BE0B-FE6DD416FCB0} REBOOT=ReallySuppress /qn /l*v %temp%\msp_service_uninstall_log.txt

To remove Kaspersky Security Integration Service for MSP in silent mode:

Run Command Prompt as an administrator and type

msiexec.exe /x {7EF14DEE-606A-4147-94FD-3FB0E1FA9D69} REBOOT=ReallySuppress /qn /l*v %temp%\msp_tool_uninstall_log.txt

Removing user.config file

When you uninstall Kaspersky Security Integration Tool for MSP, the user.config files are not removed. These files are automatically created for every user who has ever connected to a Kaspersky Lab solution (either on-premises or Cloud) using Kaspersky Security Integration Tool for MSP. The user.config files contain encrypted information about the user's connection settings for Kaspersky Security Center or Kaspersky Business Hub.

If necessary, you can manually remove the user.config file for every user. The user.config file is stored in the AppData folder of a user.

For example, for Windows 7 and Administrator user, the path to the user.config files is as follows: C:\Users\Administrator\AppData\Local\AO_Kaspersky_Lab\IntegrationUI.exe_Url_nrmo2y4axdcnfumknnua4kzhxvafmxmb\1.0.0.0\user.config.

Page top

[Topic 149498]

Updating Kaspersky Security Integration with ConnectWise Manage

It is recommended to update Kaspersky Security Integration with ConnectWise Manage to the latest version.

To successfully migrate Kaspersky Security Integration with ConnectWise Manage:

1. Update Kaspersky Security Integration with ConnectWise Manage.
2. Check the settings. If you are not satisfied with the results of their migration, re-configure the integration.

Updating Kaspersky Security Integration with ConnectWise Manage

The sequence of actions required to update Kaspersky Security Integration with ConnectWise Manage depends on the Kaspersky Lab solution that you use.

• If you use Kaspersky Security Center, update both components of Kaspersky Security Integration with ConnectWise Manage (Kaspersky Security Integration Service for MSP and all instances of Kaspersky Security Integration Tool for MSP) to the latest version before you start using the new version of Kaspersky Security Integration with ConnectWise Manage. If you use several instances of Kaspersky Security Integration Tool for MSP when working with a single Kaspersky Security Integration Service for MSP, make sure that all these instances are updated.

  If one or more components of Kaspersky Security Integration with ConnectWise Manage is not updated (either Kaspersky Security Integration Service for MSP or one of the Kaspersky Security Integration Tool for MSP instances), Kaspersky Security Integration with ConnectWise Manage will not operate properly.

• If you use Kaspersky Business Hub, update all instances of Kaspersky Security Integration Tool for MSP to the latest version.

Reconfiguring ticketing

Ticketing in Kaspersky Security Integration with ConnectWise Manage version Maintenance Release 2 and later differs significantly from ticketing in version Maintenance Release 1 and earlier. When you update Kaspersky Security Integration with ConnectWise Manage to Maintenance Release 2 or later, it is recommended to reconfigure ticketing in Kaspersky Security Integration Tool for MSP. For information about how to configure ticketing, refer to Setting up ticketing.

All other settings that you configured in a previous version of Kaspersky Security Integration Tool for MSP, such as integration parameters, companies, and product mappings, remain the same when you migrate Kaspersky Security Integration with ConnectWise Manage to the latest version.

[Topic 152851]

Interface of Kaspersky Security Integration with ConnectWise Manage

Kaspersky Security Integration with ConnectWise Manage consists of two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

• Kaspersky Security Integration Tool for MSP provides a graphical user interface to configure integration.
• Kaspersky Security Integration Service for MSP is a service application for Microsoft Windows that synchronizes data in Kaspersky Security Center and ConnectWise Manage. It does not have a user interface.

Kaspersky Security Integration Tool for MSP consists of one window with several nested tabs. Depending on the type of Kaspersky Lab solution that you use—on-premises or cloud-based—Kaspersky Security Integration Tool for MSP may have three or four nested tabs. On these tabs, you can configure mapping between the Kaspersky Lab solution entities, such as virtual servers / companies and security applications, and ConnectWise Manage entities, such as companies and products. You can also configure ticketing, and if you use the cloud-based version of the solution you can manage administrators who can configure the integration.

Kaspersky Security Integration Tool for MSP main window

The Kaspersky Security Integration Tool for MSP window has the following tabs:

• Companies—Use this tab to set up and modify mapping between managed companies in ConnectWise Manage and virtual servers or companies in your Kaspersky Lab solution, and to add or remove virtual servers or companies to your integration. On the Companies tab, you can also enable automatic billing for your managed companies.
• Ticketing—Use this tab to set up ticketing rules for enabling automatic creation and assignment of tickets in ConnectWise Manage. You can configure creation and assignment of tickets depending on the event severity and type, or when a computer status changes in Kaspersky Lab security applications.

  Ticketing is one of the most important features of your integration. If you do not configure ticketing, ConnectWise Manage cannot generate tickets on the basis of events and computer status changes and cannot process corresponding issues.

• Products—Use this tab to set up mapping between ConnectWise Manage products and Kaspersky Lab security applications so that usage information about Kaspersky Lab security applications appears in ConnectWise Manage as Agreement Additions. You can modify the existing mapping of products and security applications as well.
• Administrators—This tab is available for cloud-based solutions only. Use this tab to manage the administrators related to the integration with Kaspersky Business Hub. You can add existing Kaspersky Business Hub administrators to your integration or remove administrators from the integration if you do not want them to configure the integration.

Page top

[Topic 138163]

Getting started

After you install Kaspersky Security Integration with ConnectWise Manage, you establish a connection between it and ConnectWise Manage. The connection enables you to configure integration using Kaspersky Security Integration Tool for MSP and enables Kaspersky Security Integration Service for MSP to send Service Tickets and license usage information to ConnectWise Manage. To establish connection, create a new integration using Kaspersky Security Integration Tool for MSP.

The integration process varies depending on which Kaspersky Lab solution you use. This section describes how to configure integration with Kaspersky Security Center and with Kaspersky Business Hub.

[Topic 153170]

Prerequisites

When configuring integration, you must specify the parameters of the Kaspersky Lab solution you integrate with (Kaspersky Security Center or Kaspersky Business Hub) and ConnectWise Manage connection parameters. It is recommended that you check these parameters in advance in order to prepare for setting up integration.

Kaspersky Security Center parameters

Check the following parameters:

• Address of the computer on which Kaspersky Security Center Administration Server is installed.
• Credentials: user name and password for the computer on which Administration Server is installed.
• If you establish connection to the Administration Server through a proxy server, check the proxy server parameters: network address or domain name and credentials for the proxy server.

Kaspersky Business Hub parameters

Check the credentials of your Kaspersky Business Hub account: email address and password.

ConnectWise Manage parameters

Check the following parameters:

• Web address of the site that hosts the ConnectWise Manage Server.
• Name of your company in ConnectWise Manage, that is, the company name you use to log in to ConnectWise Manage.
• Public and private keys generated by ConnectWise Manage. Note that the private key is available only at the time the key is created.

  For details on how to generate the keys, see Setting up public and private keys in ConnectWise Manage.

Additional prerequisites

During the integration process, it is required to add virtual servers or companies to your integration. These virtual servers or companies are then mapped to ConnectWise Manage companies.

For each client company in ConnectWise Manage, create and assign a separate Kaspersky Security Center virtual server / Kaspersky Business Hub company prior to integration.

One-to-one mapping is supported, and therefore the number of virtual servers or companies must not exceed the number of your managed companies.

[Topic 138687]

Setting up public and private keys in ConnectWise Manage

To create integration between ConnectWise Manage and Kaspersky Security Integration with ConnectWise Manage, you have to provide API keys. API keys are public and private keys that are generated by ConnectWise Manage for an integration account.

To create API keys in ConnectWise Manage:

1. In ConnectWise Manage, click System → Members and either select an existing member or create a new one.

   Make sure that the member you selected has all the rights necessary to set up the integration.

2. On the Member Maintenance screen, click the API Keys tab and then click the New Item button.
3. In the Description field, type the description for the newly created keys (for example, Kaspersky Integration).
4. Click the Save button to save the new item.

The two API keys are generated and displayed in the Public Key and Private Key fields.

The private key is displayed only at the time it is created.

Make a note of both keys or copy them to the Clipboard because there is no way to recover the private key after the API Keys tab is closed.

You will have to specify these keys when you configure integration with ConnectWise Manage.

[Topic 141379]

Integrating with Kaspersky Security Center

This section describes how to create and configure integration between ConnectWise Manage and Kaspersky Security Center by using Kaspersky Security Integration Tool for MSP.

To successfully create integration, connect to Kaspersky Security Center Administration Server and perform the steps described in the following sections.

[Topic 138232]

Connecting to Kaspersky Security Center Administration Server

When you start Kaspersky Security Integration Tool for MSP, the connection settings window opens. In this window, specify the settings to connect to Kaspersky Security Center Administration Server.

Connecting to Kaspersky Security Center Administration Server

To connect to Kaspersky Security Center Administration Server:

1. In the Start menu, select Kaspersky Security Integration Tool for MSP.
2. In the window that opens, select the Kaspersky Endpoint Security for Business solution to connect to Kaspersky Security Center Administration Server.
3. You can connect to Kaspersky Security Center Administration Server in one of the following ways:
   • By providing the connection parameters for the computer on which the Administration Server is installed.

     If you selected this method of connection, specify the following connection settings. None of the fields can be blank.

     • Address—Address of the computer on which the Administration Server is installed. You can specify this value as an IP address or as a domain name of the computer.
     • User name—User name to connect to the computer on which the Administration Server is installed, that is, to the computer whose address you specified in the Address field.
     • Password—Password to connect to the computer, on which the Administration Server is installed, that is, to the computer whose address you specified in the Address field.
   • By selecting the Administration Server certificate.

     In this case, you do not have to provide the connection parameters for the computer on which the Administration Server is installed. Kaspersky Security Integration Tool for MSP uses the certificate of Kaspersky Security Center Administration Server to connect to this Administration Server. Usage of the certificate guarantees that Kaspersky Security Integration Tool for MSP connects to the Administration Server from which the certificate was downloaded.

     The Administration Server certificate is created automatically during installation of the Administration Server and is stored in the %ProgramData%\Application Data\KasperskyLab\adminkit\1093\cert folder on the computer that has Administration Server installed. Before starting to use the Administration Server certificate for authentication, copy the certificate file, klserver.cer, to the computer on which Kaspersky Security Integration Tool for MSP is installed.

To use Administration Server certificate:

1. Click the Select Kaspersky Security Center Administration Server certificate link.
2. In the window that opens, select the Use a certificate check box, click Browse, and then navigate to the certificate file.
3. Click OK to start using the selected certificate for connection.
4. If you want to establish the connection to the Administration Server through a proxy server, select the Use proxy server check box. By default, this check box is cleared.

   If you selected the Use proxy server check box, provide the following proxy-server settings:

   • Address—Network address of the proxy server. Provide the address as a full domain name of the proxy server.
   • User name—User name to connect to the proxy server.
   • Password—Password to connect to the proxy server.
5. Click the Proceed button to connect to the Administration Server using the specified settings.

The system validates the provided settings and connects to the Administration Server.

[Topic 138233]

Creating a Kaspersky Security Center integration with ConnectWise Manage

After you connect to the Administration Server, the integration settings window opens, where you can create an integration between ConnectWise Manage and Kaspersky Security Center by means of Kaspersky Security Integration Tool for MSP.

Creation of an integration between ConnectWise Manage and Kaspersky Security Center is required only when you launch Kaspersky Security Integration Tool for MSP for the first time.

Specifying ConnectWise Manage integration settings

To create integration with ConnectWise Manage:

1. In the integration settings window that opens after you connect to the Administration Server, specify the following settings for the newly created integration:
   • Select platform—Select the integration platform from the drop-down list. The list contains the names of all the platforms that Kaspersky Security Center can be integrated with. For integration with ConnectWise Manage, select ConnectWise Manage.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with ConnectWise Manage. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • Site—Web address of the site that hosts the ConnectWise Manage Server. This field cannot be blank.

     When you set up integration with ConnectWise Manage Cloud, specify the web address of the site that hosts the ConnectWise Manage Server with the ‘api-' prefix. Use one of the following sites based on your location:

     • North American Cloud: api-na.myconnectwise.net
     • European Cloud: api-eu.myconnectwise.net
     • South African Cloud: api-za.myconnectwise.net
     • Australian Cloud: api-au.myconnectwise.net
   • Company—Name of your company in ConnectWise Manage. It is the company name you use to log in to ConnectWise Manage. This field cannot be blank.
   • Public key—Public key generated by ConnectWise Manage. This field cannot be blank.
   • Private key—Private key generated by ConnectWise Manage. This field cannot be blank. The private key is available only at the time the key is created.

     ConnectWise Manage generates both public and private keys. For details on how to generate the keys, see section Setting up public and private keys in ConnectWise Manage.

2. Click the Proceed button when you have finished specifying the integration settings.

   The system validates the ConnectWise Manage integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with ConnectWise Manage to gain access to ConnectWise Manage.

Kaspersky Security Center is now integrated with ConnectWise Manage.

Page top

[Topic 138753]

Adding virtual servers to the integration

After an integration with ConnectWise Manage is created, a window opens where you can add Kaspersky Security Center virtual servers to the integration. Kaspersky Security Center virtual servers are then mapped to the ConnectWise Manage companies.

Adding virtual servers to the integration

To add Kaspersky Security Center virtual servers to the integration:

1. In the window, which lists Kaspersky Security Center virtual servers, select the check boxes next to the existing virtual servers to add them to the integration.

   If you want to add all virtual servers to the integration, select the Select all check box.

2. Click Proceed.

You will now be able to map these virtual servers to ConnectWise Manage companies.

Each virtual server can be added to one integration only. That is, if a virtual server is added to an integration, it is not displayed in a list of virtual servers available for another integration.

Page top

[Topic 141380]

Integrating with Kaspersky Business Hub

This section describes how to create and configure integration between ConnectWise Manage and Kaspersky Business Hub by means of Kaspersky Security Integration Tool for MSP.

To successfully create integration, connect to Kaspersky Business Hub and perform the steps described in the following sections.

[Topic 141384]

Connecting to Kaspersky Business Hub

When you start Kaspersky Security Integration Tool for MSP, the connection settings window opens. In this window, specify the settings to connect to Kaspersky Business Hub.

Connecting to Kaspersky Business Hub

To connect to Kaspersky Business Hub:

1. In the Start menu, select Kaspersky Security Integration Tool for MSP.
2. In the window that opens, select the Kaspersky Business Hub solution.
3. Specify the following connection settings:
   • User name—Email address that you use to connect to Kaspersky Business Hub. This field cannot be blank.
   • Password—Password that you use to connect to Kaspersky Business Hub. This field cannot be blank.
4. Click the Proceed button to connect to Kaspersky Business Hub by using the specified settings.

The system validates the provided settings and establishes connection to Kaspersky Business Hub.

[Topic 141387]

Creating a Kaspersky Business Hub integration with ConnectWise Manage

After you connect to the Kaspersky Business Hub, the integration settings window opens, where you can create an integration between ConnectWise Manage and Kaspersky Business Hub by means of Kaspersky Security Integration Tool for MSP.

Creation of an integration between ConnectWise Manage and Kaspersky Business Hub is required only when you launch Kaspersky Security Integration Tool for MSP for the first time.

Specifying ConnectWise Manage integration settings

To create integration with ConnectWise Manage:

1. In the integration settings window that opens after you connect to Kaspersky Business Hub, specify the following settings for the newly created integration:
   • Select platform—Select the integration platform from the drop-down list. The list contains the names of all platforms that Kaspersky Business Hub can be integrated with. For integration with ConnectWise Manage, select ConnectWise Manage.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with ConnectWise Manage. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • Site—Web address of the site that hosts the ConnectWise Manage Server. This field cannot be blank.

     When you set up integration with ConnectWise Manage Cloud, specify the web address of the site that hosts the ConnectWise Manage Server with the ‘api-' prefix. Use one of the following sites based on your location:

     • North American Cloud: api-na.myconnectwise.net
     • European Cloud: api-eu.myconnectwise.net
     • South African Cloud: api-za.myconnectwise.net
     • Australian Cloud: api-au.myconnectwise.net
   • Company—Name of your company in ConnectWise Manage. It is the company name you use to log in to ConnectWise Manage. This field cannot be blank.
   • Public key—Public key generated by ConnectWise Manage. This field cannot be blank.
   • Private key—Private key generated by ConnectWise Manage. This field cannot be blank. The private key is available only at the time the key is created.

     ConnectWise Manage generates both public and private keys. For details on how to generate the keys, see section Setting up public and private keys in ConnectWise Manage.

2. Click the Proceed button when you have finished specifying the integration settings.

   The system validates the ConnectWise Manage integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with ConnectWise Manage to gain access to ConnectWise Manage.

Kaspersky Business Hub is now integrated with ConnectWise Manage.

Page top

[Topic 141386]

Adding Kaspersky Business Hub companies to the integration

After an integration with ConnectWise Manage is created, a window opens where you can add Kaspersky Business Hub companies to the integration. Kaspersky Business Hub companies are then mapped to the ConnectWise Manage companies.

You cannot add separate Kaspersky Endpoint Security Cloud workspaces or Kaspersky Security for Microsoft Office 365 workspaces to the integration. You can add only entire Kaspersky Business Hub companies. All workspaces created for a company in Kaspersky Business Hub are added to the integration.

Adding companies to the integration

To add Kaspersky Business Hub companies to the integration:

1. In the window, which lists Kaspersky Business Hub companies, select the check boxes next to the existing companies to add them to the integration. Icons next to the name of each company show which workspaces are created for this company in Kaspersky Business Hub.

   If you want to add all companies to the integration, select the Select all check box.

2. Click Proceed.

You will now be able to map these companies to ConnectWise Manage companies.

Each Kaspersky Business Hub company can be added to one integration only. That is, if a company is added to an integration, it is not displayed in a list of companies available for another integration.

Page top

[Topic 150900]

Supplementary parameter

The parameter that indicates the type of Kaspersky Business Hub server to which Kaspersky Security Integration Tool for MSP connects may be included in the .config file (IntegrationUI.exe.config) of Kaspersky Security Integration Tool for MSP.

The parameter name is KESCloudServer; and its possible values are:

• production—Kaspersky Security Integration Tool for MSP works with the Production server.
• beta—Kaspersky Security Integration Tool for MSP works with the Beta server.
• test—Kaspersky Security Integration Tool for MSP works with the Test server.

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

The IntegrationUI.exe.config file is stored in the installation folder of Kaspersky Security Integration Tool for MSP. The default path is C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP\IntegrationUI.exe.config.

By default, the KESCloudServer parameter is not displayed in the .config file of Kaspersky Security Integration Tool for MSP.

The KESCloudServer parameter can be specified as follows:

Page top

[Topic 138693]

Managing integrations

This section describes how to edit or delete an existing integration and how to create a new integration. For example, you may have to edit, delete, or create an integration when you change the vendor of your Professional Services Automation system.

[Topic 138699]

Creating a new integration

You can create a new integration in the Kaspersky Security Integration Tool for MSP window.

Creating a new integration

To create a new integration with ConnectWise Manage:

1. At the top of the Kaspersky Security Integration Tool for MSP window, click the name of the current integration.
2. In the Integration Settings window that opens, click the New integration button.

   A new Integration Settings window opens. The fields for the connection settings are blank.

3. Specify the values for the following settings of the integration:
   • Platform—Select the integration platform from the drop-down list. The list contains the names of all platforms that Kaspersky Security Center or Kaspersky Business Hub can be integrated with. For integration with ConnectWise Manage, select ConnectWise Manage.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with ConnectWise Manage. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • Site—Web address of the site that hosts the ConnectWise Manage Server. This field cannot be blank.

     When you set up integration with ConnectWise Manage Cloud, specify the web address of the site that hosts the ConnectWise Manage Server with the ‘api-' prefix. Use one of the following sites based on your location:

     • North American Cloud: api-na.myconnectwise.net
     • European Cloud: api-eu.myconnectwise.net
     • South African Cloud: api-za.myconnectwise.net
     • Australian Cloud: api-au.myconnectwise.net
   • Company—Name of your company in ConnectWise Manage. It is the company name you use to log in to ConnectWise Manage. This field cannot be blank.
   • Public key—Public key generated by ConnectWise Manage. This field cannot be blank.
   • Private key—Private key generated by ConnectWise Manage. This field cannot be blank. The private key is available only at the time the key is created.

     ConnectWise Manage generates both public and private keys. For details on how to generate the keys, see section Setting up public and private keys in ConnectWise Manage.

4. Click OK when you have finished specifying the integration settings.

   The system validates the ConnectWise Manage integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with ConnectWise Manage to gain access to ConnectWise Manage.

A new integration with ConnectWise Manage is created.

[Topic 138700]

Editing and viewing an existing integration

You can view and edit settings of an existing integration in the Kaspersky Security Integration Tool for MSP window.

Editing an integration

To view and edit integration with ConnectWise Manage:

1. At the top of the window, click the name of the integration whose settings you want to view or modify.
2. In the Integration Settings window that opens, in the Select integration drop-down list select the required integration.
3. Modify the following settings of the selected integration:
   • Integration name—Name of the selected integration. By default, the integration name is Integration with ConnectWise Manage. You can edit this field, however, it cannot be blank.

     For an integration with Kaspersky Business Hub, 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.

   • Public key—Public key generated by ConnectWise Manage. This field cannot be blank.
   • Private key—Private key generated by ConnectWise Manage. This field cannot be blank. The private key is available only at the time the key is created.

     ConnectWise Manage generates both public and private keys. For details on how to generate the keys, see section Setting up public and private keys in ConnectWise Manage.

     The Site and Company settings cannot be modified. If you have to change these settings, create a new integration.

4. Click OK when you have finished editing the integration settings.

   The system validates the ConnectWise Manage integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with ConnectWise Manage to gain access to ConnectWise Manage.

The integration with ConnectWise Manage is modified and saved.

[Topic 138698]

Deleting an existing integration

You can delete an existing integration in the Kaspersky Security Integration Tool for MSP window.

When you delete an integration, all virtual servers or companies that were linked to the integration are unbound from the integration but continue to exist in Kaspersky Security Center or Kaspersky Business Hub. All administrators of the deleted integration receive notifications that the integration was deleted, but they can continue to administer Kaspersky Business Hub companies that were linked to this integration.

All Kaspersky Security Center virtual servers or Kaspersky Business Hub companies that are unbound from the deleted integration can be added to other integrations.

To delete integration with ConnectWise Manage:

1. At the top of the Kaspersky Security Integration Tool for MSP window, click the name of the integration that you want to delete.
2. In the integration window that opens, click Delete to delete the integration.
3. Click Yes to confirm deletion.

The integration settings are cleared, indicating that the integration is deleted.

Page top

[Topic 138257]

Configuring integration in Kaspersky Security Integration with ConnectWise Manage

The purpose of Kaspersky Security Integration Tool for MSP is to configure integration between ConnectWise Manage and the Kaspersky Lab solution you use: Kaspersky Security Center or Kaspersky Business Hub.

Using Kaspersky Security Integration Tool for MSP, you can do the following:

• Map ConnectWise Manage companies to Kaspersky Security Center virtual servers or Kaspersky Business Hub companies.
• Configure ticketing in ConnectWise Manage.
• Map Kaspersky Lab security applications to existing ConnectWise Manage products.
• Configure automated billing.

[Topic 138285]

Mapping companies and enabling automatic billing

Use the Companies tab in the Kaspersky Security Integration Tool for MSP window to set up and modify mapping between managed companies in ConnectWise Manage and virtual servers or companies in your Kaspersky Lab solution. To set up mapping, companies must be created in ConnectWise Manage, while virtual servers must be added to Kaspersky Security Center Administration Server or companies must be created in Kaspersky Business Hub.

On the Companies tab, you can also enable automatic billing for your managed companies. This means that information about the number of license units for Kaspersky Lab security applications provided during the current billing period can be updated regularly and automatically in ConnectWise Manage. Timely updating lets you prepare customer invoices more quickly and easily.

When you click the Companies tab, a list is displayed, showing virtual servers or companies and their corresponding ConnectWise Manage companies. You can add existing virtual servers or companies to the integration and map ConnectWise Manage companies to them. You can also delete mapping between a virtual server or company and its corresponding ConnectWise Manage company. In this case, neither the virtual server / company nor the ConnectWise Manage company is deleted; instead, the link between them is broken.

Mapping companies and enabling automatic billing

The following sections explain how to add or remove virtual servers or companies to / from the integration and how to configure automatic billing.

[Topic 141401]

Adding and removing virtual servers or companies

You can add existing virtual servers or companies to the integration or remove them from the integration.

To add or remove virtual servers or companies to / from the integration:

1. In the Kaspersky Security Integration Tool for MSP window, click the Companies tab.
2. Click the Add / remove virtual servers link if you use Kaspersky Security Center, or the Add / remove companies link if you use Kaspersky Business Hub, and then do one of the following:
   • Select check boxes next to existing virtual servers or companies to add them to the integration. Then you can match these virtual servers or companies to ConnectWise Manage companies.
   • Clear check boxes next to virtual servers or companies to remove them from the integration. This action does not remove the virtual servers from Kaspersky Security Center or companies from Kaspersky Business Hub; it only deletes the mapping between the virtual servers or companies and the ConnectWise Manage companies.
3. Click OK.

Each virtual server or company can be added to one integration only. That is, if a virtual server or a company is added to an integration, it is not displayed in a list of virtual servers or companies available for another integration.

Page top

[Topic 141402]

Setting up automatic billing

You can map virtual servers or companies to ConnectWise Manage companies and configure automatic billing for the selected companies.

To set up mapping between virtual servers or companies and ConnectWise Manage companies, and edit billing settings:

1. In the Kaspersky Security Integration Tool for MSP window, click the Companies tab.
2. In the Virtual server column (if you use Kaspersky Security Center) or in the Company column (if you use Kaspersky Business Hub), locate the virtual servers or companies to which to map the ConnectWise Manage company.

   If you have a long list of virtual servers or companies, use the search box located above the table, on the right, to find the required virtual server or company. Type any part of the virtual server or company name in the search box and click the Search button. Only the virtual servers or companies whose names contain the string you entered are displayed.

3. In the ConnectWise Manage company column, click the drop-down arrow and select the ConnectWise Manage company you want to map to the virtual server or company.

   One-to-one mapping is supported. You can map one virtual server or one company to a single ConnectWise Manage company.

4. Turn automatic billing on or off for your company by using the toggle button in the Billing settings column.

   To use automatic billing, you must create mapping between Kaspersky Lab security applications and their ConnectWise Manage equivalents—products. For details, see Mapping ConnectWise Manage products to security applications.

5. Click the Select agreement drop-down arrow in the Billing settings column and select one of the available Agreements associated with the company you selected in the ConnectWise Manage company column.

   An Agreement must exist for the selected company in ConnectWise Manage in order for automatic billing to be set up successfully. Agreements for a company are created and managed in ConnectWise Manage. You can view the Agreements for the selected company in ConnectWise Manage.

   The Agreement Additions for the security applications used by the company will be automatically created in ConnectWise Manage during the daily synchronization.

6. If necessary, repeat steps 2 to 5 for each pair: virtual server-company or company-company.
7. Click the Save changes button to save your mapping.

After the ConnectWise Manage companies are mapped to the virtual servers or companies, Service Tickets and Agreement Additions for the licensed Kaspersky Lab security applications are automatically created for these companies in ConnectWise Manage.

[Topic 160671]

How automatic billing works

You can configure automatic billing to enable Kaspersky Security Integration with ConnectWise Manage to create, and update daily, the ConnectWise Manage Agreement Additions for Kaspersky Lab security applications. When automatic billing is configured, information about usage of Kaspersky Lab security applications on managed computers is transferred to ConnectWise Manage automatically, allowing faster periodic generation of invoices for your customers. For information about enabling and configuring automatic billing, refer to Setting up automatic billing.

Automatic billing works according to the following rules:

• Kaspersky Security Integration Service for MSP runs automated billing daily, so that you have up-to-date usage information in ConnectWise Manage any time you have to generate an invoice for a client.
• Kaspersky Security Integration Service for MSP creates Agreement Additions for Kaspersky Lab security applications only if these security applications are mapped to the ConnectWise Manage products. For details, refer to Mapping ConnectWise Manage products to security applications.
• To get usage information for a particular company, Kaspersky Security Integration Tool for MSP calculates how many of the company's devices use the licenses that are added to the Kaspersky Security Center virtual server / Kaspersky Business Hub company associated with the ConnectWise Manage company. Only unexpired and active commercial keys and subscriptions are counted. Servers and workstations are counted separately if the Bill devices by category option is selected when Kaspersky Lab security applications and ConnectWise Manage products are mapped. Also, Kaspersky Security Integration Service for MSP calculates how many Kaspersky Security for Microsoft Office 365 mailboxes are protected.

To differentiate the pricing policy for two types of devices (servers and workstations), a separate billing feature is available. Kaspersky Security Integration Tool for MSP supports two billing configurations:

• Associates a single licensed Kaspersky Lab security application with a single ConnectWise Manage product.
• Associates a single licensed Kaspersky Lab security application with three different ConnectWise Manage products: one for servers, a second for workstations, and a third for non-Windows devices.

  In this case, ConnectWise Manage analyzes the type of client device (server or workstation) that uses the Kaspersky Lab license. Data about each Kaspersky Lab security application license used by the device is associated with the ConnectWise Manage product mapped to this Kaspersky Lab security application.

  For example, if a client company uses Kaspersky Endpoint Security for Business Advanced on 100 devices, where 90 of them are workstations and 10 are servers, Kaspersky Security Integration Service for MSP does the following:

  • Creates an Agreement Addition on 90 devices for the ConnectWise Manage product for workstations.
  • Creates an Agreement Addition on 10 devices for the ConnectWise Manage product for servers.

[Topic 165836]

Setting up ticketing

This section explains how to set up ticketing for your managed companies.

[Topic 150500]

About setting up ticketing

Tickets allow timely responses to different types of events or to changes in computer status that occur on the company network. Automated ticketing allows you to reduce significantly the time spent monitoring and managing your companies.

You must establish ticketing rules to enable automatic creation and assignment of tickets in ConnectWise Manage. You can set up creation and assignment of tickets depending on the event severity or when a computer status changes to Critical or Warning in Kaspersky Lab security applications.

Ticket creation settings from the previous versions of Kaspersky Security Integration with ConnectWise Manage (Maintenance Release 1 and earlier) are not compatible with versions Maintenance Release 2 and later. After you update Kaspersky Security Integration with ConnectWise Manage to Maintenance Release 2 or later, you have to reconfigure ticketing in Kaspersky Security Integration Tool for MSP.

Tickets created on the basis of computer status changes are automatically closed when the corresponding issue is resolved and the status description that triggered the ticket creation is no longer relevant. For example, when a computer's status becomes Warning because a "Databases are out of date" status description is assigned, a corresponding ticket is created. When the databases are updated, the status description "Databases are out of date" is no longer relevant, and the ticket is automatically closed. However, the computer status might remain Warning because of other status descriptions, for example, "Many viruses detected".

Tickets created on the basis of events Mailboxes protection is not provided and License-related issue occurred that occur in Kaspersky Security for Microsoft Office 365 are also closed when the corresponding issue is resolved.

Tickets created on the basis of all other events that occur in Kaspersky Security for Microsoft Office 365 and tickets created on the basis of events that occur in Kaspersky Security Center or Kaspersky Endpoint Security Cloud are not closed automatically, so you must close these tickets manually.

You can create and modify ticketing rules for your managed companies. Ticketing rules are applicable to all managed companies that are mapped to Kaspersky Security Center virtual servers or Kaspersky Business Hub companies. Ticketing rules are configured individually for events and for computer statuses. When configuring integration between ConnectWise Manage and Kaspersky Business Hub, you must set up ticketing separately for Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.

[Topic 150507]

Ticketing for events

The ticketing settings depend on the Kaspersky Lab solution that you use: Kaspersky Security Center or Kaspersky Business Hub.

[Topic 178030]

Ticketing for events that occur in Kaspersky Security Center

On the Ticketing tab, you can configure ticketing rules for events that occur in Kaspersky Security Center. You can edit ticketing settings either for an individual event or for several events at the same time.

Configuring ticketing for events

To set up ticketing for events:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, select the Events section to configure ticketing for events.
3. Do one of the following:
   • To configure ticketing for one event severity, use the toggle button in the Create ticket column to enable ticket creation for the corresponding event severity. In the Lifetime, Priority, and Service Board columns, edit the settings as required.

     By default, ticketing is disabled for all event severities.

   • To configure ticketing for one or several event severities simultaneously, select the lines that contain required event severities, and then click the Edit button above the table. The Ticketing settings for events window opens.

     Editing ticketing settings for multiple event severities is useful if you want to assign the same settings to these event severities. If you want the ticketing settings to be different, edit them individually for each event severity.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected event severities.
   • Lifetime—Select the period, in days, during which the events are still relevant. The default value is 1 day.

     This value is used to determine whether to create a ticket for an event in ConnectWise Manage. If the connection between ConnectWise Manage and Kaspersky Security Center has been broken and events have not been sent for some time, only events more recent than the specified period are sent to ConnectWise Manage as tickets. A different relevance period can be set for different event severities.

   • Priority—Select the priority level for the tickets created in ConnectWise Manage. Assigning priority levels to events is used to prioritize corresponding ConnectWise Manage tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner.
   • Service Board—Select the ConnectWise Manage Service Board to assign the ticket to. Service Boards are configured in ConnectWise Manage. Make sure that the Service Board has the default status and team; otherwise, it is not possible to create Service Tickets by means of this Service Board.
   • Type—Select the ConnectWise Manage ticket type to be assigned to the ticket. Ticket types, available for selection, depend on the selected Service Board. This setting is present only in the Ticketing settings for events window.
   • Subtype—Select the ConnectWise Manage ticket subtype to be assigned to the ticket. Ticket subtypes, available for selection, depend on the selected Type. This setting is present only in the Ticketing settings for events window.

   

   Ticketing settings for events window

4. When you finish configuring ticketing for events, click the Save changes button to save the ticketing settings.

   Ticketing for event severities is configured and ConnectWise Manage tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create tickets in ConnectWise Manage for a company only if its status allows saving changes. Therefore, make sure that the Disallow Saving check box is cleared for your company on the Company Status tab.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, select the Events section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, select the Events section.
3. Click the Reset to defaults link.

Page top

[Topic 178031]

Ticketing for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365

On the Ticketing tab, you can configure ticketing rules for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365. You can edit ticketing settings either for an individual event or for several events at the same time.

Configuring ticketing for events

To set up ticketing for events:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section to configure ticketing for events. You can configure ticketing separately for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.
3. Do one of the following:
   • To configure ticketing for one event severity (in Kaspersky Endpoint Security Cloud) or for one event type (in Kaspersky Security for Microsoft Office 365), use the toggle button in the Create ticket column to enable ticket creation for the corresponding event severity or event type. In the Lifetime, Priority, Service Board, and Closing status columns, edit the settings as required.

     By default, ticketing is disabled for all event severities and event types.

   • To configure ticketing for one or several event severities or event types simultaneously, select the lines that contain required event severities or event types, and then click the Edit button above the table. The Ticketing settings for events window opens.

     Editing ticketing settings for multiple event severities or event types is useful if you want to assign the same settings to these event severities or event types. If you want the ticketing settings to be different, edit them individually for each event severity or event type.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected event severities or event types.
   • Lifetime—Select the period, in days, during which the events are still relevant. The default value is 1 day. This setting is not present for events that occur in Kaspersky Security for Microsoft Office 365.

     This value is used to determine whether to create a ticket for an event in ConnectWise Manage. If the connection between ConnectWise Manage and Kaspersky Endpoint Security Cloud has been broken and events have not been sent for some time, only events more recent than the specified period are sent to ConnectWise Manage as tickets. A different relevance period can be set for different event severities.

   • Priority—Select the priority level for the tickets created in ConnectWise Manage. Assigning priority levels to events is used to prioritize corresponding ConnectWise Manage tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner.
   • Service Board—Select the ConnectWise Manage Service Board to assign the ticket to. Service Boards are configured in ConnectWise Manage. Make sure that the Service Board has the default status and team; otherwise, it is not possible to create Service Tickets by means of this Service Board.
   • Closing status—Select the status to be assigned to the tickets in ConnectWise Manage when they are automatically closed by Kaspersky Security Integration Service for MSP after the corresponding event in the Kaspersky Lab security application has been resolved. This setting is present only for events that occur in Kaspersky Security for Microsoft Office 365.
   • Type—Select the ConnectWise Manage ticket type to be assigned to the ticket. Ticket types, available for selection, depend on the selected Service Board. This setting is present only in the Ticketing settings for events window.
   • Subtype—Select the ConnectWise Manage ticket subtype to be assigned to the ticket. Ticket subtypes, available for selection, depend on the selected Type. This setting is present only in the Ticketing settings for events window.

   

   Ticketing settings for events window

4. When you finish configuring ticketing for events, click the Save changes button to save the ticketing settings.

   Ticketing for event severities or event types is configured and ConnectWise Manage tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create tickets in ConnectWise Manage for a company only if its status allows saving changes. Therefore, make sure that the Disallow Saving check box is cleared for your company on the Company Status tab.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section.
3. Click the Reset to defaults link.

Page top

[Topic 150638]

Ticketing for computer statuses

On the Ticketing tab, you can configure ticketing rules for the computer statuses. This allows tickets to be created in ConnectWise Manage when the computer status in Kaspersky Security Center or Kaspersky Endpoint Security Cloud changes to Warning or Critical. You can edit ticketing settings either for an individual computer status or for several statuses at the same time.

Configuring ticketing for computer statuses

To set up ticketing for computer status:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, select the Warning status or Critical status section to configure ticketing for computer statuses.
3. Do one of the following:
   • To configure ticket creation for one status, use the toggle button in the Create ticket column to enable ticket creation for the corresponding status change. In the Priority, Service Board, and Closing status columns, edit the settings as required.

     By default, ticket creation is disabled for all computer status descriptions.

   • To configure ticket creation for one or several statuses simultaneously, select the lines that contain the required status description, and then click the Edit button above the table. The Ticketing settings for computer status change window opens.

     Editing ticketing settings for multiple computer statuses is useful if you want to assign the same ticketing settings to these computer statuses. If you want the ticketing settings to be different, edit them individually for each computer status.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected status changes.
   • Priority—Select the priority level for the tickets created in ConnectWise Manage. Assigning priority levels to events is used to prioritize corresponding ConnectWise Manage tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner.
   • Service Board—Select the ConnectWise Manage Service Board to assign the ticket to. Service Boards are configured in ConnectWise Manage. Make sure that the Service Board has the default status and team; otherwise, it is not possible to create Service Tickets by means of this Service Board.
   • Closing status—Select the status to be assigned to the tickets in ConnectWise Manage when they are automatically closed. Tickets created on the basis of computer status change are automatically closed when the issue that triggered this computer status is resolved.
   • Type—Select the ConnectWise Manage ticket type to be assigned to the ticket. Ticket types, available for selection, depend on the selected Service Board. This setting is present only in the Ticketing settings for computer status change window.
   • Subtype—Select the ConnectWise Manage ticket subtype to be assigned to the ticket. Ticket subtypes, available for selection, depend on the selected Type. This setting is present only in the Ticketing settings for computer status change window.

   

   Ticketing settings for computer status change

4. When you finish configuring ticketing for computer statuses, click the Save changes button to save the ticketing settings.

   Ticketing for computer statuses is configured and ConnectWise Manage tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create tickets in ConnectWise Manage for a company only if its status allows saving changes. Therefore, make sure that the Disallow Saving check box is cleared for your company on the Company Status tab.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab solution name, and then select the Warning status or Critical status section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab solution name, and then select the Warning status or Critical status section.
3. Click the Reset to defaults link.

Page top

[Topic 138437]

Mapping ConnectWise Manage products to security applications

Set up mapping between Kaspersky Lab security applications and ConnectWise Manage products, so that usage information about Kaspersky Lab security applications appears in ConnectWise Manage as Agreement Additions.

On the Products tab of the Kaspersky Security Integration Tool for MSP window, you can map Kaspersky Lab security applications to ConnectWise Manage products. You can edit the existing mapping between security applications and products as well.

The list of available security applications differs depending on which Kaspersky Lab solution you use: Kaspersky Security Center or Kaspersky Business Hub.

Mapping Kaspersky Lab security applications to ConnectWise Manage products

To set up mapping between Kaspersky Lab security applications and ConnectWise Manage products:

1. In the Kaspersky Security Integration Tool for MSP window, click the Products tab.
2. To differentiate the pricing policy for two types of devices (servers and workstations), use the Bill devices by category toggle button to turn on this feature.
3. Map Kaspersky Lab security applications in the Kaspersky Lab security application column to their equivalents in the ConnectWise Manage product column.

   If the Bill devices by category feature is disabled, each Kaspersky Lab security application can be mapped to one ConnectWise Manage product only. Otherwise, map each Kaspersky Lab security application to three ConnectWise Manage products:

   1. In the Windows workstations drop-down list, select a ConnectWise Manage product. The price of this product will be used during billing for all of the workstations that use the license for the corresponding Kaspersky Lab security application.
   2. In the Windows servers drop-down list, select a ConnectWise Manage product. The price of this product will be used during billing for all of the servers that use the license for the corresponding Kaspersky Lab security application.
   3. In the Non-Windows devices drop-down list, select a ConnectWise Manage product. The price of this product will be used during billing for all of the non-Windows devices that use the license for the corresponding Kaspersky Lab security application.
4. When you have finished mapping, click the Save changes button to save the mapping.

[Topic 150866]

Viewing companies not integrated with Kaspersky Lab security applications

When configuring integration with ConnectWise Manage, it is useful to check whether all ConnectWise Manage companies are connected to Kaspersky Security Center virtual servers / Kaspersky Business Hub companies, or whether you accidentally skipped one or more companies. For this purpose, you can use ConnectWise Manage reports that allow you to display all existing companies together with the virtual servers or companies to which they are mapped.

Kaspersky Security Integration with ConnectWise Manage adds its own fields to the ConnectWise Manage configuration. You can use these fields in different custom reports. For example, using standard ConnectWise Manage functionality, you can select companies that are not integrated with Kaspersky Security Center or Kaspersky Business Hub—that is, the ConnectWise Manage companies that do not have a corresponding virtual server or company. Then, using filters, you can manually exclude from your selection the companies that do not use Kaspersky Lab security applications.

To view ConnectWise Manage companies that are not mapped to virtual servers or companies:

1. Log in to ConnectWise Manage with your credentials.
2. In ConnectWise Manage, create a report, using ConnectWise Report Writer. Your report must include the following fields:
   • ConnectWise Manage company name.
   • Corresponding virtual server / company name.

   Refer to ConnectWise Manage documentation for details on creating reports.

3. Filter your report data by the name of the virtual server or company.

   If the name of the virtual server or company is empty, the ConnectWise Manage company is not mapped to any virtual server or company.

[Topic 175225]

Configuring integration by using the registry

By using the Microsoft Windows registry, you can configure the integration as follows:

• Enable or disable tracing.
• Change the maximum time before updated integration settings are applied.

Enabling and disabling tracing

Refer to the "Enabling and disabling tracing by using the registry" section.

Changing the maximum time before updated integration settings are applied

After you update integration settings in Kaspersky Security Integration Tool for MSP, Kaspersky Security Integration Service for MSP applies them not immediately but within a certain time interval. By default, this interval is 15 minutes. If you use an on-premises version of a Kaspersky Lab solution, you can change the interval by using Microsoft Windows registry, as described later in this section. For a Cloud version of a Kaspersky Lab solution, the interval is specified by Kaspersky Lab specialists.

To change the maximum time before updated integration settings are applied:

Before editing the Windows registry, it is recommended that you back up the registry.

1. Click the Start button.
2. In the Start menu, in either the Run box or the Search box, type regedit and press Enter.

   The Registry Editor window opens.

   If you have restricted access to the Windows computer to which you are logged in, you might not be able to access the registry.

3. In the Registry Editor window, navigate to the Kaspersky Security Integration Service for MSP registry key. It is available by one of the following registry subkeys (paths):
   • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Service for MSP
   • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Service for MSP
4. Edit the value of the ConfigReloadIntervalMinutes setting by specifying the required number of minutes.
5. Click OK in the Edit window to save your changes.
6. Close the Registry Editor window.

The value is changed.

Page top

[Topic 141389]

Managing administrators

You can manage the administrators related to the integration with Kaspersky Business Hub. You can add the accounts of existing Kaspersky Business Hub users as administrators of your integration. You can also remove administrators from the integration if you do not want them to work with the integration.

You can manage administrators within the integration only if Kaspersky Business Hub solution is used. For Kaspersky Security Center solution, this functionality is unavailable.

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

When you remove administrators from the integration, these administrators 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.

All remaining administrators who have access to the integration can add or remove administrators to / from this integration.

Managing administrators

The following sections explain how to add or remove an administrator to / from the integration.

[Topic 141394]

Adding administrators

When you add administrators to an integration, they have the same rights as existing administrators: they can administer Kaspersky Endpoint Security Cloud workspaces and Kaspersky Security for Microsoft Office 365 workspaces of all Kaspersky Business Hub companies bound to this integration and can manage the integration settings.

To add administrators:

1. In the Kaspersky Security Integration Tool for MSP window, click the Administrators tab.
2. Click the Add link to add administrators.
3. 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 Business Hub can be added to the integration.

4. 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.
5. After you perform all the actions with administrators' accounts, click the Save changes button.

The new administrators are added to the integration and gain access to all workspaces within this integration.

[Topic 141396]

Removing administrators

When you remove administrators from an integration, they can no longer manage the integration. However, the administrators' Kaspersky Lab accounts are not deleted; they are merely unbound from the integration, so that the administrators cannot manage the integration or administer its workspaces.

To remove administrators:

1. In the Kaspersky Security Integration Tool for MSP window, click the Administrators tab.
2. Select the check boxes next to the names of administrators you want removed from the integration.

   If you want to select all administrators, select the check box in the column header.

   You cannot remove all administrators from the integration. An integration must have at least one administrator.

3. Click the Delete link to remove the selected administrators.
4. After you perform all the actions with the administrators' accounts, click the Save changes button.

The selected administrators are removed from the integration and lose their rights to administer workspaces bound to the integration.

Page top

[Topic 142997]

Enabling and disabling tracing

The following sections explain how to enable and disable tracing for Kaspersky Security Integration with ConnectWise Manage components.

You may have to save traces of Kaspersky Security Integration with ConnectWise Manage, for example, if you contact Technical Support and they ask you to provide the traces for diagnostics and troubleshooting. It is recommended to disable tracing when an issue is resolved, as tracing requires additional resources and additional memory to store trace files. It is also recommended to remove trace files from your computer after the issue that required tracing is resolved, because the trace files may contain personal and confidential data.

By default, tracing is disabled.

There are two ways of enabling and disabling tracing for Kaspersky Security Integration with ConnectWise Manage components:

• Using the Microsoft Windows registry.
• In the .config files of Kaspersky Security Integration with ConnectWise Manage components.

[Topic 143646]

Enabling and disabling tracing by using the registry

You can enable and disable tracing by using the Microsoft Windows registry.

To enable or disable tracing:

Before editing the Windows registry, it is recommended that you back up the registry.

1. Click the Start button.
2. In the Start menu, either in the Run box or the Search box, type regedit and press Enter.

   The Registry Editor window opens.

   If you have restricted access to the Windows computer you are logged into, you might not be able to access the registry.

3. In the Registry Editor window, navigate to the Kaspersky Security Integration Service for MSP or Kaspersky Security Integration Tool for MSP registry key. They are available by one of the following paths:
   • Kaspersky Security Integration Service for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Service for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Service for MSP
   • Kaspersky Security Integration Tool for MSP

     If the Kaspersky Security Integration Tool for MSP registry key is not displayed, either run Kaspersky Security Integration Tool for MSP as administrator (by right-clicking the application icon and selecting Run as administrator), or create the registry key manually.

     • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Tool for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Tool for MSP
4. Edit the value of the EnableTraces parameter as follows:
   • 1—To enable tracing.
   • 0—To disable tracing.
5. Click OK in the Edit window to save your changes.
6. Close the Registry Editor window.

The trace files are saved to the .log files in the application installation folder:

• For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.log, by default saved to the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
• For Kaspersky Security Integration Service for MSP the file is IntegrationServer.log, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.

When you uninstall Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP, the trace files are removed together with the application.

Page top

[Topic 143647]

Enabling and disabling tracing by using the .config files

You can enable and disable tracing in the .config files of Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP. The files are stored in the installation folders of the corresponding products.

To enable or disable tracing:

1. Navigate to the .config file of the Kaspersky Security Integration with ConnectWise Manage component for which you want to enable or disable tracing. The .config file is stored in the installation folder. By default, the navigation paths are:
   • For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.exe.config, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
   • For Kaspersky Security Integration Service for MSP the file is IntegrationServer.exe.config, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.
2. Open the .config file with any text editor and change the value of the minlevel attribute of the logger element as follows:
   • To enable tracing, set the value of the minlevel attribute to Debug.

     <logger name="MSPIntegration.*" writeTo="fileTarget" minlevel="Debug" />

   • To disable tracing, set the value of the minlevel attribute to Off.

     <logger name="MSPIntegration.*" writeTo="fileTarget" minlevel="Off" />

3. Save and close the modified .config file.

The trace files are saved to the .log files in the application installation folder:

• For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.log, by default saved to the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
• For Kaspersky Security Integration Service for MSP the file is IntegrationServer.log, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.

When you uninstall Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP, the trace files are removed together with the application.

Page top

[Topic 159990]

Reporting

This section describes how to create different types of reports for managed Kaspersky Security Center virtual servers or Kaspersky Business Hub companies in ConnectWise Manage.

[Topic 160003]

Service report

You can create a regular service report for a representative of a managed company. This report includes statistics on protection services provided to the client. You can view this report for the last 30 days and the last 7 days. Kaspersky Security Integration with ConnectWise Manage updates statistics daily.

A report can be built for a particular managed company linked to Kaspersky Security Center virtual server or Kaspersky Business Hub company, by using the standard ConnectWise Report Writer. The name of a service report configuration item in ConnectWise Manage contains the report period, the report starting date and ending date, and the name of the Kaspersky Security Center virtual server. (If you use Kaspersky Business Hub, the name of the Kaspersky Business Hub Company will not be included). If the name of a service report configuration item is more than 100 characters long, its length is reduced.

A generated report includes statistics on tickets processed during the report period and on the state of managed computers in the customer infrastructures.

A service report includes the following data:

• Report period—Either 7 days or 30 days.
• Report starting date
• Report ending date
• Managed computers—Number of computers of the managed company that are connected to the Kaspersky Business Hub company or Kaspersky Security Center virtual server.
• Protected computers—Number of computers on which a real-time protection application is installed.
• New critical tickets—Number of tickets based on critical events or computer statuses that were created by Kaspersky Security Integration with ConnectWise Manage during the report period (regardless of whether or not these tickets were closed during the report period). Tickets based on events are created according to the rules that you set as described in Ticketing for events. Tickets based on computer statuses are created according to the rules that you set as described in Ticketing for computer statuses.
• Closed critical tickets—Number of tickets based on critical events or computer statuses that were resolved and closed by Kaspersky Security Integration with ConnectWise Manage during the report period (regardless of whether or not these tickets were created during the report period).
• New warning tickets—Number of tickets based on warning events or computer statuses that were created by Kaspersky Security Integration with ConnectWise Manage during the report period (regardless of whether or not these tickets were closed during the report period).
• Closed warning tickets—Number of tickets based on warning events or computer statuses that were resolved and closed by Kaspersky Security Integration with ConnectWise Manage during the reporting period (regardless of whether or not these tickets were created during the report period).
• New functional failure tickets—Number of tickets based on functional failure events that were created by Kaspersky Security Integration with ConnectWise Manage during the reporting period (regardless of whether or not these tickets were closed during the report period).
• Closed functional failure tickets—Number of tickets for functional failure events that were resolved and closed by Kaspersky Security Integration with ConnectWise Manage during the report period (regardless of whether or not these tickets were created during the report period).
• Problem computers—Number of computers whose status is other than OK at the moment the configuration item is created.

[Topic 160042]

License report

You can create a license report for a client company to provide information about keys for the Kaspersky Lab security applications, including key usage and availability.

The name of a license report configuration item in ConnectWise Manage contains the last update date of the configuration item and the name of the security application to which the license applies. If the name of a license report configuration item is longer than 100 characters, it is cut.

A license report includes the following data for each key:

• Report date—Last update date of the configuration item.
• License ID
• Security application name
• License period
• License expiration date
• License restriction—Number of computers to which the key can be assigned.
• Number of company's computers using the license—Number of computers to which the key is assigned. These computers belong to the selected client company.
• Total number of computers using the license—Number of computers to which the key is assigned. These computers belong to all client companies of the MSP or to the MSP itself.
• Key is more than 90% used—If the total number of computers that use the key divided by the license restriction is greater than 0.9, the value is Yes. Otherwise, the value is No.
• Key exceeded restriction—If the total number of computers that use the key divided by the license restriction is greater than 1, the value is Yes. Otherwise, the value is No.
• License information—Additional information about the key.
• Support information—Information about Technical Support contacts.

[Topic 160040]

Generating a report in ConnectWise Manage

A service report is provided in ConnectWise Manage as configuration items of a special Kaspersky report type. A license report is represented as configuration items of the Kaspersky license report type.These items are also linked to managed company profiles according to the mapping to companies or virtual servers.

To generate a report for a managed company in ConnectWise Manage:

1. On the left navigation menu, point to System, and then click Report Writer.
2. Click the New button.
3. On the Data Sources tab that opens, select the v_rpt_Configuration check box.
4. Click the Fields tab, and then add the following fields:
   • Question
   • Answer

   These fields will be names of columns in the report.

5. Click the Filters tab, and then add the following filters:
   • Filter: Company_Name; Operator: Equals (Select); Value(s): in the drop-down list, select the managed company for which you want to view the report.
   • Filter: Config_Name; Operator: Equals (Select); Value(s): in the drop-down list, select the configuration item that corresponds to the required report type (Kaspersky report or Kaspersky license report) and—for a service report—period (start date and end date).
6. If you want the report to display additional information, add other fields and filters. For more details, refer to the ConnectWise Manage documentation at https://docs.connectwise.com/ConnectWise_Documentation/090/070.
7. Click the Preview button to preview the report.
8. Click the Save button to save the report.
9. Export the report, print it, or send it by email to your client.

   You can export the report to a CSV file, a Microsoft Excel spreadsheet, a Microsoft Word document, or an XML document. You can also save the SQL query that matches the specified report parameters to a text file.

[Topic 151099]

Custom fields in ConnectWise Manage

Kaspersky Security Integration with ConnectWise Manage provides easy access to valuable integration-specific information on ConnectWise Manage companies directly from the ConnectWise Manage graphical user interface (GUI). You can view this information in each ConnectWise Manage company profile and use this information in ConnectWise Manage reports.

The following custom fields are available for the ConnectWise Manage companies:

• If you use Kaspersky Security Center
  • Kaspersky virtual server—Name of the virtual server mapped to this company in Kaspersky Security Integration Tool for MSP.
• If you use Kaspersky Business Hub:
  • Kaspersky workspace—Name of the Kaspersky Business Hub company mapped to this ConnectWise Manage company in Kaspersky Security Integration Tool for MSP.
  • Kaspersky workspace URL—Link to open your Kaspersky Business Hub company from the ConnectWise Manage company profile.

If you accidentally deleted the custom fields created by the integration, you can restore them by using the following workaround. However, this workaround works only the first time you save changes in parameter values after Kaspersky Security Integration Tool for MSP starts.

To restore the custom fields:

1. Start or restart Kaspersky Security Integration Tool for MSP.
2. Change the value for any parameter on any tab (Companies, Ticketing, or Products) to activate the Save changes button.
3. Click the Save changes button.

   The custom fields are displayed after you save changes to your integration.

4. Set the parameter that you changed in step 2 to the original value, and then save your settings.

The custom fields are now available in the ConnectWise Manage company profile.

[Topic 95897_1]

Glossary

Administration Server

A component of Kaspersky Security Center that centrally stores information about all Kaspersky Lab applications that are installed within the corporate network. Administration Server can also be used to manage these applications.

Administration Server client (Client computer)

A computer, server, or workstation on which Network Agent and managed Kaspersky Lab applications are running.

Anti-virus databases

Databases that contain information about computer security threats known to Kaspersky Lab as of when the anti-virus databases are released. Entries in anti-virus databases allow malicious code to be detected in scanned objects. Anti-virus databases are created by Kaspersky Lab specialists and updated hourly.

Kaspersky Business Hub company

Virtual Administration Server by Kaspersky Lab that is designed to manage a security software suite on devices connected to Kaspersky Endpoint Security Cloud and/or Kaspersky Security for Microsoft Office 365, as well as to store individual settings of Kaspersky Endpoint Security Cloud and/or Kaspersky Security for Microsoft Office 365 and the registration data of a company using any of these products.

Network Agent

A Kaspersky Security Center component that enables interaction between the Administration Server and Kaspersky Lab applications that are installed on a specific network node (workstation or server).

Virus

A program that infects other ones, by adding its code to them in order to gain control when infected files are run. This simple definition allows identifying the main action performed by any virus: infection.

[Topic 70331_1]

Contact Technical Support

This section describes how to get technical support and the terms on which it is available.

[Topic 124640_1]

How to get technical support

If you cannot find a solution to your issue in the Kaspersky Security Integrations for MSP documentation or in any of the sources of information about Kaspersky Security Integrations for MSP, contact Technical Support. Technical Support specialists will answer all your questions about configuring and using Kaspersky Security Integrations for MSP.

Before contacting Technical Support, please read the support rules.

You can contact Technical Support in one of the following ways:

• By visiting the Technical Support website
• By sending a request to Technical Support from the Kaspersky CompanyAccount portal

[Topic 68417_1]

Technical Support via Kaspersky CompanyAccount

Kaspersky CompanyAccount is a portal for companies that use Kaspersky Lab applications. The Kaspersky CompanyAccount portal is designed to facilitate interaction between users and Kaspersky Lab specialists through online requests. You can use Kaspersky CompanyAccount to track the status of your online requests and store a history of them as well.

You can register all of your organization's employees under a single account on Kaspersky CompanyAccount. A single account lets you centrally manage electronic requests from registered employees to Kaspersky Lab and also manage the privileges of these employees via Kaspersky CompanyAccount.

The Kaspersky CompanyAccount portal is available in the following languages:

• English
• Spanish
• Italian
• German
• Polish
• Portuguese
• Russian
• French
• Japanese

To learn more about Kaspersky CompanyAccount, visit the Technical Support website.

[Topic 34744_1]

AO Kaspersky Lab

Kaspersky Lab is a world-renowned vendor of systems protecting computers against digital threats, including viruses and other malware, unsolicited email (spam), and network and hacking attacks.

In 2008, Kaspersky Lab was rated among the world’s top four leading vendors of information security software solutions for end users (IDC Worldwide Endpoint Security Revenue by Vendor). Kaspersky Lab is the preferred vendor of computer protection systems for home users in Russia (IDC Endpoint Tracker 2014).

Kaspersky Lab was founded in Russia in 1997. It has since grown into an international group of companies with 38 offices in 33 countries. The company employs more than 3,000 skilled professionals.

Products. Kaspersky Lab products provide protection for all systems, from home computers to large corporate networks.

The personal product range includes security applications for desktop, laptop, and tablet computers, smartphones and other mobile devices.

The company offers protection and control solutions and technologies for workstations and mobile devices, virtual machines, file and web servers, mail gateways, and firewalls. The company's portfolio also features specialized products providing protection against DDoS attacks, protection for industrial control systems, and prevention of financial fraud. Used in conjunction with centralized management tools, these solutions ensure effective automated protection for companies and organizations of any size against computer threats. Kaspersky Lab products are certified by major test laboratories, compatible with software from diverse vendors, and optimized to run on many hardware platforms.

Kaspersky Lab virus analysts work around the clock. Every day they uncover hundreds of thousands of new computer threats, create tools to detect and disinfect them, and include their signatures in databases used by Kaspersky Lab applications.

Technologies. Many technologies that are now part and parcel of modern anti-virus tools were originally developed by Kaspersky Lab. It is no coincidence that many other developers use the Kaspersky Anti-Virus engine in their products, including: Alcatel-Lucent, Alt-N, Asus, BAE Systems, Blue Coat, Check Point, Cisco Meraki, Clearswift, D-Link, Facebook, General Dynamics, H3C, Juniper Networks, Lenovo, Microsoft, NETGEAR, Openwave Messaging, Parallels, Qualcomm, Samsung, Stormshield, Toshiba, Trustwave, Vertu, and ZyXEL. Many of the company’s innovative technologies are patented.

Achievements. Over the years, Kaspersky Lab has won hundreds of awards for its services in combating computer threats. Following tests and research conducted by the reputed Austrian test laboratory AV-Comparatives in 2014, Kaspersky Lab ranked among the top two vendors by the number of Advanced+ certificates earned and was ultimately awarded the Top Rated certificate. But Kaspersky Lab's main achievement is the loyalty of its users worldwide. The company’s products and technologies protect more than 400 million users, and its corporate clients number more than 270,000.

[Topic 37531]

Information about third-party code

Information about third-party code is contained in the file legal_notices.txt, in the application installation folder.

[Topic 138691]

Trademark notices

Registered trademarks and service marks are the property of their respective owners.

Excel, Microsoft, and Windows are registered trademarks of Microsoft Corporation in the United States and other countries.

[Topic 149635]

Kaspersky Security Integration with Autotask

This section describes Kaspersky Security Plug-in for ConnectWise Automate. It contains a general description of the software and provides instructions for working with it.

[Topic 149331]

Kaspersky Security Integration with Autotask

This section describes the purpose, functions, and distribution kit of Kaspersky Security Integration with Autotask, and provides hardware and software requirements for Kaspersky Security Integration with Autotask.

[Topic 149300]

About Kaspersky Security Integration with Autotask

Integration is the process of bringing together components into a single system. Kaspersky Security Integration with Autotask integrates Kaspersky Lab solutions (Kaspersky Security Center or Kaspersky Business Hub) and Autotask to provide a combination of monitoring and management tools, such as automated billing and ticket creation for client accounts. Kaspersky Security Integration with Autotask integrates Autotask with all cloud-based products managed by Kaspersky Business Hub: Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.

In terms of Kaspersky Security Integration with Autotask, integration is a set of parameters and interaction rules that can be set up and configured. First, you create an integration between your Kaspersky Lab solution and Autotask; then you can manage and configure your integrations, and view and edit integration parameters. When configuring an integration, you set up mapping between the entities of the Kaspersky Lab solution and Autotask entities, and define rules that determine how your Kaspersky Lab solution interacts with Autotask.

Kaspersky Security Integration with Autotask consists of two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP (managed service providers).

• Kaspersky Security Integration Tool for MSP provides a graphical user interface (GUI) to configure integration. The tool is used to configure connection between the Kaspersky Lab solution that you use and Autotask. The tool is also used to configure mapping between the Kaspersky Lab solution entities and Autotask entities. Kaspersky Lab solution entities are virtual servers, if you use Kaspersky Security Center, or companies, if you use Kaspersky Business Hub. Autotask entities are Accounts and Services.
• Kaspersky Security Integration Service for MSP is a Microsoft Windows service application that is installed on the computer that has Kaspersky Security Center Administration Server installed. Kaspersky Security Integration Service for MSP synchronizes data in Kaspersky Security Center and Autotask. It is a service application only, with no user interface.

Page top

[Topic 162500]

About data provision

Kaspersky Security Integration with Autotask is designed for the integration of Kaspersky Lab solutions for administration of security applications with Autotask within the framework of the functionality described in this Help document.

To use Kaspersky Security Integration with Autotask, you must install the integration components and connect them to the Kaspersky Lab solution you use, create an integration with Autotask, specify connection parameters and integration settings and select your customers’ virtual servers / companies for the integration.

By using the product, you agree that said product may receive data from Autotask and the connected virtual servers / companies, as well as store, process, and display information that is intended for ensuring the product functionality.

By creating an integration and connecting Autotask and virtual servers / companies to the product, you thus confirm that you are the sole owner of any data you provide or that you are entitled to provide any data.

Any information provided is protected and processed in accordance with the Kaspersky Lab Privacy Policy.

For the purpose of integration of Kaspersky Security Center / Kaspersky Business Hub and Autotask, Kaspersky Security Integration with Autotask may receive, store, and process the following types of data:

• Data required to connect to the integrated software:
  • Parameters for connecting to Kaspersky Security Center Administration Server, including account credentials.
  • Account credentials for connecting to Kaspersky Business Hub.
  • Connection parameters for accessing Autotask.
• Data about events that occur in Kaspersky Security Center, Kaspersky Endpoint Security Cloud, or Kaspersky Security for Microsoft Office 365. This data is required for automatic creation of tickets or similar entities.
• Data about assigning the Critical and Warning statuses to computers managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud. This data is required for automatic creation of tickets or similar entities.
• Data about usage of licenses for Kaspersky Lab security applications by computers managed by Kaspersky Security Center or Kaspersky Endpoint Security Cloud (the number of computers that use a certain license). This data is required for automatic generation of invoices for your customers.
• Data about the number of protected Kaspersky Security for Microsoft Office 365 mailboxes. This data is required for automatic generation of invoices for your customers.
• Data about the state of a managed Kaspersky Security Center virtual server / Kaspersky Endpoint Security Cloud workspace (the number of managed computers, the number of protected computers, the number of created and closed tickets of various types, the number of threats and malicious objects detected on the computers, the number of problematic computers, and the number of infected computers). This data is required for report generation.
• Data about licenses used at Kaspersky Security Center virtual servers / Kaspersky Endpoint Security Cloud workspaces and about attributes of these licenses. This data is required for report generation.
• Integration settings:
  • Type of integrated platform (Autotask).
  • Integration name.
  • Integration ID (for integrations with Kaspersky Business Hub).
  • Date and time of integration creation.
  • Set of integrated virtual servers / companies.
  • List of Kaspersky Business Hub administrators (their aliases and email addresses) who are also granted administrative privileges in the integration.
  • Rules for mapping objects of Kaspersky Security Center / Kaspersky Business Hub to those of Autotask (virtual servers / companies to accounts and Kaspersky Lab security applications to Autotask services).
  • Rules for creating objects in Autotask, such as tickets, contract service adjustments, and configuration items.

If you integrate Autotask with Kaspersky Business Hub, the above data (specifically, data required to connect to the integrated software and integration settings) is transferred from Kaspersky Security Integration Tool for MSP to Kaspersky Business Hub. This data is processed there and is stored according to the terms and conditions of the Privacy Policy of Kaspersky Business Hub.

If your integration includes a company for which a Kaspersky Endpoint Security Cloud workspace has been created, the data that Kaspersky Business Hub receives from Kaspersky Security Integration Tool for MSP is transferred to the Kaspersky Endpoint Security Cloud workspace. This data is processed there and is stored according to the terms and conditions of the agreements that were accepted during the workspace creation.

If your integration includes a company for which a Kaspersky Security for Microsoft Office 365 workspace has been created, the data that Kaspersky Business Hub receives from Kaspersky Security Integration Tool for MSP is transferred to the Kaspersky Security for Microsoft Office 365 workspace. This data is processed there and is stored according to the terms and conditions of the agreements that were accepted during the workspace creation.

All received data is used by the MSP administrators and technicians. Kaspersky Lab Technical Support specialists may also use the above data when an MSP administrator contacts Technical Support.

[Topic 149309]

Features of Kaspersky Security Integration with Autotask

Kaspersky Security Integration with Autotask helps you to integrate Kaspersky Lab solutions with Autotask to provide ticketing, straightforward monitoring, issue tracking, automated billing, and reporting in the customer environment.

Kaspersky Security Integration with Autotask provides the following features:

• Connection

With Kaspersky Security Integration with Autotask, you can connect Kaspersky Lab solutions to Autotask in a few clicks to enable automated billing, ticketing, and other processes. You do not need any additional tools or consoles: you can access everything from Autotask.

• Automatic ticketing

Kaspersky Security Integration with Autotask simplifies multi-tenancy management by enabling automation of ticket creation and workflow for each of your client accounts. You can select an Autotask account of your client and map it to the corresponding virtual server / company in the Kaspersky Lab solution that you use.

The tickets are automatically created in Autotask, which reduces the time you spend monitoring your managed client account and increases the number of clients that a single technician can manage. For additional resource efficiency, assign priorities and queues to tickets to streamline their prioritization.

• Billing setup

Kaspersky Security Integration with Autotask provides easy access to information on usage of Kaspersky Lab security applications from Autotask, which significantly simplifies and automates customer billing and reporting.

• Report generation

You can generate service reports on Kaspersky Security Center virtual servers or Kaspersky Business Hub companies and license reports directly from Autotask. Service reports include statistics on protection services provided to the client over the last 30 days and the last 7 days. License reports provide information about keys, including their usage and availability.

• Compatibility

With Kaspersky Security Integration with Autotask, it is easy to create solutions based on your customers’ needs and requirements: Autotask works with both on-premises and cloud-based Kaspersky Lab solutions. Use Kaspersky Lab cloud-based security to avoid additional overhead, or keep everything inside the perimeter and make the most of your existing hardware investment with an on-premises solution.

[Topic 149324]

Distribution kit

Kaspersky Security Integration with Autotask is delivered free of charge as a distribution package that contains installation files for Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

You can download the distribution kit from the Kaspersky Lab website.

No license is required for Kaspersky Security Integration with Autotask.

[Topic 149334]

Software requirements

Basic software requirements for integration setup:

• Kaspersky Security Center Administration Server 10 Service Pack 2 Maintenance Release 1 and later, Kaspersky Endpoint Security Cloud, or Kaspersky Security for Microsoft Office 365.

Software requirements for Kaspersky Security Integration Tool for MSP:

• Microsoft Windows 7 and later.
• Microsoft .NET Framework 4.5.2.
• Kaspersky Security Center Administration Server 10 Service Pack 2 Maintenance Release 1 and later, or Kaspersky Security Center Administration Console 10 Service Pack 2 Maintenance Release 1 and later—for an on-premises solution only.

Software requirements for Kaspersky Security Integration Service for MSP:

• Supported operating systems are the same as those supported by Kaspersky Security Center 10 Service Pack 2 Maintenance Release 1 and later. Refer to Kaspersky Security Center documentation for details.
• Administration Server component of Kaspersky Security Center 10 Service Pack 2 Maintenance Release 1 and later.
• Microsoft .NET Framework 4.5.2.

Page top

[Topic 153108]

Deployment schemas of Kaspersky Security Integration with Autotask

This section describes the deployment schemas of Kaspersky Security Integration with Autotask. The schemas include the two components of Kaspersky Security Integration with Autotask:

• Kaspersky Security Integration Tool for MSP—Used to configure connection between the Kaspersky Lab solution you use and Autotask, and to configure mapping between the Kaspersky Lab solution entities and Autotask entities.
• Kaspersky Security Integration Service for MSP—Synchronizes data in Kaspersky Security Center and Autotask. It is a service application only, with no user interface.

The deployment schema that suits your integration depends on the Kaspersky Lab solution you use and on your integration model. There are three deployment schemas:

• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center.
• For an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center with slave Administration Servers.
• For a cloud-based version of a Kaspersky Lab solution—Kaspersky Business Hub.

This section describes the deployment schemas in detail.

[Topic 153109]

Deployment schema for on-premises solution

Deploy Kaspersky Security Integration with Autotask based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you do not have slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Integration with Autotask are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution

The following list describes deployment prerequisites and data flow:

• Kaspersky Security Integration Service for MSP must be installed on the computer on which Kaspersky Security Center Administration Server is installed.
• Kaspersky Security Integration Tool for MSP must be installed on the computer on which either Administration Console or Administration Server is installed and deployed.
• In Kaspersky Security Center, virtual servers must be created for each of the managed Autotask accounts. These virtual servers are than mapped to Autotask accounts, allowing you to integrate Kaspersky Security Center and Autotask.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with Autotask for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Security Center are received by Kaspersky Security Integration Service for MSP and tickets are created based on them.

Page top

[Topic 153111]

Deployment schema for on-premises solution and slave servers

Deploy Kaspersky Security Integration with Autotask based on this schema if you use an on-premises version of a Kaspersky Lab solution—Kaspersky Security Center—and if you use slave Administration Servers in your managed company infrastructure.

The components of Kaspersky Security Integration with Autotask are shown as orange rectangles in the following figure.

Deployment schema for on-premises solution and slave servers

The following list describes deployment prerequisites and data flow:

• One or more Administration Servers are used in the client's infrastructure. These Administration Servers are slave Administration Servers relative to the Administration Server that is installed in the MSP infrastructure. The Administration Server installed in the MSP infrastructure is the master Administration Server. You can use this type of deployment to decrease load on your master Administration Server.
• Kaspersky Security Integration Service for MSP must be installed on the computer on which the slave Administration Server is installed in the client's infrastructure.
• Kaspersky Security Integration Tool for MSP must be installed on the computer on which either Administration Console or the master Administration Server is installed and deployed.
• On your slave Administration Server, virtual servers must be created for each of the managed accounts. These virtual servers are then mapped to Autotask accounts, allowing you to integrate Kaspersky Security Center and Autotask.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with Autotask for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Security Center are received by Kaspersky Security Integration Service for MSP and tickets are created based on them.

Page top

[Topic 153114]

Deployment schema for cloud-based solution

Deploy Kaspersky Security Integration with Autotask based on this schema if you use the cloud-based version of a Kaspersky Lab solution—Kaspersky Business Hub.

The components of Kaspersky Security Integration with Autotask are shown as orange rectangles in the following figure.

Deployment schema for cloud-based solution

The following list describes deployment prerequisites and data flow:

• In this deployment schema, only Kaspersky Security Integration Tool for MSP is used. Kaspersky Security Integration Service for MSP is not used.
• Kaspersky Security Integration Tool for MSP must be installed in your infrastructure, and not in the client infrastructure.
• In your Kaspersky Business Hub solution, companies must be created for each of the managed Autotask accounts. These companies are then mapped to Autotask accounts, allowing you to integrate Kaspersky Business Hub and Autotask.
• In your managed environment, you may have many different Kaspersky Lab programs installed. Data on the number of programs is used by Kaspersky Security Integration with Autotask for automatic billing. Events and computer status changes sent from Kaspersky Lab programs to Kaspersky Business Hub are received and tickets are created based on them.

Page top

[Topic 152972]

Integration scenario

This section describes the overall sequence of actions that you perform to integrate your Kaspersky Lab solution (Kaspersky Security Center or Kaspersky Business Hub) with Autotask by means of Kaspersky Security Integration with Autotask.

1. Installing Kaspersky Security Integration with Autotask.

   Download Kaspersky Security Integration with Autotask from the Kaspersky Lab web site and install it by using a standard Windows installation procedure.

2. Preparing information for setting up integration.

   Check the connection settings and additional prerequisites to successfully integrate your Kaspersky Lab solution with Autotask. You will have to provide these parameters in the next steps of this scenario.

3. Connecting Kaspersky Security Integration with Autotask to your Kaspersky Lab solution.

   Provide the parameters to connect Kaspersky Security Integration with Autotask to your Kaspersky Lab solution:

   • For Kaspersky Security Center, provide user credentials and server parameters.
   • For Kaspersky Business Hub, provide the account credentials.
4. Creating integration with Autotask.

   Provide the parameters for the new integration with Autotask that is created during initial configuration. The integration parameters are the same for Kaspersky Security Center and for Kaspersky Business Hub.

5. Adding virtual servers or companies to your integration.

   Select virtual servers or companies to be integrated with Autotask:

   • For Kaspersky Security Center, select virtual servers to be mapped to Autotask accounts.
   • For Kaspersky Business Hub, select companies to be mapped to Autotask accounts.
6. Checking integration.

   After you perform step 1 through step 5, Kaspersky Security Integration with Autotask will be installed and configured. To verify the installation, open the Accounts tab and make sure that your virtual servers / companies are displayed in the first column and that your Autotask accounts are available for selection in the second column.

   

   Kaspersky Security Integration Tool for MSP main window

[Topic 149344]

Installing and removing Kaspersky Security Integration with Autotask

Kaspersky Security Integration with Autotask is delivered as a distribution package that contains two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

This section contains step-by-step instructions for installing and removing Kaspersky Security Integration with Autotask.

[Topic 149342]

Installing Kaspersky Security Integration with Autotask

After you download the distribution package for Kaspersky Security Integration with Autotask, install the components of Kaspersky Security Integration with Autotask by using a standard Windows installation procedure.

Kaspersky Security Integration Service must be installed if you use Kaspersky Security Center. If you use Kaspersky Business Hub, you do not have to install Kaspersky Security Integration Service.

Install Kaspersky Security Integration Service for MSP on the computer on which Kaspersky Security Center Administration Server is installed. Install Kaspersky Security Integration Tool for MSP on the computer on which either Administration Console or Administration Server is installed and deployed.

Install both components of Kaspersky Security Integration with Autotask—Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP—in the same manner. The steps below describe the installation process for each component.

Before you install the components of Kaspersky Security Integration with Autotask, it is strongly recommended to check their digital signatures to make sure that they are issued by Kaspersky Lab.

To check the digital signature for a component of Kaspersky Security Integration with Autotask:

1. Locate the installation application (msp_setup.exe file) for the Kaspersky Security Integration with Autotask component.
2. Right-click the installation application and select Properties.
3. In the properties window that opens, click the Digital Signatures tab and check that the installation application has Kaspersky Lab signatures.
4. Close the properties window.

After you check the digital signatures of the Kaspersky Security Integration with Autotask components, install each of the components.

You can install Kaspersky Security Integration with Autotask either in interactive mode or in silent mode.

Installation in interactive mode

To install a component of Kaspersky Security Integration with Autotask in interactive mode:

1. On the machine where you want to install Kaspersky Security Integration with Autotask, double-click the installation application (msp_setup.exe file) for the component.
2. Follow the wizard steps to install the component.
   • Accept the terms of the license agreement to continue installation.
   • When installing Kaspersky Security Integration Tool for MSP, accept the terms of the privacy policy to continue installation.
   • If required, change the installation folder for the component. The folder you select must have about 25 MB of free space to install both components of Kaspersky Security Integration with Autotask.
3. Click Finish on the last page of the wizard.

Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP are installed. Kaspersky Security Integration Tool for MSP is added to the Start menu.

Installation in silent mode

To install Kaspersky Security Integration Tool for MSP in silent mode:

1. Read the license agreement and the privacy policy stored in license.txt file next to the installation application (msp_setup.exe file). Proceed only if you accept the terms of the license agreement and the privacy policy.
2. At the command prompt, type

   msp_setup.exe /s /v"EULA=1 PRIVACYPOLICY=1 INSTALLDIR=\"<installation path>\""

   Here,

   • EULA=1 means that you accept the terms of the license agreement.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Tool for MSP will not be installed.

   • PRIVACYPOLICY=1 means that you accept the terms of the privacy policy.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Tool for MSP will not be installed.

   • INSTALLDIR=\"<installation path>\" is the path to the Kaspersky Security Integration Tool for MSP installation folder.

     If you do not specify this parameter, Kaspersky Security Integration Tool for MSP will be installed to %PROGRAMFILES%\Kaspersky Lab\Kaspersky Security Integration Tool for MSP (in 32-bit versions of Windows) or %PROGRAMFILES(x86)%\Kaspersky Lab\Kaspersky Security Integration Tool for MSP (in 64-bit versions of Windows).

Kaspersky Security Integration Tool for MSP is installed and is added to the Start menu.

To install Kaspersky Security Integration Service for MSP in silent mode:

1. Read the license agreement stored in license.txt file next to the installation application (msp_setup.exe file). Proceed only if you accept the terms of the license agreement.
2. At the command prompt, type

   msp_setup.exe /s /v"EULA=1 INSTALLDIR=\"<installation path>\""

   Here,

   • EULA=1 means that you accept the terms of the license agreement.

     If you specify another value or if you do not specify this parameter, Kaspersky Security Integration Service for MSP will not be installed.

   • INSTALLDIR=\"<installation path>\" is the path to the Kaspersky Security Integration Service for MSP installation folder.

     If you do not specify this parameter, Kaspersky Security Integration Service for MSP will be installed to %PROGRAMFILES%\Kaspersky Lab\Kaspersky Security Integration Service for MSP (in 32-bit versions of Windows) or to %PROGRAMFILES(x86)%\Kaspersky Lab\Kaspersky Security Integration Service for MSP (in 64-bit versions of Windows).

Kaspersky Security Integration Service for MSP is installed.

Known issue

Kaspersky Security Integration Service for MSP cannot connect to Autotask if Kaspersky Security Center and Kaspersky Security Integration Service for MSP are deployed in the client's network instead of the managed service provider's network, and there is an authentication proxy server between Kaspersky Security Integration Service for MSP and Autotask.

To enable Kaspersky Security Integration Service for MSP to connect to Autotask over the Internet through the proxy with authentication:

1. Launch the Services Microsoft Management Console snap-in by selecting Start → Control panel → Administrative Tools → Services.
2. Right-click Kaspersky Security Integration Service for MSP and select Properties.
3. In the service properties window that opens, click the Log On tab and specify the following settings:
   • In the Log on as section, select the This account option.
   • Specify the account credentials for connection to the Internet by Kaspersky Security Integration Service for MSP.
4. Click OK in the service properties window to save your changes.

Page top

[Topic 149343]

Removing Kaspersky Security Integration with Autotask

You can remove the components of Kaspersky Security Integration with Autotask by using a standard Windows installation / uninstallation procedure.

To remove a component of Kaspersky Security Integration with Autotask:

1. On the Start menu, select Control Panel and then click Programs and Features.
2. In the list of installed programs, select Kaspersky Security Integration Tool for MSP or Kaspersky Security Integration Service for MSP.
3. Right-click the selected application and select Uninstall.

The selected application is removed. Repeat these steps for the other component of Kaspersky Security Integration with Autotask.

As an alternative, you can remove the components of Kaspersky Security Integration with Autotask in silent mode.

To remove Kaspersky Security Integration Tool for MSP in silent mode:

Run Command Prompt as an administrator and type

msiexec.exe /x {E58E13CA-6745-4C60-BE0B-FE6DD416FCB0} REBOOT=ReallySuppress /qn /l*v %temp%\msp_service_uninstall_log.txt

To remove Kaspersky Security Integration Service for MSP in silent mode:

Run Command Prompt as an administrator and type

msiexec.exe /x {7EF14DEE-606A-4147-94FD-3FB0E1FA9D69} REBOOT=ReallySuppress /qn /l*v %temp%\msp_tool_uninstall_log.txt

Removing user.config file

When you uninstall Kaspersky Security Integration Tool for MSP, the user.config files are not removed. These files are automatically created for every user who has ever connected to a Kaspersky Lab solution (either on-premises or Cloud) using Kaspersky Security Integration Tool for MSP. The user.config files contain encrypted information about the user's connection settings for Kaspersky Security Center or Kaspersky Business Hub.

If necessary, you can manually remove the user.config file for every user. The user.config file is stored in the AppData folder of a user.

For example, for Windows 7 and Administrator user, the path to the user.config files is as follows: C:\Users\Administrator\AppData\Local\AO_Kaspersky_Lab\IntegrationUI.exe_Url_nrmo2y4axdcnfumknnua4kzhxvafmxmb\1.0.0.0\user.config.

[Topic 165375]

Updating Kaspersky Security Integration with Autotask

It is recommended to update Kaspersky Security Integration with Autotask to the latest version.

The sequence of actions required to update Kaspersky Security Integration with Autotask depends on the Kaspersky Lab solution that you use.

• If you use Kaspersky Security Center, update both components of Kaspersky Security Integration with Autotask (Kaspersky Security Integration Service for MSP and all instances of Kaspersky Security Integration Tool for MSP) to the latest version before you start using the new version of Kaspersky Security Integration with Autotask. If you use several instances of Kaspersky Security Integration Tool for MSP when working with a single Kaspersky Security Integration Service for MSP, make sure that all these instances are updated.

  If one or more components of Kaspersky Security Integration with Autotask is not updated (either Kaspersky Security Integration Service for MSP or one of the Kaspersky Security Integration Tool for MSP instances), Kaspersky Security Integration with Autotask will not operate properly.

• If you use Kaspersky Business Hub, update all instances of Kaspersky Security Integration Tool for MSP to the latest version.

All settings that you configured in a previous version of Kaspersky Security Integration Tool for MSP, such as integration parameters, accounts, and product mappings, remain the same when you migrate Kaspersky Security Integration with Autotask to the latest version.

[Topic 152900]

Interface of Kaspersky Security Integration with Autotask

Kaspersky Security Integration with Autotask consists of two applications: Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP.

• Kaspersky Security Integration Tool for MSP provides a graphical user interface to configure integration.
• Kaspersky Security Integration Service for MSP is a service application for Microsoft Windows that synchronizes data in Kaspersky Security Center and Autotask. It does not have a user interface.

Kaspersky Security Integration Tool for MSP consists of one window with several nested tabs. Depending on the type of Kaspersky Lab solution that you use—on-premises or cloud-based—Kaspersky Security Integration Tool for MSP may have three or four nested tabs. On these tabs, you can configure mapping between the Kaspersky Lab solution entities, such as virtual servers / companies and security applications, and Autotask entities, such as accounts and services. You can also configure ticketing, and (if you use the cloud-based version of the solution) you can manage administrators who can configure the integration.

Kaspersky Security Integration Tool for MSP main window

The Kaspersky Security Integration Tool for MSP window has the following tabs:

• Accounts—Use this tab to set up and modify mapping between company accounts in Autotask and virtual servers or companies in your Kaspersky Lab solution, and to add or remove virtual servers or companies to your integration. On the Accounts tab, you can also enable automatic billing.
• Ticketing—Use this tab to set up ticketing rules for enabling automatic creation and assignment of tickets in Autotask. You can configure creation and assignment of tickets depending on the event severity and type, or when a computer status changes in Kaspersky Lab security applications.

  Ticketing is one of the most important features of your integration. If you do not configure ticketing, Autotask cannot generate tickets on the basis of events and computer status changes and cannot process corresponding issues.

• Services—Use this tab to set up mapping between Autotask services and Kaspersky Lab security applications so that usage information about Kaspersky Lab security applications appears in Autotask. You can modify the existing mapping of services and security applications as well.
• Administrators—This tab is available for cloud-based solutions only. Use this tab to manage the administrators related to the integration with Kaspersky Business Hub. You can add existing Kaspersky Business Hub administrators to your integration or remove administrators from the integration if you do not want them to configure the integration.

Page top

[Topic 149348]

Getting started

After you install Kaspersky Security Integration with Autotask, you establish a connection between it and Autotask. The connection enables you to configure integration using Kaspersky Security Integration Tool for MSP and enables Kaspersky Security Integration Service for MSP to send Service Tickets and license usage information to Autotask. To establish connection, create a new integration using Kaspersky Security Integration Tool for MSP.

The integration process varies depending on which Kaspersky Lab solution you use. This section describes how to configure integration with Kaspersky Security Center and with Kaspersky Business Hub.

[Topic 153010]

Prerequisites

When configuring integration, you must specify the parameters of the Kaspersky Lab solution you integrate with (Kaspersky Security Center or Kaspersky Business Hub) and Autotask connection parameters. It is recommended that you check these parameters in advance in order to prepare for setting up integration.

Kaspersky Security Center parameters

Check the following parameters:

• Address of the computer on which Kaspersky Security Center Administration Server is installed.
• Credentials: user name and password for the computer on which Administration Server is installed.
• If you establish connection to the Administration Server through a proxy server, check the proxy server parameters: network address or domain name and credentials for the proxy server.

Kaspersky Business Hub parameters

Check the credentials of your Kaspersky Business Hub account: email address and password.

Autotask parameters

Credentials used to log in to Autotask: user name and password.

It is recommended to create and use a separate dedicated user with the API User security level rather than providing the credentials that you use to log in to Autotask. This security level must be set as Not required to change password. Because the API User security level does not allow logging in through the user interface, it eliminates many security risks associated with using an integration.

To set the "Not required to change password" security level:

1. In Autotask, select Admin → Features & Settings, expand the Resources/Users node, and then click Resources/Users.
2. Right-click a user name in the Resource Name column and select Edit Resource.
3. In the Resource Management window that opens, select the Security tab, and in the Security Level drop-down list select API User.
4. Click the Save & Close button.
5. Select Admin → Features & Settings, expand the Resources/Users node, and then click Security Levels.
6. In the Security Levels window that opens, click the Pencil icon next to the API User value in the Name column.
7. In the Security Level window that opens, expand the Other node and select the Not required to change password (password does not expire) check box.
8. Click Save & Close.

Additional prerequisites

During the integration process, it is required to add virtual servers or companies to your integration. These virtual servers or companies are then mapped to Autotask accounts.

For each client company represented by an account in Autotask, create and assign a separate Kaspersky Security Center virtual server / Kaspersky Business Hub company prior to integration.

One-to-one mapping is supported, and therefore the number of virtual servers or companies must not exceed the number of your managed accounts.

[Topic 149351]

Integrating with Kaspersky Security Center

This section describes how to create and configure integration between Autotask and Kaspersky Security Center by using Kaspersky Security Integration Tool for MSP.

To successfully create integration, connect to Kaspersky Security Center Administration Server and perform the steps described in the following sections.

[Topic 149355]

Connecting to Kaspersky Security Center Administration Server

When you start Kaspersky Security Integration Tool for MSP, the connection settings window opens. In this window, specify the settings to connect to Kaspersky Security Center Administration Server.

Connecting to Kaspersky Security Center Administration Server

To connect to Kaspersky Security Center Administration Server:

1. In the Start menu, select Kaspersky Security Integration Tool for MSP.
2. In the window that opens, select the Kaspersky Endpoint Security for Business solution to connect to Kaspersky Security Center Administration Server.
3. You can connect to Kaspersky Security Center Administration Server in one of the following ways:
   • By providing the connection parameters for the computer on which the Administration Server is installed.

     If you selected this method of connection, specify the following connection settings. None of the fields can be blank.

     • Address—Address of the computer on which the Administration Server is installed. You can specify this value as an IP address or as a domain name of the computer.
     • User name—User name to connect to the computer on which the Administration Server is installed, that is, to the computer whose address you specified in the Address field.
     • Password—Password to connect to the computer, on which the Administration Server is installed, that is, to the computer whose address you specified in the Address field.
   • By selecting the Administration Server certificate.

     In this case, you do not have to provide the connection parameters for the computer on which the Administration Server is installed. Kaspersky Security Integration Tool for MSP uses the certificate of Kaspersky Security Center Administration Server to connect to this Administration Server. Usage of the certificate guarantees that Kaspersky Security Integration Tool for MSP connects to the Administration Server from which the certificate was downloaded.

     The Administration Server certificate is created automatically during installation of the Administration Server and is stored in the %ProgramData%\Application Data\KasperskyLab\adminkit\1093\cert folder on the computer that has Administration Server installed. Before starting to use the Administration Server certificate for authentication, copy the certificate file, klserver.cer, to the computer on which Kaspersky Security Integration Tool for MSP is installed.

To use Administration Server certificate:

1. Click the Select Kaspersky Security Center Administration Server certificate link.
2. In the window that opens, select the Use a certificate check box, click Browse, and then navigate to the certificate file.
3. Click OK to start using the selected certificate for connection.
4. If you want to establish the connection to the Administration Server through a proxy server, select the Use proxy server check box. By default, this check box is cleared.

   If you selected the Use proxy server check box, provide the following proxy-server settings:

   • Address—Network address of the proxy server. Provide the address as a full domain name of the proxy server.
   • User name—User name to connect to the proxy server.
   • Password—Password to connect to the proxy server.
5. Click the Proceed button to connect to the Administration Server using the specified settings.

The system validates the provided settings and connects to the Administration Server.

[Topic 149374]

Creating a Kaspersky Security Center integration with Autotask

After you connect to the Administration Server, the integration settings window opens, where you can create an integration between Autotask and Kaspersky Security Center by means of Kaspersky Security Integration Tool for MSP.

Creation of an integration between Autotask and Kaspersky Security Center is required only when you launch Kaspersky Security Integration Tool for MSP for the first time.

Specifying Autotask integration settings

To create integration with Autotask:

1. In the integration settings window that opens after you connect to the Administration Server, specify the following settings for the newly created integration:
   • Select platform—Select the integration platform from the drop-down list. The list contains the names of all platforms that Kaspersky Security Center can be integrated with. For integration with Autotask, select Autotask.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with Autotask. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • User name—User name to be used to log in to Autotask.
   • Password—Password for the user name to be used to log in to Autotask.

     It is recommended to create and use a separate dedicated user with the API User security level rather than providing the credentials that you use to log in to Autotask. Refer to section Prerequisites for details.

2. Click the Proceed button when you have finished specifying the integration settings.

   The system validates the Autotask integration settings and permission level for the specified credentials. These settings are saved and then used by Kaspersky Security Integration with Autotask to gain access to Autotask.

   The permission level of the credentials you provided must be high enough to perform all operations in Kaspersky Security Integration Tool for MSP; otherwise, an error occurs, and integration for the user with these credentials cannot be created. For example, integration cannot be created for a user lacking permissions for editing tickets in Autotask.

Kaspersky Security Center is now integrated with Autotask.

Page top

[Topic 149382]

Adding virtual servers to the integration

After an integration with Autotask is created, a window opens where you can add Kaspersky Security Center virtual servers to the integration. Kaspersky Security Center virtual servers are then mapped to the Autotask accounts.

Adding virtual servers to the integration

To add Kaspersky Security Center virtual servers to the integration:

1. In the window, which lists Kaspersky Security Center virtual servers, select the check boxes next to the existing virtual servers to add them to the integration.

   If you want to add all virtual servers to the integration, select the Select all check box.

2. Click Proceed.

   You will now be able to map these virtual servers to Autotask accounts.

Each virtual server can be added to one integration only. That is, if a virtual server is added to an integration, it is not displayed in a list of virtual servers available for another integration.

Page top

[Topic 149350]

Integrating with Kaspersky Business Hub

This section describes how to create and configure integration between Autotask and Kaspersky Business Hub by means of Kaspersky Security Integration Tool for MSP.

To successfully create integration, connect to Kaspersky Business Hub and perform the steps described in the following sections.

[Topic 149354]

Connecting to Kaspersky Business Hub

When you start Kaspersky Security Integration Tool for MSP, the connection settings window opens. In this window, specify the settings to connect to Kaspersky Business Hub.

Connecting to Kaspersky Business Hub

To connect to Kaspersky Business Hub:

1. In the Start menu, select Kaspersky Security Integration Tool for MSP.
2. In the window that opens, select the Kaspersky Business Hub solution.
3. Specify the following connection settings:
   • User name—Email address that you use to connect to Kaspersky Business Hub. This field cannot be blank.
   • Password—Password that you use to connect to Kaspersky Business Hub. This field cannot be blank.
4. Click the Proceed button to connect to Kaspersky Business Hub by using the specified settings.

The system validates the provided settings and establishes connection to Kaspersky Business Hub.

[Topic 149379]

Creating a Kaspersky Business Hub integration with Autotask

After you connect to the Kaspersky Business Hub, the integration settings window opens, where you can create an integration between Autotask and Kaspersky Business Hub by means of Kaspersky Security Integration Tool for MSP.

Creation of an integration between Autotask and Kaspersky Business Hub is required only when you launch Kaspersky Security Integration Tool for MSP for the first time.

Specifying Autotask integration settings

To create integration with Autotask:

1. In the integration settings window that opens after you connect to Kaspersky Business Hub, specify the following settings for the newly created integration:
   • Select platform—Select the integration platform from the drop-down list. The list contains the names of all platforms that Kaspersky Business Hub can be integrated with. For integration with Autotask, select Autotask.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with Autotask. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • User name—User name to be used to log in to Autotask.
   • Password—Password for the user name to be used to log in to Autotask.

     It is recommended to create and use a separate dedicated user with the API User security level rather than providing the credentials that you use to log in to Autotask. Refer to section Prerequisites for details.

2. Click the Proceed button when you have finished specifying the integration settings.

   The system validates the Autotask integration settings and permission level for the specified credentials. These settings are saved and then used by Kaspersky Security Integration with Autotask to gain access to Autotask.

   The permission level of the credentials you provided must be high enough to perform all operations in Kaspersky Security Integration Tool for MSP; otherwise, an error occurs, and integration for the user with these credentials cannot be created. For example, integration cannot be created for a user lacking permissions for editing tickets in Autotask.

Kaspersky Business Hub is now integrated with Autotask.

Page top

[Topic 149386]

Adding Kaspersky Business Hub companies to the integration

After an integration with Autotask is created, a window opens where you can add Kaspersky Business Hub companies to the integration. Kaspersky Business Hub companies are then mapped to the Autotask accounts.

You cannot add separate Kaspersky Endpoint Security Cloud workspaces or Kaspersky Security for Microsoft Office 365 workspaces to the integration. You can add only entire Kaspersky Business Hub companies. All workspaces created for a company in Kaspersky Business Hub are added to the integration.

Adding companies to the integration

To add Kaspersky Business Hub companies to the integration:

1. In the window, which lists Kaspersky Business Hub companies, select the check boxes next to the existing companies to add them to the integration. Icons next to the name of each company show which workspaces are created for this company in Kaspersky Business Hub.

   If you want to add all companies to the integration, select the Select all check box.

2. Click Proceed.

   You will now be able to map these companies to Autotask accounts.

Each Kaspersky Business Hub company can be added to one integration only. That is, if a company is added to an integration, it is not displayed in a list of companies available for another integration.

Page top

[Topic 150877]

Supplementary parameter

The parameter that indicates the type of Kaspersky Business Hub server to which Kaspersky Security Integration Tool for MSP connects may be included in the .config file (IntegrationUI.exe.config) of Kaspersky Security Integration Tool for MSP.

The parameter name is KESCloudServer; and its possible values are:

• production—Kaspersky Security Integration Tool for MSP works with the Production server.
• beta—Kaspersky Security Integration Tool for MSP works with the Beta server.
• test—Kaspersky Security Integration Tool for MSP works with the Test server.

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

The IntegrationUI.exe.config file is stored in the installation folder of Kaspersky Security Integration Tool for MSP. The default path is C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP\IntegrationUI.exe.config.

By default, the KESCloudServer parameter is not displayed in the .config file of Kaspersky Security Integration Tool for MSP.

The KESCloudServer parameter can be specified as follows:

Page top

[Topic 149390]

Managing integrations

This section describes how to edit or delete an existing integration and how to create a new integration. For example, you may have to edit, delete, or create an integration when you change the vendor of your Professional Services Automation system.

[Topic 149396]

Creating a new integration

You can create a new integration in the Kaspersky Security Integration Tool for MSP window.

Creating a new integration

To create a new integration with Autotask:

1. At the top of the Kaspersky Security Integration Tool for MSP window, click the name of the current integration.
2. In the Integration Settings window that opens, click the New integration button.

   A new Integration Settings window opens. The fields for the connection settings are blank.

3. Specify the values for the following settings of the integration:
   • Platform—Select the integration platform from the drop-down list. The list contains the names of all platforms that Kaspersky Security Center or Kaspersky Business Hub can be integrated with. For integration with Autotask, select Autotask.
   • Integration name—Name of the new integration. This field cannot be blank. By default, the integration name is Integration with Autotask. The integration name is displayed in the Kaspersky Security Integration Tool for MSP window as a link that allows you to view and access the integration properties.

     For an integration with Kaspersky Business Hub, 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.

   • User name—User name to be used to log in to Autotask.
   • Password—Password for the user name to be used to log in to Autotask.
4. Click OK when you have finished specifying the integration settings.

   The system validates the Autotask integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with Autotask to gain access to Autotask.

A new integration with Autotask is created.

[Topic 149395]

Editing and viewing an existing integration

You can view and edit settings of an existing integration in the Kaspersky Security Integration Tool for MSP window.

Editing an integration

To view and edit integration with Autotask:

1. At the top of the window, click the name of the integration whose settings you want to view or modify.
2. In the Integration Settings window that opens, in the Select integration drop-down list select the required integration.
3. Modify the following settings of the selected integration:
   • Integration name—Name of the selected integration. By default, the integration name is Integration with Autotask. You can edit this field, however, it cannot be blank.

     For an integration with Kaspersky Business Hub, 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.

   • User name—User name to log in to Autotask.
   • Password—Password for the user name, specified to log in to Autotask.
4. Click OK when you have finished editing the integration settings.

   The system validates the Autotask integration settings. If the settings you provide are correct, they are saved and then used by Kaspersky Security Integration with Autotask to gain access to Autotask.

The integration with Autotask is modified and saved.

[Topic 149397]

Deleting an existing integration

You can delete an existing integration in the Kaspersky Security Integration Tool for MSP window.

When you delete an integration, all virtual servers or companies that were linked to the integration are unbound from the integration but continue to exist in Kaspersky Security Center or Kaspersky Business Hub. All administrators of the deleted integration receive notifications that the integration was deleted, but they can continue to administer Kaspersky Business Hub companies that were linked to this integration.

All Kaspersky Security Center virtual servers or Kaspersky Business Hub companies that are unbound from the deleted integration can be added to other integrations.

To delete integration with Autotask:

1. At the top of the Kaspersky Security Integration Tool for MSP window, click the name of the integration that you want to delete.
2. In the integration window that opens, click Delete to delete the integration.
3. Click Yes to confirm deletion.

The integration settings are cleared, indicating that the integration is deleted.

Page top

[Topic 149480]

Configuring integration in Kaspersky Security Integration with Autotask

The purpose of Kaspersky Security Integration Tool for MSP is to configure integration between Autotask and the Kaspersky Lab solution you use: Kaspersky Security Center or Kaspersky Business Hub.

Using Kaspersky Security Integration Tool for MSP, you can do the following:

• Map Autotask accounts to Kaspersky Security Center virtual servers or Kaspersky Business Hub companies.
• Configure ticketing in Autotask.
• Map Kaspersky Lab security applications to existing Autotask services.
• Configure automated billing.

[Topic 149481]

Mapping accounts and enabling automatic billing

Use the Accounts tab in the Kaspersky Security Integration Tool for MSP window to set up and modify mapping between accounts in Autotask and virtual servers or companies in your Kaspersky Lab solution. To set up mapping, accounts must be created in Autotask, while virtual servers must be added to Kaspersky Security Center Administration Server or companies must be created in Kaspersky Business Hub.

On the Accounts tab, you can also enable automatic billing for your Autotask accounts. This means that information about the number of licenses for Kaspersky Lab security applications provided during the current billing period can be updated regularly and automatically in Autotask. Timely updating lets you prepare customer invoices more quickly and easily.

When you click the Accounts tab, a list is displayed, showing virtual servers or companies and their corresponding Autotask accounts. You can add existing virtual servers or companies to the integration and map Autotask accounts to them. You can also delete mapping between a virtual server or company and its corresponding account. In this case, neither the virtual server / company nor the account is deleted; instead, the link between them is broken.

Mapping accounts and enabling automatic billing

The following sections explain how to add or remove virtual servers or companies to / from the integration and how to configure automatic billing.

[Topic 149499]

Adding and removing virtual servers or companies

You can add existing virtual servers or companies to the integration or remove them from the integration.

To add or remove virtual servers or companies to / from the integration:

1. In the Kaspersky Security Integration Tool for MSP window, click the Companies tab.
2. Click the Add / remove virtual servers link if you use Kaspersky Security Center, or the Add / remove companies link if you use Kaspersky Business Hub, and then do one of the following:
   • Select check boxes next to existing virtual servers or companies to add them to the integration. Then you can match these virtual servers or companies to Autotask accounts.
   • Clear check boxes next to virtual servers or companies to remove them from the integration. This action does not remove the virtual servers from Kaspersky Security Center or companies from Kaspersky Business Hub; it only deletes the mapping between the virtual servers or companies and the Autotask accounts.
3. Click OK.

Each virtual server or company can be added to one integration only. That is, if a virtual server or a company is added to an integration, it is not displayed in a list of virtual servers or companies available for another integration.

Page top

[Topic 149501]

Setting up automatic billing

You can map virtual servers or companies to Autotask accounts and configure automatic billing for the selected accounts.

To set up mapping between virtual servers or companies and Autotask accounts, and edit billing settings:

1. In the Kaspersky Security Integration Tool for MSP window, click the Accounts tab.
2. In the Virtual server column (if you use Kaspersky Security Center) or in the Company column (if you use Kaspersky Business Hub), locate the virtual servers or companies to which to map the Autotask account.

   If you have a long list of virtual servers or companies, use the search box located above the table, on the right, to find the required virtual server or company. Type any part of the virtual server or company name in the search box and click the Search button. Only the virtual servers or companies whose names contain the string you entered are displayed.

3. In the Autotask account column, click the drop-down arrow and select the account you want to map to the virtual server or company.

   One-to-one mapping is supported. You can map one virtual server or one company to a single Autotask account.

4. Turn automatic billing on or off for your Autotask account by using the toggle button in the Billing settings column.

   To use automatic billing, you must create mapping between Kaspersky Lab security applications and their Autotask equivalents—services. For details, see Mapping Autotask services to security applications.

5. Click the Select contract drop-down arrow in the Billing settings column and select one of the available Contracts associated with the account you selected in the Autotask account column.

   A contract of the Recurring Service type must exist for the selected account in Autotask in order for automatic billing to be set up successfully. Contracts for an account are created and managed in Autotask. You can view the contracts for the selected account in Autotask.

   For details on automatic billing, see How automatic billing works.

6. If necessary, repeat steps 2 to 5 for each pair: virtual server-account or company-account.
7. Click the Save changes button to save your mapping.

After the accounts are mapped to the virtual servers or companies and automatic billing is configured, the Contract Service Adjustments for the licensed Kaspersky Lab security applications are automatically created for these accounts in Autotask.

[Topic 149641]

How automatic billing works

You can configure automatic billing to enable Kaspersky Security Integration with Autotask to create, and update daily, the Contract Service Adjustments for accounts in Autotask. When automatic billing is configured, information about usage of Kaspersky Lab security applications on managed computers is transferred to Autotask automatically, allowing faster periodic generation of invoices for your customers. For the information about enabling and configuring automatic billing, refer to Setting up automatic billing.

Automatic billing works according to the following rules:

• Kaspersky Security Integration Service for MSP runs automatic billing daily, so that you have up-to-date usage information in Autotask any time you have to generate an invoice for a client.
• Kaspersky Security Integration Service for MSP creates Service Adjustments to Autotask Contracts only for those Kaspersky Lab security applications that are mapped to Autotask Services. For details, refer to Mapping Autotask services to security applications.
• For each account with a specified Contract that is mapped to a virtual server or a company, Kaspersky Security Integration Service for MSP calculates how many devices managed by this virtual server or belonging to this company utilize licenses for Kaspersky Lab security applications. Only unexpired and active commercial keys and subscriptions are counted. Servers and workstations are counted separately if the Bill devices by category option is selected when Kaspersky Lab security applications and Autotask services are mapped. Also, Kaspersky Security Integration Service for MSP calculates how many Kaspersky Security for Microsoft Office 365 mailboxes are protected.
• Every time the number of devices that utilize licenses for Kaspersky Lab security applications or the number of protected mailboxes changes, Kaspersky Security Integration Service for MSP generates a Service Adjustment for the Contract associated with the account. This Service Adjustment contains information on how usage of the Kaspersky Lab security applications changed.

To differentiate the pricing policy for two types of devices (servers and workstations), a separate billing feature is available. Kaspersky Security Integration Tool for MSP supports two billing configurations:

• Associates a single licensed Kaspersky Lab security application with a single Autotask service.
• Associates a single licensed Kaspersky Lab security application with three different Autotask services: one for servers, a second for workstations, and a third for non-Windows devices.

  In this case, Autotask analyzes the type of client device (server or workstation) that uses the Kaspersky Lab license. Data about each Kaspersky Lab security application license used by the device is associated with the Autotask service mapped to this Kaspersky Lab security application.

  For example, if a client company uses Kaspersky Endpoint Security for Business Advanced on 100 devices, where 90 of them are workstations and 10 are servers, Kaspersky Security Integration Service for MSP does the following:

  • Creates a Contract Service Adjustment on 90 devices for the Autotask service for workstations.
  • Creates a Contract Service Adjustment on 10 devices for the Autotask service for servers.

[Topic 165837]

Setting up ticketing

This section explains how to set up ticketing for your Autotask accounts.

[Topic 150687]

About setting up ticketing

Tickets allow timely responses to different types of events or changes in computer status that occur on the network. Automated ticketing allows you to reduce significantly the time spent monitoring and managing your Autotask accounts.

You must establish ticketing rules to enable automatic creation and assignment of tickets in Autotask. You can set up creation and assignment of tickets depending on the event severity or when a computer status changes to Critical or Warning in Kaspersky Lab security applications.

Tickets created on the basis of computer status changes are automatically closed when the corresponding issue is resolved and the status description that triggered the ticket creation is no longer relevant. For example, when a computer's status becomes Warning because a "Databases are out of date" status description is assigned, a corresponding ticket is created. When the databases are updated, the status description "Databases are out of date" is no longer relevant, and the ticket is automatically closed. However, the computer status might remain Warning because of other status descriptions, for example, "Many viruses detected".

Tickets created on the basis of events Mailboxes protection is not provided and License-related issue occurred that occur in Kaspersky Security for Microsoft Office 365 are also closed when the corresponding issue is resolved.

Tickets created on the basis of all other events that occur in Kaspersky Security for Microsoft Office 365 and tickets created on the basis of events that occur in Kaspersky Security Center or Kaspersky Endpoint Security Cloud are not closed automatically, so you must close these tickets manually.

You can create and modify ticketing rules for your Autotask accounts. Ticketing rules are applicable to all accounts that are mapped to Kaspersky Security Center virtual servers or Kaspersky Business Hub companies. Ticketing rules are configured individually for events and for computer statuses. When configuring integration between Autotask and Kaspersky Business Hub, you must set up ticketing separately for Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.

[Topic 150692]

General ticketing settings

In the General section of the Ticketing tab, you can configure general ticketing settings. General settings are applicable to all tickets that have been automatically created in Autotask as a result of events or computer status changes that occur in Kaspersky Lab security applications. General settings provide the required initial values to the ticket attributes so that tickets are created correctly in Autotask.

Configuring general ticketing settings

To configure general ticketing settings:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, select the General section.

   The General Settings right pane allows you to configure general settings for ticketing.

3. Edit the following settings:
   • In the Ticket source drop-down list, select the source to be assigned to new tickets that are automatically created in Autotask when an event is triggered or a change in computer status occurs. This value is optional; it is displayed in the ticket properties in Autotask.
   • In the New ticket status drop-down list, select the status to be assigned to new tickets that are automatically created in Autotask when an event is triggered or a change in computer status occurs. By default, these tickets are assigned the New status. This value is required.
   • In the Closed ticket status drop-down list, select the status to be assigned to tickets when they are automatically closed by Kaspersky Security Integration Service for MSP after the corresponding issue in the Kaspersky Lab security application has been resolved. By default, these tickets are assigned the Complete status. This value is required.
4. When you finish configuring general ticketing settings, click the Save changes button to save the ticketing settings.

   General ticketing settings are configured and Autotask tickets are created in accordance with the specified rules.

You can cancel changes and reset general ticketing settings to their last saved values.

To cancel changes to general ticketing settings and restore last saved values:

1. Open the Ticketing tab and in the left pane select the General section.
2. Click the Cancel changes button.

You can also reset general ticketing settings to their default values.

To reset general ticketing settings to their default values:

1. Open the Ticketing tab and in the left pane select the General section.
2. Click the Reset to defaults link.

Page top

[Topic 150688]

Ticketing for events

The ticketing settings depend on the Kaspersky Lab solution that you use: Kaspersky Security Center or Kaspersky Business Hub.

[Topic 178028]

Ticketing for events that occur in Kaspersky Security Center

On the Ticketing tab, you can configure ticketing rules for events that occur in Kaspersky Security Center. You can edit ticketing settings either for an individual event or for several events at the same time.

Configuring ticketing for events

To set up ticketing for events:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, select the Events section to configure ticketing for events.
3. Do one of the following:
   • To configure ticketing for one event severity, use the toggle button in the Create ticket column to enable ticket creation for the corresponding event severity. In the Lifetime, Queue, Priority, and Due, hours columns, edit the settings as required.

     By default, ticketing is disabled for all event severities.

   • To configure ticketing for one or several event severities simultaneously, select the lines that contain required event severities, and then click the Edit button above the table. The Ticketing settings for events window opens.

     Editing ticketing settings for multiple event severities is useful if you want to assign the same settings to these event severities. If you want the ticketing settings to be different, edit them individually for each event severity.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected event severities.
   • Lifetime—Select the period, in days, during which the events are still relevant. The default value is 1 day.

     This value is used to determine whether to create a ticket for an event in Autotask. If the connection between Autotask and Kaspersky Security Center has been broken and events have not been sent for some time, only events more recent than the specified period are sent to Autotask as tickets. A different relevance period can be set for different event severities.

   • Queue—Select the queue in which to put the created ticket. The drop-down list contains the names of the Autotask queues. By default, tickets are put in the Monitoring Alert queue. This setting is required.
   • Priority—Select the priority level for the tickets created in Autotask. Assigning priority levels is used to prioritize corresponding Autotask tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner. The default priority for Critical events is Critical, and for Warning and Functional Failure events it is Medium. If one of these basic priority values is deleted in Autotask, the default value is blank. This setting is required.
   • Due—Specify the time interval during which the ticket issue must be resolved and the ticket must be closed. The default value is 12 hours.
   • Work type—Select the work type to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.
   • Issue type—Select the Autotask issue type to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.
   • Issue subtype—Select the Autotask issue subtype to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.

   

   Ticketing settings for events window

4. When you finish configuring ticketing for events, click the Save changes button to save the ticketing settings.

   Ticketing for event severities is configured and Autotask tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create tickets only for active Autotask accounts. Therefore, make sure that the Active check box is selected in the account properties.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, select the Events section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, select the Events section.
3. Click the Reset to defaults link.

Page top

[Topic 178029]

Ticketing for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365

On the Ticketing tab, you can configure ticketing rules for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365. You can edit ticketing settings either for an individual event or for several events at the same time.

Configuring ticketing for events

To set up ticketing for events:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section to configure ticketing for events. You can configure ticketing separately for events that occur in Kaspersky Endpoint Security Cloud and Kaspersky Security for Microsoft Office 365.
3. Do one of the following:
   • To configure ticketing for one event severity (in Kaspersky Endpoint Security Cloud) or for one event type (in Kaspersky Security for Microsoft Office 365), use the toggle button in the Create ticket column to enable ticket creation for the corresponding event severity or event type. In the Lifetime, Queue, Priority, and Due, hours columns, edit the settings as required.

     By default, ticketing is disabled for all event severities and event types.

   • To configure ticketing for one or several event severities or event types simultaneously, select the lines that contain required event severities or event types, and then click the Edit button above the table. The Ticketing settings for events window opens.

     Editing ticketing settings for multiple event severities or event types is useful if you want to assign the same settings to these event severities or event types. If you want the ticketing settings to be different, edit them individually for each event severity or event type.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected event severities or event types.
   • Lifetime—Select the period, in days, during which the events are still relevant. The default value is 1 day. This setting is not present for events that occur in Kaspersky Security for Microsoft Office 365.

     This value is used to determine whether to create a ticket for an event in Autotask. If the connection between Autotask and Kaspersky Endpoint Security Cloud has been broken and events have not been sent for some time, only events more recent than the specified period are sent to Autotask as tickets. A different relevance period can be set for different event severities.

   • Queue—Select the queue in which to put the created ticket. The drop-down list contains the names of the Autotask queues. By default, tickets are put in the Monitoring Alert queue. This setting is required.
   • Priority—Select the priority level for the tickets created in Autotask. Assigning priority levels is used to prioritize corresponding Autotask tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner. The default priority for Critical events that occur in Kaspersky Endpoint Security Cloud is Critical, and for Warning and Functional Failure events it is Medium. The default priority for all events that occur in Kaspersky Security for Microsoft Office 365 is Critical. If one of these basic priority values is deleted in Autotask, the default value is blank. This setting is required.
   • Due—Specify the time interval during which the ticket issue must be resolved and the ticket must be closed. The default value is 12 hours.
   • Work type—Select the work type to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.
   • Issue type—Select the Autotask issue type to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.
   • Issue subtype—Select the Autotask issue subtype to be assigned to the ticket. This setting is present only in the Ticketing settings for events window.

   

   Ticketing settings for events window

4. When you finish configuring ticketing for events, click the Save changes button to save the ticketing settings.

   Ticketing for event severities or event types is configured and Autotask tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create tickets only for active Autotask accounts. Therefore, make sure that the Active check box is selected in the account properties.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab security application name, and then select the Events section.
3. Click the Reset to defaults link.

Page top

[Topic 150691]

Ticketing for computer statuses

On the Ticketing tab, you can configure ticketing rules for the computer statuses. This allows tickets to be created in Autotask when the computer status in Kaspersky Security Center or Kaspersky Endpoint Security Cloud changes to Warning or Critical. You can edit ticketing settings either for an individual computer status or for several statuses at the same time.

Configuring ticketing for computer statuses

To set up ticketing for computer status:

1. In the Kaspersky Security Integration Tool for MSP window, click the Ticketing tab.
2. In the left pane, select the Warning status or Critical status section to configure ticketing for computer statuses.
3. Do one of the following:
   • To configure ticket creation for one status, use the toggle button in the Create ticket column to enable ticket creation for the corresponding status change. In the Queue, Priority, and Due, hours columns, edit the settings as required.

     By default, ticket creation is disabled for all computer status descriptions.

   • To configure ticket creation for one or several statuses simultaneously, select the lines that contain the required status description, and then click the Edit button above the table. The Ticketing settings for computer status change window opens.

     Editing ticketing settings for multiple computer statuses is useful if you want to assign the same ticketing settings to these computer statuses. If you want the ticketing settings to be different, edit them individually for each computer status.

   You can edit the following ticketing settings:

   • On / Off (or, in the main window, the toggle button)—Enable or disable ticket creation for the selected status changes.
   • Queue—Select the queue in which to put the created ticket. The drop-down list contains the names of the Autotask queues. By default, the tickets are put in the Monitoring Alert queue. This setting is required.
   • Priority—Select the priority level for the tickets created in Autotask. Assigning priority levels to the tickets created for computer status change is used to prioritize corresponding Autotask tickets. The ticket priority allows you to respond to the issues in order of their importance, so that more urgent problems can be resolved sooner. The default priority for Critical computer statuses is Critical, and for Warning computer statuses it is Medium. If one of these basic priority values is deleted in Autotask, the default value is blank. This setting is required.
   • Due—Specify the time interval during which the ticket issue must be resolved and the ticket must be closed. The default value for Critical computer statuses is 12 hours, and for Warning computer statuses it is 24 hours.
   • Work type—Select the work type to be assigned to the ticket. This setting is present only in the Ticketing settings for computer status change window.
   • Issue type—Select the Autotask issue type to be assigned to the ticket. This setting is present only in the Ticketing settings for computer status change window.
   • Issue subtype—Select the Autotask issue subtype to be assigned to the ticket. This setting is present only in the Ticketing settings for computer status change window.

   

   Ticketing settings for computer status change window

4. When you finish configuring ticketing for computer statuses, click the Save changes button to save the ticketing settings.

   Ticketing for computer statuses is configured and Autotask tickets will be created in accordance with the specified rules.

Kaspersky Security Integration Service for MSP can create Tickets only for active Autotask accounts. Therefore, make sure that the Active check box is selected in the account properties.

You can cancel changes and reset ticketing settings to their last saved values.

To cancel changes of ticketing settings and restore last saved values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab solution name, and then select the Warning status or Critical status section.
3. Click the Cancel changes button.

You can also reset ticketing settings to their default values.

To reset ticketing settings to their default values:

1. Open the Ticketing tab.
2. In the left pane, click the Kaspersky Lab solution name, and then select the Warning status or Critical status section.
3. Click the Reset to defaults link.

Page top

[Topic 149608]

Mapping Autotask services to security applications

Set up mapping between Kaspersky Lab security applications and Autotask services, so that usage information about Kaspersky Lab security applications appears in Autotask as Service Adjustments to existing contracts.

On the Services tab of the Kaspersky Security Integration Tool for MSP window, you can map Kaspersky Lab security applications to Autotask services. You can edit the existing mapping between security applications and services as well.

The list of available security applications differs depending on which Kaspersky Lab solution you use: Kaspersky Security Center or Kaspersky Business Hub.

Mapping Kaspersky Lab security applications to Autotask services

To set up mapping between Kaspersky Lab security applications and Autotask services:

1. In the Kaspersky Security Integration Tool for MSP window, click the Services tab.
2. To differentiate the pricing policy for two types of devices (servers and workstations), use the Bill devices by category toggle button to turn on this feature.
3. Map Kaspersky Lab security applications in the Kaspersky Lab security application column to their equivalents in the Autotask service column.

   If the Bill devices by category feature is disabled, each Kaspersky Lab security application can be mapped to one Autotask service only. Otherwise, map each Kaspersky Lab security application to three Autotask services:

   1. In the Windows workstations drop-down list, select an Autotask service. The price of this service will be used during billing for all of the workstations that use the license for the corresponding Kaspersky Lab security application.
   2. In the Windows servers drop-down list, select an Autotask service. The price of this service will be used during billing for all of the servers that use the license for the corresponding Kaspersky Lab security application.
   3. In the Non-Windows devices drop-down list, select an Autotask service. The price of this service will be used during billing for all of the non-Windows devices that use the license for the corresponding Kaspersky Lab security application.
4. When you have finished with mapping, click the Save changes button to save the mapping.

[Topic 150839]

Viewing accounts not integrated with Kaspersky Lab security applications

When configuring integration with Autotask, it is useful to check whether all Autotask accounts are connected to Kaspersky Security Center virtual servers / Kaspersky Business Hub companies, or whether you accidentally skipped one or more accounts. For this purpose, you can use Autotask reports that allow you to display all existing Autotask accounts together with the virtual servers or companies to which they are mapped.

Kaspersky Security Integration with Autotask adds its own fields to the Autotask configuration. You can use these fields in different reports. For example, using standard Autotask functionality, you can select clients that are not integrated with Kaspersky Security Center or Kaspersky Business Hub—that is, the clients whose accounts do not have a corresponding virtual server or company. Then you can manually, using filters, exclude the accounts that do not use Kaspersky Lab security applications from your selection.

To view Autotask accounts that are not mapped to virtual servers or companies:

1. Log in to Autotask with your user name and password.
2. In Autotask, create a report, using Autotask LiveReports Designer. Your report must include the following fields:
   • Autotask account name.
   • Corresponding virtual server / company name.

   Refer to Autotask documentation for details on creating reports.

3. Filter your report data by the name of the virtual server or company.

   If the name of the virtual server or company is empty, the account is not mapped to any virtual server or company.

[Topic 173479]

Configuring integration by using the registry

By using the Microsoft Windows registry, you can configure the integration as follows:

• Enable or disable tracing.
• Change the maximum time before updated integration settings are applied.

Enabling and disabling tracing

Refer to the "Enabling and disabling tracing by using the registry" section.

Changing the maximum time before updated integration settings are applied

After you update integration settings in Kaspersky Security Integration Tool for MSP, Kaspersky Security Integration Service for MSP applies them not immediately but within a certain time interval. By default, this interval is 15 minutes. If you use an on-premises version of a Kaspersky Lab solution, you can change the interval by using Microsoft Windows registry, as described later in this section. For a Cloud version of a Kaspersky Lab solution, the interval is specified by Kaspersky Lab specialists.

To change the maximum time before updated integration settings are applied:

Before editing the Windows registry, it is recommended that you back up the registry.

1. Click the Start button.
2. In the Start menu, in either the Run box or the Search box, type regedit and press Enter.

   The Registry Editor window opens.

   If you have restricted access to the Windows computer to which you are logged in, you might not be able to access the registry.

3. In the Registry Editor window, navigate to the Kaspersky Security Integration Service for MSP registry key. It is available by one of the following registry subkeys (paths):
   • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Service for MSP
   • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Service for MSP
4. Edit the value of the ConfigReloadIntervalMinutes setting by specifying the required number of minutes.
5. Click OK in the Edit window to save your changes.
6. Close the Registry Editor window.

The value is changed.

Page top

[Topic 150693]

Managing administrators

You can manage the administrators related to the integration with Kaspersky Business Hub. You can add the accounts of existing Kaspersky Business Hub users as administrators of your integration. You can also remove administrators from the integration if you do not want them to work with the integration.

You can manage administrators within the integration only if Kaspersky Business Hub solution is used. For Kaspersky Security Center solution, this functionality is unavailable.

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

When you remove administrators from the integration, these administrators 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.

All remaining administrators who have access to the integration can add or remove administrators to / from this integration.

Managing administrators

The following sections explain how to add or remove an administrator to / from the integration.

[Topic 141394_1]

Adding administrators

When you add administrators to an integration, they have the same rights as existing administrators: they can administer Kaspersky Endpoint Security Cloud workspaces and Kaspersky Security for Microsoft Office 365 workspaces of all Kaspersky Business Hub companies bound to this integration and can manage the integration settings.

To add administrators:

1. In the Kaspersky Security Integration Tool for MSP window, click the Administrators tab.
2. Click the Add link to add administrators.
3. 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 Business Hub can be added to the integration.

4. 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.
5. After you perform all the actions with administrators' accounts, click the Save changes button.

The new administrators are added to the integration and gain access to all workspaces within this integration.

[Topic 141396_1]

Removing administrators

When you remove administrators from an integration, they can no longer manage the integration. However, the administrators' Kaspersky Lab accounts are not deleted; they are merely unbound from the integration, so that the administrators cannot manage the integration or administer its workspaces.

To remove administrators:

1. In the Kaspersky Security Integration Tool for MSP window, click the Administrators tab.
2. Select the check boxes next to the names of administrators you want removed from the integration.

   If you want to select all administrators, select the check box in the column header.

   You cannot remove all administrators from the integration. An integration must have at least one administrator.

3. Click the Delete link to remove the selected administrators.
4. After you perform all the actions with the administrators' accounts, click the Save changes button.

The selected administrators are removed from the integration and lose their rights to administer workspaces bound to the integration.

Page top

[Topic 149862]

Enabling and disabling tracing

The following sections explain how to enable and disable tracing for Kaspersky Security Integration with Autotask components.

You may have to save traces of Kaspersky Security Integration with Autotask, for example, if you contact Technical Support and they ask you to provide the traces for diagnostics and troubleshooting. It is recommended to disable tracing when an issue is resolved, as tracing requires additional resources and additional memory to store trace files. It is also recommended to remove trace files from your computer after the issue that required tracing is resolved, because the trace files may contain personal and confidential data.

By default, tracing is disabled.

There are two ways of enabling and disabling tracing for Kaspersky Security Integration with Autotask components:

• Using the Microsoft Windows registry.
• In the .config files of Kaspersky Security Integration with Autotask components.

[Topic 149864]

Enabling and disabling tracing by using the registry

You can enable and disable tracing by using the Microsoft Windows registry.

To enable or disable tracing:

Before editing the Windows registry, it is recommended that you back up the registry.

1. Click the Start button.
2. In the Start menu, either in the Run box or the Search box, type regedit and press Enter.

   The Registry Editor window opens.

   If you have restricted access to the Windows computer you are logged into, you might not be able to access the registry.

3. In the Registry Editor window, navigate to the Kaspersky Security Integration Service for MSP or Kaspersky Security Integration Tool for MSP registry key. They are available by one of the following paths:
   • Kaspersky Security Integration Service for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Service for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Service for MSP
   • Kaspersky Security Integration Tool for MSP

     If the Kaspersky Security Integration Tool for MSP registry key is not displayed, either run Kaspersky Security Integration Tool for MSP as administrator (by right-clicking the application icon and selecting Run as administrator), or create the registry key manually.

     • HKEY_LOCAL_MACHINE\SOFTWARE\KasperskyLab\Kaspersky Security Integration Tool for MSP
     • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\KasperskyLab\Kaspersky Security Integration Tool for MSP
4. Edit the value of the EnableTraces parameter as follows:
   • 1—To enable tracing.
   • 0—To disable tracing.
5. Click OK in the Edit window to save your changes.
6. Close the Registry Editor window.

The trace files are saved to the .log files in the application installation folder:

• For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.log, by default saved to the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
• For Kaspersky Security Integration Service for MSP the file is IntegrationServer.log, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.

When you uninstall Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP, the trace files are removed together with the application.

Page top

[Topic 149863]

Enabling and disabling tracing by using the .config files

You can enable and disable tracing in the .config files of Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP. The files are stored in the installation folders of the corresponding products.

To enable or disable tracing:

1. Navigate to the .config file of the Kaspersky Security Integration with Autotask component for which you want to enable or disable tracing. The .config file is stored in the installation folder. By default, the navigation paths are:
   • For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.exe.config, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
   • For Kaspersky Security Integration Service for MSP the file is IntegrationServer.exe.config, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.
2. Open the .config file with any text editor and change the value of the minlevel attribute of the logger element as follows:
   • To enable tracing, set the value of the minlevel attribute to Debug.

     <logger name="MSPIntegration.*" writeTo="fileTarget" minlevel="Debug" />

   • To disable tracing, set the value of the minlevel attribute to Off.

     <logger name="MSPIntegration.*" writeTo="fileTarget" minlevel="Off" />

3. Save and close the modified .config file.

The trace files are saved to the .log files in the application installation folder:

• For Kaspersky Security Integration Tool for MSP the file is IntegrationUI.log, by default saved to the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Tool for MSP folder.
• For Kaspersky Security Integration Service for MSP the file is IntegrationServer.log, by default stored in the C:\Program Files (x86)\Kaspersky Lab\Kaspersky Security Integration Service for MSP folder.

When you uninstall Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP, the trace files are removed together with the application.

Page top

[Topic 160066]

Reporting

This section describes how to create different types of reports for managed Kaspersky Security Center virtual servers or Kaspersky Business Hub companies in Autotask.

[Topic 160067]

Service report

You can create a regular service report for a representative of a managed company. This report includes statistics on protection services provided to the client. You can view this report for the last 30 days and the last 7 days. Kaspersky Security Integration with Autotask updates statistics daily.

A report can be built for a particular managed company linked to Kaspersky Security Center virtual server or Kaspersky Business Hub company, by using the standard Autotask LiveReports Designer.

A generated report includes statistics on tickets processed during the report period and on the state of managed computers in the customers’ infrastructure.

A service report includes the following data:

• Report period—Either 7 days or 30 days.
• Report starting date
• Report ending date
• Managed computers—Number of computers of the managed company that are connected to the Kaspersky Security Center virtual server or Kaspersky Business Hub company.
• Protected computers—Number of computers on which a real-time protection application is installed.
• New critical tickets—Number of tickets based on critical events or computer statuses that were created by Kaspersky Security Integration with Autotask during the report period (regardless of whether or not these tickets were closed during the report period). Tickets based on events are created according to the rules that you set as described in Ticketing for events. Tickets based on computer statuses are created according to the rules that you set as described in Ticketing for computer statuses.
• Closed critical tickets—Number of tickets based on critical events or computer statuses that were resolved and closed by Kaspersky Security Integration with Autotask during the report period (regardless of whether or not these tickets were created during the report period).
• New warning tickets—Number of tickets based on warning events or computer statuses that were created by Kaspersky Security Integration with Autotask during the report period (regardless of whether or not these tickets were closed during the report period).
• Closed warning tickets—Number of tickets based on warning events or computer statuses that were resolved and closed by Kaspersky Security Integration with Autotask during the reporting period (regardless of whether or not these tickets were created during the report period).
• New functional failure tickets—Number of tickets based on functional failure events that were created by Kaspersky Security Integration with Autotask during the reporting period (regardless of whether or not these tickets were closed during the report period).
• Closed functional failure tickets—Number of tickets for functional failure events that were resolved and closed by Kaspersky Security Integration with Autotask during the report period (regardless of whether or not these tickets were created during the report period).
• Problem computers—Number of computers whose status is other than OK at the moment the configuration item is created.

[Topic 160068]

License report

You can create a license report for a client company to provide information about keys for the Kaspersky Lab security applications, including key usage and availability.

A license report includes the following data for each key:

• Report date—Last update date of the configuration item.
• License ID
• Security application name
• License period
• License expiration date
• License restriction—Number of computers to which the key can be assigned.
• Number of company's computers using the license—Number of computers to which the key is assigned. These computers belong to the selected client company.
• Total number of computers using the license—Number of computers to which the key is assigned. These computers belong to all client companies of the MSP or to the MSP itself.
• Key is more than 90% used—If the total number of computers that use the key divided by the license restriction is greater than 0.9, the value is Yes. Otherwise, the value is No.
• Key exceeded restriction—If the total number of computers that use the key divided by the license restriction is greater than 1, the value is Yes. Otherwise, the value is No.
• License information—Additional information about the key.
• Support information—Information about Technical Support contacts.