Skip to content

Commit

Permalink
Merge pull request #35 from Dakota-LM/hotfix/fixninjarmm
Browse files Browse the repository at this point in the history
Fixed NinjaRMM Setup page
  • Loading branch information
nlowreydufour authored Oct 8, 2024
2 parents 26aa885 + 3af5623 commit 2ae7acb
Show file tree
Hide file tree
Showing 3 changed files with 891 additions and 216 deletions.
1 change: 1 addition & 0 deletions .vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
{ text: 'ConnectWise Control', link: '/connectwise-control-integration-setup' },
{ text: 'ConnectWise Manage', link: '/connectwise-manage-integration-setup' },
{ text: 'N-Central', link: '/ncentral-integration-setup' },
{ text: 'NinjaRMM', link: '/ninjarmm-integration-setup' },
{ text: 'HaloPSA', link: '/halo-integration-setup' },
{ text: 'Azure', link: '/azure-graph-permissions-setup' },
],
Expand Down
29 changes: 17 additions & 12 deletions ninjarmm-integration-setup.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,39 @@
<h1>NinjaRMM Dynamic Integration</h1>
# NinjaRMM Dynamic Integration

<h3>Setting up this integration allows you to:</h3>
### 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

<h3>Configure the following in general settings (Administration -> General -> Settings):</h3>
### Configure the following in general settings (Administration -> General -> Settings):

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

<h3>ImmyBot currently requires the following client app scopes to operate correctly:</h3>
### ImmyBot currently requires the following client app scopes to operate correctly:

- Monitoring
- Management
- Control

<h3>As well as the following grant types:</h3>
### As well as the following grant types:

- Authorization Code
- Refresh Token

<h2>Create a client app in your NinjaRMM instance using above permissions:</h2>
## Create a client app in your NinjaRMM instance using above permissions:
(Administration -> Apps -> Api -> Add)

![image](https://github.com/user-attachments/assets/5a27d217-a574-4a34-b42a-dd9a984e2ce1)
<p color="yellow">Note: Change the "instance" in the redirect uri to your ImmyBot subdomain</p>
::: warning
Note: Change the "instance" in the redirect uri to your ImmyBot subdomain
:::

<h2>Copy the below script to NinjaRMM Automation library and name it ImmyBot:</h2>
## Copy the below script to NinjaRMM Automation library and name it ImmyBot:
(Administration -> Library -> Automation -> Add -> New Script)

```powershell
Param(
[Parameter(Mandatory=$true)]
Expand All @@ -47,11 +49,14 @@ 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.

<h2>In ImmyBot, create a new dynamic integration with the NinjaRMM integration type:</h2>
## 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](https://github.com/user-attachments/assets/78b760fd-b0f9-4230-9b3e-389d487dfea3)
<p color="yellow">Note: Currently the OAuthInfo parameter button will not stay when you refresh the browser window. </br>This will not kill your integration, so just leave it as is.</p>
::: 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.
Loading

0 comments on commit 2ae7acb

Please sign in to comment.