NinjaRMM

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 (Optional: This permission is only needed so ImmyBot can also uninstall the Ninja agent)
• Advanced Installer Options -> ON

Create a script in the NinjaRMM Automation library

(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"

The script should be set to

• Name: ImmyBot
• Language: Powershell
• Operating System: Windows
• Architecture: All
• Run As: System

Note the Script ID

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.

Create the integration in ImmyBot

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

1. Add the required parameters and authenticate the OAuthInfo parameter with a NinjaRMM user with sufficient privileges:
   • Name: NinjaRMM
   • Region: This is the subdomain
   • ScriptID: From the URL in the script step above
   • UseCustomClientApp: This is optional and not recommended
2. Once that is filled out, click on Provide Concent, and follow the onscreen instructions.
3. Once that is done click update and enable the integration.

Migrating to the official ImmyBot NinjaOne integration

You need to do this if you want to utlize the sliding refresh token provided by Ninja. This will prevent you from having to constantly consent through oAuth.

1. Click Provide Consent

2. Continue through our consent page

3. Continue through Ninja’s consent page

4. Once you get back to the confirmation page, close it to go back to the integration settings page

5. Finally, click Update

Congratulations! You’ve migrated to the official client app in Ninja for ImmyBot!