Introduction:

The Quickpass agent can be deployed through Kaseya VSA X with minimal interaction after the initial setup is completed. The following article will walk you through how to deploy the Quickpass agent to your customer's systems using Kaseya VSA X.

Prerequisites

• Customers created in the Quickpass Dashboard
  • via ITGlue
  • via Hudu
  • via ConnectWise Manage
  • Manual Creation
• Ensure that you have reviewed and understand the Install Token
  https://support.getquickpass.com/hc/en-us/articles/360035206994-How-to-install-the-Server-Agent-Manual-and-Silent#InstToken 
  and Agent ID values
  https://support.getquickpass.com/hc/en-us/articles/360061942274-Export-Customers-List-Status-and-Agent-ID-s
• Review the Scripted Agent Installation KB Article to understand what each Powershell Parameter will do
  https://support.getquickpass.com/hc/en-us/articles/4413576799639-Scripted-Agent-Installation
• Agent installation must be done "As Administrator" so ensure that the account the RMM deployment is being executed will have those permissions.

Setup

Create Custom Fields

1. Navigate to your Kaseya VSA X tenant.

2. Navigate to MODULES > Automation > Custom Fields.

3. Click Create Custom Field.

4. In Details, assign Display Name to be 'CyberQPInstallToken' - adjust as desired for your preferred naming convention.

5. In Variable Details, ensure Type is 'Text', then assign Default Value and Global Value to be the Install Token for your QP Tenant.

6. In Contexts, ensure Global is selected.

7. Click Create.

8. Repeat steps 2 - 7 listed above to create a second Custom Field, but assign Display Name to be 'CyberQPAgentID', leave Default Value 'blank', and in Contexts ensure only Organization is selected

NOTE: If your Kaseya VSA X tenant utilizes Sites as well for more granular management, a separate Site specific Custom Field may be needed.

Assign Custom Fields to Organizations

1. Navigate to ADMINISTRATION > Configuration > Organizations.

2. Click into the desired organization > select Custom Fields > Edit > Assign Custom Field.

3. In Custom Field, select 'CyberQPAgentID'.

4. Click Enter Manually, then assign the Custom Field text value according to the Agent ID of the desired QP Customer you wish to deploy the agents to.

5. Select Add > Save.

6. Repeat steps 1 - 5 to assign the 'CyberQPAgentID' Custom Field for additional organizations, assigning the Custom Field text value according to the corresponding QP Customer's Agent ID.

Create Automation Script

1. Navigate to MODULES > Automation > Scripts.

2. Click into the desired folder, then click New Script.

3. Assign Name and Description as desired.

4. In Inputs, click New.

5. Assign Name to be 'InstallToken'.

6. Toggle Use custom field value.

7. Click Custom Field drop down, then search for the 'CyberQPInstallToken' custom field.

8. Click Save Variable.

9. Repeat steps 4 - 8 to add a second variable, but assign Name to be 'AgentID' and in the Custom Field drop down search for the 'CyberQPAgentID' custom field.

10. Scroll down, and underneath Windows click the Enable toggle.

11. Ensure Script type is PowerShell.

12. Notice lines 2 - 3 reference the Input Variables for InstallToken and AgentID added in the steps above.

13. Navigate to PowerShell Script for Agent Installation and copy the PowerShell script.

14. Underneath the input variables in the script body, paste the copied PowerShell script into the window.

15. In lines 15 - 16, edit the code so the Input Variables referenced in lines 2 - 3 are called for:

BEFORE (pasted directly from copied PowerShell script).

15: $QPInstallTokenID = "InstallToken"
16: $QPAgentID = "CustomerAgentID"

AFTER (variable values has been edited according to the Input Variable names created during steps 4 - 8).

15: $QPInstallTokenID = "$InstallToken"
16: $QPAgentID = "$AgentID"

16. Once the above edits have been made, click Save.

Deploy the Automation Script

1. Navigate to MODULES > Devices > Device Management > select desired device(s) > Actions > Run Script.

2. Select the script, and click Run > follow any on screen prompt to confirm the Run.

3. Repeat steps 1 - 2 as desired for additional organizations.

Next Steps

Kaseya VSA X Quickpass Agent Monitoring Articles

• coming soon!