/portal

Sample UniFi portal in php

Primary LanguagePHP

Requires
----------------------------------------
PHP >= 5.5.0
UniFi >= 4.6.0

Ubiquiti UniFi External Portal Example
----------------------------------------
The provided example of authorizing guests on the UniFi controller had 
some minor issues. First and for most was the the fact that it relied 
on an external script. This is a deal breaker for users that are on 
cheap shared hosting that has functions PHP's exec disabled for 
security purposes. It also is not a good idea to call out to external 
scripts from the internet at large due to the security implications. 
This is a pure PHP solution and just requires that the curl module is 
installed for PHP.


Files
-----------------------------------------
There are two examples included.
  * Simple is most basic form, this can be used as a jumping off point
    to making your own more complex portal.
  * SQL contains a way to store uses in an external database using
    sqlite. It is written using PDO so switching database types is
    trivial.



Installation
-----------------------------------------
For the simple example just edit the authorize.php file and enter in
your UniFi controller details. You can change the index.php file as you
see fit. Just leave the php at the top of the file alone.

For the SQL example in addtion to editing index.php you will need to
edit config.php. The config settings are all at the top of the file. To
initilize a database just visit the /manager section and a database will
be created for you, assuming the web server has write permission to the
database folder.


How it works
-----------------------------------------
The code is pretty straight forward. The initial page captures the GET
variables passed by the unifi controller and stores them as PHP session
variables. The core functionality of the interacts with the unifi
controller API using CURL. Once the CURL post is made it sleeps for a
short while to give time for the controller to authorize the client then
redirects the client to their original destination.

Bugs
-----------------------------------------
Please report any bugs or enhancements to:
https://github.com/kaptk2/portal

License
-----------------------------------------

Copyright (c) 2015, Andrew Niemantsverdriet
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met: 

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer. 
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies, 
either expressed or implied, of the FreeBSD Project.