(20250210) Worked on the IP addr util a bit.

2025-02-10 19:34:52 +05:30
parent 800d6706ef
commit 95d90e807b
15 changed files with 1918 additions and 10 deletions
@@ -0,0 +1,29 @@
+# MiktoTik Configuration Steps
+### We need to configure MikroTik servers for two end use cases - PPPoE or Hotspot. here are the steps to achieve them through MikroTik's REST API facility. Use the `MiktoTik (EasyFi)` Postman collection for this.
+#### Author: Khushal
+#### Date: 20250210
+
+---
+
+## General Notes:
+
+MikroTik allows access via REST API using Basic-Auth headers which take a `username` and a `password`. The base path 
+would look something like `http://<ip-addr>/rest`. You may need to mention a port no. if the default has been changed. 
+
+---
+
+## Steps for PPPoE
+
+### 1. Select a Physical Interface
+
+In this step you must pick the first available interface that is not being used elsewhere. Mind you that this interface 
+is an actual physical connectivity interface (typically ethernet) on the MikroTik device.
+
+- Enlist the available interfaces using the listing API on the `/interface` path using `GET` method.
+- Select the first one that has field `"running"` set to `"false"`, and pick its `".id"` value.
+- Rename it to `"easyfi-pppoe"` by its `".id"` on the `/interface/<.id>` path using `PATCH` method.
+
+**NOTE:** Remember to save the original configuration in the `comment` field (as a JSON string) in case a roll-back is 
+needed.
+
+### 2.