Documentation

Everything you need to know about LabLock installation and usage

Documentation

System Requirements

System Requirements

The requirements below list the minimal configuration. Any better hardware or newer software may be used. If you experience problems, nonetheless, please do not hesitate to contact us.

Architecture

✓ 32 bits

✓ 64 bits

Software

✓ Windows 10

✓ .Net 4.7 or higher

Hardware

✓ 1 gigahertz (GHz) or faster processor

✓ At least 2 gigabytes (GB) for 32-bit or 4 GB for 64-bit

✓ 1GB available disk space

Browsers

✓ Chrome

✓ FireFox

✓ Microsoft Edge

✓ Internet Explorer

Installation

Administrator rights are required for LabLock installation

Start the installation: Right click on LabLockInstall.exe file from the installation folder and click on "Run as administrator"
This will open the installation wizard. Click "Start" to begin the installation.
Read the EULA (End User License Agreement), click the checkbox to accept the license terms, and click on "Next"
Click on "Install .NET 4.7.2" to install .NET on the PC.
Click "Next" to continue with the installation.
Click on "NodeJS" to install NodeJS on the PC.
Once the installation is completed a pop up will be displayed. Click "ok" to confirm NodeJS is installed.
Click "Next" to continue with the installation.
Click "Install LabLock components" to start the installation process of LabLock Service.
Click "Next" to continue the installation of LabLock Service.
Select LabLock service port and click "Next".
Note: By default, LabLock uses the port 8081 for the service API traffic.
Select LabLock web portal port and click "Next".
Note: By default, LabLock uses the port 3000 for the Web traffic.
Select LabLock installation folder and click "Next".
Note: By default, LabLock folder is located on C:\Program Files\JAKO-Solutions\LabLock\
Click "Next" in "Confirm Installation" windows to start LabLock Service installation.
Once LabLock service is installed click "Close" to return to LabLock wizard.
Click on "Validate" to validate LabLock service installation.
After clicking "Validate", if the installation was successful the following message will appear: "LabLock version 1.1.0 already installed in the machine".
Click "Next" to move to the next window.
Click "Deploy" to bring the LabLock web interface into effect.
Once the Web interface is installed, it will show a message in green.
Click "Next" to continue.
Click on "Reboot" to restart the PC or Finish to go back to Windows.
Note: The computer will need to be restarted to begin using LabLock.

Getting Started

After the LabLock installation is complete, restart the PC to start using the product. LabLock portal can be accessed remotely or locally from different web browsers.

Accessing LabLock

Open one of the supported web browsers (Edge, Chrome, Mozilla) and type in the following URLs:

For local access:

http://localhost:port or http://127.0.0.1:port

For remote access:

Introduce computer name or IP followed by the port.

http://computername:port or http://ip:port

Where the port is the port number configured during the installation. By default, LabLock uses port "3000"

The login page to introduce your username and password will appear.

Once the credentials are accepted, you will be redirected to the LabLock landing page.

Navigation

LabLock Top menu contains the main 5 sections of LabLock: Dashboard, Restrictions, Settings, Import/Export, and Activity.

On the right side of the menu, there is a dropdown menu with the information of the user logged into the LabLock interface. The dropdown menu shows the full name of the logged in user. Click on the user's full name to open menu.

User Menu

Option	Description
User	This is the local user for local authentication or the SAMaccountname for AD authentication of the logged user to the LabLock portal.
Role	This is the role that the user is part of.
IP	This is the IP from the computer that is logging into the LabLock portal.
LabLock Version	This is the version of LabLock installed on the PC.
License Status	This is a link to a Windows where the license status is displayed.
Help	This is a link to the documentation located on the LabLock website.
Logout	This is a button to log the user from the LabLock portal.

License Status Window

License Status Window gives an overview of the status of license where the following information can be found:

Option	Description
License	Maybe "Permanent" or "Temporary".
License ID	This is the ID of the license file.
Computer	This is the name of the computer where the license file is activated.
Customer name	The name of the company assigned by JAKO-Solutions when the license is generated.
Customer ID	This is the JAKO-Solutions customer ID.

Dashboard

The top version of the dashboard contains 3 parts: Desktop details, Restrictions Dashboard, and user details:

