11. User Client

Table of Contents

11.1. Introduction

The User Client is a Java application for desktops and notebooks that resides in the system tray.

According to the Oracle Java Documentation:

“The system tray is a specialized area of the desktop where users can access currently running programs. This area may be referred to differently on various operating systems. On Microsoft Windows, the system tray is referred to as the Taskbar Status Area, while on the GNU Network Object Model Environment (GNOME) Desktop it is referred to as the Notification Area. On K Desktop Environment (KDE) this area is referred to as the System Tray. However, on each system the tray area is shared by all applications running on the desktop.”

The SavaPage User Client is provided as a notifier of personal user events like:

A successful print to SavaPage. See SavaPage as Printer.
A Proxy Printer started printing one of your jobs. See Proxy Printers

A notification message is typically displayed near the SavaPage tray icon in the form of a balloon (Windows) or message box (GNU/Linux, macOS).

The User Web App opens for the authenticated user at a double-click on the tray icon, a click in the notification message or selecting the Open Web App… item from the tray icon context menu. When the User Client is trusted as authentication source no extra login is needed.

User Client authentication is explained in User Client Authentication.

Client access can be restricted by IP address with these configuration properties:

User Client Access Configuration Properties
Configuration property	Description
cliapp.ip-addresses-allowed	A CIDR Set of Client IP addresses that are allowed to use the User Client App (when void, all client addresses are allowed).
cliapp.auth.ipaddresses-denied.enable	Enable (`Y`) or Disable (`N`) User Client Authentication for clients that are denied for their IP address.

See Config Editor on how to enter these properties.

Note

Rate Limiting is applied to login failures.

Important

When using the User Client concurrently with the User Web App and Proxy Print Authentication you are strongly advised to use an external database like PostgreSQL. See Using an External Database.

Warning

Java applications with system tray icons do not work properly with GNOME Shell. This is a persistent Java bug that is still not resolved. As a workaround, use the --anchor command line option for an alternative display.