Differences

This shows you the differences between two versions of the page.

--- technical:mikrotik-hotspot [2025/05/13 09:43] – system
+++ technical:mikrotik-hotspot [2025/05/13 15:01] (current) – system
@@ Line 11: / Line 11: @@
 With this scenario we assume you have:
-  * A recent installation of RADIUSdesk which includes Dynamic RADIUS Clients support.
+  * A recent installation of RADIUSdesk.
       * We will use our **cloud.radiusdesk.com** demo server which has an IP Address of **164.160.89.129** in this document.
       * Our cloud.radiusdesk.com demo server has a site wide RADIUS shared secret of **testing123**.
@@ Line 115: / Line 115: @@
 ==== Configure a Hotspot running on the wlan1 WiFi interface ====
 === Add a Hotspot using the setup wizard ===
+  * Connect to the Mikrotik's web interface and select **IP → Hotspot**.
+  * Click the **Hotspot Setup** button. (Do not use the **Add New** option this time)
+  * Select the **Hotspot Interface** as **wlan1** and click **next**.
+  * Specify the **Local address of Network** as **10.5.50.1/24**
+  * Ensure **Masquerade Network** is selected.
+  * Click **Next** to continue.
+  * Keep the default value of **Address Pool of Network** (10.5.50.2-10.5.50.254).
+  * Click **Next** to continue.
+  * Specify **Select certificate** as **none** since we will not use https initially.
+  * Click **Next** to continue.
+  * Keep the default value for **IP Address of SMTP Server** (0.0.0.0).
+  * Click **Next** to continue.
+  * Keep the default value for **DNS Servers**. This will be the value assigned by the DHCP server to the Ethernet-1 interface.
+  * Click **Next** to continue.
+  * Keep the default value for **DNS Name** (empty).
+  * Click **Next** to continue.
+  * Supply a local admin user for the hotspot with a password.
+  * Click **Next** to continue.
+  * This should bring you to the end of the wizard and leave you with an entry in the list of available configured hotspots.
+=== Understanding the Hotspot configuration ===
+  * The **Hotspot Setup** wizard did the following behind the scenes. You are welcome to confirm in order to understand the Mikrotik better.
+    * Created a DHCP server pool called **dhcp1** running in interface **wlan1**
+      * Confirm by viewing **IP → DHCP Server**.
+      * **Networks** sub-tab will contain a ;;;Hotspot network with the 10.5.50 range.
+     *Created a hotspot server profile called **hsprof1**.
+      * Confirm by viewing **IP → Hotspot**.
+      * **Server Profiles** sub-tab will contain the **hsprof1** entry.
+=== Modify the created Server Profile ===
+  * We need to tel the **hsprof1** Server Profile to make sure it use RADIUS.
+  * Connect to the Mikrotik's web interface and select **IP → Hotspot**.
+  * Select **IP → Hotspot**. Select the **Server Profiles** sub-tab and select **hsprof1**
+  * Make sure **Use RADIUS** is selected.
+  * Make sure **Interim Update** has a sane value e.g. 00:10:00 for every 10 minutes.
+  * Click **Apply** to save this value.
+  * You can optionally enable MAC authentication and the format of the MAC address. Select **XX-XX-XX-XX-XX-XX** to work with RADIUSdesk.
+Your Mikrotik Hotspot is now configured. Next we will prepare RADIUSdesk.
+----------------
+===== Prepare RADIUSdesk =====
+==== Our Setup ====
+  * The setup described here makes use of a VPS server that runs RADIUSdesk somewhere in the cloud. (We use cloud.radiusdesk.com)
+  * RADIUSdesk makes it super easy to add a RADIUS client to the FreeRADIUS server.
+  * Simply take care of the following items when you are pointing a RADIUS client to the RADIUSdesk server:
+    * Public IP Address of the RADIUSdesk server.
+    * Ensure the site wide shared secret is correct. (Check this with the person who configured the RADIUSdesk server)
+    * Ensure there is a unique identifier the RADIUS client can identify itself with to the server. (We did this by setting the Identity of the Mikrotik router.)
+  * After you took care of that simply reboot the Mikrotik router while it has an active Internet connection.
+  * It should then be reported under **New Arrivals - RADIUS**.
+  * The **New Arrivals - RADIUS** tab is closed by default.
+  * To launch it, click the **New Arrivals** button in the **RADIUS Clients** applet.
+<panel type="primary">
+{{:technical:mikrotik:new_arrivals.png|}}
+</panel>
+----------
+==== On-boarding a new arrival ====
+  * After the Mikrotik appeared under the **New Arrivals - RADIUS** tab we can change it to a RADIUS Client.
+<panel type="primary">
+{{:technical:mikrotik:onboarding_1.png|}}
+</panel>
+  * Select the new arrival you want to change and click on the **Attach** button.
+  * This will bring pop up a window where you can provide some detail.
+  * Give it a name:
+<panel type="primary">
+{{:technical:mikrotik:onboarding_2.png|}}
+</panel>
+  * The **Monitor** and **Maps** sub-tabs you can leave as default.
+  * The Enhancements tab has some handy enhancements. You are also advised to enable auto close - We give it a value of one hour (3600 seconds)
+<panel type="primary">
+{{:technical:mikrotik:onboarding_3.png|}}
+</panel>
+  * Finally select the realms that can use this RADIUS Client.
+<panel type="primary">
+{{:technical:mikrotik:onboarding_4.png|}}
+</panel>
+  * After you click the **Next** button this item will be moved to the list of RADIUS Clients. You will see this item indicates that it never contacted the RADIUSdesk server.
+  * Simply reboot the Mikrotik to confirm that contact is now established.
+  *  This brings us to the end of this section.
+-----------
+==== Testing it out ====
+  * Reboot the Mikrotik
+  * Connect to the WiFi Access point which the wlan1 interface advertises and confirm the following
+    * You get an IP Address in the 10.5.50.x range
+    * The DHCP server assigns you a DNS server's address for name resolution.
+    * As soon as you try to visit a website on the Internet you are redirected to the Mikrotik login page.
+    * Try to connect with a valid user defined in RADIUSdesk and confirm that the authentication works as intended.
+  * If things do not work correct; run a debug trace on FreeRADIUS and restart the Mikrotik router.
+  * Confirm that the Mikrotik router does send an Accounting-On packet to the RADIUS server by looking at the debug output of the FreeRADIUS server.
+-------------
+==== What next ====
+Although your system is up and running now you may want to do the following advanced configurations
+  * Introduce central managed Dynamic Login Pages for Mikrotik.
+The Advanced setup page will cover these topics.