This article provides the steps to enable guest authentication with Facebook and Google+.
NOTES & REQUIREMENTS:
Applicable to UniFi Controller 22.214.171.124 and later. In order to use 3rd party guest authentication, you must have a publicly-resolvable hostname pointing to your controller. If your company already uses a public domain, such as example.com, you may want to set up a subdomain such as portal.example.com. There are a variety of Dynamic DNS providers where you can register a hostname, then have your USG update it to your WAN IP.
Table of Contents
Social media guest authentication can be enabled to allow clients to login to a guest network using their Facebook or Google+ credentials. Start by creating a facebook app, google+ API login, or both.
Facebook App Setup
1. Register a Facebook App
Use the guide HERE to register a Facebook authentication app, keeping this help article open for reference.
Step 3 prompts you to choose a display name for your application. Choose a name that will represent your WiFi portal. Users will see this when authenticating. For this example, I’ll use the name "CMurphy Hotspot Login," and keep the default email, which is the email linked to my Facebook account. For Category, I’ll use Communication. Category isn’t critical here, so feel free to use a different category if it better represents your business.
You will be prompted to either enter a quick-start guide, or go back. If you click go back, you can get to the dashboard by clicking My Apps in the top right corner. Select Choose Platform > Website to begin the quick start quide.
2. Complete Facebook Website Quick Start.
Under Tell us about your website, enter the domain name of your controller as the Site URL. Next, click Skip to Developer Dashboard.
3. App Settings
Navigate to Settings in the sidebar to open up the basic app settings.
App ID and App Secret will be automatically assigned to your app. Choose a Display Name and Namespace for your app - these can be anything, but users will see them when authenticating.
Under both App Domains and Site URL, enter the domain or subdomain of your controller.
Replace controller with publicly accessible controller URL, and if using non-default site, replace site id with the site's unique 8-digit identifier, i.e. ryx7y4tf in the following example:
Be sure to save your changes.
4. Add Product
Next, click Add Product, then Facebook Login to create the login page.
5. Add Controller Redirect URI and Port
Under Facebook Login settings, include the following URL under "Valid OAuth redirect URIs". Use the toggle options in the below image.
Or if using http (which may not be permitted by current Facebook settings):
Replace domain.com with your publicly accessible controller URL, and site <siteid> with the 8-digit site identifier from your UniFi Controller URL, for example:
In this example, the siteid is "ryx7y4tf" and would need to be included in the URL added to the "Valid OAuth redirect URIs" in Facebook App settings:
Save changes before continuing.
6. Publish App
Finally, publish the app to live, by changing the "Off" dialog button at the top of the Facebook for developers page to on.
If you are setting up Google authentication as well, continue reading. Otherwise, skip to Controller Setup.
Google+ API Setup
1. Enable Google Login
Use the Enable the Google+ API Guide HERE to enable Google login.
Step 6a in Google's guide, linked above, prompts the admin to enter the app origin. In this case, it will be the subdomain, followed by port 8880 (and/or 8843). Note the Client ID and Client Secret, which will be used later in the Controller Setup.
You will need to add your customized version of the following URL to Google API Credentials Settings:
If using Secure Portal (https):
Or if you do not have Secure Portal enabled (http):
Replace <controller-url> with your publicly accessible controller URL, and site <siteid> with either default if using the default site, or the 8-digit site identifier from your UniFi Controller URL, as in the following example:
In this example, the siteid is "ryx7y4tf" and would need to be included in the URL added to Google API settings. The following would need to be added to Authorized redirect URIs in Google API settings:
If client device gets a redirect error after setup, add the redirect URI below under "Authorized redirect URIs" in the above step:
UniFi Controller Setup
1. Activate Guest Policies
Once you have configured your Facebook or Google app, open your publicly hosted controller. Begin by activating Guest Policies.
2. Configure the Guest Portal
Next, open the Guest Control tab to configure the guest portal. Select Hotspot authentication. If you wish, enter a Promotional URL to forward clients to your website after they are authenticated. Select Redirect using hostname, and enter your controller subdomain. Select Enable HTTPS Redirection.
3. Activate Third Party Authentication Method
Under Hotspot, select the third party authentication methods that you wish to activate. Enter the ID and Secret for the selected app(s).
4. Add Facebook and Google's Public IPs
Under Access Control, add the following list of public IPs that Facebook uses:
Now add the following public IP that Google uses:
5. Test the Guest Network
Finally, use a device to connect to the guest network and verify that the guest portal works properly.