Use this article as a guide to create and maintain an RMM integration with NinjaRMM, which gives you information about CPU, memory, last reboot, etc.
It should only take about an hour to get up and running with your RMM. This is a rough estimate based on our experience with several partners who integrated with their RMM.
The NinjaRMM sync described below will do the following:
Steps to integrate:
- Generate API credentials
- Enter your RMM credentials
- Wait for the sync to complete
- Organization matching
- Configuration matching
- An SSL connection with a valid certificate (not self-signed) from a trusted authority is required.
- Manager or Administrator level access to IT Glue.
- If you're integrating with a PSA and an RMM, you will want to first sync your RMM to your PSA and your PSA to IT Glue to make sure that the required data is available for matching.
- A Manager role will only be able to see RMM matched/unmatched data for organizations that they have explicit access to. To grant access to RMM data for all organizations, refer to Step 7 of our Adding and removing users KB article.
2. Generate API credentials
- You need to generate dedicated IT Glue API credentials from NinjaRMM (API key and API secret key).
3. Enter your RMM credentials
- Open IT Glue.
- Navigate to Account > Integrations and click +New.
- Click the Ninja MSP option.
- Enter your Ninja RMM API key and secret key and then click Connect.
Next, you’ll be taken to the Sync Logs screen.
Note: If the credentials fail for any reason, syncing will stop until you re-enter your credentials.
4. Start a manual sync
Navigate to Account > Integrations, click Actions and Start Manual Sync. When the sync is complete, the status column changes from Syncing... to OK.
5. Organization matching
IT Glue discovers organizations and configurations and tries to match them to data in your account. The matching logic is at the top of this article. Anything that isn't automatically matched will need to be manually actioned.
- From Account > Integrations, find your RMM in the list and click on Actions and then Matching.
- Start with the Unmatched filter to review unmatched organizations.
- If you're happy with a suggested match, click Accept Suggestion to accept it:
Or, you can search for and choose a different organization using the Match To column. You can also choose to ignore organizations, which means they won't count as unmatched items in subsequent syncs.
Warning. If you don't see an organization, you can choose the Create Organization action to create (import) it. But make sure there is nothing to match first, so that you don't create a duplicate organization.
- Keep going through all your unmatched organizations until they are all matched.
- If you change your mind about any of the matches, click Actions, choose Change Match, and then manually search for and choose a different organization.
6. Configuration matching
Next, go through the same process to match configurations as you did for organizations.
- To begin, click the Matched filter, pick a matched organization, and then choose the Match Devices action.
- You should first review your matched devices to see if everything looks okay.
- Next, click the Unmatched filter and start matching any remaining configurations until all are actioned (matched, ignored, or created).
- Before you create configurations, first match any of the devices that we couldn't match based on MAC addresses or serial number, for example, virtual servers. When you're done matching, you can create (in bulk or individually) any of the remaining devices coming in from your RMM.
Important. We don't recommend that you create configurations from your RMM if you'd like to then have them populate from IT Glue to your PSA. New items created from such data will not sync with your PSA unless you choose to do so manually by editing and saving each and every item. This is absolutely manual and is not recommended.
- Repeat for each organization until all configurations are actioned.
Once everything is matched, the RMM setup is complete. At any time, you can come back to these instructions to discover and match new organizations and configurations from your RMM.