# N-central Integration

Linking [N‑Central](https://www.n-able.com/products/n-central-rmm) to ilert enables MSPs to route technical alerts – such as device offline events or network issues – into tailored on-call workflows. These alerts trigger escalation paths and ensure rapid response and ticket creation for managed customer environments.

### In ilert: Create a N-central alert source <a href="#create-alert-source" id="create-alert-source"></a>

1. Go to **Alert sources** --> **Alert sources** and click on **Create new alert source**

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **N-central** in the search field, click on the N-central tile and click on **Next**.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## Configure notifications in N-central

Login to N-ABLE N-central and navigate to the users menu.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Mi1FZB7zdiM1P4VREu_%2F-Mi1l22zO6y6JUuMmle_%2Fimage.png?alt=media\&token=96ca476f-37e5-4613-8f85-731c4bf51ff1)

Go ahead and click on the **email address** of the user for whose notifications you want to create alerts in ilert for. (We recommend creating a user just for this purpose, however that is not necessary).

In the user's edit view, click on the ***User Details*** tab and then on the **Notification Method** sub-tab.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Mi1FZB7zdiM1P4VREu_%2F-Mi1lj4dXxaHJeU8MQnL%2Fimage.png?alt=media\&token=b7be6ca8-7028-4acf-8197-2a1e7466987f)

Choose **Add** and create a new Third Party I**ntegration - HTTP** notification method.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Mi1FZB7zdiM1P4VREu_%2F-Mi1lt_RHHr0la51miDA%2Fimage.png?alt=media\&token=acaa9a27-92ab-4481-ab4e-3053b51d308f)

Give it a proper name and paste the URL that you have copied ***from the new alert source*** that you have created in ilert from the steps above as **Target URL**.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Mi1FZB7zdiM1P4VREu_%2F-Mi1mOQr8bM56opaA342%2Fimage.png?alt=media\&token=4ec8308c-1b70-402e-9b8f-c6732d413517)

Click on **Save** to create the new notification method.

Congratulations you have successfully connected N-central with ilert.

## Ensuring that notifications from N-central reach ilert

To make sure that N-central events will reach your ilert alert sources it is important to verify all required assignments of users in N-central.

* is your user part of an **Access Group** that is linked to the **Device**
* is your user assigned as **Primary Notification** of the **Notification Profile** (*Configuration -> Monitoring -> Notifications -> Choose Notification Profile of your choice e.g. Connectivity Failed -> Primary Notification -> Selected Recipients*)

## Acknowledgement and Resolving

To acknowledge and resolve N-central events in ilert you will need to add following notification templates.

1. On the sidebar navigate to **Administration -> Defaults -> Notification Templates**.

{% tabs %}
{% tab title="Acknowledgement" %}

1. Click on **Notification Acknowledgement**.
2. Scroll down to **HTTP MESSAGE TEMPLATE** and enter following template:

```
{{ActiveNotificationTriggerID}}
{{CustomerName}}
{{DeviceName}}
{{DeviceURI}}

{{ExternalCustomerID}}
{{AffectedService}}
{{TaskIdent}}
{{NcentralURI}}
{{QualitativeOldState}}
{{QualitativeNewState}}
{{TimeOfStateChange}}
{{ProbeURI}}
{{QuantitativeNewState()}}
{{ServiceOrganizationName}}
{{TimeOfNotification}}
{{AcknowledgementTime}}
{{AcknowledgementUser}}
{{AcknowledgementNote}}
```

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FqrNp58ki6Nahwo1dYEdZ%2F2.png?alt=media&#x26;token=126890aa-4940-47d9-83a2-4eafdfae0b38" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Resolving" %}

1. Click on **Return To Normal Notification**.
2. Scroll down to **HTTP MESSAGE TEMPLATE** and enter following template:

```
{{ActiveNotificationTriggerID}}
{{CustomerName}}
{{DeviceName}}
{{DeviceURI}}

{{ExternalCustomerID}}
{{AffectedService}}
{{TaskIdent}}
{{NcentralURI}}
{{QualitativeOldState}}
{{QualitativeNewState}}
{{TimeOfStateChange}}
{{ProbeURI}}
{{QuantitativeNewState()}}
{{ServiceOrganizationName}}
{{TimeOfNotification}}
{{AcknowledgementTime}}
{{AcknowledgementUser}}
{{AcknowledgementNote}}
```

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F64pPuWR2GJ0PDVkQdhSb%2F3.png?alt=media&#x26;token=39b6441c-237b-4c80-a69c-4468d20210ab" alt=""><figcaption></figcaption></figure>

3. To activate resolving: On the sidebar navigate to **Configuration -> Monitoring -> Notifications**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoCJWRPFZRhBtyh6TMkLy%2F4.png?alt=media&#x26;token=b48fdd69-5874-4f6e-9706-be24a9612ad6" alt="" width="281"><figcaption></figcaption></figure>

4. Now select a desired **Notification**.
5. Click on **Trigger Details** and either add or edit a trigger.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyG3MJd04fw2otdqQnWoT%2F5.png?alt=media&#x26;token=773569e5-9662-41ac-99cb-95db5a5fa79c" alt=""><figcaption></figcaption></figure>

6. Select the **Notify on return to Normal** checkbox and save the trigger.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FRtx5OxxgDke2IeUQBCcJ%2F6.png?alt=media&#x26;token=35614b1c-b623-4612-b864-811204c22345" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## FAQ

### I am having issues creating an N-central user

You can find the official documentation [here](https://documentation.n-able.com/N-central/userguide/Content/User_Management/Role%20Based%20Permissions/role_based_permissions_create_user.htm)

### I am having issues creating an HTTP notification method for an N-central user

You can find the official documentation [here](https://documentation.n-able.com/N-central/userguide/Content/Further_Reading/API_Level_Integration/API_Integration_NotifReg.html)

### How can I test alerts?

If you navigate on to the **devices** overview of your assigned access groups or that are using your notification profile, you may click on one of the devices to edit them and select the specific device's ***service*** that relates to your Notification Profile, you can edit the check in the **Monitoring tab** and **reverse the check** - this will usually trigger a notification.
