Extended Connector Integration for NinjaRMM Assets, Software, and Users

Let Oomnitza be your single source of truth!

You'll get complete visibility of your assets, software, and users as data from NinjaRMM is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and NinjaRMM in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

  • Configurable dashboards and list views of key information
  • Configurable reports to share information with your colleagues and management
  • Configurable asset workflows that you can easily create to automate tasks such as:
    • Workflows for approving and rejecting devices
    • Workflows for rebooting devices
    • Workflows for getting and updating custom device fields
    • Workflows for scheduling and canceling maintenance operations

blue_link.svg Extended connector integration for assets and software

blue_link.svg Extended connector integration for users

Before you start

Best practice
For the integration with Oomnitza, instead of using an existing user account, create a dedicated user account with its own credentials. 

To stream NinjaRMM data into Oomnitza, you must add your NinjaRMM authentication credentials to the credentials vault in Oomnitza. NinjaRMM requires OAuth 2.0 authentication. 

Information you need to add credentials to Oomnitza 
You need your Ninja client ID and secret.
You also need to know the scope or permissions for the NinjaRMM API, which are:
- Monitoring. Read-only access to monitoring data and organization structure.
- Offline access. Monitoring privileges when offline.
- Control. Remote API access.
- Management. Write permissions for device and organization information. 
Sample
Let's say you want to grant monitoring and offline access permissions when you add the credentials to Oomnitza. You enter monitoring offline_access. If you want to grant all of the permissions, you enter monitoring offline_access control management.       

Useful links

blue_link.svg NinjaRMM Authorization

blue_link.svg Create Client ID and secret. You must log into your NinjaRMM account to access the information. 

blue_link.svg Learn more about scope. You must log into your NinjaRMM account to access the information. 

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and NinjaRMM , complete these steps:

  1. Log into Oomnitza.
  2. Click Settings > Credentials, and then click Add new credential (+).
  3. Add the information details.
  4. Click the AUTHORIZATION tab.
  5. From the Authorization Type list, select OAuth 2.0.
  6. From the SaaS list, select NinjaRMM.
  7. Enter your Ninja client ID and secret.
  8. Enter a value for the NinjaRMM API scope such as monitoring offline_access or monitoring offline_access control management.  
  9. Click Authenticate
  10. Click CREATE

Next step

You use the credentials that you added to create and customize your NinjaRMM integration with Oomnitza.

Extended Connector integration for assets and software

Info details

  1. From the menu, click Settings.
  2. On the Integrations page, scroll down to the Extended section for Asset Integrations.
  3. Click NEW INTEGRATION.
  4. In the New Asset Integration sidebar, click NinjaRMM.
  5. To integrate Oomnitza with the NinjaRMM Asset Load, click APPLY and then click NEXT twice.

Connect details

  1. Enter a descriptive name for the integration such as NinjaRMM Devices and Software. That'll be the name of the user integration tile that is shown on the Integrations page.
  2. To retrieve the name and version of the software for the devices, select Software.
  3. Select Cloud as the installation type.
  4. From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
  5. From the Integration Preferences list, select Create & Update
  6. Enter the name of the user of the integration.
  7. Click Next.

Mappings

Map the NinjaRMM fields to the Oomnitza fields and create custom mappings to get the asset information that you need.

Try it out!
Click the down arrow down-arrow-icon.svg in the field that you want to map to Oomnitza.  Select Add new Oomnitza asset field. Replace the name with a user-friendly label, and click CREATE.

Standard NinjaRMM to Oomnitza mappings

The following NinjaRMM fields can be mapped to Oomnitza: 

Approval Status
Connector Sync Time
Created
Device Type
Dns Name
Id
Ip Addresses List
Last Contact
Last Logged In User
Last Update
Location Id
Mac Addresses List
Memory Capacity
Node Class
Node Role Id
Offline
Organization Id
Os Architecture
Os Build Number
Os Language
Os Last Boot Time
Os Locale
Os Manufacturer
Os Name
Os Needs Reboot
Os Service Pack Major Version
Os Service Pack Minor Version
Processors Architecture
Processors Clock Speed
Processors Max Clock Speed
Processors Name
Processors Num Cores
Processors Num Logical Cores
Public IP
Role Policy Id
System Bios Serial Number
System Chassis Type
System Domain Role
System Domain
System Manufacturer
System Model
System Name
System Name
System Number Of Processors
System Serial Number
System Total Physical Memory
System Virtual Machine
Volumes Auto Mount
Volumes Capacity
Volumes Compressed
Volumes Device Type
Volumes File System
Volumes Free Space
Volumes Label
Volumes Name
Volumes Serial Number

