RMM: NinjaOne RMM

NinjaOne RMM Integration gives an ability to bulk deploy ConnectSecure Agents.

1 Manual Import Method
2 API Method Overview
3 Getting Started
4 Setup
- 4.1 Credentials
  - 4.1.1 NinjaOne Portal
    - 4.1.1.1 Create Global Custom Fields
  - 4.1.2 ConnectSecure Portal
    - 4.1.2.1 Enter Credentials
- 4.2 Company Mapping
5 Get Support

Manual Import Method

NinjaOne provides this method, here is the KB from their site:

API Method Overview

NinjaOne RMM Integration allows you to deploy ConnectSecure Agents in bulk via NinjaOne RMM.

Download the NinjaOne RMM Scripts here:

Tap here to download the NinjaOne script

Check out the link for how to generate/reset the User Secret required for agent installation:

How To > Generate/Reset User Secret

Getting Started

NinjaOne may need an additional script to call custom fields:

# Import the NJCliPSh module
{
    Import-Module NJCliPSh
    Write-Output "NJCliPSh module imported."
} catch {
    Write-Output "Failed to import NJCliPSh module. Error: $_"
    exit
}

Click on Overview > Integrations > NinjaOne RMM to configure the integration.

Setup

Credentials

NinjaOne Portal

Ensure that only the "Client Credentials" grant type is selected in the allowed grant types configuration. This selection ensures that the OAuth2 flow is restricted to client credentials, suitable for server-to-server authentication scenarios.

When selecting the "Client Credentials" grant type, the system will not require a redirect URL. This is because the client credentials flow does not involve user redirection and is intended for non-interactive authentication scenarios.

Navigate to the NinjaOne portal & click on Administration.
Navigate to Apps, select API and click on Add.

Select the Application Configuration as API Services(machine to machine)
Enter Name: Choose a name of your choice for the Application Configuration.
Enter Scopes: Select all the fields.
Select Allowed Grant Types: Client Credentials.

Once the Application Configuration is set click on Save.

Once the application is created successfully, the client’s secret credentials will be created.
Make sure to copy the client's secret credentials before leaving this page.

Create Global Custom Fields

Navigate and login to NinjaOne portal.
click on Administration and navigate to Devices.
Click on Global Custom Fields.

Create Global Custom Fields
Enter Name :create a Label as cybercnscompanyid
Enter Name :create a name as cybercnsdomain
Enter Name :create a name as cybercnstenantid
Enter Name :create a name as cybercnstoken
Select Field Type as Text.
click on Create for text next field.
Select Technician as Editable.
Select Automation as Read/write.
Select API as Read/write.
Select Definition Scope as Device, location, organization
Then click on Save.

Need to create four mandatory fields under Global Custom Fields to Map the company under ConnectSecure portal. Four include : cybercnscompanyid, cybercnsdomain, cybercnstenantid ,cybercnstoken.
Navigate to NinjaOne portal & click on Administration and select Organizations and create new Organizations.

Enter Name: Choose a name of your choice for the credentials to be added.
Select Alerting on your Choose

ConnectSecure Portal

Navigate to Global > Overview/Dashboard > Integrations > RMM Integrations and choose NinjaOne RMM from the integrations from the tiles.

Enter Credentials

Before we start here, NinjaOne 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 ClientID: Enter an API ClientID as generated from NinjaOne for a user.
Enter Client Secret: Enter API ClientSecret as generated from NinjaOne for a user.
Enter Domain: Enter the NinjaOne URL used for accessing the portal. Eg. https://oc.ninjarmm.com
Enter Select Associated Company: Select the Associated company under user.

Once all the above is entered correctly, SAVE credentials.

Company Mapping

This is where companies between NinjaOne and ConnectSecure are to be mapped; Import them directly from NinjaOne RMM or map existing ConnectSecure companies to NinjaOne RMM using the Add button.

If you want to manually search for companies, you can simply click the drop-down of NinjaOne RMM companies.

One of these two options could be selected

Import Companies from NinjaOne RMM:- To import multiple companies listed under NinjaOne RMM to ConnectSecure at a time.

Map Existing Company to an NinjaOne RMM company:- To map an existing company in ConnectSecure to the existing company under NinjaOne RMM.

To import multiple companies from NinjaOne RMM, choose Import Companies from NinjaOne RMM, and click on Next.

In the below image, the company can be searched using the search option given.
The Page Size shows the rows per page that can be displayed for search results and the Page shows the number of pages that can be displayed for a search result.
Click on Search Companies to show the list of the companies as requested in the search column.
Once searched as per the choice or the requirement it displays the search result in the Select Companies dropdown.
In case you want to manually search the company, you can simply click on the drop-down of NinjaOne RMM Companies and it will list all companies available under NinjaOne RMM.

In case the local company is already created in ConnectSecure and is to be mapped with NinjaOne RMM company, then select Map Existing Company to NinjaOne RMM company and click on Next.

Choose Credentials for the Map Existing Company to NinjaOne RMM company.
Choose Local Company.
Choose NinjaRMM One Company and click on Add.

Once all the fields are provided, Click on Finish to map all the selected NinjaOne RMM companies.

Using the Action column, you can Edit and Delete the integration mapping. Any mapping can be removed as and when necessary.

Get Support

If you have an integration-related inquiry, please email support@connectsecure.com with the details, and our Support Team will assist you.