Altai

Owned by Support
Last updated: Mar 09, 2017 by Zdenek Sidney Hornych
5 min read

Altai Service Controller 1600

Service Controller Altai is based on the same firmware version as Mikrotik devices. Both devices use RouterOS system. The settings of the Altai Service Controller 1600 is based on the same setup guide as for the standard Mikrotik. There is only one difference: Altai Service Controller has a serial number which SOCIFI uses for the device identification. For the identification of the device the mac address of the first ethernet device has to be used

For the fast settings, we described the main important steps in this guide.

1) Time synchronization - Setting SNTP client

The first step is a configuration of time synchronization. It is configured in the SNTP client (time) on the menu:
System > SNTP Client

Enabled: Checked
Mode: Unicast
Primary NTP Server: 0.north-america.pool.ntp.org (for example)
Secondary NTP Server: 1.north-america.pool.ntp.org (for example)


 

Please set servers that are as close to your location as possible. You can find NTP list here: http://www.pool.ntp.org/en/


Enable the correct time zone System > Clock > Time Zone Name:
America/Montreal (or according to your location):

The time is automatically synchronized after the correct termination of LAN configuration.

2) Radius settings

The second step is a configuration of a client for the external SOCIFI RADIUS server. It is necessary for authentication and managing parameters of clients connections. Here are necessary to be enabled the communication from the Altai Service Controller to the SOCIFI RADIUS servers for the UDP packets on the standard radius ports (1812/udp and 1813/udp). This must be enabled on each device in the way between controller device and the SOCIFI RADIUS server

Add primary radius server (RADIUS Server 1):
Radius + General tab

Servis
hotspot: checked
Called ID :
Domain:
Address: rad-1-euw-1.socifi.com (for example)

We recommend to use this set of RADIUS servers:
 


 List of RADIUS according to your location:
 For North America

RADIUS Server 1

rad-1-use-1.socifi.com or IP address: 52.7.148.174, Radius shared secret: socifi

RADIUS Server 2

rad-2-use-1.socifi.com or IP address: 52.55.217.23, Radius shared secret: socifi

 For Europe and Africa

RADIUS Server 1

rad-1-euw-1.socifi.com or IP address: 52.209.184.212, Radius shared secret: socifi

RADIUS Server 2

rad-2-euw-1.socifi.com or IP address: 52.50.155.202, Radius shared secret: socifi

 For Asia-Pacific

RADIUS Server 1

rad-1-euw-1.socifi.com or IP address: 52.209.184.212, Radius shared secret: socifi

RADIUS Server 2

rad-2-euw-1.socifi.com or IP address: 52.50.155.202, Radius shared secret: socifi

In order to have the Radius communication working fine, the IP addresses (above) and the ports 1812 Auth and 1813 Acc must be accessible.


Secret: socifi
Authentication port: 1812
Accounting port: 1813
Timeout: 300 ms
Accounting Backup: unchecked
Src. Address:

Add secondary radius server (RADIUS Server 2):
Radius + General tab

Servis
hotspot: checked
Called ID :
Domain:
Address: (for example)

Secret: socifi
Authentication port: 1812
Accounting port: 1813
Timeout: 300 ms
Accounting Backup: unchecked
Src. Address:

 3) Bridge settings

As the third step must be created a new bridge interface. This new bridge interface will be used as the virtual input interface for the SOCIFI hotspots system.
Bridge > Bridge tab > +

New Interface: General tab
Name:bridge-HS
OK

For the connection between the new bridge interface and some physical input interface with data for SOCIFI platform, must be added this physical interface to the new bridge interface. For example, physical ether2 interface will be added to the new bridge interface:

Bridge > Ports tab > +

New Bridge Port: General tab
Interface: ether2 
all on Bridge:bridge-HS

When it used some VLAN for SOCIFI data from input devices then must be added this VLAN interface to the new bridge.


4) Hotspot settings by wizard

In this step will be created the main hotspot system using the inbuilt Hotspot Wizard

Definition of the SOCIFI hotspot

Run the definition of hotspot:
IP > Hotspot > Servers Tab, Hotspot Setup

bridge-HS Instead of addresses listed in this figure, we recommend a different address, then the address of the interface (bridge-HS), eg: 10.50.5.1/24, see the notes at the end of the manual.

The number of IP addresses should submit their license (L4 = 200 addresses). See notes at the end of the manual.

