Datto RMM - Old Interface
CyberCNS can help bulk install agents using Datto RMM across your network. Current integration capabilities are focused on pushing & installing CyberCNS agents across the organization.
Into CyberCNS Portal, Navigate to Global Settings> Integrations.
Choose DattoRMM from the listed integrations.
Enter Credentials
Before we start here, Datto user API Key information should be ready to be inputted here.
Enter Name: Choose a name of your choice for the credentials to be added.
Enter API Key: Enter an API Key as generated from Datto for an user.
Enter API Secret: Enter API Secret as generated from Datto for an user.
Enter Domain: Enter domain as shown into Datto under user.
Once all the above is entered correctly, SAVE credentials.
Once all the below details are provided, SAVE the data. Likewise, multiple credentials can be added in this section using the '+' sign. Each set of Credentials can be attached to a company using Company Mapping.
Navigate to Company Mapping so as to map added credentials to a company for integration purpose.
Under Company Mapping, Choose DattoRMM Credentials from the dropdown ( here already added credentials will reflect).
Click on +Add to map a Company to credentials.
While Mapping a new Company, Import Companies from DattoRMM OR Map Existing Company into a DattoRMM Company can be selected.
As the name suggests, Import Companies from DattoRMM allows to import DattoRMM here.
Map Existing Company into a DattoRMM Company allow to map existing company into CyberCNS to be mapped to existing company into DattoRMM.
Once appropriate selection is done, Click on Next.
In case of DattoRMM companies to be imported, they will reflect as shown below. Search Company feature can be used into CyberCNS in case you have many companies under Datto and need to search for a specific company.
Once required company/companies are selected, click on Finish.
Multiple companies if mapped, will be listed under Mapping Info as shown below. Once this integration and company mapping is completed, user should be able to see CyberCNS Variables auto added into DattoRMM under the mapped Sites.
Login to the Datto RMM instance as an administrator. ( This is an Old Interface)
Generate User API Key for Integration with CyberCNS
Navigate to Settings>Users sections into Datto
Select the user to generate the API key for.
As shown below, click on Generate API Key ( if not generated already) Or use the existing API Key information.
Use User API Key, API Secret Key and API URL from here.
In the case of DattoRMM, To add a CyberCNS agent installation script, a new Component is to be created.
DattoRMM can be used for installing CyberCNS Lightweight agent OR CyberCNS Probe Agent.
Create separate components for each agent (Lightweight and Probe) and each OS (separate components for MacOS, Linux and Windows).
Respective scripts for MacOS, Linux and Windows OS, which are ready to be used with DattoRMM can be used from below documentation.
DattoRMM - Agent Installation Scripts for Windows
DattoRMM - Agent Installation Scripts for MacOS
DattoRMM - Agent Installation Scripts for Linux
Follow the steps below to create Components.
Navigate to Components on the top main menu.
Click on New Component under Actions to create a new component.
Enter the details below to create a component (software/scripts) that can be used for deployment to a device or a group of devices.
Name a Component, to help you understand what it will do.
Add Description of this component for understanding what will be a use of this component.
Click on the drop-down of the category and select Scripts.
The next step is to select Sites to deploy agents. As per requirement, please select All Sites OR Selected Sites where the CyberCNS agent is to be deployed. These Sites are already present in Datto RMM.
After selecting Sites, select the Script Type.
For Apple Mac & Linux , select Unix (Linux, Mac OSX) as a Script Type.
For Windows, select Powershell as a Script Type.
CyberCNS has a ready script to be copied here into the Scripts section.
The next is Variables. Under Variables, values of Company ID, Client ID, Client Secret and CyberCNS domain URL will be fetched once DattoRMM credentials are shared in CyberCNS under Integrations.
Every company in CyberCNS will have different values for Company ID, Client ID, and Client Secret which will be created as a Variable in DattoRMM.
Variables are auto fetched once the DattoRMM integration is set successfully.
To save the component created, click on Save at the end.
Once the Component is Saved successfully, it will be listed under the Component List.
Once the Component/s are ready, jobs should be created so as to run as per schedule/immediately as it is set.
To create a Job to run using Component/s created, navigate to Jobs from the top main menu. Select New Job.
General Section of Job will require to Name the Job for understanding purpose.
Schedule it Immediately OR Click to Change the schedule.
Click to Change schedule will ask to choose the frequency of the job getting created.
e.g. If selected immediately, the job will run immediately after you successfully create it.
The next step is to add Job Targets. Click on Add Targets to select the type as devices/group of devices etc.
Target Type can be selected as per requirement. Here choose Devices as to select devices from the list where CyberCNS Agent is to be deployed OR select Default Device Filters and search by windows to list all windows.
Select Sites to target from the list where CyberCNS agent is to be deployed.
Target Type can be selected as per requirement. Here choose Devices as to select devices from the list where CyberCNS Agent is to be deployed OR select Default Device Filters and search by Mac to list all Mac OS.
Select Sites to target from the list where CyberCNS agent is to be deployed.
In case Target Type is selected as Device(s), where CyberCNS Agent to be deployed can be selected from the list populated.
Once Target is set, click on Add a Component.
This will populate already created Components to choose from. Select a component created for CyberCNS Agent installation and Save.
The next step is to add, Advanced Options of your choice as below:
Set the Expiry of the job
Set the Duration of the job
Into Execution, select as the logged-in user must have Administrator Rights.
Set the Alerts conditions
Select output choices and mention the job recipients as default OR Additional as needed.
Click on Save so as to successfully save this job.
Once the job is saved, it will be listed under Active Jobs.
Completed jobs can be seen under the Completed Jobs section. To get the job status, click on the job name from the Completed jobs list.
You can view the status of the job as below. In case it is successful, it will show to view standard output (Stdout).
Stdout for the successful job will be as below, showing CyberCNS Agent installation is successful.
In case of an error, it will showcase an error faced under (Standard Error) Stderr.
This completes the Datto RMM.