Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.





Installing FreeRADIUS


HostBill connects directly to FreeRADIUS mysql database, so you need to make sure that

  1. FreeRADIUS have enabled sql support
  2. SQL server/port on FreeRADIUS server is accessible from your HostBill
  3. SQL user you will use have enabled remote access from your HostBill server


If you dont have freeRADIUS installed yet you can refer to this short guide: Installing FreeRadius

Installing HostBill


HostBill installation is fully automated and takes just seconds, more info at Installation

Connecting HostBill with FreeRADIUS


  1. In HostBill go to Settings > Modules, find and activate freeRadius hosting module
  2. You will be redirected to Settings > Apps to set connection with FreeRADIUS database
  3. Enter your freeRadius database credentials, use Test Connection to check if HostBill can connect

 

Creating your first FreeRadius-based package


  1. In HostBill go to Settings > Products & Services, and Add new order page
  2. From Order Types select Other type
  3. After creating order page add new product in it, provide name & Save changes
  4. From Connect with App section select FreeRadius module & app.
  5. Under User & Group Tab, select group you wish to assign clients using this package to (HostBill will fetch groups directly from FreeRADIUS).
  6. Additionally, you can set attributes each user created with this package will have, ie set. Simultaneous-Use:=1 .

If you'd like to enable your clients with ability to change passwords go to Client Functions in your product config, and make sure "Change Password" function is enabled.

 

FAQ

Q: What are groups in product config, how to use them?
A:
- Groups are fetched from mysql table radgroupcheck of freeradius mysql database
- if no group is available/selected in product config - user group feature will not be used
- if group is set in configuration - it will be used to add user to radusergroup table


Q: What happens in the freeradius system when a customer is suspended in HostBill?
A: To distinguish suspended user, he is being moved automatically to group "HB-Suspended"

HB-Suspended group is added automatically by HostBill. Its auth-type is set to reject to prevent user from login.