ConnectWise

Overview

HYAS Protect for ConnectWise PSA enables security operations teams and MSPs to automatically generate service tickets in ConnectWise PSA when threats are detected by HYAS Protect. This integration ensures your team can immediately act on security events from within your existing workflows, helping you detect, triage, and resolve incidents faster.

Prerequisites

• Admin access to ConnectWise PSA

• HYAS Protect administrator account

• API Member credentials created in ConnectWise PSA

• An available Service Board in ConnectWise PSA for security alerts

Configuration

Initial configuration is made simple by HYAS Protect’s self-service integration. Follow along as we guide you through the process.

ConnectWise API Configuration

This outlines the required permissions for API endpoints used in HYAS Protect integration with ConnectWise PSA. Ensure the API member's security role includes these permissions to access and interact with the specified endpoints.

Permissions Breakdown

Step-by-Step Instructions: Setting Up Permissions

1. Log in to ConnectWise PSA: Access the admin console with sufficient permissions to modify roles.

2. Create or Edit a Security Role: Navigate to System > Security Roles, then create a new role or edit
   an existing one.

3. Assign Required Permissions: Use the table above to set up the necessary permissions:

   1. Module: Ensure the correct module (e.g., System, Companies, Service Desk) is selected.

   2. Function: Assign the appropriate function (e.g., Member Maintenance, Service Tickets).

   3. Permission Level: Grant the required level, either Inquire (All) or Add (All).

4. Save the Role: Once the permissions are configured, save the role.

5. Assign the Role to the API Member: Go to System > Members, locate the API member, and assign the security role.

6. After saving your changes to the API member, go to the API Keys tab to create your API key pair.

   1. Navigate to Settings>Members and then select the user you wish to view or generate an API key for.

   2. Select the ‘API Keys tab’

   3. Click ‘+' to create a new API Key or view your existing API Key (public only) under 'Public API Key’.

7. Test API Access: Use the API member credentials to test the endpoints and ensure they work as
   expected.

HYAS Setup

• Navigate to apps.hyas.com to login to HYAS.

• Click on the settings icon in the top right of the screen and navigate to ‘MSSP Settings’

• Then, click on ‘ConnectWise’

• Now, fill in the Site, Company ID, Public Key and Private Key to initiate communication between HYAS Protect and ConnectWise.

  

• If you do not know your ‘Site’ or ‘Company ID’, please contact ConnectWise.

• Once you have your Public and Private API keys, enter them in the appropriate sections in the ConnectWise configuration page in the HYAS Protect UI (above).

• Click on ‘Verify Setup’.

• If the setup is successful, you’ll receive the following confirmation:

• If the setup is unsuccessful, you’ll receive the following error:

• If you receive an error, please verify that the credentials were entered correctly. If the error continues, reach out to ConnectWise to verify your credentials.

• Once your set up has been verified successfully, click ‘Save’

Companies

The next step in the configuration process is to map your HYAS Protect Companies to your ConnectWise Companies. This is done so that when alerts are triggered, they reflect with the correct company.

• See the Getting Started Guide to create and manage users/companies in HYAS Protect.

• HYAS Companies will automatically populate on the left based on the companies you’ve setup in HYAS.

• ConnectWise Companies will automatically populate the dropdown list based on those you’ve configured in ConnectWise.

• As you assign company mappings, the entries are saved automatically.

  

• After mapping all of your companies, it’s time to move to the final step, Services.

Services

In the Services tab, you can enable ticket creation and configure the information to be included in those tickets.

• If you wish to enable ticket creation in ConnectWise, toggle the ‘Enabled’ slider to the on position as shown below.

• Next, navigate to the four drop downs under the ‘Ticket Service’ section. Each of these drop downs contains information directly sourced from ConnectWise and is configurable via the ConnectWise UI.

• Select the desired values for Service Board, Status, Priority and Type.

• Click ‘Save’

• You’re ll set! Your ConnectWise, HYAS Protect integration is complete!

Sample ConnectWise Ticket

Below is what a ticket generated in ConnectWise based off a blocked DNS query in HYAS Protect.

• Note that the Board, Status, Type and Priority are the values selected in the HYAS Protect UI under the Services section.

• Under ‘Initial Description’ and ‘Discussion’ (not pictured), you’ll find the date/time stamp, domain, and block reason(s) provided by HYAS Protect.

Troubleshooting

Tickets are not being created in ConnectWise

• Verify API credentials (Public/Private Key)

• Confirm role permissions are correctly assigned

• Ensure the service board exists and is spelled correctly

• Check for firewall or network restrictions

API authentication errors

• Regenerate keys in ConnectWise

• Re-enter them in HYAS Protect integration settings

Additional Information

Click the following links for additional information on setting up block lists, allow lists, category blocking & rulesets in HYAS Protect.