Automation App

The Workflow Automation application is an extension that can be installed on PC along with IDmelon Accesskey to automate the user login and logout routine in kiosk environments (Windows Kiosk, KioWare, etc.). Therefore, the login (and logout) steps are done once by a system admin, and then by tapping the user’s card on the reader, the login steps are done automatically, as well as for the user to exit the kiosk environment.

Prerequisites

Configuring a workflow

To switch to automation mode, enter the following command in PowerShell.

accesskeycli workflow-automation -s -t automation-app -a login-logout -e kiosk-interactive
  • -s: To activate automation and configure it.
  • -t automation-app: This value is always fixed.
  • -a login-logout: To set the automation actions. In this case, both the login and logout procedures can be automated. (Other possible actions: -a login , -a logout)
  • -e kiosk-interactive: To set the environment. In this case, we want to use the kiosk environment of Windows 10 and 11. (Other possible environments: kioware, kiosk-multiapps, -e kiosk-browser).
  • -p microsoft-login (Optional): To set the target platform. In this case, our goal is Microsoft 365 login and logout automation.
  • -u https://myapps.microsoft.com?login_hint=${UserId} (Optional): To set the target URL. In this case, we set the Microsoft 365 URL.

Kiosk

For kiosk single app (full-Screen kiosk), enter the following command in PowerShell:

accesskeycli workflow-automation -s -t automation-app -e kiosk-interactive

For multi app kiosk, enter the following command in PowerShell:

accesskeycli workflow-automation -s -t automation-app -e kiosk-multiapps

KioWare

One of the software that has implemented the kiosk environment is KioWare, which is supported by the IDmelon Workflow Automation extension. The only difference between KioWare and the Windows kiosk is the need to train the logout operation.

  • Open KioWare Config Tool on your system.

  • Select the option Attract/Inactivity from the left menu.

  • From the Session End Settings section, set the When the session ends, clear: option as follows:

Automation Train

  • Select the option General from the left menu.

  • From the Exit Passcodes section, click on Add Exit Passcode button.

Automation Train

  • From the new dialog that opens, set the Exit Action option to Restart KioWare.

  • In the Change Passcode section, enter your desired passcode.

  • Click on Done button.

Automation Train

Train a workflow

The training operation is performed only once by the admin.
If no workflow is predefined for the target platform while tapping the card, the training hints window will be displayed and the training procedure will begin.

  • Navigate to the website or application you need training for.
  • Tap a card on the reader.
  • Click the Yes button on the presented alert if you want to start the training.

Automation Train

  • The training hints window will appear as follows.

Automation Train

  • Leave the toggle of the Display Tap to Login Page on to see the Tap Your Card alert on the top of the start page later for each login.

Automation Train

  • Toggle the Enable Error Message for Unregistered Cards on to display an error after tapping a card which is not enrolled yet.

Automation Train

  • Click the Start button to start the training.
  • The recording icon will appear in the bottom right corner of the screen which means that each click will be captured as a step.

Automation Train

  • During the recording process, try to click only on the icons, buttons, or links, and not on the white spaces. After all the clicks are captured as all the necessary steps, click on the recording icon to stop training.

Note: Currently, for the kiosk environment (kiosk-interactive, kiosk-browser, kiosk-multiapps), the logout operation does not need to be trained, and when the user’s card is tapped to log out, the kiosk environment is automatically restarted.

Deploying a pre-trained workflow

Workflows created on a PC can be copied onto others PCs. That is, the training steps are performed only once on one PC by an administrator, and after copying the workflow files onto other PCs, there is no need to training on each PC separately.

Note: The Monitor Dimensions, Scale and Display Resolution of all systems must be the same.

Automation Train

Admin needs to copy the following folder from their PC:

C:\Program Files (x86)\IDmelon\Accesskey\Extensions\WorkflowAutomation\Actions

Then, paste the folder in a path, such as C:\kiosk\Actions, in other PCs.

Finally, enter the following command in PowerShell on those target PCs:

Copy-Item -Path "C:\kiosk\Actions" -Destination "C:\Program Files (x86)\IDmelon\Accesskey\Extensions\WorkflowAutomation\Actions" -Recurse -Force

Automation

After the training process is over, everything is ready to use. When the user taps the card on the reader, if the login page is open in the kiosk environment, the automation will be started and clicks will be done automatically. If the user has already logged in and the card is tapped again, the kiosk will automatically restart and be ready for the next user to log in.

Disabling a workflow

To disable training prompt, enter the following command in PowerShell.

accesskeycli workflow-automation -c disable-auto-capture

To disable the Workflow Automation, enter the following command in PowerShell.

accesskeycli workflow-automation -r -t automation-app
Edit this page on GitHub
×