Facebook Login

The login with Facebook Credentials is meant to be free, guests can not be charged.
To setup a Facebook Login for your guests, you will need to create a Facebook Developer Account and configure a Facebook App with it.
Facebook login requires at least one valid ticket template, configured as 0€ (free).
In case you use a custom certificate on your IACBOX, pay close attention to change all redirect URLs according to your custom hostname.

Developer Account

To create a Facebook app, a Facebook Developer Account is required.
To transform a regular Facebook Account into a Facebook Developer Account, follow this link while logged in with a regular account:
https://developers.facebook.com/async/registration.

image

Click on Continue to proceed with the activation of the Facebook Developer account.

Creating the Facebook App

In the Developer Account’s Dashboard, click on Create App

image

Choose Other when asked for the use case.

image

If prompted for the app type, select Consumer and proceed with Next.

image

Enter an App name as well as an Email address, a Category and proceed by clicking Create app.

image

The *Create App ID" Button creates your App and forwards you to the configuration menu. Start configuration by clicking on + Add Product in the navigation on the left side and select Facebook Login.

image

After Facebook Login was added, the following screen will appear:

image

It is not neccessary to Choose a Platform here, instead proceed by switching directly into the new Settings menu. Which can be found directly over the Quickstart navigation menu entry. This will open the Client OAuth Settings. Proceed by copying the following URL into both fields, Valid OAuth Redirect URIs and Deauthorize:

https://hotspot.internet-for-guests.com/?auth=social&hauth_done=Facebook

image

Afterwards proceed by clicking on Save Changes which can be found on the right bottom of the site.

Now click on the top Settings entry in the navigation menu. This will bring you to the basic settings of your app. In here, click on + Add Platform and then select Website.

image

In the next step fill out your Contact Email, the Display Name of your app and the Category selection. Afterwards fill the fields App Domains and Site URL with the following:

App Domains: hotspot.internet-for-guests.com and the domain of your public accessible site URL (e.g. iacbox.com)

image

Site URL: Your public accessible homepage as URL (e.g. https://www.iacbox.com)

image

After the changes are saved, set the toggle in the middle of the page from In development to Live. Without this toggle, client authentications will not work.

image

To conclude the setup of this app, navigate to Facebook Login/Settings. Here you will see that one final permission is required.

image

Inside this message click on “Get Advanced Access”. In the follow-up popup about “Take a Tour” it is not necessary to do so right away.

image

Find the section for “public_profile” and click on “Get advanced access”.

image

In the next step confirm the popup.

image

Configure Facebook Login

In the WebAdmin of the IACBOX navigate to Login methods/Social networks and activate Facebook.

image

Enter the App ID and App Secret. Select one of the given Redirect URLs from the drop-down, it must match with the Redirect URL used in your APP settings.

Login Page

On the Login Page you are able to choose Facebook to log in. Click on the Button to get to the Facebook Authentication Page.

Log in on the Facebook Login Page

image

Accept permissions which will be asked for

image

Afterwards you’ve been successfully authenticated via the Facebook login.

image

Stored Data

Successful authentications will be saved and can be accessed in the WebAdmin menu Reporting/Collected user data. Please ensure handling the saved data is compliant with the GDPR regulations.