Guest Login

Owned by Aleksei Melnikov
Last updated: Nov 15, 2022 by Gustaf Sjögren
4 min read

There is an option in TermWeb that enables the Guest user account. Guest users are concurrent users that, instead of having a unique and reserved login like Named Users, use a clients and/or servers concurrent Guest licenses.

By default, Guest users can not view or edit anything in TermWeb. Guests need to be provided privileges through Permission Schemes much like Named Users.

Authentication

There are three available options for authenticating Guest users without SSO. These options are available in the Administration view under: User management → Guest Account → Log in method (see highlight in screenshot below for reference).

  • Automatic (Always) - This option is only available in the original Admin client for multitenant servers.

All users are logged into TermWeb automatically logged into the Admin client as Guest users without the need to fill in credentials using the servers base URL (ex: https://demo.termweb.eu). The normal login page will still be available (ex: https://demo.termweb.eu/login)

  • Automatic (when client is specified in URL)

All users are logged into the specified TermWeb client automatically when using the /client/client_name appendation in the URL (ex: https://demo.termweb.eu/client/client_name) where client_name is the login name of the TermWeb client. The login name of a specified client is found in the Administration view under: User management → Client info → Login Name (see highlight in screenshot below for reference). This page can only be accessed by users with the Administrator role or System Administrator role.

  • Normal

All guest users can access the TermWeb client by providing the User name and Password provided in the Guest account details menu. Multitenant servers also need to be provided with the correct Client name.

Disabling automatic login

Automatic login can also be prohibited by a server administrator by editing the following property in the termweb.properties-file:

guest.autologin.disabled=true

SSO Authentication

Users can be logged in as Guest users if they are authenticated by a validated Identity Provider. A server administrator can enforce the default login progression for all users by editing the following properties in the termweb.properties-file:

api.autocreate.users=false

api.login.as.guest.when.usermissing=true

The above settings can also be individually set for each type of SSO authentication (OpenID, SAML 2.0, OIDC). Read more about individual configurations here.

Licensing

Guest users are a generic concurrent account that can access TermWeb. The number of Guest user licenses determines the number of concurrent users that access a TermWeb client or server simultaneously. If the maximum number of simultaneous Guest users has been reached for a client or server, the user will receive an error message to that affect.

Server License information

The License information for a server is available through the Administration view under: System → License (see highlight in screenshot below for reference). Please not that this page can only be accessed by users with the System Administrator role.

The Guest account property needs to be enabled for Guest user login. The number of concurrent Guest users allowed for the server is shown in the Max concurrent guests value.

Client license information

The license information for a specified client, containing the number of concurrent Guest users allowed for the client, can be found in the Administration view under: User management → Client info → Max concurrent guests (see highlight in screenshot below for reference). Please not that this page can only be accessed by users with the Administrator role or System Administrator role.

Additionally, System administrators can access and set this value in the the Administration view under: System → Clients and by left-clicking the specific client (see highlight in screenshot below for reference).