Desktop Details

This section displays computer details. It will provide the computer name, operation system, and time when the PC was turned on.

There are 3 buttons where the PC can be logged off, restarted, and shut down.

Restrictions

This section details the restriction's status. In this section, you can suspend the LabLock restrictions temporarily by clicking suspend.

Restrictions will be activated automatically if the suspension count down reaches 0. Restrictions can be activated by clicking the suspend button again.

Suspend button is disabled if no restrictions are set in the Restrictions section.

User Details

This section contains the user's details. If a user is logged on to the PC, it will show what users are logged in and when they logged into the PC.

You can screenshot the desktop by clicking on the "camera" icon.

You can also send a 100-character message to the PC where LabLock is installed by clicking on the "message" icon.

Note: Users that are part of the interactive group will not have screenshots and message icons. Those users aren't fully logged into Windows OS, they're just running a process or service. Therefore, message and screenshot options are disabled.

Restrictions

Restrictions are divided into 5 different sections: Core, System Keys, Apps, Startup, and Firewall.

Core

Core tab is a section where you can configure restrictions based on Desktop, Taskbar, FileExplorer and System.

Desktop Restrictions

LabLock Policy	Description
Hide the Desktop	Hides all desktop icons and disables desktop context menus
Disable edit Desktop	Protects desktop icons and desktop files/folders from tampering: they can be executed, but cannot be edited or deleted
Disable Edge	Disables the ability to swipe using touch from the edges of the screen
Hide Bin on Desktop	Hides the Bin from the Desktop

System Keys

The system keys tab allows you to block keyboard keys, keys combinations, and Mouse buttons. It is divided into subsections to represent different groups of keys.

Apps

The Apps tab is a white list of applications allowed to run on the PC. Applications can be configured by adding the path of the executable file ".exe" or adding a folder where all executable files ".exe" within it and its subfolders will be allowed to run.

By default, the list is empty. The module won't block any applications until at least one application is added.

Note: The Task Manager is never blocked from the Apps Tab for security reasons. If you want to block Task Manager, it can be blocked from the "Core - Systems" section.

Startup

The Startup tab allows you to add paths to executables and scripts that will be executed by Windows at Start-up.

Firewall

The firewall tab allows configuring local Firewall rules on the PC where LabLock is located. The screen is divided into two tables: LabLock firewall rules and Windows firewall rules.

Firewall Rules will only be added by port number.

Settings

Settings menu allows you to configure the different LabLock options. Settings are divided into 3 different sub-sections: Roles, AD, and General.

Roles

General

Roles

The Roles tab allows access to different profiles within LabLock. These roles must be attached to existing Local Windows groups or Active Directory security groups.

On the landing screen, there will be a list with all the roles created, a description, the group they belong to, the permissions granted for the role, and the status of the role. By default, there will be an Administrator role belonging to the Administrators local Windows group to access the application.

Note: To do the initial setup, only a user belonging to the Administrators windows group will be allowed to log in to LabLock.

Import/Export

Import

In the Import section, you will import the existing LabLock restrictions and settings configurations from other LabLock instances.

Click "Browse" to upload a LabLock configuration file.
Once loaded, you have different checkboxes for the different "Restrictions" and "Settings" available in LabLock.
By default, all the sections will be imported.
Check the sub-sections that you want to import to the system
Click the "Import now" button to upload them and apply the configuration.

In the "Activity" section can be checked the MD5 number of the configuration file is imported for traceability.

Export

The Export section allows you to save your current LabLock configuration for backup purposes or to deploy to other machines.

Select the sections you want to include in your export
Click "Export now" to generate the configuration file
Save the file to your preferred location

Exported configurations can be imported on other LabLock instances to quickly deploy the same settings.

Activity

The activity menu can be used to view, search and trace the different activities and changes to the restrictions in the LabLock web portal, such as applied restrictions, warnings, user login information, and more.

Features

Use the search box to find specific entries
Filter entries based on the username, IP, dates, and different menu sections
Inspect applied restrictions by clicking the info button
Export logs in CSV format by clicking the export button in the upper right corner

By default, the activity log has a limit of 50 explorable entries, which can be expanded to 200 or 1000 entries, while the total number of log entries can be exported.