RMM: NinjaOne RMM

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


Overview

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

Download the NinjaOne RMM Scripts here:

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

https://app.storylane.io/share/mon9mqtzrbwp


Getting Started

NinjaOne may need 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.

image-20240411-145236.png
image-20240411-145306.png

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, which is suitable for server-to-server authentication scenarios.​

​When the "Client Credentials" grant type is selected, 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 Created successfully, the client secret credential for the application will be created.

  • Make sure to copy client secret credential 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.

** Note: The screenshot currently lacks ‘cybercnstoken'; this is needed, and the screenshot is scheduled to be updated.

  • Create Global Custom Fields

  • Enter Label :create a Label as cybercnscompanyid.

  • Enter Name :create a name as cybercnstenateid.

  • 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, organisation

  • Then click on Save.

 

  • Need to create three mandatory fields under Global Custom Fields to Map the company under ConnectSecure portal. Four include : cybercnscompanyid, cybercnstenateid ,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.

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

  2. Enter ClientID: Enter an API ClientID as generated from NinjaOne for a user.

  3. Enter Client Secret: Enter API ClientSecret as generated from NinjaOne for a user.

  4. Enter Domain: Enter the NinjaOne URL used for accessing the portal. Eg. https://oc.ninjarmm.com

  5. 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.