If you are customer with White Label solution, please change your custom domain from hotspot.socifi.com to your custom domain (for example mycustomdomain.com) at step 7

Hotspot Setup:

  1. HotSpot Interface: bridge-HS
  2. Local Address of Network: 10.50.5.1/24
  3. Address Pool of Network: 10.50.5.2 - 10.50.5.254
  4. Select Certificate: none
  5. IP Address of SMTP Server: 0.0.0.0
  6. DNS Servers: 10.50.5.1 / 8.8.4.4 / 4.4.4.4 (or will be better using our DNS servers from your site or your provider)
    First DNS server address must be the interface address!!
  7. DNS Name: hotspot.socifi.com (required)
    This domain could be adjusted to fit your needs. For example hotspot.mydomain.com
  8. Name of Local HotSpot User: user


The changes in the Hotspot settings

Remove Shared User (default = 1):
IP > Hotspot  > User ProfilesDefault , General Tab

Shared Users: clear
OK

Addresses per MAC = 1 (default = 2 )    

Please note that the field shows normally just gray color with no values


IP > Hotspot > Server hotspot1

Addresses per MAC: 1

Change the Name from the default value of hotspot1 to value "AL_ <mac_address_of_first_ethernet_interface>", for example "AL_3F0602DFA144". 

OK

Change the method of the Authentication:
IP > Hotspot > Server Profiles select hsprof1

Hotspot Server Profile <hsprof1> Login Tab
HTTP PAP: checked

Use RADIUS: Checked
Default Domain:
Location ID:
Location Name:
Mac Format: XX:XX:XX:XX:XX:XX
Accounting: Checked
Interim-Update: 00:01:00
Nas Port Type: 19 (wireless-802.11)

screenshot-3.png

5) Scripts WalledGarden and ReplaceLogin

In this step will be made some changes in the configuration by the inbuilt scripting system

WalledGarden

Now define a list of allowed servers, IP > Hotspot Walled Garden:

Create WalledGarden script: System > Scripts +
Name: WalledGarden


Copy & paste following script:  

If you are customer with White Label solution, please add your custom domain (for example mycustomdomain.com) to the Walled Garden list.

add dst-host=*. mycustomdomain.com
/ip hotspot walled-garden
add dst-host=*.socifi.com
add dst-host=*.facebook.com
add dst-host=*.akamaihd.net
add dst-host=*.akamai.net
add dst-host=*.edgecastcdn.net
add dst-host=*.edgekey.net
add dst-host=*.akamaiedge.net
add dst-host=*.twitter.com
add dst-host=twitter.com
add dst-host=*.twimg.com
add dst-host=*.fastly.net
add dst-host=*.li-cdn.net
add dst-host=*.cloudfront.net
add dst-host=facebook.com
add dst-host=*.fbcdn.net
add dst-host=*.instagram.com
add dst-host=instagram.com
add dst-host=*.cdninstagram.com
add dst-host=*.linkedin.com
add dst-host=linkedin.com
add dst-host=*.licdn.com
 Want to Allow Google+ login ?

The new Allow login through social networks does not include the Google login. The reason is that some Android based devices are not redirected to the Captive Portal when the user gets connected to WiFi network. In case you'd like to add it you need to do following:

  1. Check if your hotspot allows DNS names in the Walled garden. Some hotspots can use IP addresses only. See: Why DNS-based Walled Garden (and not IP-based)
  2. Allow Google+ login: Settings > Brand > Authentication > Allow login through social networks > Set on Allow Google login
  3. Add these walled garden domain into existing list:

Google+ Login DNS's

Please adopt same format your Walled garden is already using e.g. with or without the asterisk, separated by comma or space etc.

 For Cisco Meraki, Ruckus, Xirrus
*.googleapis.com
*.googleusercontent.com
*.gstatic.com
*.accounts.youtube.com
*.apis.google.com
*.accounts.google.com
*.l.google.com

The local accounts.google.XX domain must be added into the Walled Garden list. For example accounts.google.co.uk for United Kingdom, accounts.google.com.sg for Singapore, accounts.google.de for Germany etc. Google domains list you can find at https://ipfs.io/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco/wiki/List_of_Google_domains.html

 For Open Mesh
googleapis.com,googleusercontent.com,gstatic.com,accounts.youtube.com,apis.google.com,accounts.google.com,l.google.com

