Skip to content

Latest commit

 

History

History
74 lines (52 loc) · 2.48 KB

ninjarmm-integration-setup.md

File metadata and controls

74 lines (52 loc) · 2.48 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
Write-Host "Ephemeral Agent started"

Before leaving the script, also create a Script Variable.

  1. Hit + Add next to Script Variables.
  2. Select the String/Text type.
  3. Enter Code as the variable name.
  4. Hit Add to save it.

Note 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

At this time Client IDs do not support special characters. Please create a new client app if one is generated for you.

Warning

Currently the UI element for the OAuthInfo parameter button will not persist 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.