Microsoft Login

This will allow all public Microsoft accounts (includes accounts used with Outlook.com, Xbox, Skype, Visual Studio, Windows Live, OneDrive and Windows Phone) to be used to authenticate on the IACBOX login page.

Login via Microsoft Account is intended to be free; guests cannot be charged. To set up Microsoft Login for guests, create and configure a Microsoft App with an existing Microsoft account. The Microsoft login requires at least one valid ticket template configured as 0€ (free).

Creating the Microsoft App

Go to the Microsoft Website and sign in with an account. After signing in, the system will redirect to the App Overview page, where a new app can be created by clicking on Register new Application.

image

Name the new app, select the supported account types (default: Personal Microsoft accounts only), and enter a valid Redirect URI to the login page of the IACBOX. The Redirect URI may vary; for instance, if a custom certificate is used, adjust the domain names accordingly. Additionally, the Redirect URI will differ based on whether the default login page or the LoginAPI is used.

Default login page URL: https://hotspot.internet-for-guests.com/
LoginAPI URL: https://hotspot.internet-for-guests.com:8443/index.php

If the LoginAPI has never been activated, use the default login page URI. The dropdown-selection can also be left on Web. Finish on Register.

image

The next page shows a summary of the created App. Write down the Application (client) ID and then proceed by opening the Certificates & secrets menu on the left side.

image

On the Certificates & secrets page click on New client secret and add a new secret here (the name does not matter). After creating this secret, copy the content of the field Value.

image

System Configuration

Before proceeding, ensure a Ticket Template for Social login types has been created. To do so, navigate to the WebAdmin menu Users/Tickets/Templates and create a new template. In this template, scroll down to the section Login methods and then activate the checkbox for Social Login. Now configure the rest of the settings in the template and then save it.

At this point 2 fields should be of note:

  • Application (client) ID
  • Secret “value”

Enter both fields at the Microsoft Login configuration in the IACBOX WebAdmin menu Login methods/Social networks/Microsoft. In addition select one of the given Redirect URLs from the drop-down, it must match with the Redirect URL used in the Microsoft APP settings and then Save.

image

Login page

After saving this configuration it will take effect immediately and an option to log in with a Microsoft account will be displayed on the login page.

image

If a new theme of the login page has been created, Microsoft Login may need to be manually activated as a login method for it to become visible. This can be done by editing the currently active theme in the WebAdmin menu Login page/Login page editor. In the editor, locate and click on Login box 1 (bottom left corner). Then, in the top right corner, select Social networks in the Element tab.
Click Save to enable Microsoft Login in the theme.