ConnectWise Automate integration

If you’re new to integrations in Rewst, read through our introductory integration documentation here.

Why use the ConnectWise Automate integration?

Our ConnectWise Automate integration enables the automation of remote monitoring and management. Use the ConnectWise Automate API within Rewst workflows to perform actions such as endpoint management, remote monitoring, and IT automations.

Set up the ConnectWise Automate integration

Set up steps in ConnectWise Automate

To create a new ConnectWise Automate integration, you'll need to create a system integrator account.

1. Create a user class in ConnectWise Automate for our Rewst User:

   1. Log in to ConnectWise Automate Control Center using your administrator credentials.

      1. Navigate to Users and Contacts > User Class Manager in the System menu.

      2. Click + at the bottom left corner of the User Class Manager window.

      3. Enter Rewst Automationas the name for the new user class. Click OK.

      4. Set permissions:

         • Core Tab: Select the new user class and configure the necessary permissions on the "Core" tab.

         • Plugin Tab: If applicable, configure permissions for specific plugins on the "Plugin" tab.

      5. Click Save.

2. Click Settings in the bottom left corner.

3. Navigate to User Management.

4. Click Add in the top left.

5. Set the First Name, Last Name, Email, User Name, and Password.

   

   Our recommended setup information for the user
6. Click the User Classes tab.

7. Click Edit User Classes.

8. Select the Rewst Automation user class you configured earlier.

1. Check the Integrator box at the bottom.

2. Click Save.

If you have completed these steps and customers are not showing up when refreshing options, this is a permission issue. validate that you performed the steps above, and check to ensure the user class has access to customers.

Set up steps in Rewst

1. Navigate to Configuration > Integrations in the left side menu of your Rewst platform.

2. Search for ConnectWise Automate in the integrations page.

3. Click on the integration tile to launch the configuration setup page.

4. Under Parameters, enter the following information from ConnectWise Automate into the relevant fields:

   1. Hostname

   2. Password - what is used to log in to ConnectWise Automate

   3. Username

   4. Client ID - optional, with Rewst's client ID set as the default if this is not updated

   5. TOTP Secret - optional, for generating 6-digit MFA codes

5. Click Save Configuration.

6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.

Note that if you have IP address restrictions in place, you'll need to add the Rewst IP to your allowed list. The US IP for Rewst is 3.139.170.31. For other regional IP information, see our security policy here.

Use custom PowerShell scripts with your RMM integration

This brand of RMM allows PowerShell scripts to be passed via API. To report the script back to Rewst, you'lll need to add a manual webhook action. We recommend using the run PowerShell script subworkflow to handle this for you and if using custom scripts you will need to add this to bottom to ensure the call back to Rewst is made.

$postData = $PS_Results | ConvertTo-Json Invoke-RestMethod -Method 'Post' -Uri $post_url -Body $postData -ContentType 'application/json; charset=utf-8

Least privilege access guide for ConnectWise Automate integration

It is assumed that you do not have conflicting permissions on the script level or group level. Additional work may be required if this is the case and Automate documentation should be referenced.

You must be careful when assigning permissions to your clients. If you copy the permissions wrong there is a chance you could overwrite existing permissions, please be sure to follow ConnectWise Documentation for best practices for assigning the client permissions.

For more information on how to set up user classes and client permissions please visit Connectwise Automate documentation.

Configure user class permissions

To be able to utilize Rewst with least privilege you will need to configure a new user class named Rewst Automation. The class should then be configured with the following permissions.

User class permission

Actions	Permission
Agent Templates	Read
Alerts	Update
Clients	Read, Update, Delete
Clients → Show/Hide Passwords	Access
Clients → Show All	Access
Computers → Force Update	Access
Computers → Retired Assets	Delete
Computers → Show All	Access
Contacts	Read, Update, Delete
Groups	Create, Update, Delete
Groups → Scheduled Scripts	Update
Locations → Show All	Access
Patch Manager	Read, Update
Scripts	Read, Update, Delete
Scripts → Schedule Scripts	Update
Searches → Send Commands	Access
Tickets	Create, Read, Update, Delete
Tickets → Ticket Requests	Access

Configure client level permissions

Client level permissions

Actions	Permission
Locations	Read, Edit, Delete
Projects	Read
Product Keys	Read
Documents	Read
Passwords	Read

Default computer permissions: Enabled if listed

Actions	Permission
Command Prompt	Access
Software and Tools	Install
History	Access
Commands	View, Send
Scripts	Schedule
Information	Edit
Alerts	Clear
Scheduled Scripts	Delete

Triggers for ConnectWise Automate integration

Trigger type name	Type	Description
Detect Script Execution	Polling	Triggers when a script is running
New Computer	Polling	Triggers when a new computer is added
New Event Log	Polling	Triggers when a new event log is detected
New Running Script	Polling	Triggers when a script is running

Actions and endpoints

For more on how actions work in Rewst, check out our introductory actions documentation here.

Category	Action	Description
Computers	List Computers
Computers	Get Computer Devices	List a computer's devices
Computers	Get Computer Services	List a computer's services
Computers	List Computer Drives	List Drives
Computers	Get Computer Patching Stats	Retrieve an individual computer's patching statistics
Computers	Get Computer PatchJobs	List a computer's patch jobs
Computers	List Retired Assets
Contacts	List Contacts
Contacts	List System Contacts
Extrafields	Get Location EDFs	List extra data fields from the specified location
Extrafields	Get Computer EDFs	List extra data fields from the specified computer
Extrafields	Get Client EDFs	List extra data fields from the specified client
Extrafields	Get Contact EDFs	List extra data fields from the specified contact
Extrafields	Update Extra Data Field	Description coming soon...
Extrafields	List Extra Data Field(s)	Description coming soon...
Generic Request	CW Automate API Request	Generic action for making authenticated requests against the ConnectWise Automate API
Groups	List Groups
Networkdevices	List Network Devices
Remoteagent	List Agent Templates
Searches	List Searches
System	List Users	List Automate users
System	Add User	Add a new Automate user
System	Get User	Retrieve an individual user
System	Delete User	Delete an automate user
System	List User Folders	List user folders
System	List User Classes	List user classes
System	Get System Patch Information	Retrieve patch build information

Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our Canny feedback collector.