• 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.2k 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, 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