Integrating MikroTik
  • 11 May 2022
  • 3 Minutes to read
  • Comment

Integrating MikroTik

  • Comment

What You Need to Integrate MikroTik

Make sure you have the following elements ready before you start the integration process.

A MikroTik Router with RouterOS

You need to purchase a MikroTik router running Router OS with a level 6 license. MikroTik offers a comprehensive list of distributors.

Your router must run RouterOS with a level 6 license.

The integration won't work with any other license level. If you currently have a difference license level, get in touch with MikroTik to upgrade.

If no one in your team is familiar with Wi-Fi networks setup, we also recommend you reach out to a MikroTik consultant that can help you set up your network.

The Default MikroTik Router Admin Details

You also need the name and password of the default admin user in your router. This is the admin that you used to complete your initial router setup.

Integrating MikroTik

Step 1. Enabling MikroTik

  1. If the navigation menu isn't visible, click the menu icon in the top left corner of the page.

  2. Enable the MikroTik hotspot/captive portal. toggle.

  3. Enable the Show sign-up button in captive portal toggle to let new users join your space by redirecting them to your Members Portal.

  4. Enable the Show products store button in captive portal to let users purchase Wi-Fi access by redirecting them to your Members Portal.

  5. Enable the Require MAC pre-registration toggle if you want to manually register any new device prior to letting customers log in to your network.

  6. Add the username and password of your default admin user in MikroTik in the MikroTik full admin username and MikroTik full admin password fields.

  7. Click the Save Changes button.

Step 2. Downloading Your Hotspot Files

Now that MikroTik is enabled on the Admin Panel, click on the Download Hotspot files button.

MikroTik_HotspoFilestButton.png

The download should only take a few seconds and you'll find the files in the Downloads folder of your device.

The files are compressed in a zip file that you need to open to access the files. Once you have the files, keep them handy, you'll need them during the next step.

Step 3. Creating Your Hotspot in MikroTik

You now need to create a hotspot for your customers. The hotspot is effectively a captive portal that authenticates users trying to connect to your Wi-Fi network.

Open RouterOS and create a new hotspot. Once you have your new hotspot, you can start tweaking its settings to make it work with Nexudus.

Define MAC HTTP CHAP as Your Authentication Method

You need a hotspot with modified HTML pages that allow relaying authentication to our servers. All check-in and member information is stored there. Set the hotspot authentication to MAC HTTP CHAP. In the Mac Auth Mode, make sure you select MAC in the Username field.

Define Hotspot Admin User

You also need to make sure that the hotspot admin user is the same default admin user you've added to Nexudus in the MikroTik integration.

Replace the OnLogin/OnLogout Scripts

Locate the OnLogin and OnLogout scripts in your new hotspot. Replace the existing script with the scripts in the OnLogin and OnLogout text files you downloaded from Nexudus.

mikrotik4

Step 4. Editing Your Walled Garden Addresses

The last step of the MikroTik integration process is updating your walled garden to ensure your customers. Your walled garden is a list of websites or domains that users can access without being authenticated. You need to add all the following addresses to your walled gardent to ensure a smooth integration.

  • ajax.googleapis.com
  • maps.googleapis.com
  • fonts.googleapis.com
  • pki.goog
  • gstatic.com
  • googleapis.com
  • apis.google.com
  • www.google.com
  • www.paypalobject.com
  • themes.googleusercontent.com
  • maps.gstatic.com
  • twimg.com
  • platform.twitter.com
  • multigateway.nexudus.com
  • checkout.stripe.com
  • q.stripe.com
  • api.stripe.com
  • netdna.bootstrapcdn.com
  • cdnjs.cloudflare.com
  • sandbox.forte.net
  • api.mixpanel.com
  • s3.amazonaws.com
  • cdn.syndication.twimg.com
  • XYZ.spaces.nexudus.com

Make sure you replace XYZ with your location's default domain. You can find this domain through Settings > Website on the Admin Panel.

DefaultLocationDomain.png

All set! Mikrotik is now integrated with Nexudus.


Was this article helpful?

What's Next