About Setting Up a New ConnectWise Manage Integration
To set up a new ConnectWise Manage integration, you must first do the following:
- Download and install the ConnectWise Manage Internet Client from the following location: http://www.connectwise.com/install
- In Barracuda RMM, you must create a new user with Administrator privileges that will be used exclusively by the ConnectWise Manage integration to send ticket updates back to Barracuda RMM.
Note: If you have global account policies that require regular password expiry, you must remember to change this account's password to prevent it from being locked out, which will break the integration.
- In ConnectWise Manage, generate Public and Private keys that will be used in the integration process.
To Generate Public and Private Keys in ConnectWise Manage
- Start ConnectWise Manage and log in.
- Click the System icon.
- Click the Members link.
- Click the API Members tab.
- Click the + button, and create a new member with the Admin role, then click Save.
- Click the Arrow button to go back to the Member page.
- Click the API member you created, then click the API Keys tab.
- Click the + icon.
- Type a description for the Key.
- Click the Save icon.
- Copy the Public Key and Private Key and keep them where you can find them.
Note: The Private Key is not available after you leave this page, so it’s important for you to copy it.
About Configuring a New ConnectWise Manage PSA Integration
Configure a new Barracuda RMM-ConnectWise Manage PSA integration by following these procedures in order:
Configuring the Integration in ConnectWise Manage
The following procedures describe how to configure the integration in ConnectWise Manage.
- Entering the Service Center Administrator Credentials in ConnectWise
- Configuring the Service Center Connection to the ConnectWise Web Service
- Configuring Barracuda RMM SNMP Assets in ConnectWise
Entering the Service Center Administrator Credentials in ConnectWise Manage
First, in ConnectWise Manage you must enter the login credentials for the Service Center Administrator user that you created in Barracuda RMM. These credentials will be used exclusively by ConnectWise Manage to send ticket updates back to Barracuda RMM.
As well, when you set up the credentials you must ensure the ConnectWise Manage asset sync is disabled. Barracuda RMM is responsible for syncing assets. This means that in order to avoid conflicting asset syncs, you need to disable asset syncing in ConnectWise Manage.
- Log into ConnectWise Manage PSA using an admin account.
- Under Setup, click Setup Tables.
- Search for and open the Management IT table.
- Click New to create a new Management Solution.
- In the Name field, type Barracuda RMM.
- From the Management IT Solution list, select Custom.
- In the Custom Solution Name box, type SyncOff.
- In the Username field, type the Service Center Administrator user name that was created for ConnectWise Manage.
- In the Password field, type the Service Center Administrator password.
Note: If this password is set to expire, integration with Barracuda RMM will need to be updated at that time. - Click Save.
Configuring the Service Center Connection to the ConnectWise Manage Web Service
You must configure a ConnectWise Manage User Name and Password that will be used exclusively by Service Center to communicate with the ConnectWise Manage Web Service. These credentials are known in ConnectWise Manage as an Integrator Login. If you don’t already have an Integrator Login created specifically for Barracuda RMM, then you can create one in the procedure below.
- Log into ConnectWise Manage PSA using an admin account.
- Under Setup, click Setup Tables.
- Search for and open the Integrator Login table.
- Click New to create a new user or select an existing user from the table.
- Type the ConnectWise Manage credentials (Username and Password) that Service Center will use to connect to the ConnectWise Manage web service.
- To require that any future configuration to the ConnectWise Manage service desk module requires a password re-entry, select the Require password re-entry to configure this service desk module check box.
- From the Access Level list, ensure All Records is selected.
- Ensure the Service Ticket API check box is selected.
- Select the Service Board that you used when Entering the Service Center Administrator Credentials in ConnectWise Manage.
- Do one of the following:
- For Barracuda-hosted On Premise customers, enter the Ticket Callback URL, formatted as shown in the example below:
<SCMessaging URL>/cwcallback.aspx?companyname=<Company ID>&vardomain=default&host=api-<ConnectWise Website Hostname>&recid=
Note: For hosted Service Centers, your SCMessaging URL is in the following format:
http://<xx00>.mw-rmm.barracudamsp.com/SCMessaging/ATCallback.aspx , where <xx00> is the name of the server where your Service Center is hosted, for example, eu02 or us01. - For other customers, enter the Ticket Callback URL, formatted as shown in the example below:
<SCMessaging URL>/cwcallback.aspx?companyname=<Company ID>&vardomain=<VAR Domain>&host=api-<ConnectWise Website Hostname>&recid=
For example: http://scmessaging.test.mycompany.com/cwcallback.aspx?companyname=HorizontalPlatforms&vardomain=Var1&host=api-myconnectwise.com&recid=
Note : For ConnectWise Manage 2017.4 and higher, prefix the domain name with "api-". For example, if you log in to ConnectWise Manage with "myconnectwise.com," use "api-myconnectwise.com".
Tip: In Barracuda RMM, you can get this URL and copy it into ConnectWise Manage. See Configuring the Ticket Status Mapping.
- For Barracuda-hosted On Premise customers, enter the Ticket Callback URL, formatted as shown in the example below:
- Ensure the following check boxes are selected:
- Managed Services API
- Company API
- Reporting API
- System API
- Click Save.
Configuring Barracuda RMM SNMP Assets in ConnectWise Manage
You must configure the integration for Barracuda RMM SNMP assets by following these two procedures:
To create a new Configuration Type for MW SNMP Devices
- Log into ConnectWise Manage PSA using an admin account.
- Under Setup, click Setup Tables.
- Search for and open the Configuration table.
- Click Configuration.
- Click New to create a new Configuration Type.
- In the Configuration Type box, type MW SNMP Devices.
- Click Save.
To create a new Managed Devices Solution name
- Log into ConnectWise Manage PSA using an admin account.
- Under Setup, click Setup Tables.
- Search for and open the Managed Devices Integration table.
- Click New to create a new item.
- In the Name box, type MW SNMP Devices.
- In the Solution box, type Barracuda RMM.
- Ensure the Integrator Login is set to the one you’ve configured for Barracuda RMM.
- Click Save.
- Click the Cross-References tab.
- Click New to create a new item.
- In the Type box, type MW SNMP Devices.
- From the Configuration Type list, select MW SNMP Devices.
- Click Save.
Configuring the Integration in Service Center
The following procedure describes how to configure and enable the ConnectWise Manage integration with Barracuda RMM.
- Installing the ConnectWise Manage Service Desk Module
- Configuring the Web Service Credentials
- Configuring the Setup Table Names
- Configuring Asset Synchronization
- Configuring the Service Board Mapping
- Configuring the Ticket Status Mapping
- Configuring Site Company Mapping
- Configuring Ticketing Options
Installing the ConnectWise Manage Service Desk Module
The ConnectWise Manage Service Desk Module is available in the Update Center, in Service Center.
Upgrades to the ConnectWise Manage Service Desk Module will be also be available in Update Center. For information on updating an existing ConnectWise Manage installation, see About Upgrading the ConnectWise Manage Service Desk Module.
- In Service Center, click Update Center > Components.
- Click Service Desk Modules.
- Click New.
- Select the check box beside ConnectWise Manage Service Desk Module.
- Click Install.
Configuring the Web Service Credentials
You need to name and describe (if desired) this integration. Then you need to provide the credentials needed for integration.
To complete this procedure, you’ll need the Public and Private Keys you generated in the To Generate Public and Private Keys in ConnectWise Manage procedure.
- In Service Center, click Configuration > Integrations > Service PSA Integrations.
- Click the ConnectWise Manage Service Desk Module link
- Modify the Name field, if required.
- In the Description field, type a description, if desired.
- In the Company ID field, type your ConnectWise Manage Company ID.
- In the Public Key field, paste the public key you generated in the To Generate Public and Private Keys in ConnectWise Manage procedure.
- In the Private Key field, paste the private key you generated in the To Generate Public and Private Keys in ConnectWise Manage procedure.
- To require that any future configuration to the ConnectWise Manage service desk module requires a password re-entry, select the Require password re-entry to configure this service desk module check box.
- In the Website URL, type the FQDN of your ConnectWise Manage PSA system (for example, https://api-connectwise.com).
Note: For ConnectWise Manage 2017.4 and higher, prefix the domain name with "api-". - Click one of the following:
- Next
- Management Solution Name on the right sidebar
The Company ID, User Name, Password and Website URL are all validated before you can continue.
Configuring the Setup Table Names
Barracuda RMM needs to know the Management Solution Name, Managed Devices Configuration Type and Managed Devices Solution name for the integration to work.
- In the Management Solution Name box, type the name.
To find the Management Solution Name, in ConnectWise Manage go to Setup Tables > Management IT and locate the name.
For example, LPI is the Management Solution Name. - In the Managed Devices Configuration Type box, type the name of the Managed Devices Solution.
If you followed the instructions in Configuring the Integration in ConnectWise Manage, you do not need to change this value. To find the Managed Devices Configuration Type, in ConnectWise Manage go to Setup Tables > Managed Devices Integration.
For example, MW SNMP Devices is the Managed Devices Configuration Type. - In the Managed Devices Solution box, type the name of the Managed Devices Solution.
If you followed the instructions in Configuring the Integration in ConnectWise Manage, you do not need to change this value. To find the Managed Devices Solution, in ConnectWise Manage go to Setup Tables > Managed Devices Integration.
For example, Barracuda RMM is the Managed Devices Solution. - Click one of the following:
- Next
- Asset Synchronization on the right sidebar
Configuring Asset Synchronization
On this page, you need to tell Barracuda RMM when to check for new assets and what to do with the devices that are added or deleted since the last sync. You can also click the Sync Now button to run a sync immediately or click View Log to see the assets collected for a specific sync.
- From the time popup, select a time or type a time when you want the asset synchronization to run daily.
- From the Status for Added Configurations list, select the status that new configurations will be set to when the corresponding device in Barracuda RMM is a newly discovered device. Select either Active or Inactive.
- From the Status for Deleted Configurations, select the status that existing configurations will be set to when the corresponding device in Barracuda RMM gets deleted. Select either Active or Inactive.
- If desired, click Sync Now or else the synchronization will start when you click Save. Note that the Sync button is enabled when you save the integration.
Tip: You can view the assets collected from a specific sync by clicking View Log in the Log Viewer section. Logs are deleted automatically after 14 days. - Click one of the following:
- Next
- Service Boards on the right sidebar
Important: Use only Active and Inactive in Status for Added Configurations and Status for Deleted Configurations. Editing these status options causes asset synchronization to fail.
Configuring the Service Board Mapping
The Service Boards screen displays all the active service boards in ConnectWise Manage. You must select one default service board that will automatically receive all of the tickets mapped from Barracuda RMM. You can specify additional service boards to synchronize with Barracuda RMM. When a ticket is moved from the default service board to one of these service boards, either manually or through an automated workflow, then ticket status updates will continue to be synchronized between Barracuda RMM and ConnectWise Manage. If you do not select a service board to map, when a ticket moves to that service board, the ticket status updates between Barracuda RMM and ConnectWise Manage will no longer occur.
- In the Is Default column, select the option button for the service board that you want to set as the default service board.
- Select the check box beside each additional service board that you want to map.
- Click one of the following:
- Next
- Ticket Status Mapping on the right sidebar
Configuring the Ticket Status Mapping
ConnectWise Manage and Barracuda RMM both allow you to apply a status to a service ticket. Because each system uses different terminology, you must map equivalent status descriptions between systems. See Entering the Service Center Administrator Credentials in ConnectWise Manage for the equivalent steps required in ConnectWise Manage.
Ticket status mapping between ConnectWise Manage and Barracuda RMM is two-way, which means that for each service board that you selected in the previous step, you can select the appropriate ConnectWise Manage service ticket status for ticket updates from Barracuda RMM, and you can select the appropriate Barracuda RMM ticket status for service ticket updates from ConnectWise Manage. This two-way mapping allows you to control how statuses are mapped when the number of statuses between the two systems is inconsistent. It is strongly recommended that you maintain consistency in status mappings between the two systems.
- In the first service board displayed in the Barracuda RMM to ConnectWise Manage Ticket Status Mapping area, for each Barracuda RMM ticket status, select a corresponding ConnectWise Manage service ticket status.
- Repeat step 1 for each additional service board in the Barracuda RMM to ConnectWise Manage Ticket Status Mapping area.
- In the first service board displayed in the ConnectWise Manage to Barracuda RMM Ticket Status Mapping area, for each ConnectWise Manage service ticket status, select a corresponding Barracuda RMM ticket status.
- Repeat step 3 for each additional service board ConnectWise Manage to Barracuda RMM Ticket Status Mapping area.
- Ensure you copy the Ticket Callback URL into ConnectWise Manage. See Configuring the Service Center Connection to the ConnectWise Manage Web Service.
- Click Next or click Site Company Mapping on the right sidebar.
Configuring Site Company Mapping
In this procedure, you map Barracuda RMM sites to the corresponding company names in ConnectWise Manage. Do this for each Barracuda RMM site you maintain.
- In the Barracuda RMM Site list, select a site.
- In the ConnectWise Manage Company list, select the corresponding company name.
- Click the Link button.
- Repeat steps 1-3 until all your sites have been mapped.
- Click one of the following:
- •Next
- •Ticketing Options on the right sidebar
Configuring Ticketing Options
You can configure what alerts from Barracuda RMM get sent to ConnectWise Manage.
- By default, all tickets are sent. You can filter the tickets that are sent by clearing the check box beside any of the following:
- To exclude site-based tickets, you can clear the All site-based tickets check box, or you can click the + icon beside this check box, and clear any of the following: Manual tickets, Site not communicating, Loss of monitoring protocol, and New device tickets.
- To exclude website-based tickets, clear the All website-based tickets check box.
- To exclude all device-based tickets, clear the All device-based tickets check box.
- To exclude device-level monitor tickets, click the + icon beside the All device-based tickets check box to expand it, and then clear the Device-level monitor tickets check box.
- To filter policy module tickets, click the + icon beside the All device- based tickets check box to expand it, and then select the Filtered policy modules option button. Click Add, and select the check box that corresponds with each policy module you want to add. Click Apply.
- To filter policy set tickets, click the + icon beside the All device-based tickets check box to expand it, and then select the Filtered policy sets option button. Click Add, and select the check box that corresponds with each policy set you want to add. Click Apply.
- Click Save.
This completes the basic Barracuda RMM-ConnectWise Manage integration that is possible without the MSP Add-on. If you have purchased the MSP Add-on, use the documentation provided by ConnectWise Manage to configure the deeper integration that the MSP Add-on makes possible.