NEW

ConnectWise PSA Integration

Automate ticket creation from WithSecure™ Elements to ConnectWise PSA and learn how to configure the integration.

The WithSecure™ Elements integration with ConnectWise PSA automatically forwards security activity from Elements into ConnectWise PSA as tickets. This lets MSPs manage WithSecure detections and notifications inside the same PSA tool they already use for service delivery, without manual ticket creation.

What this integration does

  • Automated ticketing — WithSecure™ Elements creates tickets in ConnectWise PSA when there is relevant activity for a mapped customer.
  • Per-customer routing — Tickets are routed to the correct ConnectWise PSA customer using the customer’s ConnectWise PSA reference ID.
  • Deep links back to Elements — Each ticket includes basic information about the Elements Security Center activity, along with a deep link to the full details in WithSecure.
  • Native and multi-tenant — The integration is built into Elements, supports multiple customer tenants, and is configured entirely from the Elements Security Center.

Before you begin

You will need:

  • A ConnectWise PSA account with permissions to create API keys.
  • Access to the WithSecure™ Elements Security Center as a WithSecure Partner.

Step 1: Create API keys in ConnectWise PSA

  1. Select My account from the user dropdown in the top-left corner.
  2. Select the API keys tab.
  3. Click the + icon to add a new API key:
    1. Set the description, e.g. WithSecure Elements.
    2. Click the Save icon to generate the public and private keys.
  4. Copy the public and private keys for use in the Elements Security Center.

To configure the integration you will need:

  • Company ID — the same ID used to log in to the ConnectWise PSA management console.
  • Public Key
  • Private Key

Step 2: Configure the integration in Elements Security Center

In the WithSecure™ Elements Security Center, go to the Management > Integrations section and locate the ConnectWise PSA integration.

Click Configure on the ConnectWise PSA component. The configuration dialog has four steps: Connection details, Data configuration, Result, and Test (optional). The configuration is saved on the Result step. Until then, go back to an earlier step with Previous or by clicking its name at the top of the dialog, and use Cancel or the X in the top-right corner to close the dialog without saving.

Connection details

The Connection details step of the ConnectWise PSA configuration dialog, with the Tenant, Company ID, Public Key, and Private Key fields

  1. Select your Tenant from the dropdown list (the same as your ConnectWise PSA management console URL).
  2. Set the Company ID (the same as your ConnectWise PSA management console Company ID).
  3. Enter the Public Key and Private Key copied from ConnectWise PSA.
  4. Click Connect to validate connectivity. When the connection succeeds, the dialog moves on to Data configuration.

When you open an integration that is already configured, the dialog shows that it is already configured and fills in the saved values. The Private Key is masked; leave it as it is to keep the saved key. If you change the Tenant, enter the private key again. Click Connect to continue to the settings.

Data configuration

The Data configuration step of the ConnectWise PSA configuration dialog, with the event types, service board, priority override, and severity thresholds

  1. Under Event types that create tickets, leave Endpoint BCD (Broad Context Detections on endpoints), Identity and Cloud BCD (Azure identity, Azure workload, and AWS workload incidents), and XM (Exposure Management Recommendations) selected, or clear a type that should not create tickets. All three are selected by default.
  2. Under Ticket destination, select the Service board where tickets will be routed. This is required while at least one event type is selected.
  3. Leave Override priorities off unless this ConnectWise account does not use the standard priority IDs. When you turn it on, map Critical, High, Medium, and Low to priorities from that account.
  4. Under BCD, set Minimum risk for tickets. It applies to both Endpoint BCD and Cloud BCD tickets. The default is High and above. Other choices are Info and above, Low and above, Medium and above, and Severe only. A threshold below Medium can create a large number of tickets. Waiting-for-customer, elevation, and risk-change updates can still create or update tickets.
  5. Under XM, set Minimum severity for tickets. The default is all severities (Info and above). Other choices are Warning and above and Critical only. Closed or accepted-risk recommendations never create tickets.
  6. Click Next.

If the service boards or priorities cannot be loaded from ConnectWise PSA, the error is shown next to the field. Next stays unavailable until the list loads or you turn off the option that needs it: clear all event types for Service board, or turn off Override priorities for the priorities.

Result

Review the settings and click Save. To change a setting first, click Previous to go back to Data configuration.

Test (optional)

The Test (optional) step of the ConnectWise PSA configuration dialog, with the company selector and the test ticket button

After you save, you can create a test ticket to check that ConnectWise PSA accepts tickets from Elements with these settings. A test ticket shows problems such as a service board that cannot be used, a mandatory field that Elements does not fill in, or missing API permissions, before the first real ticket fails.

  1. Select the Company for the test ticket. The list shows the companies in your ConnectWise PSA; no company mapping is needed yet.
  2. Click Create test ticket.
  3. Check the result:
    • Test ticket created shows a link to the ticket in ConnectWise PSA. This is a real ticket, so you can close or delete it in ConnectWise PSA.
    • Test ticket could not be created shows the error message from ConnectWise PSA. Click Edit settings to go back to Data configuration, change the settings, click Next and Save again, and create a new test ticket.
  4. Click Close. Creating a test ticket is optional; the configuration is already saved.

Step 3: Enable ticketing for a customer

Map your ConnectWise PSA companies to the corresponding WithSecure™ Elements companies. Ticket creation starts automatically for each mapped company.

  1. In the company mapping view, match each ConnectWise PSA company to its WithSecure™ Elements company.
  2. Click Save Mappings.

Mapping ConnectWise PSA companies to WithSecure Elements companies

Monitor tickets

Monitor the tickets you configured the integration to create in ConnectWise PSA. Each ticket contains basic information about the Elements Security Center activity and a deep link to the full details in WithSecure.

Troubleshooting

If tickets are not created as expected, open the integration with Configure, click Connect, Next, and Save, and create a test ticket on the Test (optional) step. It shows the error message from ConnectWise PSA directly.

You can also review the integration logs in the Elements Security Center:

  1. Go to the Management > Integrations section.
  2. Open the active ConnectWise PSA integration.
  3. Select Logs to review recent integration activity and error details.

Availability

This integration is available to WithSecure Partners in the Elements Security Center. It is not available for free trials or company-managed subscriptions. To access dedicated partner features, contact WithSecure.