• Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Search
  • Register
  • Login
Netgate Discussion Forum
  • Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Search
  • Register
  • Login

[HOWTO] Captive portal + FreeRADIUS + local MySQL user friendly single step

Scheduled Pinned Locked Moved Captive Portal
154 Posts 47 Posters 104.6k Views
Loading More Posts
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • R
    rudat
    last edited by Nov 1, 2017, 9:14 AM

    in the Post is written „:=„  an not „;=„ also a change im the php file

    1 Reply Last reply Reply Quote 0
    • R
      rudat
      last edited by Nov 1, 2017, 3:10 PM

      @retestreak:

      I'm running the latest version of pfsense with freeradius3
      I followed every detail in the guide but I still cant manage to make everything work.

      I did try what user "srvrgt" suggested except changing the "==" to ";=" resulted in having an attribute error. ( I left the schema file as it was "==")
      I've only changed the password value to cleartext-password in the php file.

      Now I am facing 2 issues.

      1. Whenever a client connects and fills in the form the user gets created in sql but somehow it is not showing up on radius clients tab.

      2. When a client submits the form they first get redirected to the new captive portal after clicking the accept button the default pfsense captive portal comes on with the error code that username/password is wrong however
      authentication for user testu:testp works because it is in the clients tab on radius

      If someone could help me that would be great!
      Thank you in advance

      I used the version form v0.48 - 03 May 2017
      download from  https://github.com/deajan/pfSense-cp-auth-onestep

      1 Reply Last reply Reply Quote 0
      • R
        rudat
        last edited by Nov 1, 2017, 9:34 PM

        @srvrgt:

        heyy guys, first of all thank you Deajan for the amazing work, really, it helps alot, now to my problem, i am currently on pfsense 2.3.4, and everything seems to be working fine except for the radius login part, i can see the users in the MYSQL database but they are all Rejected, the configuration of the ports on the radius server is ok, i was able to find this in the logs

        "Invalid user (sql1: Failed to create the pair: Invalid vendor name in attribute name "Password"): [123] (from client tester port 2010 cli "

        i believe from what ive read that there is no such thing as apassword atribute, it must be Cleartext-Password, the problem is that i cant seem to find where to change the value, could you please help me out?,

        FYI if i use the test user and test password i can log in no problem and the mysql database also reflects that, so im guessing its just some sintaxis problem.

        thanks

        Do you found a Solution?

        1 Reply Last reply Reply Quote 0
        • R
          retestreak
          last edited by Nov 2, 2017, 7:18 AM

          @rudat:

          @srvrgt:

          heyy guys, first of all thank you Deajan for the amazing work, really, it helps alot, now to my problem, i am currently on pfsense 2.3.4, and everything seems to be working fine except for the radius login part, i can see the users in the MYSQL database but they are all Rejected, the configuration of the ports on the radius server is ok, i was able to find this in the logs

          "Invalid user (sql1: Failed to create the pair: Invalid vendor name in attribute name "Password"): [123] (from client tester port 2010 cli "

          i believe from what ive read that there is no such thing as apassword atribute, it must be Cleartext-Password, the problem is that i cant seem to find where to change the value, could you please help me out?,

          FYI if i use the test user and test password i can log in no problem and the mysql database also reflects that, so im guessing its just some sintaxis problem.

          thanks

          Do you found a Solution?

          Thanks for the help :)

          I've changed the Cleartext-password atribute in the schema.sql to ":=" and I had to enter my database password in the captive portal setting. Now everything works great.

          1 Reply Last reply Reply Quote 0
          • D
            doken1313
            last edited by Nov 27, 2017, 9:49 AM

            Absolutely amazing work! Congratulations to all of you that made this system.

            However I had some issues from users registering with emails with no valid domains (no mx records at all) so I am posting an addon for all of you that  want to avoid this :

            Add a new error message in captiveportal-config.php like

            $novalidmail_string = "The input you provided is not a valid email.";
            
            

            or whatever you want to appear there and make your ozy-captive.php look like this (lines 105 - 117)

            
            	if (isset($_POST['emailAddress']))
            	{
            		$emailAddress = cleanInput($_POST["emailAddress"]);
            		$record = 'MX';
            		list($user, $domain) = explode('@', $emailAddress);
            	}
            	else
            		$emailAddress = false;
            	if (!checkdnsrr($domain, $record)  && ($askForEmailAddress == true))
            	{
            		$checkMessage = t('novalidmail_string');
            		$badCheck = true;
            	}
            
            

            Once again great work !

            1 Reply Last reply Reply Quote 1
            • D
              darkiazz
              last edited by Dec 8, 2017, 2:25 PM

              Hi guys !

              I've a problem with pfSense 2.4.1 and this solution..

              I've 'Invalid creditential specified' and in the system logs 'failed retrieving values required to evaluate condition'.

              Do anyone can help me ?

              Thanks you

              1 Reply Last reply Reply Quote 0
              • D
                Darlene
                last edited by Jan 18, 2018, 12:21 AM

                @deajan:

                03 May 2017:

                • New version 0.48 has php-mysqli requirements
                  29 Nov 2016:
                • Added watchdog install
                  26 May 2016:
                • Added new pkg procedure for 2.3 final and post 2.3 releases

                Hello,

                I've written a captive portal wrapper that creates the FreeeRADIUS user account and logs in in one step, all with bootstrap responsive code and validation, with configurable language that suits for hotels and public wifi providers.
                Here's the full howto:

                1 Introduction

                pfSense-cp-auth-onestep is a project that aims to provide a captive portal interface for pfSense 2.x (currently tested on 2.2.x and 2.3-beta) that doesn't require the creation of a user account.

                In fact, when a user registers, it creates the RADIUS user account and then logs in with that account.

                A demo can be found at the following address:http://pfcp.netpower.fr
                The latest doc can be found here: http://netpower.fr/pfcp-pfSense-auth-onestep

                Initial work based on the excellent work of khan: https://forum.pfsense.org/index.php?topic=57260.0

                2 Preparation of pfSense

                In order to work, pfSense needs the following packages: FreeRADIUS, Cron.

                Also, some upstream packages are required in order to work.

                First we need to fetch some upstream packages:

                Additional steps for pfSense 2.3

                The repository management has changed in pfSense 2.3, and by default the FreeBSD repository is disabled.

                You must edit the file /usr/local/etc/pkg/repos/pfSense.conf and set the following value:

                FreeBSD: { enabled: yes }
                

                Additional steps after 2.3 final release

                You must also edit file /usr/local/etc/pkg/repos/FreeBSD.conf and set the following value:

                FreeBSD: { enabled: yes }
                

                ATTENTION: Once the packages are installed with pkg command, please set this value to 'no' again so updates won't interfere with pfSense normal functionality.

                Installation of packages:

                pkg
                pkg update
                pkg install nano git
                

                If your pkg doesn't find the packages, you may need to reinit the pkg database with

                rm -f /var/db/pkg/*.sqlite
                

                After this, pkg update should reinitialize the pkg database.

                2.1 Installation of MySQL

                Although MySQL should be installed on a separate machine, it's convenient to have a single pfSense box doing the whole authentication.

                Installation of MySQL isn't supported by pfSense, so you'll have to redo the following steps after every update.

                2.1.1 pfSense 2.2 steps

                MySQL installation

                pkg install mysql56-server
                pkg install compat8x-amd64
                

                PHP support

                touch /etc/php_dynamodules/mysql
                /etc/rc.php_ini_setup
                

                The following command should output mysql and mysqlnd.

                php -m | grep mysql
                

                2.1.2 pfSense 2.3 steps

                MySQL installation

                pkg install mysql56-server
                pkg install compat9x-amd64
                pkg install php56-mysql
                

                Since v0.48 of the captive portal version, mySQL queries are done via prepared statements using mysqli.
                If using pfSense-cp-onestep-auth v0.48 or higher, please replace php56-mysql package with php56-mysqli.

                PHP support

                The following command should output mysql and mysqlnd.

                php -m | grep mysql
                

                2.1.3 Common steps

                We need to allow the MySQL service to start.

                echo 'mysql_enable="YES"' > /etc/rc.conf
                

                Also, pfSense won't start services unless their name finishes by “.sh”

                mv /usr/local/etc/rc.d/mysql-server /usr/local/etc/rc.d/mysql-server.sh
                

                2.1.4 MySQL startup fix

                For whatever, pfSense won't start MySQL sometimes. If you have a tip, please tell.

                In order to fix this, create the following file /usr/local/bin/mysql_relaunch.sh

                #!/usr/bin/env sh  
                
                service /mysql-server.sh status > /dev/null
                if [ $? != 0 ]; then
                        service mysql-server.sh start
                fi
                

                Render the file executable

                chmod +x /usr/local/bin/mysql_relaunch.sh
                

                Install the cron package and add the following entry:

                */1 * * * * root /usr/local/bin/mysql_relaunch.sh
                

                After this, we may launch the mysql service

                service mysql-server.sh start
                

                Also, as FreeRADIUS may start before mysql and fail, install watchdog service and set it up to restart FreeRADIUS.

                Secure your installation by running the following command and change your root password

                /usr/local/bin/mysql_secure_installation
                

                Optionnaly, you may create the following password file /root/.my.cnf

                [client]
                password="YourMySQLrootPassword"
                

                2.2 FreeRADIUS setup

                2.2.1 FreeRADIUS installation
                Install the FreeRADIUS2 package via System > Packages > Available

                In Services > FreeRADIUS > Users

                Add a user called: testu

                Set it's password: testp

                in Services > FreeRADIUS > NAS / Clients

                Add a NAS user:

                IP: 127.0.0.1

                Client Shortname: tester

                Shared Secret: SuperTest (replace this with a good password)

                In Services > FreeRADIUS > Interface

                Add the interface the RADIUS server should listen on: 127.0.0.1

                You can now check in Status > System Logs that the server is active

                Sep 29 14:54:50 radiusd[10330]: Loaded virtual server <default>Sep 29 14:54:50 radiusd[13493]: Ready to process requests.</default>

                Connect to pfSense via ssh or console and check if FreeRADIUS authenticates (replace SuperTest with your Shared Secret):

                radtest testu testp 127.0.0.1:1812 0 SuperTest
                

                The answer should look like:

                Sending Access-Request of id 108 to 127.0.0.1 port 1812
                        User-Name = "testu"
                        User-Password = "testp"
                        NAS-IP-Address = 192.168.1.1
                        NAS-Port = 0
                        Message-Authenticator = 0x00000000000000000000000000000000
                rad_recv: Access-Accept packet from host 127.0.0.1 port 1812, id=108, length=20

                Check authentication in Status > System Logs

                Sep 29 15:04:51	radiusd[22223]: Login OK: [testu] (from client pfSense port 0)
                

                #TIP: See https://doc.pfsense.org/index.php/Testing_FreeRADIUS for tuning and troubleshooting

                2.2.2 MySQL FreeRADIUS integration

                First we need to create the RADIUS database. Launch the “mysql” program. If you didn't create the /root/.my.cnf password file, launch “mysql -p” and execute the following statements:

                CREATE DATABASE  `radius`;
                exit
                

                We also have to get a copy of the sql files needed for the captive portal.

                You can fetch them via wget at http://netpower.fr/sites/default/files/soft/bin/pfSense-cp-auth-onestep.gz or directly via git:

                cd /root
                git clone https://github.com/deajan/pfSense-cp-auth-onestep
                cd /root/pfSense-cp-auth-onestep/sql
                

                We need to integrate every .sql file into the radius database. Please execute the admin.sql file at last because it contains definitions for the other files. Add “-p” to myql if you don't have created the password file.

                Before running those commands, modify the admin.sql file in order to replace the default password 'radpass'. (Use vi or nano if installed).

                mysql radius < cui.sql
                mysql radius < nas.sql
                mysql radius < radippool.sql
                mysql radius < schema.sql
                mysql radius < wimax.sql
                mysql radius < reg_users.sql
                mysql radius < admin.sql
                

                Activate SQL support in Services > FreeRADIUS > SQL:

                Enable SQL Support: Enable

                Enable SQL Authorization: Enable

                Enable SQL Accounting: Enable

                Enable SQL Session: Enable

                Enable SQL Post-Auth: Enable

                Server IP Address –> 127.0.0.1

                Server Port --> 3306

                Server Database -> radius

                Server User -> radius

                Server Password -> radpass (replace with your database password).

                MySQL authentication test

                Execute the following command (replace SuperTest with your Shared Secret):

                radtest testu testp 127.0.0.1:1812 0 SuperTest
                

                The radpostauth table should contain the authentication info:

                mysql -p -e "SELECT * FROM radpostauth;" radius
                

                +–--+----------+-------+---------------+---------------------+
                | id | username | pass  | reply        | authdate            |
                +----+----------+-------+---------------+---------------------+
                |  1 | testu    | testp | Access-Accept | 2015-09-29 15:13:24 |
                +----+----------+-------+---------------+---------------------+

                2.3 Enable captive portal

                2.3.1 Setup

                Grab a copy of the pfSense-pfcp-auth-onestep files via github or via the following link http://netpower.fr/sites/default/files/soft/bin/pfSense-cp-auth-onestep.gz

                Uncompress the file and edit captiveportal-config.php to meet your settings, especially the database password.

                Create a new zone in Services > Captive Portal . Example “PUBLICWIFI”

                In Services > Captive Portal > File Manager, upload all the files from pfSense-pfcp-auth-onestep beginning with “captiveportal-*”

                The following files need to be uploaded:

                captiveportal-bootstrap.min.css
                captiveportal-bootstrap.min.js
                captiveprotal-jquery.validate.js
                captiveportal-jquery-1.11.3.min.js
                captiveportal-background.jpg
                captiveportal-sidelogo.png
                captiveportal-check_readio_sheet.png
                captiveportal-termsofuse.html
                captiveportal-config.php

                #TIP: I had trouble with uploading the files in pfSense 2.2.6. After every 3 files, I had to restart WebConfigurator via ssh.

                We Can now enable the captive portal on the LAN interface or whatever interface you need.

                We also need to activate RADIUS authentication:

                IP: 127.0.0.1

                Port: 1812

                Shared Secret: SuperTest (or your Shared Secret)

                Radius Protocol: PAP

                Account Check:

                Send RADIUS accounting packets: Enable

                Port: 1813

                Accounting updates: stop/start accounting (FreeRADIUS if available)

                RADIUS NAS IP attribue: LAN IP (or whatever interface you selected)

                Portal page contesnts: Upload file ozy-captive.php

                Redirection URL: Whatever you'd like, example: http://www.google.com

                2.3.2 Testing

                Once enabled, you can open a browser and enter any domain. You should end on the captive portal page.

                You may access directly to the captive portal via http://[pfSenseIP]:8002

                #TIP: Your computer should use DHCP and use the pfSense IP as DNS server or the redirection won't work.

                If the redirection still doesn't work, check that the DNS Resolver service is running without the forwarding mode.

                Also, if your computer already has the domain in DNS cache, you may have to flush dns cache.

                On Linux:

                service nscd restart
                

                On Windows:

                ipconfig /flushdns
                

                At least, close and reopen your browser so it would make a new DNS query.

                Fell free to help improve this howto.

                Regards,
                zy.

                please how do u edit and enter the code?

                1 Reply Last reply Reply Quote 0
                • GertjanG
                  Gertjan
                  last edited by Jan 18, 2018, 5:59 AM

                  @Darlene:

                  please how do u edit and enter the code?

                  Using a keyboad and your hands ?!

                  Of course, a more specific answer is possible as soon as we know what kind of device you use.

                  No "help me" PM's please. Use the forum, the community will thank you.
                  Edit : and where are the logs ??

                  1 Reply Last reply Reply Quote 0
                  • M
                    mansoor.khan
                    last edited by Jan 19, 2018, 2:59 PM

                    Hello,

                    I am facing problem in login page from Captiveportal.

                    I am using the default login Form Html code with Form action 'action ="$PORTAL_ACTIONS"' and still I am continuously getting Access-Reject message in Mysql table 'radpostauth'.

                    I am using Pfsense 2.4.2 with freeRadius3 pakage and mysql Server 5.6.39.

                    When I create user from Captiveportal -> Users login page works fine then. Also with NO authentication login page is working.

                    But I need this with Mysql database authentication.

                    Did anyone face problem like this? If you have solution in mind please let me know.

                    Thanks in advance

                    M 1 Reply Last reply Aug 1, 2019, 3:17 PM Reply Quote 0
                    • O
                      Ophion
                      last edited by Feb 8, 2018, 4:27 PM

                      Great work! Appreciated.

                      1 Reply Last reply Reply Quote 0
                      • D
                        Darlene
                        last edited by Feb 13, 2018, 10:26 AM

                        Please how do you edit those files you mentioned earlier

                        1 Reply Last reply Reply Quote 0
                        • GertjanG
                          Gertjan
                          last edited by Feb 13, 2018, 11:25 AM

                          @Darlene:

                          Please how do you edit those files you mentioned earlier

                          Who is you ?
                          What file ?

                          No "help me" PM's please. Use the forum, the community will thank you.
                          Edit : and where are the logs ??

                          1 Reply Last reply Reply Quote 0
                          • P
                            pama
                            last edited by Feb 15, 2018, 7:30 AM

                            Please help, I am not able to install mysql…how can you get it working? Thank you

                            1 Reply Last reply Reply Quote 0
                            • C
                              caraffandee @srvrgt
                              last edited by Jun 27, 2018, 12:10 PM

                              @srvrgt said in [HOWTO] Captive portal + FreeRADIUS + local MySQL user friendly single step:

                              FOLLOWUP, in case anyone is hitting the same problem as me, the problem is with freeradius3, so first of all you need to change the attribute type on the file ozy-captive :
                              From :    “INTO radcheck (username, attribute, value) VALUES (?, ‘Password’, ?)”)) "
                              TO:  INTO radcheck (username, attribute, value) VALUES (?, ‘Cleartext-Password’, ?)"))
                              And then you need to change the file    Schema.sql  BEFORE you add it to the radius database
                              FROM:
                              CREATE TABLE radcheck (
                                id int(11) unsigned NOT NULL auto_increment,
                                username varchar(64) NOT NULL default ‘’,
                                attribute varchar(64)  NOT NULL default ‘’,
                                op char(2) NOT NULL DEFAULT ‘==’,
                                value varchar(253) NOT NULL default ‘’,
                                PRIMARY KEY  (id),
                                KEY username (username(32))
                              ) ;
                              TO:
                              CREATE TABLE radcheck (
                                id int(11) unsigned NOT NULL auto_increment,
                                username varchar(64) NOT NULL default ‘’,
                                attribute varchar(64)  NOT NULL default ‘’,
                                op char(2) NOT NULL DEFAULT ‘:=’,
                                value varchar(253) NOT NULL default ‘’,
                                PRIMARY KEY  (id),
                                KEY username (username(32))
                              ) ;
                              I hope this helps anyone  My problem was with pfsense 2.3.4  FRERADIUS 3

                              Hi, @deajan, hi @rudat . I can confirm @srvrgt post. I've used the base work to setup a small captive portal in a hotel. Everything used to worked great until I upgraded to the latest version of pfSense/OzyCaptive-single-step. It stopped working. After modifying the table structure as per srvrgt advice, everything works flawlessly again.
                              I think you should update your code in the project repo, specifying that your latest version requires pfSense 2.4.3/freeradius3.
                              Thanks everybody for the outstanding work!

                              P.S.: Does anyone know a simple way to limit bandwidth on per-user basis? (something like this -obviously fictional -

                              INSERT INTO radcheck (id, username, attribute, op, value) VALUES (NULL, ‘Eleonor’, ‘Max-Input-Bandwidth’, ‘<=’, ‘5242880’);
                              
                              1 Reply Last reply Reply Quote 0
                              • O
                                OKODA @deajan
                                last edited by Aug 22, 2018, 6:08 PM

                                This post is deleted!
                                1 Reply Last reply Reply Quote 0
                                • M
                                  Marcus Vinicius @mansoor.khan
                                  last edited by Aug 1, 2019, 3:17 PM

                                  @mansoor-khan Hi mansoor!!! i setted up everything in captive portal + FreeRADIUS + mariadb (mysql) but I got the same problem trying log on Captive portal page, and mysql reports me (Access-Reject) too after type mail and name on the box.

                                  Did you or someone got this problem already solved?

                                  Thank you Guys

                                  1 Reply Last reply Reply Quote 0
                                  • N
                                    Nova9
                                    last edited by Nova9 Aug 19, 2019, 2:47 PM Aug 16, 2019, 11:22 AM

                                    [removed]

                                    F 1 Reply Last reply Aug 16, 2019, 11:39 AM Reply Quote 0
                                    • F
                                      free4 Rebel Alliance @Nova9
                                      last edited by Aug 16, 2019, 11:39 AM

                                      @Nova9 php 5.6 is outdated and full of vulnerabilities on pfsense

                                      pfsense is now running php 7...

                                      as for your CSS ...this is a pfSense forum, not HTML one :'( we could try to help you debugging your page, but we need the associated HTML to help you

                                      N 1 Reply Last reply Aug 16, 2019, 12:30 PM Reply Quote 0
                                      • N
                                        Nova9 @free4
                                        last edited by Nova9 Aug 19, 2019, 2:47 PM Aug 16, 2019, 12:30 PM

                                        [removed]

                                        GertjanG 1 Reply Last reply Aug 16, 2019, 2:09 PM Reply Quote 0
                                        • GertjanG
                                          Gertjan @Nova9
                                          last edited by Aug 16, 2019, 2:09 PM

                                          @Nova9 said in [HOWTO] Captive portal + FreeRADIUS + local MySQL user friendly single step:

                                          Maybe the .js files aren't loading properly?

                                          Use the right button of your mouse.
                                          Every browser will give you the possibility to see the 'html source of the web page.
                                          You'll be seeing in a split second if resource files like css and js files are not load, most of the time because they have another file on the system name.

                                          Btw : The subject "Captive portal + FreeRADIUS + local MySQL user friendly single step:" is a rather big project.
                                          Nothing something that can be pulled of 'ASAP'.
                                          Using an old pfSense version gives you a new feature : you created a security time bomb.

                                          No "help me" PM's please. Use the forum, the community will thank you.
                                          Edit : and where are the logs ??

                                          1 Reply Last reply Reply Quote 0
                                          • J Joseguadalupe referenced this topic on Apr 5, 2022, 8:42 PM
                                          • J Joseguadalupe referenced this topic on Apr 5, 2022, 8:42 PM
                                          • N ngpfpeter referenced this topic on Dec 18, 2023, 8:29 PM
                                          • GertjanG Gertjan referenced this topic on Dec 19, 2023, 7:53 AM
                                          • D Dmc referenced this topic on Feb 22, 2025, 12:27 PM
                                          • D Dmc referenced this topic on Mar 20, 2025, 3:40 PM
                                          • First post
                                            Last post
                                          Copyright 2025 Rubicon Communications LLC (Netgate). All rights reserved.
                                            This community forum collects and processes your personal information.
                                            consent.not_received