The local accounts.google.XX domain must be added into the Walled Garden list. For example accounts.google.co.uk for United Kingdom, accounts.google.com.sg for Singapore, accounts.google.de for Germany etc. Google domains list you can find at https://ipfs.io/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco/wiki/List_of_Google_domains.html

 For Mikrotik
/ip hotspot walled-garden
add dst-host=*.googleapis.com
add dst-host=*.googleusercontent.com
add dst-host=*.gstatic.com
add dst-host=*.accounts.youtube.com
add dst-host=*.apis.google.com
add dst-host=*.accounts.google.com
add dst-host=*.l.google.com
add dst-host=accounts.google.com

The local accounts.google.XX domain must be added into the Walled Garden list. For example accounts.google.co.uk for United Kingdom, accounts.google.com.sg for Singapore, accounts.google.de for Germany etc. Google domains list you can find at https://ipfs.io/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco/wiki/List_of_Google_domains.html

 For DD-WRT
googleapis.com googleusercontent.com gstatic.com accounts.youtube.com apis.google.com accounts.google.com l.google.com

The local accounts.google.XX domain must be added into the Walled Garden list. For example accounts.google.co.uk for United Kingdom, accounts.google.com.sg for Singapore, accounts.google.de for Germany etc. Google domains list you can find at https://ipfs.io/ipfs/QmXoypizjW3WknFiJnKLwHCnL72vedxjQkDDP1mXWo6uco/wiki/List_of_Google_domains.html

Related pages:

The Splash Page is not triggered when Android devices connect to WiFi

facebook.com and twitter.com       (Yes, twice. Once with and once without the asterisk)



The result is a list of servers:

The list of Walled Garden servers is changed from time to time, you may be asked to change its contents. The current list is always in this documentation. Before you run the script again (even if with new content), first you must delete old Walled Garden server list (otherwise the list would be permanently duplicated).

Creating a definition for hotspot login

Script definition for content of hotspot / login.html

We generate a hotspot / login.html file the same way: System > Scripts > +
Name: ReplaceLogin


Click Apply and then run script: Run Script (change takes the effect by changing the date and time of the file: File hotspot/login.html). Copy & paste following script:


If you are customer with White Label solution, please change http://connect.socifi.com to your custom domain (for example http://connect.mycustomdomain.com)

Some RouterOS devices have default storage on the flash memory. In this case it is necessary to modify part of this script “/file” in according to its actual storage name, e.g.: "/file set flash/hotspot/login.html contents=" supposing that link "flash/hotspot/login.html" exists. It is necessary to check it in the list of files in the "File" module.

:set mac [interface ethernet get ether1 mac-address];

/file set "hotspot/login.html" contents="<html>
<head>
<meta http-equiv=\"refresh\" content=\"0; url=http://connect.socifi.com/?rad=yes&serial=$mac&client_mac=\$(mac)&client_ip=\$(ip)&userurl=\$(link-orig)&login_url=\$(link-login-only)\" />
<meta http-equiv=\"pragma\" content=\"no-cache\">
<meta http-equiv=\"expires\" content=\"-1\">
</head>
</html>"


6) Connecting your MikroTik to SOCIFI Dashboard

When adding Altai device you'll need to use the MAC address of the first ethernet ports as was described in chapter 4



Step 1: Login to SOCIFI Dashboard

Step 2: Click on the "Hotspots" tab on the left sidebar

Step 3: Click on the “Add a new hotspot” button located on the top right corner on the screen (pictured below)

Note: A pop-up window will appear (below)

Step 4: Select the Wi-Fi hardware manufacturer from the drop down menu

Step 5: Enter the serial number or MAC address (depending on the specific equipment manual) of your equipment. You can add multiple hotspots at once.

Step 6: Set your Network location (this step is essential for correct ad targeting)

Step 7: In the pop-up window type your location or just move the marker on the map and click on the save button to confirm the selection. This address is used for ad GEO targeting.

Step 7: Click Save

Note: Newly added hotspot are marked as  (Hotspot pending). After the first user connects to the hotspot via SOCIFI, the status will automatically change and appear as  (Active) within an hour. Get your first connections to test if it works properly. 


...And on of the end some important things in settings where users make some error:

  • the name of the hotspot - "AL_<mac_of_the_first_etherent_interface>" in IP > Hotspot > Server menu
  • time synchronization
  • the correct settings of the input interface to the hotspot input bridge interface
  • WalledGarden - sometimes is error that is used WhiteLabel domain and not add it to the WalledGarden 
  • ReplaceLogin script - checking when was the file "login.html" replaced