Merge pull request #1682 from netalertx/main

sync

docs/REST_IMPORT.md

@@ -0,0 +1,49 @@
+# 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**

front/php/templates/language/fr_fr.json

@@ -807,5 +807,8 @@
     "settings_system_icon": "fa-solid fa-gear",
     "settings_system_label": "Système",
     "settings_update_item_warning": "Mettre à jour la valeur ci-dessous. Veillez à bien suivre le même format qu'auparavant. <b>Il n'y a pas de pas de contrôle.</b>",
-    "test_event_tooltip": "Enregistrer d'abord vos modifications avant de tester vôtre paramétrage."
+    "test_event_tooltip": "Enregistrer d'abord vos modifications avant de tester vôtre paramétrage.",
+    "WF_Action_target": "Appliquer l'action à",
+    "WF_Action_target_conditions": "Cibler des conditions de l'appareil",
+    "WF_Action_token_hint": "Utiliser <code>{{trigger.COLUMN}}</code> pour référencer l'appareil déclencheur (par ex. <code>{{trigger.devLastIP}}</code>, <code>{{trigger.devMac}}</code>)"
 }