Chapter 3. User Web App

Table of Contents

3.1. Login
3.1.1. About
3.1.2. Select Language
3.1.3. Single Web App Session
3.1.4. Login Alternatives
3.1.5. Card Self Association Dialog
3.2. SafePages
3.2.1. Document Expiration
3.2.2. Footer
3.2.3. Document Details
3.2.4. Browser
3.3. PDF
3.3.1. PDF Filters
3.3.2. Document Scope
3.3.3. Description
3.3.4. Security
3.3.5. Passwords
3.3.6. Letterhead
3.3.7. Download
3.3.8. Send
3.4. Print
3.4.1. Printer Selection
3.4.2. Selected Printer
3.4.3. Delegated Print
3.4.4. Print Job Settings
3.4.5. Direct Print Release
3.4.6. Full Print Scope and Jobs
3.4.7. Delegated Print Edit
3.4.8. Job Ticket Print
3.5. Printer Settings
3.5.1. Page Scaling
3.5.2. Print Preview
3.5.3. Printer Setting Options
3.6. Letterheads
3.7. Delete
3.8. Log
3.8.1. Documents
3.8.2. Transactions
3.9. Sort
3.10. User Details
3.10.1. Internet Printer
3.10.2. Pagometers
3.10.3. Financial
3.10.4. Redeem Voucher
3.10.5. Transfer Credit
3.10.6. Transfer Money
3.10.7. Send Bitcoins
3.11. Upload
3.11.1. Upload Dialog
3.11.2. Upload Drop Zone
3.12. GDPR Dialog

The User Web App can be reached at https://savapage:8632/. For all URL options see Appendix E, URL Cheat Sheet.


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

3.1. Login

Web App: Login Dialog

Figure 3.1. Web App: Login Dialog


When a user opens the Web App the login dialog is skipped when an Authentication Token is present in local storage of the browser. The login dialog is also skipped when the Web App is opened from a trusted and authenticated User Client or with a One-Time Authentication Token.

For a description of the global user authentication defaults see Section 4.10.3, “User Authentication”.

Some invariants:

  • Only Persons can login.

  • Disabled users are not allowed to log in.

  • The internal "admin" user is not allowed to log in as user.

  • As long as system setup is needed user login attempts are blocked with a message saying “Application setup is required”.


You can use an alias as User Name. See Section 12.4, “User Name Aliases”.

3.1.1. About

The About dialog shows version and copyright information. The top of the dialog can be customized: see Section, “Custom HTML”.


The dialog contains a Printer Driver section with a download link for the CUPS SAVAPAGE.ppd file. This section can be enabled or disabled by setting the configuration key webapp.about.driver-download.enable to Y or N. See Section, “Config Editor” on how to change this value.

3.1.2. Select Language

Web App: Select Language Dialog

Figure 3.2. Web App: Select Language Dialog

  • At the moment English, German and Dutch are fully supported. Press the language of your choice. This will reload the login dialog in the newly selected language.

  • Press Cancel to return to the login dialog.


You can use the webapp.language.available configuration property to enter a comma separated list of selectable ISO 639 language codes. For instance: de,en,fr,es,ru,nl. See Section, “Config Editor” on how to enter this value.

When the list is restricted to a single language, the Language button in is not shown in the Login dialog, and the Web App Locale is set to the single available language.

3.1.3. Single Web App Session

A warning message is shown when a desktop [10] user tries to open the same Web App type a second time in the same browser instance. In rare occasions, for instance, due to network connectivity issues, this statement might be false. In that case a Login will bring you back on track.

Same type Web App session detected

Figure 3.3. Same type Web App session detected

When a user opens a second Web App session of another type this message is shown:

Web App type change detected

Figure 3.4. Web App type change detected

In both situations, either go back to the active Web App session or press Login to login to the intended Web App type. This will invalidate any other SavaPage session in the same browser instance.

3.1.4. Login Alternatives

The appearance of the Login dialog on a device depends on the following settings:

Terminal settings overrule global settings, and the URL parameter overrules the defined default. When available, alternative login methods can be selected by tapping the method button at the bottom of the dialog. Some sample Login dialogs are shown below.

Web App: Login Dialog - ID Number

Figure 3.5. Web App: Login Dialog - ID Number

Web App: Login Dialog - Local NFC Card

Figure 3.6. Web App: Login Dialog - Local NFC Card

Web App: Login Dialog - Network NFC Card

Figure 3.7. Web App: Login Dialog - Network NFC Card


A special URL path is available to use OAuth as SSO for User Web App. This URL can be presented on the site of an OAuth provider, to seamlessly link to SavaPage. See Appendix E, URL Cheat Sheet.

3.1.5. Card Self Association Dialog

When an unknown card is swiped, and Card Self Association is enabled, the user is presented this dialog to associate the new card.

Web App: Login Dialog - Card Self Association

Figure 3.8. Web App: Login Dialog - Card Self Association

There is a time limit to enter the Username and Password. The remaining seconds are shown and when counted down to zero the dialog is automatically closed. The time limit (seconds) is contained in configuration key webapp.card-assoc.dialog-max-secs. See Section, “Config Editor” on how to change this value.

[10] The Single Web App Session check is solely done for certain desktop browser sessions. Sessions on macOS and mobile devices are not checked.