Skip to content

Latest commit

 

History

History
62 lines (44 loc) · 2.07 KB

ninjarmm-integration-setup.md

File metadata and controls

62 lines (44 loc) · 2.07 KB
Raw

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)

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.