NetAlertX/docs/REST_IMPORT.md

# RSTIMPRT plugin OPNsense/Dnsmasq setup

This guide shows you how to configure **OPNsense/Dnsmasq** in the **RSTIMPRT** plugin.



## 1. Create an OPNsense user
1. In OPNsense, navigate to **System** → **Access** → **Users**
2. Click the **+** to add a new user
3. Give your user a name (e.g., `netalertx`) and a Full name (e.g., `NetAlertX`) 
4. Assign privilege: `Services: Dnsmasq DNS/DHCP: Settings`
5. Click **Save**

![REST_IMPORT > OPNsense user](./img/REST_IMPORT/opnsense_user.png)



## 2. Create an OPNsense API key
1. On the OPNsense Users screen, click the **AP Key** button next to your new user
![REST_IMPORT > OPNsense API key](./img/REST_IMPORT/opnsense_user_api_key.png)
2. Click **Yes** when prompted to generate and download the new key.  You'll receive a text file with a `key` and a `secret`.
![REST_IMPORT > API key confirmation](./img/REST_IMPORT/opnsense_user_api_key_confirm.png)



## 3. Configure the RSTIMPRT plugin
1. In NetAlertX, navigate to **Settings** → **Core** → **Loaded plugins** and add `RSTIMPRT` 
2. Click **Save**
3. Navigate to **Settings** → **Core** → **Device scanners** and expand `RSTIMPRT` 
4. Under **RSTIMPRT_imports**, click **Add** 
5. Enter the following connection info:
    - Name: Whatever you'd like to call this REST instance (e.g., `OPNsense Dnsmasq`)
    - URL: Full URL to the API endpoint (e.g., `https://192.168.1.1:8443/api/dnsmasq/leases/search`)
    - Method: `GET`
    - Auth Type: `basic`
    - Username / API Key: The `key` value from your downloaded API key file
    - Password / API Secret: The `secret` value from your downloaded API key file
      ![RSTIMPRT_imports configuration](./img/REST_IMPORT/rstimport_config_1.png)

6. In the same window, enter the following field mappings:
    - Device List Path: `rows`
    - MAC Address: `hwaddr`
    - IP Address: `address`
    - Device Name: `hostname`
    - Vendor: `mac_info`
![RSTIMPRT_imports configuration](./img/REST_IMPORT/rstimport_config_2.png)

7. Click **Update**
8. Click **Save**