Installing with Blesta

Installing with Blesta

Important: Server running Blesta must permit PHP scripts to use cURL network calls to TCP port 9071. Most shared hosting providers, for security reasons, disable features like this. You may have to use dedicated (virtual) server to be certain integration will work.

General preparations

1. Download archive for your OS and architecture to computer where you wish to install BlissRADIUS Embedded. Extract program file to installation folder, /blissembed on Linux or c:/blissembed on Windows. Program file is blissembed.exe or blissembed respectively.

2. On Linux OS make sure program file has execute privilege. If needed run shell command chmod a+x blissembed from created folder.

3. Create blissembed.cfg file in folder with program and configure correct values (see example below). You must not skip this step. Configuration file must contain line hosttype = blesta

4. Add write privileges to program folder for BlissRADIUS Embedded to be able to write files in it.

Blesta API access

1. Log in to Blesta staff area and navigate to Settings > System > API Access and add API user blissmebed. Save key as you will have to enter it in BlissRADIUS Embedded admin area later on.

Connecting with database

1. If you are using MySQL database of Blesta host to store data, then you need to create MySQL user account (see below). If you are only testing BlissRADIUS Embedded then you can skip this step and use SQLite database instead.

Starting program and copying required PHP files

1. Run BlissRADIUS Embedded by typing console/shell command: blissembed.exe or ./blissembed depending on your OS. This will start program in debug mode. For production use correct starting procedure.

2. Program will extract required files to blesta sub folder. You must copy all files from it to your Blesta installation folder.

3. Once copied edit components/modules/blissembed/config.php file and set BLISSEMBED_URL value to correct IP address where BlissRADIUS Embedded is installed. Configure other settings to your liking. This file and options in it are not automatically updated with new versions of BlissRADIUS Embedded. If new options become available you have to manually add them to activate features.

4. Give write privilege to components/modules/blissembed folder of your Blesta installation to user that runs web server. Files engine.php and version.txt in that folder must be write able. They are automatically updated each time Blesta detects newer version of BlissRADIUS Embedded running.

Blesta module and plugin activation

1. Log in to Blesta staff area and navigate to Settings > Modules > Available and find and install BlissRADIUS Embedded module.

2. Navigate to Settings > Plugins > Available and find and install BlissRADIUS Embedded plugin.

3. In staff area home page open Manage Widgets and enable BlissRADIUS Embedded widget that displays RADIUS statistics. This is done separately by every Blesta admin.

Configuring BlissRADIUS Embedded

1. Open BlissRADIUS Embedded web interface on http://127.0.0.1:9071 using browser (change address if not accessing from local computer). By default BlissRADIUS Embedded uses admin as password for web interface and all access from local addresses 127.0.0.1 and ::1 doesn't require login.

2. Go to Config page in BlissRADIUS Embedded web interface and set correct parameters for Blesta host:

   • Host API URL should point to Blesta API access, for local computer it is http://127.0.0.1/blesta/index.php/api Path may differ depending on web servers rewrite rules. Normally you need to add only /api at the end of your Blesta website URL.
   • Set API username to blissembed (Blesta API access user you created) and API password to key you saved for latter.
   • Add Blesta IP address to Trusted IP Address field for login if it is other than 127.0.0.1 or ::1

3. Confirm that configuration is correct by clicking on Test API button.

If you get Authentication failed / HTTP error 401 but entered credentials are correct, you might be running PHP in CGI or FCGId mode. You need to update your .htaccess file to pass an environment variables to Blesta, or simply make sure .htaccess contains:

RewriteEngine on
...
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

If this doesn't work check instructions here for other possible reasons.

You have successfully connected BlissRADIUS Embedded with Blesta and two way communication is working.

Example blissembed.cfg

This is example configuration for testing Blesta. SQLite database in local file is used to store data separately from host software.

hosttype = blesta
dbtype = sqlite

This is example configuration for production. Data is stored in same MySQL database where Blesta stores data. Change database parameters to match correct values.

hosttype = blesta
dbtype = mysql
dbhost = 192.168.100.10
dbport = 3306
dbname = blesta
dbuser = blissembed
dbpass = blissembed

Creating MySQL user account

Creating new MySQL role and granting privileges is required only if you are using BlissRADIUS Embedded with MySQL. Replace database name with one Blesta is using.
Username and password must be same as in blissembed.cfg Replace localhost with IP address where BlissRADIUS Embedded is installed if they are not on same computer.

CREATE USER 'blissembed'@'localhost' IDENTIFIED WITH mysql_native_password BY 'blissembed';
GRANT ALL PRIVILEGES ON blesta.* TO 'blissembed'@'localhost';

If you receive "The authentication plugin is not supported" error during program start make sure user is identified with correct plugin, as BlissRADIUS Embedded uses mysql_native_password. You might need to change my.cnf file and re-create user if example above don't work:

[mysqld]
default-authentication-plugin=mysql_native_password

2025-03-16

Referral program is active, existing users can win bonus license time if they bring new customers in.

2025-03-02

BlissRADIUS Embedded™ 1.16 is out with new features.

2024-09-27

BlissRADIUS Embedded™ 1.15 is out with postpaid license support.

2024-09-19

We are introducing changes to payment methods. See Home page for more details.

2023-07-06

BlissRADIUS Embedded™ 1.14 is out with new features.

2022-11-18

BlissRADIUS Embedded™ 1.13 is released with new fixes and features.

2021-12-31

BlissRADIUS Embedded™ 1.12 is out with new features.

2021-06-22

Volume discount for monthly BlissRADIUS™ licenses is available now.