Mikrotik Router. Setup Guide

Transcription

1 Mikrotik Router Setup Guide

2 Disclaimer THIS DOCUMENTATION AND ALL INFORMATION CONTAINED HEREIN ( MATERIAL ) IS PROVIDED FOR GENERAL INFORMATION PURPOSES ONLY. GLOBAL REACH AND ITS LICENSORS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THE MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE, OR THAT THE MATERIAL IS ERROR-FREE, ACCURATE OR RELIABLE. GLOBAL REACH RESERVES THE RIGHT TO MAKE CHANGES OR UPDATES TO THE MATERIAL AT ANY TIME. Limitation of Liability IN NO EVENT SHALL GLOBAL REACH BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, ARISING FROM YOUR ACCESS TO, OR USE OF, THE MATERIAL. VERSION 1.1 PUBLISHED APRIL 2015 Page 2 of 14

3 IMPORTANT - BEFORE YOU START Before attempting to integrate your hardware controller in to Odyssys, please ensure that ALL of the following requirements are in place; You have a controller installed in an environment where compatible Access Points are configured to work with the controller, i.e - DNS, DHCP options configured correctly Your client environment is configured to allow network clients to; Associate to an Access Point Obtain an IP address Access to the internet The following components are required to be configured and working in your environment before attempting integration with Odyssys; DHCP Server DNS Server Firewall NAT PLEASE NOTE - This is a technical document and as such, integration of your hardware with Odyssys should only be handled by trained individuals. TECH NOTE Odyssys does not use standard RADIUS ports, therefore please make sure you allow the ports in your firewall, defined in your manager.odyssys.net Captive Portal settings. Page 3 of 14

4 GETTING STARTED WITH ODYSSYS Before configuring the Mikrotik Router for use with Odyssys, you will first need to create a Captive Portal to obtain key settings for your Mikrotik Router. 1. Within your Internet browser, navigate to 2. Login to Odyssys, using your Customer ID, Username and Password 3. Using the navigation panel on the left hand side of the Odyssys Dashboard, select "Captive Portals" then "Captive Portals" and finally "Create Captive Portal" 4. Enter the following details to create a new Captive Portal Name: <Name of your Captive Portal> Description: <Description of your Captive Portal> RADIUS Shared Secret: <Either keep the current shared secret or create your own> Hardware Vendor: Mikrotik Gateway Address: <LAN IP address of your device> Page 4 of 14

5 5. Click "Create" to save the settings and complete initial setup of the Captive Portal Select the newly created Captive Portal and it will display the information required to configure the Mikrotik Router - Please note you may need to scroll down to see the information. TECH NOTE The information will differ for each Captive Portal created and is unique to each Captive Portal. Page 5 of 14

6 CONFIGURING ODYSSYS WITHIN MICROTIK 1. Download the Cloud Captive Portal configuration files for Mikrotik/RouterOS from the Odyssys Manager: 2. Unzip these files to a directory on your computer and transfer the unzipped directory to the MikroTik router using an ftp client. For more information on how to upload files to your MikroTik router, please refer to your MikroTik user manual. 3. Connect to your MikroTik Router via its web user interface. 4. Select IP then Hotspot from the left-hand side menu. 5. Select the Server Profiles tab, click Add New and configure with the below settings Page 6 of 14

7 Name: <Choose a name for the hotspot server profile> HTML Directory: <Set to the name of uploaded hotspot directory for the portal, for example: if downloaded zip file name is zip> Login By: HTTP CHAP Split User Domain: Unchecked Use RADIUS: Checked Default Domain: <Captive Portal ID number (same name as the hotspot directory for the portal HTML directory)> Location ID: Leave blank Location Name: Leave blank MAC Format: XX:XX:XX:XX:XX:XX Accounting: Checked Interim Update: 00:10:00 NAS Port Type: 19 (wireless ) Click OK to save configuration. Example configuration Page 7 of 14

8 6. Under the Servers tab, click Add New and configure with the below settings Enabled: Checked Name: <Choose a name for the hotspot server> Interface: <Interface to register for hotspot services> (usually the bridge which includes all the ports which the APs are connected to bear in mind that you may lose the management access to the MikroTik router; we suggest configuring a port for management in a different bridge). Address Pool: None Profile: <Select the Server Profile created in previous step> Click OK to save configuration. Example configuration Page 8 of 14

9 7. Under the Walled Garden tab, click Add New and configure with the following details. Repeat for each Walled Garden entry you have been provided with (Found on page 11 of this document) and add *.odyssys.net entry as well. Enabled: Checked Action: Allow Server: <Select the hotspot server you created in the previous step> Dst. Host: <Found on page 11 of this document> Click OK to save configuration. Click on Radius from the left hand menu and click on Add New and configure with the following details. Repeat for each RADIUS server you have been provided Page 9 of 14

10 . Enabled: Checked Service: Hotspot Called ID: Leave blank Domain: <Captive Portal ID number> (same name as the hotspot directory for the portal HTML directory) Address: <Radius IP address provided in your Odyssys Captive Portal Configuration> Secret: <Provided in your Odyssys Captive Portal Configuration> Authentication Port: <Provided in your Odyssys Captive Portal Configuration> Accounting Port: <Provided in your Odyssys Captive Portal Configuration> Timeout: 3000ms Accounting Backup: Unchecked Click OK to save configuration and complete setup. Page 10 of 14

11 ACCESS CONTROL LIST ADDRESSES Odyssys Twitter api.twitter.com *.twimg.com Google Facebook *.facebook.com *.akamaihd.net *.fbcdn.net connect.facebook.com LinkedIn PayPal Express Checkout / / / / /32 If you wish to disable Apple's Captive Assistant please add the following to your walled garden captive.apple.com Page 11 of 14

12 FREQUENTLY ASKED QUESTIONS Q. I want to add different authentication provider types, how do I do this? A. Please see our Odyssys Authentication guide for further information. Q. I need more information on how to setup Odyssys A. Please see our Odyssys setup guide. Page 12 of 14

13 GLOSSARY ACL - Access Control List AAA - Authentication, Authorization, and Accounting DHCP - Dynamic Host Configuration Protocol DNS - Domain Name Service NAT - Network Address Translation PORT - A process-specific or an application-specific software construct serving as a communication endpoint, which is used by the Transport Layer protocols of Internet Protocol suite, such as User Diagram Protocol (UDP) and Transmission Control Protocol (TCP) RADIUS - Remote Authentication Dial In User Service (RADIUS) SHARED SECRET - A single password shared between two devices SSID - Service Set Identifier - A unique identifier for your Wi-Fi service WLAN - Wireless Local Area Network WLC - Wireless Local Area Network Controller Page 13 of 14

14 Craven House, 121 Kingsway London WC2B 6PA T +44 (0) info@globalreachtech.com Copyright Global Reach Technology Limited All rights reserved. Global Reach and the Global Reach logo are registered trademarks.