Introduction
This KB is designed to get you on your way to deploying the Quickpass Agent to your Customers' systems via the N-Central RMM solution.
Prerequisites
- Customers created in the Quickpass Dashboard
- 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.
Create the Automation Policy
1. Navigate to your N-Central RMM tenant
2. Navigate to Configuration > Scheduled Tasks > Script/Software Repository
3. Click Start Automation Manager
NOTE: If you have not installed the N-Central Automation Manager, follow the on-screen instructions to download, install, and run the Automation Manager
4. In the Automation Manager, create a New Policy and name as desired > OK
5. In the Categories window, search for Run PowerShell Script
6. Click and drag the Run PowerShell Script object to the Policy Builder window
7. Click Input > Input Parameters > ADD > New Input Parameters > assign 'AgentID' for Name and Display > ensure Type is string > leave Value blank > OK
8. Repeat Step 7 to create a new Input Parameter, but assign 'MSA' for Name and Display > ensure Type is number > leave Value blank > OK
9. Click Input > Global Variables > ADD > type 'InstallToken' for Name and Display > ensure Type is string > assign Value to be the Install Token for your QP Tenant > OK
NOTE: Please ensure the QP Tenant Install Token below is populated into the Global Variable value as the agent deploy will not work without this value entered
10. Click OK on the Input Variables and Global Variables window
11. Click Input Parameters > ADD > type 'inputAgentID' for Name and Display > in Value click the link icon > in Objects section, select Input Parameters > in Output parameters section, select AgentID > OK > ensure Value field now shows 'Input Parameters.AgentID'
12. Repeat step 11, but type 'inputMSA' for Name and Display > select number for Type > in Value click the link icon > in Objects section, select Input Parameters > in Output parameters section, select MSA > OK > ensure Value field now shows 'Input Parameters.MSA'
13. Repeat step 11, but type 'inputInstallToken' for Name and Display > select string for Type > in Value click the link icon > in Objects section, select Global Variables > in Output parameters section, select InstallToken > OK > ensure Value field now shows 'Global Variables.InstallToken'
14. Ensure your Input Parameters window shows as below
14. Navigate to PowerShell Script for Agent Installation and copy the PowerShell script
15. Click Script > Edit, then paste the copied PowerShell script into the window
16. Edit the $QPInstallTokenID variable, the $QPAgentID variable, and the $MSAOption variable in the PowerShell script window as shown below
NOTE: For EU tenants, hardcode edit the $RegionID variable
$QPInstallTokenID = "$inputInstallToken"
$QPAgentID = "$inputAgentID"
$MSAOption = "MSA=$inputMSA"
17. Once confirmed all steps above have been followed, Click File > Save As > name as desired > ensure file type is (.amp)
Upload and Deploy the Automation Policy
1. Navigate to your N-Central RMM tenant
2. Navigate to Configuration > Scheduled Tasks > Script/Software Repository > ADD > Automation Policy
3. Click Browse and select the recently saved (.amp) file > OK
4. Navigate to Actions > Run an Automation Policy
5. Adjust Credentials as needed
6. In Automation Policy, select the drop down and select the newly added policy
7. In Input Parameters, edit the AgentID parameter text field according to the Agent ID of the desired QP Customer you wish to deploy the agents to
8. In Input Parameters, adjust the '0' value to '1' if you wish to run the QuickpassServerAgent service as a Managed Service Account on the target machine
9. Click into the Targets tab > select the desired machines you wish the policy to run against
10. Click into the Schedule tab > set a schedule to run if desired, or leave as it to run immediately
11. Click into the Notifications tab > adjust the settings to be alerted on the status of the Policy Task as desired
12. Once the Policy Task is configured as desired, click SAVE to run
NOTE: Once ran, the Policy Task will populate a Status tab to show the status of the Policy Task as it runs. If the status fails and the agent is not deployed to the target machine, please review the N-Central RMM Status logs and adjust accordingly. If the challenges persists, contact support@cyberqp.com for further assistance
Next Steps
N-Central RMM Quickpass Agent Monitoring Articles
- coming soon!
Comments
0 comments
Article is closed for comments.