02. Quick setup tutorial

Quick setup tutorial

For a gentle and quick tutorial on how to setup and configure BlissRADIUS, we will examine a case of an small Internet service provider.

Our ISP services number of wireless as well as LAN clients. It uses MikroTik routers and Microsoft Windows(R) server for BlissRADIUS hosting. Clients are authenticated using PPPoE authentication protocol.

Two account types are provided for clients:

All clients are randomly assigned address in range from 1.1.1.10 to 1.1.1.255. This is example range and will not work in your case. You should use your available address range.

Network overview

Image shows basic network setup with RADIUS, one wireless and one LAN router. They are all connected using central router.

Here is description of RADIUS protocol and network utilization for administrators to take a note of:

MikroTik NAS setup

Both MikroTik's in network must be configured first. After log on using WinBox(R) this must be executed:

Configuration steps

BlissRADIUS should be set using browser. Login to Admin portal on http://localhost:8800 (replace address with RADIUS servers address). Enter admin as username and password.

There are couple of things that must be configured here:

Only then we can proceed to test connection.

Setting up NAS servers

This must be done for both MikroTik routers. Go to Admin > NAS and click on button Add.

Set options to:

Interim update interval setting on MikroTik is in minutes while BlissRADIUS uses seconds.

Leave rest of the options to default. Upon finishing this you should see 2 MikroTik routers on NAS server list.

Creating account types

For a first type of account (a monthly limited) go to Admin > Account types and click Add button. Set options to:

Then create second type of account with options:

Use MikroTik documentation to check on avaliable RADIUS attributes.

Creating client accounts

Go to Users > Search and click Add button. Select username and one of two created account types.

After creating client account, you must click on Add payment button and create default payment.

When done, a green indicator under Active field will show that client account is ready for use.

Testing client connections

By here, BlissRADIUS and NAS servers are configured for use. Now it is time to try to connect using one of created client accounts. Using clients computer, do the following:

Again, IP address range is just an example and will not work with your network setup. You must set address range to something appliable to your case.

If this failed then open NAS using WinBox and open RADIUS settings. Click on Status tab and check counters.

Procedure described here should be used as first step when debugging client problems. Make effort that all of your support personnel learn about it.

2018-06-27
BlissRADIUS Embedded™ 1.6 is out with incremental improvements and new usability features.
2018-03-31
BlissRADIUS Embedded™ 1.5 is released with new proxy features and advanced caching for better resilience.
2018-03-04
BlissRADIUS Embedded™ 1.4 maintenance release is out! No significant changes, lot of small fixes. And we finally updated documentation on custom integration.
2017-12-02
BlissRADIUS Embedded™ 1.3 is released. It is incremental release with more fixes and tweaks than new features.
2017-06-05
BlissRADIUS Embedded™ 1.2 is out! It brings many performance and stability enhancements.
2016-11-05
BlissRADIUS Embedded™ 1.0 is out! This is important milestone that marks more than a year of successful production use. 1.0 is backward compatible with 0.x and brings incremental improvements and bug fixes.
2016-09-26
BlissRADIUS Embedded™ 0.9 brings integration with Blesta billing. There is also a new "local" standalone mode to run program without third-party billing. Manual has been updated accordingly.