immy.bot

Appearance

NinjaRMM Dynamic Integration ​

Setting up this integration allows you to: ​

  • Import customers from NinjaRMM
  • Import computers from NinjaRMM
  • Manage all computers in NinjaRMM without deploying the ImmyBot Agent
  • Create ImmyBot Role in NinjaRMM

Configure the following in general settings (Administration -> General -> Settings): ​

  • Ninja Agent uninstall prevention -> OFF
  • Advanced Installer Options -> ON

ImmyBot currently requires the following client app scopes to operate correctly: ​

  • Monitoring
  • Management
  • Control

As well as the following grant types: ​

  • Authorization Code
  • Refresh Token

Create a client app in your NinjaRMM instance using above permissions: ​

(Administration -> Apps -> Api -> Add)

image

WARNING

Note: Change the "instance" in the redirect uri to your ImmyBot subdomain

Copy the below script to NinjaRMM Automation library and name it ImmyBot: ​

(Administration -> Library -> Automation -> Add -> New Script)

powershell
Param(
    [Parameter(Mandatory=$true)]
    [string]$code
)

$bytes = [System.Convert]::FromBase64String($code)
$DecodedCommand = [System.Text.Encoding]::UTF8.GetString($bytes)

# Execute Script Content
iex $DecodedCommand

Make a note of the script Id in the URL https://{region}.ninjarmm.com/#/editor/script/71 -> 71. It will be needed as one of the parameters in the integration setup to run scripts.

In ImmyBot, create a new dynamic integration with the NinjaRMM integration type: ​

(Show More -> Integrations -> Add Integration -> NinjaRMM)

Add the required parameters and authenticate the OAuthInfo parameter with a NinjaRMM user with sufficient privileges: image

WARNING

Note: Currently the OAuthInfo parameter button will not stay when you refresh the browser window. This will not kill your integration, so just leave it as is.

At this point, you should be able to map clients. Once clients are mapped, agents will start getting identified.