ConnectWise Configuration
Updated Sep 27, 2023If you are using old hardware or software to host your ConnectWise instance, you may be blocked from integrating your ConnectWise environment with Arctic Wolf. The Arctic Wolf ITSM integration uses a callback mechanism to a self-hosted Arctic Wolf URL. This webhook is secured by Arctic Wolf and requires that your TLS ciphers are up to date, following ELBSecurityPolicy-TLS13-1-2-2021-06
from AWS.
TLS protocols:
Protocol-TLSv1.2
Protocol-TLSv1.3
TLS ciphers:
TLS-AES-128-GCM-SHA256
TLS-AES-256-GCM-SHA384
TLS-CHACHAZO-POLY1305-SHA256
ECDHE-ECDSA-AES128-GCM-SHA256
ECDHE-RSA-AES128-GCM-SHA256
ECDHE-ECDSA-AES128-SHA256
ECDHE-RSA-AES128-SHA256
ECDHE-ECDSA-AES256-GCM-SHA384
ECDHE-RSA-AES256-GCM-SHA384
ECDHE-ECDSA-AES256-SHA384
ECDHE-RSA-AES256-SHA384
Configure ConnectWise integration
This guide outlines how to configure ConnectWise® to sync incident tickets with Arctic Wolf.
Requirements
- A ConnectWise account with administrator access.
- ConnectWise version 2022.1 or higher.
Before you begin
- If you have a self-hosted ConnectWise instance, add the Arctic Wolf IP ranges to your allowlist. To see the complete list of IP addresses that you must allowlist, go to the Arctic Wolf Unified Portal, and then click Help > Allowlist Requirements. The IP addresses that must be allowlisted are listed under Third-Party Managed Service Integrations.
Steps
- Create a security role.
- Select a service board.
- Select a status for syncing with Arctic Wolf.
- Generate API keys.
- View Company ID.
- Provide credentials to Arctic Wolf.
- Provide integration information to Arctic Wolf.
Step 1: Create a security role
-
Sign in to your ConnectWise instance.
-
In the navigation menu, click System > Security Roles.
-
Click New Item.
-
Enter a name for the new role in the Role ID field.
-
Click Save.
-
On the Security Roles page, click the newly created role. The Security Modules page opens.
-
Click System
-
Next to Table Setup, click Customize. The Update Security dialog opens.
-
Make sure these permissions are listed under Allow Access to these. If any are listed under Disallow Access to these, select the permission name and click <.
- Company / Company Statuses
- Company / Company Type
- Service / Priority
- Service / ServiceBoard
-
Click Save to close the Update Security dialog.
-
Configure these permissions:
Category Permission name Add Level Edit Level Delete Level Inquire Level Companies Company Maintenance None None None All Companies Manage Attachments All None None All Service Desk Close Service Tickets All All None All Service Desk Service Ticket - Dependencies All All None All Service Desk Service Tickets All All None All System Table Setup None None None All -
Click Save.
Step 2: Select a service board
All tickets that are synced to Arctic Wolf must use the same ConnectWise service board. If you want to use an existing service board for the integration instead of creating a new board, proceed to Select a status for syncing with Arctic Wolf.
Otherwise, to create a new board:
- In the navigation menu, click System > Setup Tables > Search.
- Search for and select
Service Board
in the Table column. The Service Board List page opens. - Click New Item to create a new service board.
- Fill in the remaining required fields and click Save.
Step 3: Select a status for syncing with Arctic Wolf
The status field is used to mark a ConnectWise ticket for Arctic Wolf. Any tickets that are saved with the selected status will start to sync with Arctic Wolf. After syncing has started, changing the status does not affect the syncing.
If you want to use an existing status instead of creating a new status, proceed to Generate API keys.
Otherwise, to create a new status:
- From the Service Board List page, select the board from Select a service board.
- Click the Statuses tab.
- Click New Item to create a new status.
- Under Status Description, enter a descriptive name for the status, for example
Notify Arctic Wolf
. - Fill in the remaining required fields and click Save.
Step 4: Generate API keys
-
In the navigation menu, click System > Members.
-
Click the API Members tab.
-
Click New Item to create a new API member for Arctic Wolf.
-
Under Role ID, select the role created in Create a security role.
-
Under Default Board, select the board from Select a service board.
-
Fill in the remaining required fields and click Save.
-
Click the API Keys tab.
-
Click New Item to create a new API key.
-
Give the key a description and click Save.
-
Copy the generated keys for the created API member to a secure location. You must provide these keys to Arctic Wolf as part of Provide credentials to Arctic Wolf.
Note: The private key is permanently hidden after you leave this page.
Step 5: View Company ID
- In the navigation pane, click Companies > Companies.
- On the Company listing page, make note of the Company ID value for the company that Arctic Wolf sends tickets to. This will be provided to Arctic Wolf in Provide integration information to Arctic Wolf.
Step 6: Provide credentials to Arctic Wolf
Note: If you are an MSP, only submit your credentials for the parent company hosting the ConnectWise PSA or Manage tenant.
-
Sign in to the Arctic Wolf Unified Portal.
-
In the menu bar, click Telemetry Management > Connected Accounts.
-
Click Add Account +.
-
On the Add Account page, from the Account Type list, select ITSM Ticketing Integration.
-
From the list of cloud services, select ITSM ConnectWise Account.
-
On the Add Account page, complete these steps:
- Account Name — Enter a unique and descriptive name for the account.
- Enter the absolute URL that you use to access your ConnectWise instance, using the format
https://example.connectwise.com
. - Enter the company identifier that you enter on the ConnectWise sign in page. This is usually a string of alphanumeric characters.
- Enter the public and private keys from the API member created in Generate API keys.
- Credential Expiry — (Optional) Enter the expiration date if the credentials have an expiry date.
-
Click Test and Submit Credentials.
Step 7: Provide integration information to Arctic Wolf
- Send this integration information to your Arctic Wolf team through your usual ticketing workflow:
- ConnectWise board — The service board from Select a service board.
- ConnectWise status — The status from Select a status for syncing with Arctic Wolf.
- ConnectWise note types — The ConnectWise note type that you want to use when replying to an Arctic Wolf ticket, and the note type that you want Arctic Wolf replies marked as. One of:
- Discussion
- Internal
- Resolution
- Priority mappings — The priority levels in your ConnectWise instance that correspond to low, medium, high, and urgent priority tickets from Arctic Wolf.
- Closure state — The ConnectWise ticket state that Arctic Wolf should use to mark a ticket as resolved.
- Re-opening state — The ConnectWise ticket state that Arctic Wolf should use to mark a ticket as unresolved or re-opened.
- ConnectWise Company ID — The value from View Company ID.
Create a ConnectWise ticket for Arctic Wolf
After you have configured the ConnectWise integration, you can create a ticket for any incident.
Notes:
- The email address of the person creating the ticket in ConnectWise must be listed as a contact of your organization with Arctic Wolf.
- Markdown formatting in comments is not synced between your organization and Arctic Wolf.
- Attachments added through the Attachments tab are only synced to Arctic Wolf after a comment has been added to your ticket. To make sure that your attachment is received promptly, we recommend using a New Note to send attachments.
- In your ConnectWise instance, create a new ticket.
- Under Company, select the organization that this incident relates to.
- Select a Contact who is listed as a contact of your organization with Arctic Wolf.
- Under Board, select the board from Select a service board.
- Under Status, select the status from Select a status for syncing with Arctic Wolf.
- Fill in the remaining required fields and click Save to create the ticket and begin syncing with Arctic Wolf.
- To add comments and attachments for Arctic Wolf after your ticket is created:
-
Click New Note.
-
Select the Discussion checkbox.
-
Add comments and attachments as needed.
Note: Make sure that the total attachment size is less than 50 MB, and that all attachments are submitted with a comment.
Tip: Click Show Options in the attachments dialog to change the accepted file formats.
-
Click Save.
-