Don't forget to select a sync key, such as System Serial Number and ensure that you map the NinjaRMM ID field to Oomnitza as the ID field is used in asset workflows. 

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping NinjaRMM fields to Oomnitza fields, click NEXT.   

Schedule

By default, NinjaRMM asset data is streamed to Oomnitza once every day. Software data retrieval is disabled unless you selected Software on the Connect page.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

  1. Configure your schedule.
  2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

edit-integration.svg

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings.

Use API presets to create asset workflows

To reduce costs by automating repetitive and  complex tasks, take advantage of the built-in presets for assets.

To add a preset to a workflow, complete these steps:

  1. Click Assets > Workflow.
  2. Click Add (+) and enter the name and description of the workflow.
  3. Click Add new. A Begin and End block is automatically added to the Sandbox.   
  4. Drag and drop the API block onto the Sandbox.
  5. Click Edit on the API block.
  6. Enter NinjaRMM to search for the presets.
  7. Select a preset:
    • NinjaRMM Approve or Reject Device to change the approval status of a device. Requires APPROVE or REJECT entry.
    • NinjaRMM Update Custom Device Field. Use this preset to update an existing custom field.
    • NinjaRMM Get Device Custom Fields. Use this preset to return a list of the custom fields on a device. 
    • NinjaRMM Schedule Maintenance. Use this preset to create a maintenance schedule. Start and end date and time must be entered.  
    • NinjaRMM Cancel Maintenance. Use this preset to cancel maintenance operation for a device. Device ID is required
    • NinjaRMM Reboot Device. Use this preset to reboot a device. Mode, either normal or forced, must be provided. 
  8. Configure and save your changes. 
  9. Edit the Begin block to set the trigger for the workflow.
  10. Connect the three blocks together.
  11. Validate, launch, and save your workflow.

blue_link.svg Understanding workflows

Did you know
You can use expressions that are provided in the Jinja2 template to retrieve information. For example, to get information about custom fields, you can use the Get Device Custom Field API preset.
Syntax
To do this, replace
<custom_field_name> with the actual name of the field:
{% if response and response[0] and response[0].<custom_field_name> %}{{response[0].<custom_field_name>}}{% else %}{% endif %}
Illustration

To access the Response tab when you edit the API block, you must switch from basic to advanced mode.
NinjaRMM_GetDeviceCustomField.png
Need help?
Contact support@oomnitza.com.

Extended connector integration for users and SaaS users

You can use the credentials that you created for the asset and software integration. See Add credentials to the vault in Oomnitza

Info and connect details

  1. From the menu, click Settings.
  2. On the Integrations page, scroll down to the Extended section for User Integrations.
  3. Click NEW INTEGRATION.
  4. In the New User Integration sidebar, click NinjaRMM.
  5. To integrate Oomnitza with the NinjaRMM User Load, click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from NinjaRMM to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

  1. Enter a descriptive name for the integration such as NinjaRMM Users. That'll be the name of the user integration tile that is shown on the Integrations page.
  2. From the User Selection list, select User plus SaaS User.
  3. From the installation type list, select Cloud.
  4. From the Credentials list, select the credentials from the Oomnitza vault.
  5. From the Integration Preferences list, select Update only.   
  6. Enter the name of the user of the integration.
  7. Click Next.

Mappings

Map the NinjaRMM fields to Oomnitza fields and create custom mappings to get the user information that you need.

Standard NinjaRMM to Oomnitza mappings

The following NinjaRMM fields can be mapped to Oomnitza: 

Id
Email
Phone
Enabled
Last Name
User Type
Device Ids List
First Name
Tags List
Must Change Pw
Administrator
Mfa Configured
Organization Id
Invitation Status
Notify All Clients
Permit All Clients
Connector Sync Time

Ensure that you select a role such as Employee and select one or more of the fields as sync keys such as the user's name. 

Want to map more NinjaRMM fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the NinjaRMM fields to Oomnitza fields, click NEXT.

Schedule

By default, NinjaRMM user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

  1. Configure your schedule.
  2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

edit-integration.svg

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

  • Configure dashboards for your assets
  • Configure custom reports
  • Configure workflows for automating complex and repetitive tasks

blue_link.svg See Getting started

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk