When the AlienApp for ConnectWise is enabled and connected to your ConnectWise Manage environment, USM Anywhere sends data to automatically generate new service tickets from alarms and vulnerabilities and synchronize assets with the Configurations catalog. For more information about these AlienApp for ConnectWise response actions, see AlienApp for ConnectWise Orchestration.
Important: Before you configure the AlienApp for ConnectWise, make sure to review the requirements.
A configured connection also provides a UI integration, so that you can access USM Anywhere directly from your ConnectWise Manage console. For more information about this feature, see USM Anywhere and ConnectWise Manage UI Integration.
A set of ConnectWise Manage API keys are required to authenticate USM Anywhere for communications with ConnectWise Manage.
Important: The Private Key is visible only at the time that you generate the API keys. After that, it is no longer accessible. It is a best practice to make a copy of both the Public and Private Keys and store them in a secured location.
To get the API keys
- Log in to your ConnectWise Manage account using the web UI or client application.
- Navigate to System > Members and click the API Member tab.
If you do not already have a member that you can use for the integration, create a new API Only Member.
Note: Although it is a best practice to use an API Member account for integrations, you can create API keys from your current member account. API Members do not require a Manage License and cannot access the Manage UI.
The member account that you use must have the AdministratorRole ID to generate the API Keys.
- Click the New Item icon ( ) and define the new member.
- Click the Save icon ( ).
- Select the API Keys tab.
- Click the New Item icon ( ) and enter a Description for Public API Key.
Click the Save icon ( ).
The page displays both the public and private API keys.
- Copy both of the key values to a secured location.
To enable AlienApp for ConnectWise functions, you must configure a connection with your ConnectWise Manage environment and define the associated customer (managed company). This connection enables the AlienApp to perform operations using the ConnectWise Manage REST APIs.
To configure the ConnectWise Manage connection
- In USM Anywhere, go to Data Sources > Integrations.
Click the AlienApps tab.
In the AlienApps page, click the ConnectWise tile.
The page displays the Status tab, but it does not provide status information until the AlienApp for ConnectWise is enabled and configured.
If you have more than one deployed USM Anywhere Sensor, select the Sensor that you want to use for the enabled AlienApp.
USM Anywhere AlienApps operate through a deployed Sensor and use APIs to integrate with the connected third-party technology. Choose the Sensor that can access the integration endpoint. The HTTPS connections to the API will originate from this Sensor.
- Click Enable.
- Select the Settings tab.
Specify the connection information.
Manage site URL — Select the site you use to access your ConnectWise Manage environment.
For example, if you access the browser version of ConnectWise Manage at https://mysite.connectwise.net, you specify mysite.connectwise.net for this option.
- Company — Enter the company name that you use when you log into your ConnectWise account.
Managed company — Enter the company ID that you want to associate with the USM Anywhere deployment.
This is the company ID of an active company (customer) already specified in your ConnectWise Manage environment. You can use the Company Search function in ConnectWise Manage to locate the correct Company ID.
- Member — Enter the name for the member account that you used to generate the API keys.
- Board name — Enter the name for the ConnectWise board where you want to manage the created service tickets.
Add the public and private keys that you generated in ConnectWise Manage.
- Click Change Public Key and paste the copied public key value in the text box.
- Click Change Private Key and paste the copied private key value in the text box.
(Optional) If you want to use your own SSLProtocol used for transmitting private documents through the Internet. SSL works by using a public key to encrypt data that's transferred over the SSL connection. See also transport layer security. certificate for connection to your ConnectWise environment, select the Require CA certificate checkbox and enter the certificate in the CA certificate field.
The SSL certificate must be configured in ConnectWise. For more information about ConnectWise SSL support and enablement, refer to the ConnectWise documentation (requires a ConnectWise University login).
(Optional) If you want to synchronize assets discovered by USM Anywhere with the Configurations defined in ConnectWise Manage, select the Automatically sync assets with Manage? checkbox.
When this option is selected, USM Anywhere runs an automated job once per hour to update the Configurations catalog in ConnectWise Manage to add or update discovered assets.
- Click Save.
Select the Status tab to verify the connection.
After USM Anywhere completes a successful connection to the ConnectWise Manage REST APIs, this tab displays icons in the HEALTH column.
If you see the icon, this indicates that there is a problem with the connection. The MESSAGE column provides information about the issue. If this is the case, repeat the steps to fix the configuration or troubleshoot your ConnectWise connection.
Related Video Content
To view other related training videos, click here.