Self-service kiosk installation and configuration

1. Create a specific folder on the local machine, such as C:\self-service-kiosk;
2. Obtain the self-service kiosk package from the Downloads screen;
3. Copy the SelfServiceTerminal.zip file to the user's local machine, in local folder C:\self-service-kiosk;
4. In local folder C:\self-service-kiosk, unzip the SelfServiceTerminal.zip file. After the SelfServiceTerminal.zip file is unzipped, it may be deleted from local folder C:\self-service-kiosk.

1. On senior X Platform, go to Technology > Administration > Application Management;
2. Click on New application, define the Name (example: self-service kiosk), the Description (example: self-service kiosk - Lobby Management) and click on Save;
3. To define the application roles, go to Technology > Administration > Authorization > Role Management;
4. Click on the Edit button of the User role;
5. In the Applications tab, associate the self-service kiosk application with the selected role by enabling the Associated option and clicking on Save;
6. Go to Technology > Administration > Application management to generate the application access keys. On the self-service application, click on Actions and select Manage keys.
7. Click on Generate key and, in the configuration file of the self-service kiosk package that was unzipped on the local machine, type the two generated keys, detailed in the following topic ("Define the self-service kiosk properties");
8. Leave this screen open to be used in the next step.

In local folder C:\self-service-kiosk, open the application.properties file to edit it and enter the properties:

• access.key = copy the access key generated during the application registration;
• secret = copy the secret generated during the application registration. It is the nameless field right below the Access key.
• tenant.name = define the tenant that will access the application. For example, if the platform user is admin@sam.com, simply enter "sam" in this field.

Leave the other fields of the file with their current values, they should only be modified in specific cases. The fields are:

• server.port = Indicates the port of the Operating System where the service will run.
• spring.servlet.multipart.max-request-size = Maximum size of am http request for the application.
• spring.servlet.multipart.max-file-size = Maximum size of a file sent to the application. Normally used to restrict the photo size.

After completing the information, clickTo save and close the file.

In local folder C:\self-service-kiosk, double click on the create-service file and the start-service file.

Before registering a kiosk, register a property set. Then:

1. On the senior X Platform, access Access and Security Management > Entrance Management > Self-service > Self-service;
2. Click on Add, define the Description and choose the Lobby in which the terminal belongs;
3. Select its Properties;
4. Define the Manufacturer:
   • Remote access: this option is enabled when the self-service kiosk is used on mobile devices - tablets;
   • Videosoft: for terminals of this manufacturer, up to two dispenser ports may be added. The Smart communication port must be defined. For kiosks that use two dispensers, the communication port that will be used for scheduled credentials and that one that will be used for non-scheduled credentials must be defined.
   • Perto: terminals of this manufacturer only allow one dispenser port.
5. Click on Save.

The Active kiosk checkbox indicates that the self-service kiosk is active and can be selected for use when configuring the device.

The In use checkbox, however, cannot be edited and is only for consultations.

If it is checked, this kiosk is already configured on a device. If unchecked, this kiosk is available to be used on a device, as long as it is also set as active.

The Remove usage becomes available if the kiosk is set as In use. By clicking this button, the previously-associated device is dissociated, and this kiosk may be configured again on another device.

When the self-service kiosk is started, its screen displays the remote access kiosks that were previously registered on senior X Platform > Access Control and Security Management. Select the desired kiosk, enter the IP of the thermal printer that will be used to print the credentials and click on Save.