Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

Custom Integration: NinjaOne

runZero requirements

NinjaOne requirements

  • API client ID and secret with appropriate permissions.
  • NinjaOne API URL (e.g. https://us2.ninjarmm.com).

Steps

NinjaOne configuration

  1. Generate an API client ID and secret for NinjaOne.
  2. Note down the API URL: https://<your-region>.ninjarmm.com/.

runZero configuration

  1. (OPTIONAL) - Make any necessary changes to the script to align with your environment.
    • Modify API calls as needed to filter inventory data.
    • Modify datapoints uploaded to runZero as needed.
  2. Create the Credential for the Custom Integration.
    • Select the type Custom Integration Script Secrets.
    • For the access_key, input your NinjaOne client ID.
    • For the access_secret, input your NinjaOne client secret.
  3. Create the Custom Integration.
    • Add a Name and Icon for the integration (e.g., "ninjaone").
    • Upload an image file for the NinjaOne icon.
    • Toggle Enable custom integration script to input the finalized script.
    • Click Validate to ensure it has valid syntax.
    • Click Save to create the Custom Integration.
  4. Create the Custom Integration task.
    • Select the Credential and Custom Integration created in steps 2 and 3.
    • Update the task schedule to recur at the desired timeframes.
    • Select the Explorer you'd like the Custom Integration to run from.
    • Click Save to kick off the first task.

What's next?

  • You will see the task kick off on the tasks page like any other integration.
  • The task will update the existing assets with the data pulled from the Custom Integration source.
  • The task will create new assets for when there are no existing assets that meet merge criteria (hostname, MAC, etc).
  • You can search for assets enriched by this custom integration with the runZero search custom_integration:ninjaone.