Google Login

This manual describes how to create a new Google Project, so that guests can authenticate and log in on the IACBOX by using their Google account.

Hint

  • This module became free for all IACBOXes with valid Software Maintenance as of 1st December 2016.

  • The login with Google Credentials is meant to be free, guests can not be charged.

  • To setup a Google Login for your guests, you will need to create a Google Project and configure it according to this manual.

  • The Google login requires at least one valid ticket template, configured as 0€ (free). If not ticket template is available, a new example template will be created.

  • In case you use a custom certificate on your IACBOX, pay close attention to change all redirect URLs according to your custom hostname.

Creating a Google Project

In order to use the Google Services you have to create a project beforehand. This can be done on the Google Developers Page, accessible with this URL: https://console.cloud.google.com/cloud-resource-manager

Log in with your regular Google account and then select Create project in the top left corner.

../_images/google_plus_login_1.png

If prompted, read and eventually agree to the Terms of Service, then continue with creating a new project:

../_images/google_plus_login_2.png

Now select the newly created project from the list, toggle the menu on the right side and then select Settings.

../_images/google_plus_login_2_2.png

After this, click on the white-on-blue list-icon on the very top left corner and select APIs & Services.

../_images/google_plus_login_2_3.png

On the next page, navigate to Credentials and then proceed and select Create Credentials and within this menu, select OAuth client ID.

../_images/google_plus_login_2_4.png

If this is your first project/app, then you will be prompted to enter some missing information in the next step. Follow the prompted link to the OAuth consent screen, select External, and then fill out all required fields. As for the field Application home page it is required to use following:

https://hotspot.internet-for-guests.com

It is not necessary to add an authorised domain here, but the Developer contact information has to be filled out. Now on the next page, proceed by clicking Add or remove scopes. Here, check the first row ../auth/userinfo.email and then proceed with the button Update. After this, hit Save and continue. On the next page you can add test users to test your app before production. This is not necessary since this app will be public after all required fields have been filled out, so proceed with Save and continue instead.

../_images/google_plus_login_2_5.png

Now that the OAuth consent screen has been set up, navigate back to the Credentials menu, click on Create Credentials and then select OAuth client ID from the dropdown-menu. On the next page, select Web application as Application type and add both, an Authorized JavaScript origins and an Authorised redirect URIs entry like so:

Authorised JavaScript origins: https://hotspot.internet-for-guests.com

Authorised redirect URIs: https://hotspot.internet-for-guests.com/?auth=social&hauth.done=Google

Proceed with the button Create.

../_images/google_plus_login_2_6.png

Hint

  • Your Client ID and Client Secret will now be displayed. Later on you can find this information again by editing your OAuth web application.

WebAdmin Configuration

In the WebAdmin navigate to Login methods / Social networks and activate Google. Here, fill out the Client ID and Client secret from the last step. Select one of the given Redirect URLs from the drop-down, it must match with the Redirect URL used in your APP settings and then Save.

../_images/google_plus_login_3.png

Login Page

If you only use the default login page and did not create a new theme yet, then the Google login button should become visible automatically. However, if you’ve created a new Theme, then you may need to manually activate Google login as login method. This can be done by editing the currently active Theme in the WebAdmin menu Login page / Login page editor. In the editor, find and click on Login box 1 (left bottom corner) and then in top right corner, select Social networks in the Tab Element. Proceed by clicking on Save. The result on the login page will look like in the preview.

../_images/google_plus_login_4.png