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 Tigerpaw 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.

Tigerpaw parameters

To set up connection with Tigerpaw, you must provide Tigerpaw API connection parameters.

Kaspersky Security Integration with Tigerpaw uses the ASMX and REST APIs of Tigerpaw, and so you must specify both sets of connection parameters in Kaspersky Security Integration Tool for MSP. These parameters are used by Kaspersky Security Integration Tool for MSP and Kaspersky Security Integration Service for MSP to access Tigerpaw and to set up and synchronize integration data between your Kaspersky Lab solution and Tigerpaw. This is data such as accounts, service orders, agreements, price book items, and additional charge.

The following sections describe how to perform the setup:

• ASMX API parameters: SOAP user name and password.
• REST API parameters: public key and private key.

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 Tigerpaw accounts.

For each client company represented by an account in Tigerpaw, 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.

Configuring ASMX API connection parameters

This section describes how to create a new ASMX API user. This API user is used by the integration to access Tigerpaw ASMX API.

To create a new ASMX API user:

1. Install the Tigerpaw API Users utility. For detailed instructions, refer to Tigerpaw documentation.
2. In Tigerpaw, add an external product for Kaspersky Security Integration with Tigerpaw:
   1. On the main menu, select Edit → Master Tables.
   2. In the Table Maintenance window that opens, expand Account → External Products.
   3. Click New on the toolbar.
   4. Specify the name of the external product for Kaspersky Security Integration with Tigerpaw, and click OK.
3. Start the tsiWS Users.exe utility (by default, it is located in the following folder: C:\Program Files (x86)\Tigerpaw Software\Tigerpaw API Tools).
4. In tsiWS Users.exe, create the API user for your integration:
   • Specify the Name and Password. You will need these settings later when, establishing connection with Tigerpaw, you specify the SOAP user name and password in Kaspersky Security Integration Tool for MSP.
   • Make sure that the Active and Allow user to list accounts via API check boxes are selected.
   • In the Product drop-down list, select the external product you created in step 2.

   For more details about how to configure API users, refer to the Tigerpaw documentation.

   After you perform the steps above, the user is added and will be displayed in the table. Use this user name and password as the SOAP user name and password when you provide the integration settings.

Page top

Configuring REST API connection parameters

This section describes how to obtain the API public key and API private key for the REST API. Public and private keys are displayed in the rep properties screen in Tigerpaw. Rep records identify users in Tigerpaw. You can either create a new API rep or select an existing one for your integration.

To obtain REST API public and private keys:

1. Start Tigerpaw.
2. On the Tigerpaw main menu select Edit → Master Tables.
3. In the Table Maintenance window that opens, in the tree view expand Rep → Account Reps.
4. Select an existing account rep for your integration or create a new one.

   For more details about rep records, refer to the Tigerpaw documentation.

   The security role of the rep account that you select for your integration must provide enough rights to access all required Tigerpaw items. The items are:

   • Accounts (get, update).
   • Recurring agreements (get, create, update).
   • Master tables (get, create, update).
   • Price book items (get).
   • Service orders (get, create, update)
   • Custom folders and fields (get, create, update).
5. View the properties of an existing account rep by double-clicking it in Rep Name column of the table, or create a new account rep for the REST API by clicking New on the toolbar in the Table Maintenance window.
6. In the Account Rep Maintenance window that opens, click the Admin tab and in the REST API Security section view the public and private keys of the existing account rep or click the Generate button to create the public and private keys for a new account rep.
7. Make a note of the public and private keys or copy them to the Clipboard. You will have to specify these keys when you configure integration with Tigerpaw.

Page top