Skip to content

Initialize UIP Configuration

Kiosk Admin Client Application Configuration

The Kiosk Admin application deployed to the Adapter Hub uses UIP to sign in to the application. In order for Kiosk Admin to sign in using UIP Login Accounts, a Client Application must be configured in UIP.

For this purpose, the Kiosk Distribution contains a file named uip-client-application-template-<version>.json. This file needs to be imported into the Integration Platform and configured as described below,

  1. Open the UIP administration application in a web browser
  2. Navigate to Administration > Client Applications
  3. Click on the Add Client Application button to open the Add Client Application page.

  4. Select the Browse button and search for the uip-client-application-template-<version>.json file located in the path where your Kiosk Distribution exists. //

  5. Edit the template contents directly in the Client Application text field, modifying the following settings:

  6. Click Save when done editing

Upgrade

UIP and Adapter Hub should always be upgraded to their latest versions prior to upgrading the Kiosk Services.

When upgrading the Kiosk Services, ensure that the existing Client Application for Kiosk Admin is updated with the changes found in the Kiosk Distribution template (shown above). Updates to the Client Application are required in order for the Kiosk Admin to allow login operations.

Note: Clicking the Add Client Application button to get to the Add Client Application page starts with a generic template. If editing the template by hand, be sure to include all fields as defined in the image above for the Kiosk Admin application.

Failure to enter all data such as scopes and roles can result in Kiosk Admin not being able to login. If issues launching the Kiosk Admin application is experienced, then carefully review the Client Application JSON for errors.

Login Accounts

Login Accounts for Kiosk Admin are managed in UIP by navigating to the Administration > Login Accounts menu item (only UIP Administrators have access to this page). This page can be used to add, modify or delete the user accounts that can be used to login into the Kiosk Admin application, and login accounts used for UIP may also be used for Kiosk Admin by assigning those users a KioskAdmin Role.

//

  • Use the Add Login Account button to add a new account to access Kiosk Admin //
    • Enter a Username (i.e. login ID) and the user's First Name and Last Name
    • Select the desired UIP Role if the account should have access to UIP, otherwise "None".
    • Select the desired Kiosk Admin Role, which can be one of these:
      • Administrator - Has access to all pages in Kiosk Admin
      • User - Has access to all pages except:
        • Manage Guest Data
    • Set a password and confirm it again. The password needs to fulfill these rules:
      • Password minimum length is 9 characters
      • Password must contain at least one upper case, one lower case, one digit, and one special character
      • Password will need to be changed when the user signs in for the first time
    • Selecting Password Does Not Expire disables the default 90 day password expiration for an account (not recommended)
    • Select whether to enable multi-factor authentication (MFA) for the account to enhance security with an Authenticator app (this is recommended)
    • Click Save when done
  • Use the Edit link to edit an existing login account settings
    • Same data to be entered as for adding a new account
    • Click Save when done
  • Use the Delete link to delete an existing login account. You will be prompted to confirm the deletion. Note that you cannot delete your own account (The account that you used to log in).